Align package version and verify release metadata

.github/workflows/appimage.yml

@@ -24,7 +24,9 @@ jobs:
         run: |
           python3 - <<'PY'
           import os, tomllib
+          from btd700 import __version__
           version = tomllib.load(open('pyproject.toml', 'rb'))['project']['version']
+          assert __version__ == version, 'Python package version must match pyproject.toml'
           assert os.environ['RELEASE_TAG'] == 'v' + version, 'Tag must match pyproject.toml'
           PY
       - name: Build isolated Ubuntu runtime and source archives

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.3.1 — 2026-09-05
+
+- Synchronize the internal Python package version with the AppImage release.
+- Check both version declarations before publishing future releases.
+
 ## 0.3.0 — 2026-09-05
 
 - Downloadable x86-64 AppImage for glibc 2.39+ desktops, including Python, GTK,

README.de.md

@@ -36,8 +36,8 @@ Python, GTK, libadwaita und die Tray-Bibliothek sind enthalten. Das Paket ist f
 **x86-64 mit glibc 2.39 oder neuer**, etwa Ubuntu 24.04+ oder das getestete Bazzite 44.
 
 ```bash
-chmod +x BTD_700_Control-0.3.0-x86_64.AppImage
-./BTD_700_Control-0.3.0-x86_64.AppImage
+chmod +x BTD_700_Control-0.3.1-x86_64.AppImage
+./BTD_700_Control-0.3.1-x86_64.AppImage
 ```
 
 Datei zuerst an ihren dauerhaften Platz legen. Mit `--install-desktop` legst du
@@ -46,7 +46,7 @@ Autostart im Tray. `--remove-desktop` entfernt beide Einträge. Nach Verschieben
 oder Umbenennen der Datei den Menüeintrag neu anlegen und Autostart aus-/einschalten.
 
 Ohne FUSE funktioniert der Start mit
-`APPIMAGE_EXTRACT_AND_RUN=1 ./BTD_700_Control-0.3.0-x86_64.AppImage`.
+`APPIMAGE_EXTRACT_AND_RUN=1 ./BTD_700_Control-0.3.1-x86_64.AppImage`.
 Die [AppImage-Anleitung](docs/APPIMAGE.md) erklärt dauerhaftes Entpacken und eigene
 Builds. Prüfsummen und Bibliotheksquellen liegen beim Release. Die USB-Berechtigung
 und ein Tray-Host bleiben nötig; GNOME benötigt eine StatusNotifier/AppIndicator-Erweiterung.
@@ -58,7 +58,7 @@ git clone https://github.com/justin-eckenweber/btd700linux.git
 cd btd700linux
 ```
 
-Alternativ [Quellcode v0.3.0 als ZIP](https://github.com/justin-eckenweber/btd700linux/archive/refs/tags/v0.3.0.zip)
+Alternativ [Quellcode v0.3.1 als ZIP](https://github.com/justin-eckenweber/btd700linux/archive/refs/tags/v0.3.1.zip)
 entpacken und `bash run.sh` im Projektordner ausführen.
 
 ## Starten

README.md

@@ -72,8 +72,8 @@ It includes Python, GTK, libadwaita and the tray library. Requires **glibc 2.39+
 (for example Ubuntu 24.04 or newer, or the tested Bazzite 44 desktop).
 
 ```bash
-chmod +x BTD_700_Control-0.3.0-x86_64.AppImage
-./BTD_700_Control-0.3.0-x86_64.AppImage
+chmod +x BTD_700_Control-0.3.1-x86_64.AppImage
+./BTD_700_Control-0.3.1-x86_64.AppImage
 ```
 
 Put it in a permanent folder, then optionally run it with `--install-desktop` to
@@ -82,7 +82,7 @@ autostart. Use `--remove-desktop` to remove both entries. Keep the AppImage at t
 same path; after moving it, recreate the menu entry and toggle autostart off/on.
 
 If FUSE is unavailable, start with
-`APPIMAGE_EXTRACT_AND_RUN=1 ./BTD_700_Control-0.3.0-x86_64.AppImage`.
+`APPIMAGE_EXTRACT_AND_RUN=1 ./BTD_700_Control-0.3.1-x86_64.AppImage`.
 See the [AppImage guide](docs/APPIMAGE.md) for permanent extraction, build instructions,
 checksums and dependency sources. USB permissions and the desktop's tray host are
 still required; GNOME needs a StatusNotifier/AppIndicator extension.
@@ -129,7 +129,7 @@ cd btd700linux
 ./run.sh
 ```
 
-Or [download the v0.3.0 source ZIP](https://github.com/justin-eckenweber/btd700linux/archive/refs/tags/v0.3.0.zip),
+Or [download the v0.3.1 source ZIP](https://github.com/justin-eckenweber/btd700linux/archive/refs/tags/v0.3.1.zip),
 extract it, and run `bash run.sh` inside the extracted folder.
 
 Want to explore without touching any hardware?

btd700/__init__.py

@@ -1,3 +1,3 @@
 """Independent Linux controls for the Sennheiser BTD 700."""
 
-__version__ = "0.2.0"
+__version__ = "0.3.1"

docs/APPIMAGE.md

@@ -13,14 +13,14 @@ make it executable, and open it. All regular CLI arguments also work.
 
 ```bash
 chmod +x BTD_700_Control-*-x86_64.AppImage
-./BTD_700_Control-0.3.0-x86_64.AppImage
-./BTD_700_Control-0.3.0-x86_64.AppImage --demo
+./BTD_700_Control-0.3.1-x86_64.AppImage
+./BTD_700_Control-0.3.1-x86_64.AppImage --demo
 ```
 
 Put the file at its permanent location before adding a menu entry:
 
 ```bash
-./BTD_700_Control-0.3.0-x86_64.AppImage --install-desktop
+./BTD_700_Control-0.3.1-x86_64.AppImage --install-desktop
 ```
 
 The menu entry and **Start at login** use the original AppImage path, not its
@@ -31,7 +31,7 @@ menu entry, autostart entry and installed icon. It leaves the AppImage in place.
 If FUSE is unavailable, use the runtime's extraction mode:
 
 ```bash
-APPIMAGE_EXTRACT_AND_RUN=1 ./BTD_700_Control-0.3.0-x86_64.AppImage
+APPIMAGE_EXTRACT_AND_RUN=1 ./BTD_700_Control-0.3.1-x86_64.AppImage
 ```
 
 When installing a menu entry or enabling autostart from this mode, the launcher

packaging/appimage/RELEASE_NOTES.md

@@ -1,10 +1,10 @@
-Download **BTD_700_Control-0.3.0-x86_64.AppImage**, make it executable and open it.
+Download **BTD_700_Control-0.3.1-x86_64.AppImage**, make it executable and open it.
 Python, GTK, libadwaita and the tray library are included. Requires **x86-64 Linux
 with glibc 2.39+** (such as Ubuntu 24.04 or newer). English and German are supported.
 
 ```bash
-chmod +x BTD_700_Control-0.3.0-x86_64.AppImage
-./BTD_700_Control-0.3.0-x86_64.AppImage
+chmod +x BTD_700_Control-0.3.1-x86_64.AppImage
+./BTD_700_Control-0.3.1-x86_64.AppImage
 ```
 
 Optional `--install-desktop` adds an application-menu entry. Keep the file at that

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "btd700-control"
-version = "0.3.0"
+version = "0.3.1"
 description = "Independent native Linux controls and tray menu for the Sennheiser BTD 700"
 requires-python = ">=3.10"
 readme = "README.md"