Phosphor 4.7.0 — the UX-round release

Phosphor draws what your PC plays the way an analog CRT scope would. 4.7.0 is the UX-round release: four families of long-standing interaction bugs root-caused and fixed, tooltips everywhere, and the settings + agent-protocol hardening from the codebase audit.

4.6.2 → 4.7.0, honestly

	4.6.2	4.7.0
Local track after scoping Spotify / a mix	transport followed the beam — the paused track was unreachable, "no sound"	the loaded track owns the deck; the scoped player gets the controls only when nothing is loaded
Scope with the right-click menu open	lost a vsync wait per frame (a second blocking surface)	full rate — the menu repaints only on damage
Clicking out of the menu	inconsistent — an invisible canvas swallowed clicks	dismisses on the first click, anywhere off the menu
Dialogs & panes in the mini	presses became a window-drag; the postcard ✕ was unhittable	presses reach the UI; only the bare scope drags the window
Cursor across view switches	stale resize cursors rode along	reset on every mode switch
Tooltips	sparse	across the right-click menu and settings
Settings on a crash mid-write	could truncate; corrupt files silently reset	atomic saves; a corrupt file is quarantined as settings.json.bad with a visible warning
Agent wire (ctl/tap/schema)	client, server, and schema could drift	one typed grammar — every error's fix is an executable command, tap opens with a server hello and ends with a reason, --socket pins an instance

Removed, honestly

Nothing user-facing. The never-shipped phosphor-studio stub crate left the build workspace (the studio CLI verb answers exactly as before — exit 2 with a directive message; the studio still returns per #1). Development docs were reorganized into docs/dev/ and archive/.

Install

Debian / Ubuntu / Mint (or just double-click the .deb):

sudo apt install ./phosphor_4.7.0_amd64.deb

Fedora / RHEL (built on Mint, rpm --test verified — reports welcome):

sudo dnf install ./phosphor-4.7.0-1.x86_64.rpm

From source (needs libpipewire-0.3-dev pkg-config scdoc on apt, pipewire-devel pkgconf scdoc on dnf, and Rust 1.96+):

tar xf phosphor-4.7.0-source.tar.gz && cd phosphor-4.7.0
cargo build --release -p phosphor-app
sudo install -m755 target/release/phosphor /usr/local/bin/phosphor

Verify:

phosphor --version   # phosphor 4.7.0 (v4)

The Cinnamon panel applet (unchanged, 2.1.0) installs from the repo: applet/install.sh. Main app runs on any desktop; the applet is Cinnamon-only.

SHA256SUMS-4.7.0 covers all three assets.

---

Built by Ben with Claude (Fable 5) — root causes, receipts, and the regression ledger (docs/dev/BUGLOG.md #16–#19) ride in the repo. Signed, as always: TURTLE VECTOR 🐢⚡📼