molluskandClaude Opus 4.8
8768cd242c
Round 7. Codex ratifies: v3.3 is ready to become the implementation plan. Seven rounds, every blocker fixed or refuted with evidence. Design approval only — nothing approved for merge, no code written. Two subtle catches from the ratification round, both applied: - The owner-key union had a wording trap that would have preserved the exact bug it was written to fix. "Resolves" must mean "yields a MATCH between the two legs", not "first property present on the node" — client.id IS present on both gst-launch legs but differs, so a first-present implementation stops at key 3, sees a mismatch, concludes "different owners" and leaks. Now specified as try-in-order-until-equal, with a dedicated test. - Sticky taint must be lifetime-aware, not keyed on raw ids. client.id, node ids, module indices, link-groups and PIDs all recycle on this stack, so a bare key would hand an unrelated future app permanent inherited taint. Stored against live owner components, cleared only when all members vanish. Also added: how pixelpass learns the pipewire-pulse PID itself (consistent pipewire.sec.pid across Pulse clients, validated against /proc/<pid>/comm), with the failure modes in both directions — safe only because unresolved ancestry is fail-closed, which is the invariant the section rests on. NEW LIVE FINDING (§6.1.0), the strongest reachability evidence yet and one Codex's sandbox could not have seen: the user's CURRENT DEFAULT SINK is sink-sunshine-stereo, a support.null-audio-sink. Every hardware sink is SUSPENDED; the only RUNNING sink is Sunshine's virtual one, with Firefox playing into it and sunshine reading its monitor. The hazardous forwarder topology is live in the default audio path full time, with no EasyEffects involved. It also means the rejected hardware-sink-only shortcut would have captured NOTHING on this machine. Flagged separately, explicitly UNVERIFIED: what module-echo-cancel binds to when the default sink is an app-owned null sink. §12 expanded with a graph-engine test surface (node-local tests cannot catch C2/C3-class defects). §14 rewritten: convergence table, agreed v1 scope, and what is deliberately out. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
PeerSpeak
Decentralized, peer-to-peer voice chat — full-mesh, NAT-traversing, with no central server. Built in Rust on iroh (QUIC), PipeWire audio, the Opus codec, and an iced GUI.
Create a room, share the join ticket, and talk. Everyone connects directly to everyone else; relays are only used to punch through NATs when a direct path isn't available.
Screenshots
| Launch screen | In a room |
|---|---|
 |
 |
| Settings |
|---|
 |
Features
Rooms & sessions
- Create a room → shareable join ticket; join by pasting a ticket.
- Full-mesh multi-peer rooms with live presence.
- Recent-rooms list to hop back into a room someone's still in.
- Remembered nickname and in-call duration timer.
Audio
- PipeWire capture/playback, selectable input and output devices, per-app gain.
- Opus codec (48 kHz mono, 20 ms frames) with an adaptive jitter buffer + packet-loss concealment.
- Noise gate with a draggable threshold on a live mic meter (test your mic off-call too).
- Mix-bus soft limiter and opt-in echo cancellation (PipeWire WebRTC AEC + noise suppression).
Voice controls
- Self-mute, deafen, and rebindable push-to-talk.
- Per-peer volume, local mute, and speaking indicators.
Text chat
- In-room text chat over the gossip plane, with clickable links and inline image/audio attachments.
- Drag-selectable, copyable messages; right-click context menu on all text fields.
Shared music listening
- Build a personal playlist of local audio files with a full transport (play/pause, seek, reorder).
- Let others tune in: peers stream your current track, timeline-synced and gapless, sitting under voice at their own volume.
Screen share (via pixelpass)
- Share your screen; peers click 👁 Watch to open the stream in mpv (vlc fallback).
- Live badges on sharing peers; per-app audio capture.
Recording & notifications
- Local call recording (mic + incoming mix → WAV in
~/peerspeak-recordings/). - Desktop notifications and event chimes with per-event custom sound overrides.
UI & networking
- Selectable room layouts (3-Column, Bottom Dock, Drawer) with draggable, persisted dividers.
- 10 built-in themes (Catppuccin, Dracula, Nord, Tokyo Night, Gruvbox, Solarized…), all WCAG-AA checked.
- Network mode picker (relay-no-discovery default, full n0, or direct-only); retained-address reconnect.
- Config, window size/position, and all preferences persisted to
~/.config/peerspeak/.
See docs/FEATURES.md for the full inventory and field-test status, and docs/ARCHITECTURE.md for internals.
Roadmap
- Contacts & invites — friends list with invite-notification one-click join (design in
docs/contacts-plan.md). - Spatial audio & per-peer EQ.
- Soundboard — play short clips into the call mix.
- Room persistence / invite links beyond the raw ticket.
- Windows support — cross-compiles and launches under Wine today; needs a real WASAPI audio pass (see
docs/WINDOWS.md).
Building
PeerSpeak builds with a stable Rust toolchain (edition 2024). Install the system dependencies below, then:
cargo build --release
./target/release/peerspeak
System dependencies
Arch Linux
sudo pacman -S --needed rust pipewire opus pkgconf git
Debian / Ubuntu
sudo apt install build-essential pkg-config clang libclang-dev \
libpipewire-0.3-dev libopus-dev libasound2-dev libxcb1-dev
Plus a Rust toolchain via rustup. clang/libclang are needed for the PipeWire bindings (bindgen).
At runtime you need a running PipeWire server. Screen sharing additionally requires pixelpass on your PATH, and mpv (or vlc) to watch a peer's share.
Packaging
- Arch:
cd packaging && makepkg -si(usespackaging/PKGBUILD). - Debian/Ubuntu:
.debis built withcargo-debfrom the[package.metadata.deb]block inCargo.toml. Build inside a Debian/Ubuntu environment so the binary links that distro's glibc. - Windows: see
docs/WINDOWS.md.
License
PeerSpeak is licensed under the MIT License, © 2026 mollusk.
Third-party components bundled with PeerSpeak (the Rust dependency tree, the
statically bundled Opus codec on some builds, and embedded fonts) are all under
permissive licenses; their texts and a full dependency manifest are collected in
THIRD_PARTY_LICENSES.