Merge pull request 'fix(cli): correct the missing-PySide6 hint to the real apt packages — 0.36.1' (#35) from docs/apt-proper into main

Reviewed-on: #35

CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to RigDoctor are recorded here. Format follows
 (`MAJOR.MINOR.PATCH`, pre-1.0). `__version__` and `pyproject.toml` must match the git
 release tag (so the auto-updater, D18, can compare versions).
 
+## [0.36.1] - 2026-05-22
+### Fixed
+- `rigdoctor gui` printed the wrong fix when PySide6 is missing — it suggested the non-existent
+  `python3-pyside6` package. Now it names the real split modules
+  (`python3-pyside6.qt{widgets,gui,websockets,svg}` + `python3-pyte`).
+
+## [0.36.0] - 2026-05-22
+### Fixed
+- **`.deb` now installs all dependencies automatically — no manual tool install.** The previous
+  `Recommends: python3-pyside6` named a package that doesn't exist on Debian/Ubuntu (PySide6 is
+  split per module), so apt silently skipped it and the GUI wouldn't start. Now it Recommends the
+  actual modules the GUI imports — `python3-pyside6.qt{widgets,gui,websockets,svg}` + `python3-pyte`.
+### Changed
+- **`apt install rigdoctor` sets up the whole toolset.** The `.deb` also Recommends the optional
+  diagnostic/gaming tools (smartmontools, lm-sensors, dmidecode, pciutils, libnotify-bin,
+  libsecret-tools, gamemode, mangohud) so they install by default — users never hand-install
+  tools. `cpupower` is a Suggests (kernel-tied); `--no-install-recommends` still gives CLI-only.
+
 ## [0.35.0] - 2026-05-22
 ### Added
 - **`.deb` package (M9 / D8)** — `packaging/make_deb.py` builds a `rigdoctor_<version>_all.deb`

README.md

@@ -41,22 +41,39 @@ apt pulls the GUI dependencies (PySide6, pyte) automatically:
 sudo apt install ./rigdoctor_*_all.deb        # CLI only: add --no-install-recommends
 ```
 
-**Or add the apt repository** for `apt install` + automatic updates:
+**Or add the apt repository** for `apt install` + automatic updates. The registry is private and
+GPG-signed, so you need a Gitea token with **`read:package`**, the signing key, and the deb822
+source (`read -rsp` keeps the token out of your shell history):
 
 ```bash
-# the registry is private, so give apt a token (a Gitea PAT with read:package)
-echo "machine git.jesseyvanofferen.com login <user> password <token>" \
-  | sudo tee /etc/apt/auth.conf.d/rigdoctor.conf
-sudo chmod 600 /etc/apt/auth.conf.d/rigdoctor.conf
+read -rsp 'Gitea read:package token: ' TOKEN; echo
 
-echo "deb [trusted=yes] https://git.jesseyvanofferen.com/api/packages/jessey/debian stable main" \
-  | sudo tee /etc/apt/sources.list.d/rigdoctor.list
+# signing key → dearmored into the keyring (the key endpoint requires the token too)
+sudo install -d -m 0755 /etc/apt/keyrings
+curl -fsSL --user <user>:"$TOKEN" \
+  https://git.jesseyvanofferen.com/api/packages/jessey/debian/repository.key \
+  | sudo gpg --dearmor -o /etc/apt/keyrings/gitea-jessey.gpg
+
+# download credentials, kept out of the sources file
+printf 'machine git.jesseyvanofferen.com login <user> password %s\n' "$TOKEN" \
+  | sudo tee /etc/apt/auth.conf.d/rigdoctor.conf >/dev/null
+sudo chmod 0600 /etc/apt/auth.conf.d/rigdoctor.conf
+
+# the source (modern deb822 format, GPG-verified, all-arch)
+sudo tee /etc/apt/sources.list.d/rigdoctor.sources >/dev/null <<'EOF'
+Types: deb
+URIs: https://git.jesseyvanofferen.com/api/packages/jessey/debian
+Suites: stable
+Components: main
+Architectures: all
+Signed-By: /etc/apt/keyrings/gitea-jessey.gpg
+EOF
 
 sudo apt update && sudo apt install rigdoctor
 ```
 
-Then `sudo apt upgrade` keeps it current. *(If your server serves a signed registry, drop the
-`auth.conf.d` file and replace `[trusted=yes]` with `[signed-by=…]` + the `repository.key`.)*
+Then `sudo apt upgrade` keeps it current. *(Quick-and-dirty alternative if the registry isn't
+signed: skip the key and use a one-line `deb [arch=all trusted=yes] …/debian stable main` source.)*
 
 ### Any distro — self-extracting `.run` (no root)
 

packaging/make_deb.py

@@ -2,9 +2,13 @@
 
 Pure-Python app, so it's `Architecture: all`: we stage the package into dist-packages, drop the
 two launchers in /usr/bin, install the desktop entry + icon, write a DEBIAN/control, and call
-`dpkg-deb`. The core is stdlib (`Depends: python3`); the GUI/tray deps are **Recommends**
-(`python3-pyside6`, `python3-pyte`) so `apt install rigdoctor` gives the full app by default,
-while `--no-install-recommends` yields a CLI-only install.
+`dpkg-deb`. The core is stdlib (`Depends: python3`); everything else is **Recommends** so a
+plain `apt install rigdoctor` sets up the whole toolset automatically (users never hand-install
+deps) — the GUI modules (Debian/Ubuntu split PySide6 per module, so we name
+`python3-pyside6.qt{widgets,gui,websockets,svg}`) + `python3-pyte`, plus the diagnostic/gaming
+tools (smartmontools, lm-sensors, dmidecode, pciutils, libnotify-bin, libsecret-tools, gamemode,
+mangohud). `--no-install-recommends` still yields a CLI-only install; `cpupower` is a Suggests
+(kernel-tied/heavy).
 
 Run: `python packaging/make_deb.py` → `dist/rigdoctor_<version>_all.deb`.
 """
@@ -57,7 +61,8 @@ Maintainer: {maintainer}
 Section: utils
 Priority: optional
 Depends: python3 (>= 3.11)
-Recommends: python3-pyside6, python3-pyte
+Recommends: python3-pyside6.qtwidgets, python3-pyside6.qtgui, python3-pyside6.qtwebsockets, python3-pyside6.qtsvg, python3-pyte, smartmontools, lm-sensors, dmidecode, pciutils, libnotify-bin, libsecret-tools, gamemode, mangohud
+Suggests: linux-tools-generic
 Homepage: {homepage}
 Description: Hardware monitoring & crash diagnostics for Linux gamers
  RigDoctor monitors GPU/CPU temperatures, load, and sensors, captures crash

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rigdoctor"
-version = "0.35.0"
+version = "0.36.1"
 description = "Modular hardware monitoring & crash diagnostics for Linux gamers."
 readme = "README.md"
 requires-python = ">=3.11"

src/rigdoctor/__init__.py

@@ -1,3 +1,3 @@
 """RigDoctor — modular hardware monitoring & crash diagnostics for Linux gamers."""
 
-__version__ = "0.35.0"
+__version__ = "0.36.1"

src/rigdoctor/cli.py

@@ -55,8 +55,9 @@ def cmd_gui(args) -> int:
         from .gui.app import main as gui_main
     except ImportError as exc:
         print("The GUI needs PySide6, which isn't installed.")
-        print("  Install it with:  pip install 'rigdoctor[gui]'")
-        print("  or on Ubuntu:     sudo apt install python3-pyside6")
+        print("  Ubuntu/Debian:  sudo apt install python3-pyside6.qtwidgets "
+              "python3-pyside6.qtgui python3-pyside6.qtwebsockets python3-pyside6.qtsvg python3-pyte")
+        print("  pip:            pip install 'rigdoctor[gui]'")
         print(f"  ({exc})")
         return 2
     return gui_main([sys.argv[0]])