Coindicator is a cryptocurrency price indicator applet for Linux.
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. It will ask to elevate permissions to install dependencies. It takes the install location as an argument.
git clone https://github.com/bluppfisk/coindicator.git && cd coindicator
./install.sh /opt/coindicator # or wherever you want it installed.
User data has moved to your home folder. To keep your settings, move the user.conf file to: ~/.config/coindicator/.
source venv/bin/activate
and run the app with coindicator
. Add &
to run it in the background.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 ~/.config/coindicator/user.conf YAML file.
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.
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. kraken.py) for an example and don't forget to contribute your plug-ins here on GitHub!
pip install -e .[develop]
to install required toolspython3 setup.py build sdist
twine upload dist/{version}
if you want to upload to PyPi (will need credentials)This software was tested and found working on the following configurations:
For other systems, you may need to install LibAppIndicator support.
Before reporting bugs or issues, please try removing/renaming the ~/.config/coindicator folder first.