# plasma-bitcoin-price

KDE Plasma 5 widget die de bitcoinprijs in EUR toont, opgehaald bij de
[CoinGecko API](https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=eur).

## 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
```bash
kpackagetool5 --type Plasma/Applet --install dist/bitcoin-price-1.0.0.plasmoid
# widget toevoegen via Add Widgets; bij twijfel plasma herladen:
plasmashell --replace &
```

Verwijderen:
```bash
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](../../releases/tag/v1.0.0).

Zelf (her)packagen:
```bash
zip -r bitcoin-price.plasmoid metadata.desktop contents
```

## Licentie

MIT — zie [LICENSE](LICENSE).