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: about 1 month 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 (about 2 years ago)
• Default Branch: main
• Last Pushed: 2023-02-17T00:31:54.000Z (about 2 years ago)
• Last Synced: 2024-11-17T23:25:43.521Z (3 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.

![screenshot](https://i.imgur.com/jwftW6m.png[])

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