Display custom icons on system tray
Go to file
2022-12-12 03:08:17 +01:00
resources Add exclamation and question resources 2019-05-18 01:51:03 +02:00
screenshots Add README 2019-05-18 18:18:37 +02:00
src Remove redundant clone 2021-12-14 16:31:36 +01:00
.cspell.json Add SVG icons 2019-05-12 03:59:26 +02:00
.gitignore Initial import 2019-05-06 01:38:59 +02:00
.pre-commit-config.yaml Update .pre-commit-config.yaml 2021-10-09 17:39:39 +02:00
.quoll.txt Mention that Ayatana Application Indicators are now used 2021-10-09 22:42:06 +02:00
.rustfmt.toml Hide rustfmt configuration 2019-05-18 01:53:47 +02:00
Cargo.lock Update dependencies 2022-12-12 03:08:17 +01:00
Cargo.toml Bump edition to 2021 2022-12-12 03:07:49 +01:00
CHANGELOG.md Update CHANGELOG 2021-10-09 23:38:16 +02:00
LICENSE Add license 2019-05-18 03:12:31 +02:00
README.md Mention that Ayatana Application Indicators are now used 2021-10-09 22:42:06 +02:00


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.