Metadata-Version: 2.4
Name: archweather-live
Version: 2.2.0
Summary: Interactive weather terminal dashboard with KDE Plasma tray and autostart
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: textual<9,>=0.80
Requires-Dist: rich<15,>=13
Dynamic: license-file

# 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):

```bash
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`:

```bash
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

```bash
./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:

```bash
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

```bash
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.