Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/bitcoin-crazy/another-plasma6-coin

Plasma 6 (KDE) applet for displaying real-time Bitcoin and cryptocurrency prices on the toolbar.
https://github.com/bitcoin-crazy/another-plasma6-coin

applet binance-api bitcoin bitcoin-price btc cryptocurrency eth ethereum kde kde-plasma-6 linux plasma-desktop solana stablecoin systray ticker toolbar usd usdt widget

Last synced: about 2 months ago
JSON representation

Plasma 6 (KDE) applet for displaying real-time Bitcoin and cryptocurrency prices on the toolbar.

Awesome Lists containing this project

README 

          



# Another Plasma6 Coin (A.P6.C)




![Example of toolbar](screenshots/toolbar.png)




![Example of toolbar](screenshots/toolbar2.png)




![Example of toolbar](screenshots/toolbar3.png)




__Another Plasma6 Coin__ is a Plasma 6 (KDE) applet to show the price of Bitcoin and other cryptocurrencies in KDE toolbar.



This program was initially based on [Plasma Coin 1.0.2](https://store.kde.org/p/2242677/), written by [zayronXIO](https://store.kde.org/u/zayronXIO).



I am an anonymous programmer and I developed this applet for my personal utilization. Feel free to send pull requests.



> [!NOTE]

> This applet is available at [KDE Store](https://store.kde.org/p/2280323).



## How this applet works



A.P6.C gets prices from [Binance API](https://github.com/binance/binance-spot-api-docs), since version 2.0. Older versions were using [CoinGecko API](https://docs.coingecko.com/reference/introduction).



Binance API x CoinGecko API:



* Binance API is faster than CoinGecko API.

* Binance API has less limitations. You can access several pairs of coins at the same time.

* In April 18, 2025, CoinGecko API was providing 100 coins under USD[1], while Binance had 573 under USDT[2].



```

[1] $ curl -s 'https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd' | tr ',' '\n' | grep '"id":' | wc -l

[2] $ curl -s https://api.binance.com/api/v3/ticker/price | tr '{' '\n' | egrep '[A-Z]USDT' | wc -l

```



If you are interested in CoinGecko, see the branch [`ap6c-1.2.1-coingecko-archived`](https://github.com/bitcoin-crazy/another-plasma6-coin/tree/ap6c-1.2.1-coingecko-archived) on this Git repository or download the [version 1.2](https://github.com/bitcoin-crazy/another-plasma6-coin/releases/tag/v1.2).



This applet displays coin prices in the toolbar and includes the following features:



* Price updates every x minutes, where x is a number between 1 and 60.

* Retry after 1 minute if the last update fails.

* Immediate price update when clicking on it.

* Support for decimal places.

* Option to display the coin name, the coin and currency pair, or neither.

* Option to apply colors to prices.

* Option to use a customizable thousands separator.

* Option to apply a price multiplier.

* The `ERR` (Error) message is shown when an invalid coin pair is selected or another error occurs.



## How to install



### Automatic install



The best way to install this applet is via widget manager from KDE.



1. Right-Click over the toolbar and select `Add or Manage Widgets`.

2. Select `Get New` > `Download New Plasma Widgets` > `Another Plasma6 Coin`.

3. Click Install button.

4. Right-Click again over the toolbar and select `Add or Manage Widgets`.

5. Select `Another Plasma6 Coin` and drag it to the toolbar.

6. Right-Click over the applet in toolbar and select `Configure Another Plasma6 Coin`.



### Importing the tarball



Another way to install __Another Plasma6 Coin__ is to make it importing the tarball.



1. Download the final tarball `Another.Plasma6.Coin-.tar.xz`

2. Right-Click over the toolbar and select `Add or Manage Widgets`.

3. Select `Get New` > `Install Widget From Local File`.

4. Select the downloaded tarball.

5. Click `Add or Manage Widgets`.

6. Select `Another Plasma6 Coin` and drag it to the toolbar.

7. Right-Click over the applet in toolbar and select `Configure Another Plasma6 Coin`.



### Manual install



Another way to install __Another Plasma6 Coin__ is to make it manually.



1. Copy the directory `Another.Plasma6.Coin` to `~/.local/share/plasma/plasmoids/`

2. Run `$ kquitapp6 plasmashell && kstart plasmashell` or restart KDE.

3. Right-Click over the toolbar and select `Add or Manage Widgets`.

4. Select `Another Plasma6 Coin` and drag it to the toolbar.

5. Right-Click over the applet in toolbar and select `Configure Another Plasma6 Coin`.



## Options (configuration)




![Configuration Window](screenshots/configuration.png)




There are some options in `Configuration` window.



* The `Font Size for Price` will determine the size of the price. The name of the coin will be shown above the price and its size will be 70% of the price size.

* `Bold` is for price and coin name.

* `From Crypto` will select the cryptocurrency, and `To Crypto/Currency` will select the pair to be used.

* `Show Coin Name` and `Show Pair`: only one of these can be selected, but both can be unselected.

* `Decimal Places` is for fractional numbers.

* `Price Multiplier` allows the user to add an integer or a fractional number to multiply the current price. Up to 8 decimal places can be used. An asterisk will be placed near of the coin/pair name to symbolize the use of this feature. E.g. BTC/USDT* See more details below in the section _When to use Price Multiplier?_

* `Thousands Separator` add commas to separate the thousands in the price.

* `Swap commas-dots` swaps commas for dots and vice-versa to match usage in each country. E.g., from 1,000.23 to 1.000,23

* `Text Color` allows the user to choose a color for the price. If empty, the default theme color will be used. It is possible to use a color name (like `yellow`, `yellowgreen`) or a hex color code (like `#00ff00` or `#00FF00`). The character "`#`" is mandatory for hex colors. There is a color name table available [here](https://doc.qt.io/qt-6/qml-color.html#svg-color-reference). To choose a hex color, use the KColorChooser program, available on KDE Plasma 6.

* `Time Refresh` sets the time in minutes to auto-refresh the price. This is a value between 1 and 60.

* `Blink Refresh` defines if the price will blink when refreshing (automatically or via click).



## When to use Price Multiplier?



The Price Multiplier is a feature that allows you to multiply the current price by an integer or fractional number. You can use up to four decimal places, such as 1.3125. An asterisk will appear next to the coin/pair name to indicate that this feature is in use. For example: BTC/USDT*.



This feature is useful in two scenarios:



* Suppose you live in _Narnia_, where the official currency is _NAR_. If _1 USDT = 2.33 NAR_, you can select BTC/USDT and apply a multiplier of 2.33 to display the price in _NAR_.



* Suppose you own 1.234 BTC. You can use 1.234 as the multiplier to see the total value in USD or another currency.



## Hacking the source code



### New coins and currencies



__Another Plasma6 Coin__ arrives with a limited number of coins and currencies. It is possible to add new items.



> [!IMPORTANT]

> All prices are taken from [Binance](https://www.binance.com) via API, so is needed to use the same names from Binance.



* For coins:

  * Edit `~/.local/share/plasma/plasmoids/Another.Plasma6.Coin/contents/ui/CoinModel.qml` and add a new entry.

  * You must use the same `name` provided by Binance via API. See __TIP1__ below.

  * Example of an entry to be added:

    ```

    ListElement { name: "SOL" }

    ```

  * In the last example, `SOL` is the name to be used to call the Binance API.

  * It is not needed to restart KDE after adding new coins.



* For currencies:

  * Edit `~/.local/share/plasma/plasmoids/Another.Plasma6.Coin/contents/ui/CurrencyModel.qml` and add a new line.

  * You must use the same `abbreviation` provided by Binance via API. See __TIP1__ below.

  * Example of a line:

    ```

    ListElement { name: "British Pound" ; abbreviation: "GBP" }

    ```

  * In the last example, `British Pound` is a name to visual identification of the currency in configuration block. `GBP` will be used to call the Binance API and to compose the pair name in the KDE toolbar.

  * It is not needed to restart KDE after adding new currencies.



__TIP1:__ The Binance API provides a restricted number of coins. It is possible to get a list using the  `curl` command.



  ```

  $ curl -s https://api.binance.com/api/v3/ticker/price | tr '{' '\n' | egrep '[A-Z]USDT'

  ```



In the last example, the prices were filtered to show USDT pairs only. Remove `| egrep '[A-Z]USDT'` to see all available pairs.



It is also possible to get a list of available currencies for BTC and USDT:



  ```

  $ curl -s https://api.binance.com/api/v3/ticker/price | tr '{' '\n' | egrep '"(BTC|USDT)' | sort

  ```



__TIP2:__ It is possible to make tests against the Binance API using the `curl` command. See an example for BTC/USDT:



  ```

  $ curl -s https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT

  ```



The errors from Binance API are very comprehensive. Read carefully each message returned at the shell prompt.



### Crypto/Currency names size



The size of the Crypto/Currency names is 70% (0.7) of the price size. This can be changed at `~/.local/share/plasma/plasmoids/Another.Plasma6.Coin/contents/ui/CompactRepresentation.qml`. Search for `0.7`.