https://github.com/bimlas/xfce4-coingecko
XFCE4 GenMon plugin: Cryptocurrency price widget
https://github.com/bimlas/xfce4-coingecko
bitcoin coingecko cryptocurrency ethereum matic-network xfce xfce4 xfce4-genmon-plugin xfce4-panel-plugin
Last synced: 3 months ago
JSON representation
XFCE4 GenMon plugin: Cryptocurrency price widget
- Host: GitHub
- URL: https://github.com/bimlas/xfce4-coingecko
- Owner: bimlas
- Created: 2023-02-17T00:31:10.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-02-17T00:31:54.000Z (over 2 years ago)
- Last Synced: 2025-01-18T18:54:21.349Z (5 months ago)
- Topics: bitcoin, coingecko, cryptocurrency, ethereum, matic-network, xfce, xfce4, xfce4-genmon-plugin, xfce4-panel-plugin
- Language: Shell
- Homepage:
- Size: 2.93 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# XFCE CoinGecko
[Generic Monitor (Genmon)](https://docs.xfce.org/panel-plugins/xfce4-genmon-plugin) plugin that shows the prices of your favorite and trending cryptocurrency tokens via fetching [CoinGecko](https://coingecko.com/) API.
Features:
- Click on the widget to visit CoinGecko site
- Hover over the widget to view trending tokens
- Get system notification from tokens having huge price change
https://github.com/bimlas/xfce4-coingecko (**please star if you like the plugin**)
## Usage
```
$ xfce4-coingecko.sh ...
```
- ``
- The minimum daily price change expressed as a percentage for which you want to receive notifications (set it to a high value to disable)
- ``
- CoinGecko API ID of the token (from the "Info" box of it)
Because the list of the tokens could be long, it's suggested to create a "wrapper" shell script, for example `xfce4-coingecko-wrapper.sh`:
```
#!/bin/sh
/path/to/xfce4-coingecko.sh 20 bitcoin ethereum matic-network
```
Don't forget to make it executable via `chmod +x xfce4-coingecko-wrapper.sh`.
## Adding Genmon widget
- First you have to install `xfce4-genmon-plugin` package if it is not on your system
- Add the monitor to the panel
- Right click on the panel
- Select _Panel -> Add new items_
- Add _Generic Monitor_ plugin
- Set up the generic monitor to use with this script
- Right click on the newly added generic monitor -> _Properties_
- Command: `/path/to/xfce4-coingecko-wrapper.sh`
- Uncheck the checkbox of _Label_
- Set _Period_ to at least `30` seconds
- Do not set it to lower value because you would reach rate-limit of the API