- Cooperative mode protects itself. If you force ShelvesHub to host Deck Shelves while a
plugin loader is installed and that keeps making the Steam screen go black, ShelvesHub now
backs off to plain coexistence for the session instead of fighting the loader — and the tab
explains why. You can keep forcing through it withSHELVES_COOP_SAFE_MODE=0. It also holds
back hub-driven plugin updates in this mode so your two copies can't drift apart in version. - Optional desktop tray icon — tick one box in the installer. The installer now has an
off-by-default option to add a small menu-bar / system-tray app showing whether ShelvesHub is
hosting, with quick actions (pause/resume, restart the service, restart the data backend). It is
a separate helper installed by the same installer (no extra download) and removed cleanly on
uninstall. See docs/installation.md. - Restart the data backend without restarting everything. If the data backend gets stuck,
the tab's Troubleshooting section now has a "Restart backend" button that restarts only it —
your shelves and hosting keep running. - A setup checker that can fix itself.
shelveshub doctorchecks the things that stop
ShelvesHub from appearing — the Steam debug flag, the debug port, Steam running, the
background service — and tells you exactly what to do for any that fail.shelveshub doctor --fixcreates the Steam debug flag for you. - One-command diagnostics.
shelveshub statusprints a report (OS, architecture,
glibc, Python, and — on Linux — device model and displays) you can paste into a bug
report, especially on ARM64. - Smarter automatic recovery. It now detects whether your system has the SteamOS
session service: a Steam Deck still restarts it, a generic Linux without it just pauses
instead of running a pointless restart. - Safer bundle downloads. When a Deck Shelves release ships a
SHA256SUMS, ShelvesHub
checks the bundle and backend it downloads against it and refuses anything that doesn't
match — a corrupted or tampered download is rejected, not injected.