v0.2.8

v0.2.8

This release improves private-room correctness and significantly reduces playback startup latency, especially in CLI and Render-hosted scenarios.

Highlights

• Private rooms now reliably close when the host leaves/disconnects without transfer.
• Stream resolution is faster and more resilient with cache, preload, and parallel fallback logic.
• Better diagnostics for stream source/failure paths.

---

What changed

Private room lifecycle hardening

• Fixed private-room host exit behavior on disconnect path:
  • If host leaves without transfer, room is ended immediately.
  • Server emits room:ended (host_left_without_transfer), disconnects members, and deletes room state.
• Prevents unintended host auto-transfer in private rooms on host disconnect.

Server stream extraction and latency improvements

• Added yt-dlp player-client fallback chains for datacenter environments.
• Added structured extraction failure classification:
  • bot_challenge
  • unavailable
  • unknown
• Added fast-fail behavior (stopOnBotChallenge) to reduce wasted retries.
• Improved /youtube/search and /youtube/stream responses with structured code values and clearer status mapping.
• Added stream URL server cache:
  • TTL-based (short-lived, safe for expiring YouTube URLs)
  • bounded size with eviction
• Added in-flight dedupe for stream resolution by videoId (prevents duplicate concurrent resolution work).
• Added background stream pre-resolution on queue:add.
• /youtube/stream now can return cache-hit metadata (cached).

CLI stream startup improvements

• get_stream_url now races server and local yt-dlp in parallel (first success wins).

• Added safer cancellation cleanup for local yt-dlp subprocesses.

• Added stream preloading in room flow (including next-track preload path).

• Kept/expanded stream cache usage in CLI runtime.

• Added playback debug visibility in system log:

  • ⚡ stream source: cache (local)
  • ⚡ stream source: cache (server)
  • ⚡ stream source: server live
  • ⚡ stream source: local yt-dlp

Documentation updates

• Updated cli/README.md streaming notes to reflect:
  • server cache + pre-resolution
  • CLI parallel resolver race
  • stream source diagnostics
• Updated root README.md to reflect:
  • private host disconnect room-destroy behavior
  • latest extraction/cache/preload architecture

---

Notes

• Datacenter-hosted yt-dlp extraction can still be challenged by YouTube policies.
• This release focuses on minimizing user-visible delay and improving fallback reliability rather than relying on a single extraction path.

---

Upgrade

pip install --upgrade vaux-cli==0.2.8

Verify:

vaux --version

v0.2.5

Highlights

CLI: scrub sync, clearer feedback, and a system log

• Web → CLI scrub sync. Scrubbing the playback slider on the web client now updates the CLI's mpv position immediately — no more "pause, then play" workaround. (#37, #39)
• System log + chat log split. The right pane now shows a compact system log (joins, track changes, status) above a larger chat log, so conversation no longer drowns in event noise.
• Track-change toast. A quick ♪ <title> toast pops on every track change. ▶ / ⏭ / ⏳ icons replace the old verbose now playing: prefix, and long titles auto-truncate.
• Loading feedback. ⏳ loading stream… shows while mpv warms up on first play or skip.
• Quieter join. First-time room joins post a single ♪ syncing playback… instead of three sequential status lines.

CLI: theme picker + releases link

• Theme picker (Ctrl+P). Switch Textual themes on the fly via the command palette. Selection is session-only.
• Releases link. Ctrl+G info modal now surfaces a Releases row, and PyPI's Changelog / Issues sidebar buttons resolve to the GitHub release & issue pages.

Web: mobile lobby polish

• Mobile tab navigation, listener-management UI, and toast notifications for queue and playback events. (#34)
• Help modal in the lobby for first-time users. (#32)
• Clipboard-paste on the login page for room codes. (#33)

Bug fixes

• Fixed playback drift between web and CLI when a listener scrubbed the slider. (#37)

Install / upgrade

pip install --upgrade vaux-cli

Then run:

vaux --server <your-server-url>

Full PR history

What's Changed

• Enhance functionality, user experience, and code documentation by @itsvee0120 in #1
• Enhance Home, Login, and Lobby components with new backgrounds and styles by @itsvee0120 in #2
• Refactor server and web components for improved functionality and UI by @itsvee0120 in #3
• Add CLI for joining listening rooms and enhance VauxApp functionality by @itsvee0120 in #4
• Enhance YouTube playback and refactor VauxApp for performance by @itsvee0120 in #5
• Update CORS configuration in server to allow requests from any origin by @itsvee0120 in #6
• Enhance CORS configuration and add root endpoint in server by @itsvee0120 in #7
• Refactor session management and enhance hydration logic in Home compo… by @itsvee0120 in #8
• Update README and enhance socket handling in the server and Home comp… by @itsvee0120 in #13
• Enhance documentation, implement room slug generation, and improve CLI by @itsvee0120 in #14
• UI enhance by @itsvee0120 in #15
• Enhance playback, UI, bug reporting, and CLI branding by @itsvee0120 in #16
• Update version to 0.2.1 and enhance UI and playback features by @itsvee0120 in #17
• Update version to 0.2.2 and enhance README with project details by @itsvee0120 in #18
• Security: server-side identity + rate limiting by @itsvee0120 in #21
• Add queue management and room join failure handling by @itsvee0120 in #23
• Enhance video queue management with input validation and sanitization by @itsvee0120 in #25
• Update .gitignore and enhance bug report modal with security note by @itsvee0120 in #29
• UI update by @itsvee0120 in #30
• Update version, enhance subprocess handling, and improve UI components by @itsvee0120 in #31
• Add HelpModal component and integrate into LobbyPage for user assistance by @itsvee0120 in #32
• Enhance LoginPage with clipboard paste functionality and UI improvements by @itsvee0120 in #33
• Mobile tab navigation, listener management, and toast notifications for the lobby by @itsvee0120 in #34
• [CLI - BUG REPORT] Scrubbing Sync Issue by @itsvee0120 in #37
• Enhance CLI: playback feedback + system-log + theme picker + scrub sync by @itsvee0120 in #39

---

Full Changelog: https://github.com/itsvee0120/vaux/commits/v0.2.5