Cheese BTC Widget
De Cheese BTC Widget is een kleine, opensource Android-widget die de actuele Bitcoin-prijs op het startscherm toont. De widget bevat geen advertenties, geen analytics en vereist geen account; bij het toevoegen kiest de gebruiker tussen Amerikaanse dollars (US$) of euro (€), en de widget toont vervolgens een Bitcoin-logo, het valutasymbool en de prijs als heel getal.
De prijsgegevens worden opgehaald bij cheeserobot.org, het enige eindpunt waarmee de app communiceert.
Functies
[bewerken | brontekst bewerken]De widget is bewust minimalistisch opgezet. De belangrijkste functies zijn:
- Prijs in één oogopslag — Bitcoin-logo, valutasymbool en de prijs afgerond op een heel getal.
- Optionele 7-daagse grafiek als achtergrond, groen bij stijging en rood bij daling over de afgelopen week.
- Meerdere weergavemodi: US-dollar, euro, sats per dollar, één hele Bitcoin (₿) of de blokhoogte van het laatste blok (met de naam van de miner of pool erboven).
- Meerdere widgets tegelijk: twee instanties naast elkaar plaatsen voor zowel US$ als €.
- Automatisch verversen ongeveer elke dertig minuten; tikken op de widget forceert een directe update.
- Donkere modus: achtergrond volgt het thema van het systeem.
- Locale-bewuste getalopmaak: bijvoorbeeld
65,432in Engelse locales en65.432in Europese locales. - Foutmeldingen: bij netwerkproblemen toont de widget een uitroepteken en plaatst Android een notificatie met de oorzaak (geen verbinding, HTTP-fout, ongeldige JSON, enzovoort).
Werking
[bewerken | brontekst bewerken]Bij elke verversing voert de app één enkele GET-aanroep uit naar https://cheeserobot.org/price/summary.json. Dit gebundelde antwoord bevat de actuele prijs in US$ en €, twee historische reeksen (24 uur en 7 dagen) voor de optionele grafiek en de wijzigingsindicator, en een snapshot van het laatste Bitcoin-blok voor de blokhoogte-modus.
De prijswaarde wordt recursief gezocht in het JSON-object op basis van de gekozen valutasleutel (hoofdletterongevoelig), zodat de parser blijft werken bij kleine schemawijzigingen aan de zijde van het eindpunt. Het getal wordt afgerond op gehele waarden en weergegeven met locale-passende duizendscheidingstekens.
Installatie
[bewerken | brontekst bewerken]De app is op drie manieren beschikbaar:
- via F-Droid:
org.cheeserobot.btcwidget; - via Zapstore;
- door zijwaarts installeren van de
app-debug.apkuit de releases op GitHub.
Na installatie verschijnt er geen launcher-icoon in de app-lade. Dit is bedoeld: de widget zelf is de volledige toepassing.
Toevoegen aan het startscherm
[bewerken | brontekst bewerken]- Houd een lege plek op het startscherm ingedrukt.
- Tik op Widgets in het menu dat verschijnt.
- Sleep BTC Price uit de lijst van Cheese BTC Widget naar het startscherm.
- Kies US Dollars ($) of Euros (€) in de keuzedialoog.
De keuze van de valuta is per widget-instantie en kan achteraf niet gewijzigd worden; om een andere valuta te tonen wordt de widget verwijderd en opnieuw toegevoegd.
Privacy
[bewerken | brontekst bewerken]De applicatie maakt verbinding met precies één host: cheeserobot.org. Er is geen analytics, telemetrie, advertentienetwerk of accountvereiste. De prijs-fetch werkt zonder permissies; alleen voor de notificaties bij netwerkfouten is op Android 13 en hoger de POST_NOTIFICATIONS-permissie nodig.
