plasma-bitcoin-price

KDE Plasma 5 widget die de bitcoinprijs in EUR toont, opgehaald bij de CoinGecko API.

Weergave

Situatie	Weergave
Prijs gestegen t.o.v. vorige meting	groen
Prijs gedaald t.o.v. vorige meting	rood
Prijs gelijk gebleven (of eerste meting)	grijs
API-fout (netwerkfout, 4xx/5xx, rate limit 429)	`--`

Formaat: ₿ 68.969 € — duizendtallen volgens de systeemlocale, afgerond op hele euro's.

Configuratie

Vernieuwinterval (minuten) — standaard 5, minimaal 5, maximaal 1440. Het minimum van 5 minuten komt door de CoinGecko rate limit van 1 call per 5 minuten.

Instelbaar via rechtsklik op de widget → Configureer Bitcoin-prijs → Algemeen.

Installatie

Grafisch

Dubbelklik op dist/bitcoin-price-1.0.0.plasmoid in Dolphin (Plasma installeert dan automatisch naar ~/.local/share/plasma/plasmoids/).

Terminal

kpackagetool5 --type Plasma/Applet --install dist/bitcoin-price-1.0.0.plasmoid
# widget toevoegen via Add Widgets; bij twijfel plasma herladen:
plasmashell --replace &

Verwijderen:

kpackagetool5 --type Plasma/Applet --remove nl.a14r.bitcoinprice

Notities

De API-URL gebruikt vs_currencies=eur. In de oorspronkelijke opdracht stond een usd-URL, maar de eis was "prijs t.o.v. de euro" met een €-teken; een dollarwaarde onder een €-teken zou foutief zijn.
De trendvergelijking gebeurt tegen de laatst bekend geraakte prijs. Na een API-fout blijft die referentie staan, zodat de kleur klopt zodra er weer data binnenkomt.
Zonder CoinGecko API-key kan de API ook tussendoor een 429 geven; de widget toont dan -- tot de eerstvolgende geslaagde poll.
Getest op Debian 12 / Plasma 5 (Qt 5.15). Plasma 6 werkt vermoedelijk ook, maar is niet getest.

Repository-layout

metadata.desktop
contents/
├── config/main.xml          # config-schema (refreshMinutes, min 5, max 1440)
└── ui/
    ├── main.qml             # widget + fetch/vergelijk-logica
    ├── config.qml           # configuratievenster (categorieën)
    └── configGeneral.qml    # interval-instelling

Het kant-en-klare installatiebestand (bitcoin-price-1.0.0.plasmoid) staat als bijlage bij de v1.0.0-release.

Zelf (her)packagen:

zip -r bitcoin-price.plasmoid metadata.desktop contents

Licentie

MIT — zie LICENSE.

2.5 KiB Raw Blame History