docs: add release flow for nightly and main

README.md

@@ -29,6 +29,20 @@ Es durchsucht Provider und startet Streams.
 - Plugins: `addon/plugins/*_plugin.py`
 - Settings: `addon/resources/settings.xml`
 
+## TMDB API Key einrichten
+- TMDB Account anlegen und API Key (v3) erstellen: `https://www.themoviedb.org/settings/api`
+- In Kodi das ViewIT Addon oeffnen: `Einstellungen -> TMDB`
+- `TMDB aktivieren` einschalten
+- `TMDB API Key` eintragen
+- Optional `TMDB Sprache` setzen (z. B. `de-DE`)
+- Optional die Anzeige-Optionen aktivieren/deaktivieren:
+  - `TMDB Beschreibung anzeigen`
+  - `TMDB Poster und Vorschaubild anzeigen`
+  - `TMDB Fanart/Backdrop anzeigen`
+  - `TMDB Bewertung anzeigen`
+  - `TMDB Stimmen anzeigen`
+  - `TMDB Besetzung anzeigen`
+
 ## Tests
 - Dev Pakete installieren: `./.venv/bin/pip install -r requirements-dev.txt`
 - Tests starten: `./.venv/bin/pytest`

addon/addon.xml

@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='utf-8'?>
-<addon id="plugin.video.viewit" name="ViewIt" version="0.1.59-nightly" provider-name="ViewIt">
+<addon id="plugin.video.viewit" name="ViewIt" version="0.1.58" provider-name="ViewIt">
   <requires>
     <import addon="xbmc.python" version="3.0.0" />
     <import addon="script.module.requests" />

addon/resources/settings.xml

@@ -71,11 +71,11 @@
     <setting id="tmdb_log_responses" type="bool" label="TMDB API-Antworten loggen" default="false" />
   </category>
   <category label="Update">
-    <setting id="update_channel" type="enum" label="Update-Kanal" default="1" values="Main|Nightly|Custom" />
+    <setting id="update_channel" type="enum" label="Update-Kanal" default="0" values="Main|Nightly|Custom" />
     <setting id="auto_update_enabled" type="bool" label="Automatische Updates (beim Start pruefen)" default="false" />
     <setting id="update_repo_url_main" type="text" label="Main URL (addons.xml)" default="https://gitea.it-drui.de/viewit/ViewIT-Kodi-Repo/raw/branch/main/addons.xml" />
     <setting id="update_repo_url_nightly" type="text" label="Nightly URL (addons.xml)" default="https://gitea.it-drui.de/viewit/ViewIT-Kodi-Repo/raw/branch/nightly/addons.xml" />
-    <setting id="update_repo_url" type="text" label="Custom URL (addons.xml)" default="https://gitea.it-drui.de/viewit/ViewIT-Kodi-Repo/raw/branch/nightly/addons.xml" />
+    <setting id="update_repo_url" type="text" label="Custom URL (addons.xml)" default="https://gitea.it-drui.de/viewit/ViewIT-Kodi-Repo/raw/branch/main/addons.xml" />
     <setting id="auto_update_last_ts" type="text" label="Auto-Update letzte Pruefung (intern)" default="0" visible="false" />
     <setting id="run_update_check" type="action" label="Jetzt nach Updates suchen" action="RunPlugin(plugin://plugin.video.viewit/?action=check_updates)" option="close" />
     <setting id="update_info" type="text" label="Updates laufen ueber den normalen Kodi-Update-Mechanismus." default="" enable="false" />

docs/RELEASE.md

@@ -0,0 +1,44 @@
+# Release Flow (Main + Nightly)
+
+This project uses two release channels:
+
+- `nightly`: integration and test channel
+- `main`: stable channel
+
+## Rules
+
+- Feature work goes to `nightly` only.
+- Promote from `nightly` to `main` with `--squash` only.
+- `main` version has no suffix (`0.1.60`).
+- `nightly` version uses `-nightly` and is always at least one patch higher than `main` (`0.1.61-nightly`).
+- Keep changelogs split:
+  - `CHANGELOG-NIGHTLY.md`
+  - `CHANGELOG.md`
+
+## Nightly publish
+
+1) Finish changes on `nightly`.
+2) Bump addon version in `addon/addon.xml` to `X.Y.Z-nightly`.
+3) Build and publish nightly repo artifacts.
+4) Push `nightly`.
+
+## Promote nightly to main
+
+```bash
+git checkout main
+git pull origin main
+git merge --squash nightly
+git commit -m "release: X.Y.Z"
+```
+
+Then:
+
+1) Set `addon/addon.xml` version to `X.Y.Z` (without `-nightly`).
+2) Build and publish main repo artifacts.
+3) Push `main`.
+4) Optional tag: `vX.Y.Z`.
+
+## Local ZIPs (separated)
+
+- Main ZIP output: `dist/local_zips/main/`
+- Nightly ZIP output: `dist/local_zips/nightly/`