Fork 0
Display custom icons on system tray
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Daniele Tricoli 601a214dc9 Update dependencies 10 months ago
resources Add exclamation and question resources 4 years ago
screenshots Add README 4 years ago
src Remove redundant clone 12 months ago
.cspell.json Add SVG icons 4 years ago
.gitignore Initial import 4 years ago
.pre-commit-config.yaml Update .pre-commit-config.yaml 1 year ago
.quoll.txt Mention that Ayatana Application Indicators are now used 1 year ago
.rustfmt.toml Hide rustfmt configuration 4 years ago
CHANGELOG.md Update CHANGELOG 1 year ago
Cargo.lock Update dependencies 10 months ago
Cargo.toml Bump quoll to 0.2.0 1 year ago
LICENSE Add license 4 years ago
README.md Mention that Ayatana Application Indicators are now used 1 year ago



quoll is a generic indicator for the system tray that displays SVG and PNG icons. It currently support only Linux. It was inspired by AnyBar and basically it's a clone with small differences.


A screenshot of quoll


quoll depends on Ayatana Application Indicators libayatana-appindicator3-1 and gtk3 so in order to compile it you have to install them first. On Debian (and derivatives):

sudo apt install libayatana-appindicator3-dev libgtk-3-dev

Then simply do:

cargo install quoll

Distribution of resources is not supported yet using cargo, so to get the base icons (as the ones included in AnyBar, but in SVG format) just download them and put in the directory where quoll will search for them:

mkdir -p $(quoll home) && curl -sL https://github.com/eriol/quoll/releases/download/0.1.0/base_resources.tar.gz | tar xzf - -C $(quoll home)


quoll is controlled via UDP (default port is 1738). To start it use the serve subcommand:

quoll serve

To send a message to change the icon use the send subcommand, for example:

quoll send green

The message is simply the icon name, without the extension.

To list the icons currently available, and so the corresponding messages that we can send:

ls $(quoll home)

SVG icons will always precede PNG ones, so having both my_icon.svg and my_icon.png in quoll home directory, when we send quoll send my_icon the SVG one will be displayed.

The special message quit makes quoll to terminate.

UDP port can be specified with the -p flag and works for both serve and send subcommand:

quoll -p 1234 serve
quoll -p 1234 send red

For full usage instructions use:

quoll help


quoll is licensed under GPL-3.