Make theming Signal Desktop easy!
Adds custom CSS to Signal Desktop.
⚠️ This tool modifies theapp.asarof Signal Desktop.
Use at your own risk. Restart Signal after styling.
This works for most platforms. Install Node.js and run:
npm install -g signal-stylerIf you use an Arch Linux (btw) based distro, you can install it from the official Arch User Repository package.
Using an AUR helper like paru, yay or trizen:
paru -S signal-stylerOr manually:
git clone https://aur.archlinux.org/signal-styler.git
cd signal-styler
makepkg -siOnly do this to test new features before releases or for contributing.
git clone https://github.com/m-obeid/signal-styler.git
cd signal-styler
npm install -g pnpm # if not working try sudo or install through your package manager
pnpm install
node . -v # run node . instead of signal-stylersignal-styler [options] custom.csscustom.cssPath to your custom stylesheet.
-
-a, --asar <path>Path to Signal Desktop’sapp.asarto patch. By default, the tool will try to locate it automatically. Useful if Signal is installed via Flatpak. -
-t, --tray-icons <path>Path to the custom tray icons folder. Useful if you want to override the default tray icons with your own.The tray icons folder should have the following structure:
tray-icons ├── alert │ ├── signal-tray-icon-16x16-alert-1.png │ ├── signal-tray-icon-16x16-alert-2.png │ ├── signal-tray-icon-16x16-alert-3.png │ ├── signal-tray-icon-16x16-alert-4.png │ ├── signal-tray-icon-16x16-alert-5.png │ ├── signal-tray-icon-16x16-alert-6.png │ ├── signal-tray-icon-16x16-alert-7.png │ ├── signal-tray-icon-16x16-alert-8.png │ ├── signal-tray-icon-16x16-alert-9.png │ ├── signal-tray-icon-16x16-alert-9+.png │ ├── signal-tray-icon-256x256-alert-1.png │ ├── signal-tray-icon-256x256-alert-2.png │ ├── signal-tray-icon-256x256-alert-3.png │ ├── signal-tray-icon-256x256-alert-4.png │ ├── signal-tray-icon-256x256-alert-5.png │ ├── signal-tray-icon-256x256-alert-6.png │ ├── signal-tray-icon-256x256-alert-7.png │ ├── signal-tray-icon-256x256-alert-8.png │ ├── signal-tray-icon-256x256-alert-9.png │ ├── signal-tray-icon-256x256-alert-9+.png │ ├── signal-tray-icon-32x32-alert-1.png │ ├── signal-tray-icon-32x32-alert-2.png │ ├── signal-tray-icon-32x32-alert-3.png │ ├── signal-tray-icon-32x32-alert-4.png │ ├── signal-tray-icon-32x32-alert-5.png │ ├── signal-tray-icon-32x32-alert-6.png │ ├── signal-tray-icon-32x32-alert-7.png │ ├── signal-tray-icon-32x32-alert-8.png │ ├── signal-tray-icon-32x32-alert-9.png │ ├── signal-tray-icon-32x32-alert-9+.png │ ├── signal-tray-icon-48x48-alert-1.png │ ├── signal-tray-icon-48x48-alert-2.png │ ├── signal-tray-icon-48x48-alert-3.png │ ├── signal-tray-icon-48x48-alert-4.png │ ├── signal-tray-icon-48x48-alert-5.png │ ├── signal-tray-icon-48x48-alert-6.png │ ├── signal-tray-icon-48x48-alert-7.png │ ├── signal-tray-icon-48x48-alert-8.png │ ├── signal-tray-icon-48x48-alert-9.png │ └── signal-tray-icon-48x48-alert-9+.png └── base ├── signal-tray-icon-16x16-base.png ├── signal-tray-icon-256x256-base.png ├── signal-tray-icon-32x32-base.png └── signal-tray-icon-48x48-base.png -
-v, --versionShow the version number.
Apply my-theme.css with auto-detected Signal path:
signal-styler my-theme.cssSpecify the asar path explicitly, for example for Signal installed in userspace:
signal-styler -a ~/.var/app/org.signal.Signal/files/Signal/resources/app.asar my-style.cssIf you get permission errors, run with sudo:
sudo signal-styler custom.css- Only tested on Linux for now. It could work on Windows and macOS too, but I haven't tested it.
- File a GitHub issue if you run into any issues.
- The script expects Signal Desktop on Linux to be installed via Flatpak, if not you likely need to use
--asaror-ato point to the right file. - You can safely re-run the tool with new CSS — it will overwrite the existing stylesheet.
- Every time Signal updates, you will need to run the tool again to update the stylesheet.
signal-styler does not include any themes by default other than purple.css from the GitHub repo, which needs to be downloaded separately.
Here are some that could work (didn't test):
To get one, you just need the CSS file, which might be named manifest.css or something like that.
Do not report theme issues to me, but the original author of the theme.
Made with ❤️ by POCOGuy / m-obeid