Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Coin Price logo

Coindicator is a cryptocurrency price indicator applet for Linux.

PyPI version


  • Multiple price tickers in the status bar

  • Automatic trade pair discovery on supported exchanges

  • Additional price points in the dropdown menu

  • Audiovisual price alerts

  • Adjust the refresh rate

  • Thousands of cryptocurrency pairs from the following exchanges:



You will need Git and Python 3.5 or higher, as well as some system dependencies.

For your convenience, I've included a small install script that will install (or upgrade) coindicator and its dependencies, as well as create a desktop icon.

 git clone
 cd coindicator

Upgrading from 1.x

User data has moved to your home folder. To keep your settings, move the user.conf file to: ~/.config/coindicator/.


  • A launcher icon "Coindicator" should be installed that can be used to start the app
  • Alternatively, run ./ to activate the virtual environment and start the app
  • You can also run the program manually with source env/bin/activate and then run src/coin/ & or python3 src/coin/ & to start the app


Use the GUI to add and remove indicators (find the piggy icon), to pick assets, to set refresh frequency and to set alarms. Alternatively, edit the user.conf YAML file in the project root.

max_decimals: default 8. Lower if you want fewer decimals (takes priority over significant_digits) significant_digits: default 3. Set to higher if you want more significant digits.

Extending (Plug-ins)

Adding your own exchange plug-in is easy. Just create class file with methods for returning a ticker URL, a discovery URL, and parsing the responses from the ticker and discovery APIs. Then add the file to the exchanges folder.

Have a peek at the existing plug-ins (e.g. for an example and don't forget to contribute your plug-ins here on GitHub!


This software was tested and found working on the following configurations:

  • Ubuntu Linux 16.04 (Xenial Xurus) with Unity 7
  • Ubuntu Linux 17.10 (Artful Aardvark) with GNOME 3 and Unity 7
  • Ubuntu Linux 18.04 (Bionic Beaver) with GNOME 3 and Unity 7
  • Ubuntu Linux 19.04 (Disco Dingo) with GNOME 3 and Unity 7
  • Ubuntu Linux 19.10 (Eoan Ermine) with GNOME 3 and Unity 7
  • Ubuntu Linux 20.04 (Focal Fossa) with GNOME 3
  • Ubuntu Linux 20.10 (Groovy Gorilla) with GNOME 3
  • Ubuntu Linux 21.04 (Hirsute Hippo) with GNOME 3
  • Ubuntu Linux 21.10 (Impish Indri) with GNOME 3
  • Ubuntu Linux 22.04 (Jammy Jellyfish) with GNOME 3
  • Ubuntu Linux 22.10 (Kinetic Kudu) with GNOME 3

For other systems, you may need to install LibAppIndicator support.

Before reporting bugs or issues, please try removing ~/.config/coindicator/user.conf first and then the files in ~/.config/coindicator/cache/.

Sponsorship and Funding

Gitcoin logo

This project has been funded in the past by generous maecenas @ghettodev through Gitcoin, a platform that directs the attention of bounty hunters (coders) to open issues and feature requests on Github.

If you would like to sponsor a feature request, bug report or just donate to the project, be sure to check out Gitcoin.


A crypto-currency (Bitcoin, Ethereum et al) market price indicator for the Linux desktop. Sits in the tray and lets you set alerts. Supports GNOME, Unity and KDE.







No packages published