ArchWeather Live v2.2 — KDE Plasma Edition

Een Nederlandstalig weerprogramma voor Arch Linux + KDE Plasma 6: een interactief terminaldashboard en een native Qt6-systeemvakicoon dat bij het aanmelden kan starten. Klik op het icoon voor een compacte weersamenvatting, rechtsklik voor bediening. Vanuit het Plasma-applicatiemenu of KRunner kun je het volledige dashboard openen zonder zelf een terminalcommando in te voeren.

Dit is een bugfix-upgrade van v2.1 en ouder. Je instellingen, favorieten, SQLite-geschiedenis en cache blijven behouden.

Snel installeren / upgraden

Installeer eenmalig de KDE-afhankelijkheden (Arch Linux):

sudo pacman -S --needed python python-pip konsole pyside6

Pak de ZIP uit, open de map in Konsole en installeer als je gewone gebruiker, zonder sudo:

unzip archweather-live-v2.2-kde-fix.zip
cd archweather-live
./install.sh

• De installer maakt/werkt een Python-venv bij onder ~/.local/share/archweather/venv.
• textual en rich worden via pip geïnstalleerd; PySide6 komt van pacman en wordt beschikbaar gemaakt met een venv die de systeemsitepackages kan gebruiken. De installatie vereist internet.
• Er worden twee applicatievermeldingen gemaakt: ArchWeather Live (start Konsole met dashboard) en ArchWeather Live Systeemvak (start het achtergrondicoon).
• Het systeemvak wordt standaard geactiveerd voor KDE-autostart en, als tijdens installatie een grafische sessie actief is, ook direct gestart.
• De oude v2.0-autostart die een terminalvenster opende wordt verwijderd, zodat er niet bij elke aanmelding extra terminalvensters openen. Een reeds geopend v2-venster moet je zelf sluiten.
• Autostart start na een grafische KDE-aanmelding, niet tijdens het opstarten van het besturingssysteem of op een pure TTY.
• Voor installeren heb je geen root nodig; voor het eenmalig installeren van Arch-pakketten via pacman wel.

Probleem opgelost in v2.2: een stad selecteren

In v2.1 waren zoekresultaten standaard op celselectie ingesteld, terwijl de interface alleen op rijselectie reageerde. Daardoor werkte Enter niet. Dit is hersteld.

1. Open ArchWeather vanuit het KDE-applicatiemenu.
2. Bij het openen wordt automatisch een standaardlocatie opgehaald (ook als er meerdere gelijknamige plaatsen bestaan).
3. Zoek je zelf naar De Steeg, dan verschijnen de zoekresultaten. Klik op de juiste rij of gebruik pijltjestoetsen en Enter. De knop Gebruik geselecteerde locatie werkt ook.
4. Als de API bereikbaar is, verschijnen de gegevens. Bij netwerkfouten verschijnt een duidelijke foutmelding en kun je met R opnieuw proberen.
5. De locatie wordt als exacte coördinaten opgeslagen, zodat de volgende keer meteen de juiste plek wordt geladen.

Upgraden: installeer over v2.1 heen met ./install.sh. Je instellingen en historie blijven bewaard. Meld je na de upgrade één keer af en aan voor de nieuwste achtergrondversie van het systeemvak.

Dagelijks gebruik (zonder terminalcommando)

1. Meld je aan bij KDE Plasma: ArchWeather verschijnt in het systeemvak van je paneel (mogelijk onder Verborgen pictogrammen).
2. Linksklik op het icoon om het compacte weerpaneel te tonen. Dubbelklik om het volledige terminaldashboard te openen.
3. Rechtsklik op het icoon om locaties, instellingen, verversen, automatisch starten, meldingen en afsluiten te beheren.
4. Je kunt via Meta (applicatiestarter) zoeken naar ArchWeather Live. Pin de applicatie eventueel aan taakbeheer of favorieten.
5. Wil je het icoon altijd zien? Rechtsklik in het Plasma-systeemvak → Systeemvak configureren → bij Items stel je ArchWeather op Altijd zichtbaar (benaming kan per Plasma-versie verschillen).

Plasma-instellingen

Open via rechtsklik op het icoon Instellingen.... Pas aan:

• Startlocatie op plaatsnaam of coördinaten (52.37,4.90)
• Dashboardinterval (standaard 5 s)
• Weer-API-interval (standaard 300 s)
• Terminalthema: Arch / Matrix / Dark / Minimal
• Eigen weersdrempelmeldingen via Plasma
• Autostart bij aanmelden (schakelt XDG-autostart in of uit)

KDE toont autostart-items ook onder Systeeminstellingen → Autostart. Het icoon gebruikt PySide6 / Qt6 en volgt de actuele iconenthema's van Plasma.

Let op: de systeembalk en het terminaldashboard verversen hun status, maar de gebruikte Open-Meteo-modellen leveren niet iedere 5 seconden nieuwe metingen. Een lokale pop-upwaarschuwing is een zelfingestelde drempel, geen officiële KNMI-waarschuwing. Desktopmeldingen hangen af van Plasma's notificatie-instellingen.

Handige installatieopties

./install.sh                 # normale installatie, autostart aan
./install.sh --no-autostart  # alleen menu + systeemvak, maar niet automatisch bij aanmelden
./install.sh --no-start      # bij installatie systeemvak niet direct opstarten
./enable-autostart.sh        # later bij aanmelden weer automatisch starten
./disable-autostart.sh       # uitschakelen
./uninstall.sh               # verwijder programma, behoud je data

Op een systeem met veel bestaande toepassingen kan het systeemvakpictogram in het uitklapbare gedeelte van het KDE-paneel belanden. ./install.sh --no-autostart verwijdert ook eventuele oude v2-autostartbestanden.

Volledige weerterminal

De bestaande v2.0-functies blijven: zoeken naar locaties wereldwijd, selectie uit meerdere plaatsnamen, 48-uurs temperatuur- en neerslaggrafieken, 16 dagen voorspelling, detailmetingen, favorieten, geschiedenis, offline cache, waarschuwingen, thema's en CSV/JSON-export.

De dashboard-sneltoetsen blijven beschikbaar: F zoeken, R verversen, S favoriet, L volgende locatie, T thema, E export, H help, 1 uren, 2 dagen, 3 regen en Q sluiten.

Optionele commando's als je die toch nodig hebt:

archweather                            # volledig dashboard
archweather Amsterdam                  # direct een stad openen
archweather tray                       # systeemvak starten (voorkomt dubbele instantie)
archweather doctor                     # KDE-installatie controleren
archweather autostart status
archweather autostart on
archweather autostart off
archweather config --refresh 5 --api 300
archweather --compact Utrecht
archweather search Rotterdam
archweather history --limit 30
archweather export --format csv --output ~/weer.csv

Bestanden, data en privacy

Bestand	Locatie
Instellingen	~/.config/archweather/config.json
SQLite-geschiedenis	~/.local/share/archweather/history.sqlite3
Weercache	~/.cache/archweather/ (inclusief tray.log)
KDE-autostart	~/.config/autostart/archweather-tray.desktop
KDE-starters	~/.local/share/applications/archweather*.desktop
Qt-pictogram	~/.local/share/icons/hicolor/scalable/apps/archweather.svg
Python-omgeving	~/.local/share/archweather/venv/

De app gebruikt Open-Meteo voor geocodering en weersvoorspellingen. Je locatie wordt naar Open-Meteo verzonden om weerdata op te vragen. Er is geen eigen cloudaccount of telemetrie toegevoegd. De gegevens zijn modelprognoses; details per regio verschillen. Zonder internet kun je de laatst opgeslagen data bekijken voor eerder opgezochte locaties. In offline modus worden geen nieuwe drempelmeldingen uitgezonden.

Open-Meteo voorwaarden: https://open-meteo.com/en/terms

Testen / beperkingen

python -m unittest discover -s tests -v
python -m compileall -q archweather
bash -n install.sh

• De core, cli-autostart en bestandsinstallatie kunnen zonder KDE worden getest.
• Een echte Qt6/Plasma desktop- en Wayland-test moet plaatsvinden op je Arch Linux-computer. De code is gebouwd op basis van PySide6, maar hier is geen Qt GUI-sessie beschikbaar.
• Er is nog geen afzonderlijke native Plasma-widget op je bureaublad of een officiële regenradarkaart; v2.2 levert een echte Qt-systeemvakapp en het Textual-dashboard.
• Beëindig het systeemvak door rechtsklik → Afsluiten; dit schakelt autostart niet uit. Gebruik daarvoor de instelling of disable-autostart.sh.

Licentie: MIT (zie LICENSE). Deze code is geen officiële KDE- of Arch Linux-applicatie.