Home

Awesome

Hardcode-Tray

CircleCI Codacy Badge Gitter Hardcode-Tray
release Donate

Fixes Hardcoded tray icons in Linux

The script will automatically detect your default theme, the correct icon size, the hard-coded applications, the correct icons for each indicator and fix them. All that with the possibility to revert to the original icons.

Themes

Here's a list of themes that supports Hardcode-Tray:

<div align="center"><img src="screenshots/numix.png" alt="Preview" /></div> <div align="center"><img src="screenshots/papirus.png" alt="Preview" /></div>

Requirements

Running dependencies

If the icons looks blury, you should try installing this package libappindicator3-1. See #567 for reference.

Building dependencies

Install

Arch Linux (AUR)

Make sure the base-devel group is installed:

sudo pacman -S base-devel

Stable version:

yaourt -S hardcode-tray

Development version:

yaourt -S hardcode-tray-git

Ubuntu 16.04+ (PPA)

sudo add-apt-repository ppa:papirus/hardcode-tray
sudo apt update
sudo apt install hardcode-tray

Debian 10+

sudo sh -c "echo 'deb http://download.opensuse.org/repositories/home:/SmartFinn:/hardcode-tray/Debian_$(lsb_release -rs)/ /' > /etc/apt/sources.list.d/hardcode-tray.list"
wget -qO- https://download.opensuse.org/repositories/home:SmartFinn:hardcode-tray/Debian_$(lsb_release -rs)/Release.key | sudo apt-key add -
sudo apt-get update
sudo apt-get install hardcode-tray

Fedora 30+ / Fedora Rawhide

sudo dnf config-manager --add-repo https://download.opensuse.org/repositories/home:SmartFinn:hardcode-tray/Fedora_$(rpm -E %fedora)/home:SmartFinn:hardcode-tray.repo
sudo dnf install hardcode-tray

You can see all available packages here.

Manual installation

1- Install dependencies

On Ubuntu:

sudo apt install git build-essential meson libgirepository1.0-dev libgtk-3-dev python3 python3-gi gir1.2-rsvg-2.0 librsvg2-bin gir1.2-gtk-3.0

2- Compile

git clone https://github.com/bil-elmoussaoui/Hardcode-Tray
cd Hardcode-Tray
meson builddir --prefix=/usr
sudo ninja -C builddir install

3- Open Hardcode-Tray using this command

sudo -E hardcode-tray

4- Enjoy!

Options

Hardcode-Tray shows a welcome message by default and asks the user to choose between applying the fix or reverting it. You can hide that using

hardcode-tray --apply

or

hardcode-tray --revert

Your favorite theme does not provide icons for all those hardcoded icons? Just use a different theme and change the colors using Hardcode-Tray.

hardcode-tray --change-color "#FIRSTCOLOR #REPLACE_FIRST_COLOR" "#SECONDCOLOR #REPLACE_SECOND_COLOR"...

Let you clear the backup cache folder

hardcode-tray --clear-cache

Hardcode-Tray by default detects if the user has either Inkscape, CairoSVG, RSVGConvert, ImageMagick or SVGExport installed and use one of them to convert SVG icons to PNG. In order to choose the tool to use if one of them is broken in your installation is

hardcode-tray --conversion-tool {Inkscape, CairoSVG, RSVGConvert, ImageMagick, SVGExport}

For now, we support : CairoSVG (python3-cairosvg), Inkscape, rsvgconvert (librsvg), Imagemagick and svgexport(npm library)

Cairo has some issues with converting SVG files that use CSS (see #245).

Some applications provide dark and light tray icons with the possibility to modify them using their UI. In order to use a dark theme for dark icons and a light one for light icons, you can use those two arguments. It only works if you use both of them at the same time.

hardcode-tray --dark-theme Numix-light --light-theme Numix

You can use the --only argument to fix/revert only one application; don't use the argument if you want to fix all applications your icon theme supports.

hardcode-tray --only android-messages-desktop.electron, skypeforlinux

In order to get the names needed to fix only specific programs, you can look at the app_name key in the JSON files for the program. There you can find the corresponding name for the program you want to fix.

If you installed your app in a non-standard location, you can override the path where the icons are stored using the --path argument. Only works in combination with the --only argument for a single application.

hardcode-tray --only dropbox --path /opt/dropbox-bin

You can also use --size {24,22,16} to force the script to use a different icon size or if the script does not detect your desktop environment.

hardcode-tray --size 24 --only dropbox

You can fix your hardcoded icons using a different theme than the default one.

hardcode-tray --theme Numix --only dropbox

You can print the version of Hardcode-Tray using

hardcode-tray --version

Config file

Hardcode-Tray also supports a JSON config file that can be placed under ~/.config. The file must be named hardcode-tray.json. An example of the config file can be found here. The file supports the following options for now.

Passing --theme --conversion-tool --size will overwrite those settings.

Node-WebKit JS applications

In order to fix those ugly tray icons on NWJS applications, you will need to download the SDK from here. Extract the zip file in your home directory (or place it wherever you want) and add a new key to the config file that points to the NwJS SDK directory.

Credits

Hardcode-Tray wiki