Repository navigation
StreamQueue v0.2.0
This release significantly expands StreamQueue with native Twitch integration, channel point rewards, Windows distribution, improved moderation, playback reliability, and a more robust control panel.
Highlights
Twitch integration
StreamQueue now has native Twitch integration instead of relying only on external chat tooling.
- Connect a Twitch channel directly from the control panel
- Native Twitch chat commands for queue and playback controls
- Configurable commands, permissions, and cooldowns
- Twitch Channel Points integration for song requests
- Track Channel Points redemptions and handle request failures
- Automatic redemption handling after successful playback
- Detailed chat notifications for accepted and failed requests
- Automatic Twitch EventSub reconnection and redelivery protection
- Improved OAuth token refresh and connection lifecycle handling
Channel Points rewards
Song request rewards can now be managed directly from StreamQueue.
- Create and edit Twitch Channel Points rewards
- Configure reward cost, limits, cooldowns, and color
- Select which configured reward is used for song requests
- Configure automatic fulfillment after successful playback
- Cancel failed requests and refund points when appropriate
Windows standalone distribution
StreamQueue can now be distributed as a self-contained Windows application.
- Node.js is no longer required on the target machine
- Node Single Executable Application (
Service.exe) build - Optional Windows tray launcher
- Start, stop, restart, and monitor the StreamQueue service from the system tray
- Local logs and runtime data stored alongside the application
- Graceful shutdown with persisted state flushing
- Automatic port selection
- Protection against multiple tray instances
Blocklist and moderation
Track moderation is now built into the control panel.
- Block tracks directly from Activity, Queue, or fallback lists
- Dedicated Blocklist view
- Blocked tracks cannot be requested again
- Blocked tracks are skipped automatically in the queue and fallback playlist
- Currently playing blocked tracks can be skipped
- Blocklist entries are persisted locally
- Blocklist size and input data are validated
Playback reliability
Playback and player state handling have been substantially hardened.
- More reliable player initialization and reset handling
- Protection against duplicate playback failure reports
- Playback failures are associated with the correct video
- Failed fallback tracks can automatically advance to the next track
- Blocked tracks are skipped during playback
- State changes are centralized and persisted more reliably
- Improved overlay/player lifecycle handling
Control panel
The control panel has received a broad architectural and UX refactor.
- Modular frontend architecture
- Centralized action/event handling
- Shared list and row components
- More consistent queue, fallback, activity, and blocklist layouts
- Improved settings state handling
- Cancel actions for settings forms
- Clear saved/changed states
- Better validation feedback
- Partial configuration saves when only some fields are invalid
- Improved error and notification handling
- English and Russian localization updates
YouTube improvements
- Improved search result scoring
- Trusted-channel scoring
- Support for
music.youtube.com - Better duration validation
- Increased daily search quota allocation
- Failed API requests no longer consume search quota
- Stronger YouTube URL and video ID validation
- Improved handling of unavailable, restricted, non-embeddable, live, and Shorts videos
Testing and reliability
This release also adds substantially more automated coverage.
- Backend unit tests
- Frontend regression tests
- jsdom control panel smoke tests
- Player and state persistence tests
- Twitch integration and route tests
- EventSub/WebSocket regression tests
- Configuration validation tests
- Security tests for admin filter bypass
- YouTube search and scoring tests
Other changes
- Centralized API routing
- Shared reconnecting WebSocket infrastructure
- Dedicated Twitch settings and configuration modules
- Improved persistence and runtime path handling
- More structured request/playback failure reasons
- Better localized chat responses
- Improved API error handling
- Removed automatic browser opening for packaged deployments
- Numerous UI, stability, and cleanup fixes
Upgrade notes
StreamQueue remains local-first: application state, configuration, playlists, blocklist, cache, and logs are stored locally.
For Windows users, the new standalone distribution is intended to make running StreamQueue possible without installing Node.js or manually editing configuration files.