Nerkh (that's Persian for "rate") is a little Plasma 6 widget that keeps the prices you care about — currencies, gold, Iranian coins, crypto — right there on your desktop or panel.
Here's the whole idea: if you're going to check a number ten times a day, you shouldn't have to open a browser tab or dig through an app to see it. It should just be there.
Park it on your desktop and watch a whole list at once. Or drop it in your panel and keep one price hovering in the corner of your eye. It talks both Persian and English, borrows its colors from your system theme, and doesn't bug your CPU when there's nothing new to fetch.
 Desktop — the full list at a glance |
 Panel — one price, always handy |
 Assets |
 Data & API |
 Display |
No account, no API key, no fiddling to get started — it all works the moment you add it.
Currencies, gold and Iranian coins, and crypto — split across three groups: Fiat, Metals & Coins, and Crypto.
| Group | How many | A few of them |
|---|---|---|
| Fiat currencies | 27 | USD, EUR, GBP, AED, TRY, CNY, … |
| Gold, metals & coins | 9 | 18K gold, Bahar Azadi & Emami coins, … |
| Cryptocurrencies | 20 | BTC, ETH, USDT, plus the usual stablecoins |
Show only the ones you actually follow, and shuffle them however you like — you can reorder the assets inside a group and the groups themselves.
Want the whole list, with symbols and Persian/English names? → Supported Assets
Put it wherever it suits you:
- On the desktop, it stretches out into a full list of everything you've turned on.
- In the panel, it shrinks down to a single price you pick and keeps it right there.
When Nerkh grabs new prices is entirely up to you:
- Let it refresh on its own every so often — pick anything from 1 to 1440 minutes.
- Or tap to refresh by hand when you want a fresh number.
- Or switch auto-refresh off completely and only update on demand.
The current number is nice, but Nerkh can also show you where each asset went today:
- How much it changed, in percent.
- Up or down, colored so you catch it instantly.
- A little change bar when you'd rather glance than read digits.
- And group labels, if a long list needs a bit of tidying.
It's bilingual through and through, and it plays by Iranian conventions:
- Language — Persian, English, or whatever your system uses.
- Digits — Persian (۱۲۳), Latin (123), or automatic.
- Toman or Rial for local prices.
- USD or Toman as the base for crypto.
- A right-to-left layout that flips the way it should in Persian.
Straight away it picks up your KDE / Qt theme, and from there you can tweak plenty:
- Per-asset icons you can leave on or turn off.
- Icon size — small, medium, or large.
- Font size — small, normal, large, or huge.
- Labels — the asset's name, its symbol, or both together.
Nerkh comes with a free data source stitched together from a handful of providers, so there's nothing to sign up for and no key to paste in — it just runs.
Got something more specific in mind? Point it at your own API instead:
- Give it a custom API base URL.
- Pick how it authenticates — auto, Bearer token, custom header, query parameter, or none at all.
- Drop in an API key if yours needs one.
- Test the connection right there in settings and get a thumbs-up or a clear error on the spot.
- Right-click your panel or desktop and hit Add or Manage Widgets…
- Go to Get New… → Download New Plasma Widgets.
- Type Nerkh in the search box.
- Install it, then drag it onto your desktop or panel.
- Grab the latest package off the Releases page.
- Right-click the panel → Add or Manage Widgets… → Get New…
- Choose Install From Local File… and point it at what you just downloaded.
git clone https://github.com/keyaruga33/nerkh-widget.git
cd nerkh-widget
make installDon't see it show up? Restart Plasma, or just log out and back in.
Right-click the widget and pick Configure Nerkh. The settings live on three pages:
 Assets• Pick which assets show up • Reorder them inside a group • Reorder the groups too • Search by name or symbol |
 Display• Language & digits • Toman / Rial · crypto base • Labels, icons & icon size • Font size · change bar · group labels • Which asset sits in the panel |
 Data & API• Auto refresh on or off • Interval (1–1440 min) • Your own API base URL • Auth method & API key • Test the connection |
The numbers come from a free source that pulls together a few different providers. For everyday use there's nothing to set up — no sign-up, no key. And if you run your own endpoint, you can wire it in from the Data & API page.
The prices are only as fresh as that source, so now and then they'll sit a hair off the live market.
A tiny widget has no business grinding away in the background. Nerkh only reaches out on the schedule you set — or never, if you flip auto-refresh off and update by hand. The rest of the time it just sits quietly and leaves your CPU alone.
- KDE Plasma 6
- Qt 6
Nerkh is made for KDE Plasma, plain and simple. It isn't built for GNOME, XFCE, Cinnamon, or the other non-KDE desktops.
Nerkh isn't done growing. On the list:
- More assets
- Better data sources
- More ways to customize the look
- A nicer panel mode
- More performance tuning
- More room to play with the API
Spotted a bug, got an idea, wish it did one more thing? Bring it on.
Open an issue to report a bug or ask for a feature.
Or fork it and send a pull request if you want to get your hands in the code.
Nerkh is free and open source, under the GPL-3.0 license.
If Nerkh earns a spot on your desktop, a quick ⭐ star on GitHub means a lot and keeps me going.
And if you feel like chipping in for the work, you can always buy me a coffee:
 GitHub |
https://github.com/keyaruga33/nerkh-widget |
 KDE Store |
https://www.opendesktop.org/p/2369858/ |
 Releases |
https://github.com/keyaruga33/nerkh-widget/releases |
 Issues |
https://github.com/keyaruga33/nerkh-widget/issues |
| Supported Assets |
SUPPORTED_ASSETS.md |
Built for KDE Plasma · With Nerkh, the rates are always right in front of you.