v0.9.0 2026-08-15
• Release workflow no longer publishes a macOS DMG that failed notarization (#239 )
• The workflow uploaded the DMG before notarization ran. A failed or timed-out notarytool submission then left that non-notarized DMG in the release while the job still reported success, so macOS users would have hit the Gatekeeper "Apple cannot check it for malicious software" wall with nothing to signal why • Notarization and stapling now run before the upload, and the job fails if either one does not succeed • A failed run fetches the notarytool log, so you can find the cause without re-running the release • The job now fails early when the Apple notarization secrets are missing, instead of surfacing that after a full release build • When a required build does not complete, the draft release is renamed to DO NOT PUBLISH - .... Nothing auto-publishes in that case, but the draft used to survive holding whatever artifacts had already uploaded, which looked complete enough to publish by hand. A later successful run restores the title
• README described a pre-0.8.0 app (#239 )
• Documented accounts and hosted sessions, missing since 0.8.0 • Dropped the macOS "right-click and Open" instruction. Releases are notarized and open on a double-click • Described CDG as detection rather than playback, and listed which containers the system WebView actually plays • Marked layout memory and auto-restore as macOS-only, matching the platform gates in the code • Corrected the Linux token storage claim. keychain.rs documented a Secret Service backend that Cargo.toml never enables, so both the README and the module comment now point at #240
• Guest song requests are now auto-accepted by default (#231 )
• Incoming remote requests skip the approval modal and are added directly to the queue with singer auto-assignment • Passive toast per accepted request ("<guest> added <song> to the queue") • New "Auto-accept guest requests" toggle in Settings → Queue & History — turn off to restore manual approval • When opted out, a Manual approval: ON badge appears in the Host Session modal as a visible reminder
• Error boundary around DisplayRestoreDialog (#56 )
• A render error in the layout-restore prompt now shows a dismiss-able fallback instead of crashing the app • Dismissing also drops the pending restore so the broken dialog won't immediately re-mount
• Detached player window now stays on top of other windows (#178 )
• Default ON, so the video stays visible while you browse or use other apps • Hover-revealed pin button in the top-right toggles it on/off per session
• OpenSpec-driven development workflow (#232 )
• Workflow recorded in CLAUDE.md (issue → explore → propose → branch → apply → review-and-fix → e2e → archive → PR) • First spec captured under openspec/specs/hosted-session-requests/spec.md • /opsx:{explore,propose,apply,archive} slash commands and openspec-* skills checked in under .claude/ so the workflow is reproducible for contributors• Archived OpenSpec changes are tracked in git for PR review; in-flight changes remain ignored
v0.8.1 2026-05-15
• Hosted sessions failing with "User not loaded. Please sign in again." in released builds (#226 )
• Root cause: VITE_SUPABASE_URL and VITE_SUPABASE_ANON_KEY were not passed to npm run tauri build in CI or in scripts/build-and-release.sh, so the Supabase client was never initialised in the shipped binary. • CI and the local release script now require both variables and fail fast if either is missing.
0.8.0 - 2026-02-19
• User authentication with Supabase OAuth
• Sign in with Google, Apple, or Email via external browser • Secure token storage in system keychain (macOS Keychain, Windows Credential Manager) • Automatic token refresh every 4 minutes when authenticated • Offline mode detection with UI indicator • Deep link handling (homekaraoke://) for OAuth callback • User menu with avatar and sign out option
• Host Session feature for guest access (#201 )
• Host button in session bar (requires authentication) • Join code display (format: HK-XXXX-XXXX) visible from distance • QR code for quick mobile join • Copy code and copy link buttons • Live stats: connected guests and pending requests • Join code overlay on idle video player • Stop hosting button to end guest access • Automatic cleanup when ending session
• Hosted session ownership tracking (#207 )
• Hosted session info now stored in sessions table (not settings) • Tracks which user started hosting for proper ownership • Automatic restoration of hosted session on app restart • Different user detection: shows dialog when another user was hosting • Status tracking: active, paused, ended • Prevents hosting conflicts when different user is already hosting • Note: Users upgrading from v0.7.7 will need to re-host their session once
• Fair Queue toggle for automatic fair song insertion (#205 )
• Toggle button next to Fair Shuffle in queue panel • When enabled, new songs insert at fair position based on singer rotation • Algorithm: insert after round N+1 completes (N = singer's current song count) • Preserves existing queue order - only new songs are placed fairly • Falls back to append-to-end when no singer selected • Setting persists across app restarts
• Song Request Approval for hosted sessions (#211 )
• Notification when guests submit new song requests with "View" action • Requests button in queue panel header with badge showing pending count • Approval modal displays requests grouped by guest name • Approve or reject individual requests, or approve all at once • Per-guest "Approve All" button for bulk approval by guest • Approved songs automatically added to queue • Keyboard accessible modal (Escape to close, Tab navigation, focus trap) • Lazy loading thumbnails for performance with many requests
• Auto-assign singer when approving song requests (#215 )
• Automatically creates or finds singer for guest based on user ID • Returning guests are recognized across sessions • Race condition protection for concurrent approvals
• Use user_id instead of session_guest_id for guest identification (#222 )
• More stable identifier that persists across sessions • Enables reliable singer recognition for returning guests
v0.7.7 2026-01-18
• NextSongOverlay no longer shows current song when it's the last in queue (#197 )
v0.7.6 2026-01-17
• Keyboard shortcuts for improved navigation (#192 )
• Global: Space (play/pause), M (mute), Up/Down (volume), N (next video) • Video: F (fullscreen toggle), ESC (exit fullscreen), Left/Right (seek) • Management: Cmd+O (add file), Cmd+F or / (focus search), Tab (switch panel) • Queue: Arrow keys (navigate), Delete (remove), Enter (play selected)
• Fullscreen video mode with double-click or F key toggle • UX polish improvements
• Loading states for all async operations • Empty states with helpful messages • Tooltips on control buttons • Confirmation dialogs for destructive actions (clear queue, history, delete session)
• Cloud playlists feature planning (#194 )
• Detailed implementation plan for host client • Edge case documentation for sessions, network, co-hosts
• Removing a singer from a session no longer deletes them from Stored Singers (#188 )
• Persistent singers are now preserved when removed from session • Only non-persistent, orphaned singers are deleted • Added proper validation for session/singer existence in backend
v0.7.5 2026-01-14
• Search history with type-ahead completion (#181 )
• Remembers past YouTube and local library searches per session • Ghost text inline completion shows top matching suggestion • Dropdown list with keyboard navigation (arrows, Tab, Enter, Escape) • Settings: toggle global history, configure limits, clear history button • Separate history tracking for YouTube vs local searches
• Queue items no longer lost when starting a new session (#179 )
• Race condition where async database writes hadn't completed before session migration • Now flushes all pending queue operations before session transitions
v0.7.4 2026-01-13
• Overlay title bar style for cleaner, more modern window appearance (#176 )
• Main window: Borderless look with macOS traffic light controls • Detached player: Drag from anywhere on video, double-click for fullscreen • Platform-conditional spacing (macOS only shows traffic light area)
• TypeScript types for data-tauri-drag-region attribute • Z-index hierarchy documentation in architecture.md
v0.7.3 2026-01-12
• Configurable "Prefetch Next Video" setting with options: Never, 10s, 20s (default), 30s (#155 )
• Only applies to yt-dlp streaming mode • Pre-loads stream URL before current song ends for seamless transitions
• Settings dialog restructured for clearer organization (#164 )
• YouTube tab (first): API key configuration only • Advanced tab: yt-dlp settings (Search Method, Streaming Mode, Prefetch) • "Reset All Settings" moved to Advanced tab under "Danger Zone"
• Layout restore now correctly reattaches player when saved layout has attached player (#168 )
• Previously, restoring a layout saved with attached player would leave player detached • Also saves attached player state explicitly for future restores
v0.7.2 2026-01-11
• One-time Windows audio notice on first video play (#162 )
• Informs users to toggle mute or pause/play if first video has no sound • Uses Tauri OS plugin for reliable platform detection
• YouTube Embed playback now works on Windows without yt-dlp (#162 )
• App was incorrectly trying to use yt-dlp for all playback • Now properly falls back to YouTube Embed when yt-dlp unavailable
• Settings UI simplified when yt-dlp not installed (#162 )
• Search Method and Video Streaming Mode hidden (only YouTube options available) • Cleaner UX with less confusion about unavailable features
v0.7.1 2026-01-10
• YouTube Data API v3 for search (#149 )
• Official API replaces yt-dlp as default search method • Configure API key in Settings > YouTube tab • ~100 free searches per day with Google Cloud API key • Automatic fallback to yt-dlp if API key not configured • Video duration fetched via batch API call for efficiency
• Created GitHub issues for future settings (#152 -160)
• Playback: Video Quality, Autoplay, Default Volume, Prefetch • Display: Next Song Overlay, Singer Announcement, Player Position • Queue: History Limit, Clear on Exit
• Settings reorganized: YouTube configuration moved to dedicated "YouTube" tab • Unimplemented settings hidden until features are ready • yt-dlp marked as "Unofficial" option in settings
• Console window no longer flashes when running yt-dlp/ffmpeg on Windows (#150 )
v0.7.0 2026-01-06
• Library browser now shows favorites star on each video (#139 ) • Library view automatically refreshes after rescan completes (#139 ) • Local build script for creating polished DMG releases (scripts/build-and-release.sh) • Playwright E2E tests with 104 test cases across Chromium/WebKit (#125 )
• Test coverage for search, queue management, player controls, error handling • Tauri API mock infrastructure for browser-based testing • Comprehensive testing guide at tests/e2e/GUIDE.md
• Justfile with 70+ development workflow commands
• Navigation tabs styled as proper tab headers instead of buttons (#137 )
• Player/Search/Library tabs (left panel) • Queue/History tabs (right panel) • Active tab visually connects to content panel • Added accessibility attributes (role="tab", aria-selected)
v0.6.3 2026-01-06
• Enhanced metadata fetching for local library (Phase 5b) (#133 )
• Fetch song info from MusicBrainz (duration, album, year, artist credit) • Fetch synced lyrics from Lrclib API • Read companion .lrc files as fallback for lyrics • Detect MP3+G CDG companion files (shows has_cdg indicator) • Options enabled in Settings > Library > Rescan Options
v0.6.2 2026-01-06
• Local video library support (Phase 5a) (#131 )
• Add folders from Settings > Library tab to scan for video files • Search local files with "Local" toggle in search bar • Supported formats: mp4, mkv, avi, webm, mov, m4v, wmv, flv • Filename parsing extracts artist/title (e.g., "Artist - Title.mp4") • Optional .hkmeta.json sidecar files for custom metadata • Missing file detection with visual feedback • Click-to-start overlay for browser autoplay compliance
• Path traversal protection with canonicalization • System directory blocking (cannot add /System, /Library, etc.) • Recursion depth limiting for directory scanning • Symlink detection to prevent infinite loops
v0.6.1 2026-01-04
• yt-dlp availability check is now lazy (#127 )
• Only checks on startup if playback mode is set to 'ytdlp' • Checks when opening Settings > Advanced tab (with loading indicator) • Caches result to database to avoid redundant checks • Added "Recheck" button for manual re-check after installing yt-dlp
v0.6.0 2026-01-03
• YouTube iframe as default playback mode (#123 )
• No external dependencies required - works out of the box • yt-dlp now optional, available in Settings > Advanced • Autoplay handling with retry logic and "Click to Play" fallback • Automatic skip for videos that block embedding (error 101/150)
• Settings dialog with tabbed interface (#122 )
• Access via HomeKaraoke > Settings or ⌘, • Tabs: Playback, Display, Queue & History, Advanced, About • Settings persist to SQLite database • Arrow key navigation between tabs • Check for Updates button in About tab • Open Log Folder button in About tab • Video streaming mode setting in Advanced tab
• Update check now uses cached endpoint at homekaraoke.app (#121 )
• Avoids GitHub API rate limits (60 requests/hour per IP) • Falls back to GitHub API if cached endpoint is unavailable
• DependencyCheck no longer blocks app startup when yt-dlp is missing
v0.5.9 2026-01-01
• Windows platform support (#105 )
• Windows build in CI (produces MSI and NSIS installers) • Media controls integration (play/pause from taskbar) • Note: No code signing yet (SmartScreen warnings expected) • Note: Multi-display support not available on Windows
v0.5.8-beta 2026-01-01
• DMG containing Contents folder instead of HomeKaraoke.app bundle (#119 )
• create-dmg now receives staging directory instead of .app path directly • Added trap for guaranteed cleanup of temporary staging directory
• DMG installer missing custom background and having small icons in CI builds
• Replaced Tauri's AppleScript-based DMG styling with create-dmg tool • Uses --sandbox-safe mode that works in headless GitHub Actions
• Prefetch first queue item when player is idle (faster playback start)
• Next song overlay showing wrong song during loading transition (#117 )
• Increased prefetch threshold from 20s to 30s for slower machines (#117 )
• Seek bar not working when app starts with detached player (#116 )
• Custom karaoke-themed background image for macOS DMG installer (#112 ) • Active singer selection for auto-assigning singers when adding songs (#109 )
• "Adding as" dropdown in search panel to select active singer • Songs added to queue automatically assigned to selected singer • Active singer persisted per session
• Notification duration now varies by type (#111 )
• Success: 3s, Info: 4s, Warning: 6s, Error: 8s
• Fair Shuffle button in Queue panel (#109 )
• Reorganizes queue into fair round-robin order by singer • Multi-singer items (duets) count for ALL singers involved • Uses MAX count algorithm: duets wait until all singers are due • 11 unit tests for shuffle algorithm
• Icon-only buttons for Queue and History panels
• Shuffle, Trash, Star, and ListRestart icons from lucide-react • Improved accessibility with aria-labels
• Reduced notification auto-hide duration from 10s to 4s
• Update notification on app startup (#99 )
• Checks GitHub releases API for newer versions • Shows notification with Download button linking to release page • Remembers dismissed versions to avoid repeated notifications
• Comprehensive CONTRIBUTING.md guide for new contributors (#103 ) • In-app notification system for errors and messages (#98 )
• Notification bar slides up from bottom of screen • Support for error, warning, success, and info notification types • Auto-hide after 10 seconds with manual dismiss option • Indicator button to view last notification after it hides • Notifications can include action buttons with external links • Replaces silent errors with visible user feedback
• Fix choppy video playback in detached window on Fedora Linux (#100 )
• Disable WebKitGTK DMABuf renderer to resolve multi-window video rendering issues
• Fix video playback not working on Fedora Linux (#93 )
• Add GStreamer codec plugin dependencies for Linux packages • RPM: gstreamer1-plugins-base, gstreamer1-plugins-good, gstreamer1-libav • DEB: gstreamer1.0-plugins-base, gstreamer1.0-plugins-good, gstreamer1.0-libav • Prefer H.264 (avc) codec and exclude HLS streams for WebKitGTK compatibility
• Singer Favorites feature (#88 )
• Persistent singers can save favorite songs • Star button on search results and history items to add/remove favorites • Manage Favorites dialog (Singers menu) to view and manage favorites per singer • Load Favorites to Queue dialog to quickly add favorites to queue • Auto-assign singer when loading favorites to queue • Promote session singers to persistent via star icon • Add persistent singers to session from singer picker dropdown • unique_name field for singer disambiguation
• Rename app from "Karaoke" to "HomeKaraoke" (#91 )
• Updated bundle identifier to app.homekaraoke • Updated all UI labels, window titles, and menu items • Updated D-Bus/MPRIS name for media controls
• Linux build support for Fedora and Debian (#89 )
• Builds .deb packages for Debian/Ubuntu • Builds .rpm packages for Fedora/RHEL • Builds .AppImage for other distributions • Media controls work via MPRIS/D-Bus • Note: Display layout save/restore not yet available on Linux
• Apple Developer code signing and notarization for macOS distribution (#85 )
• App is now signed with Developer ID certificate • Builds are notarized with Apple for Gatekeeper approval • GitHub Actions workflow updated to sign and notarize release builds
0.4.0 - 2025-12-28
• Reload button in PlayerControls for stuck videos (#69 )
• Re-fetches streaming URL and reloads video from the beginning • Useful when videos get stuck in loading state
• "Play Next" button in search results to add songs to top of queue (#72 )
• Inserts song at position 0 so it plays immediately after the current song • If nothing is playing, starts playback immediately • Button order: [+] Add to Queue, [⏭] Play Next (green), [▶] Play Now
• Improve About dialog with description and GitHub link (#65 )
• Display app description and clickable GitHub repository link • Show author information and copyright with dynamic year • Use compile-time environment variables from Cargo.toml for consistency
• Use thiserror for structured error types in Rust backend (#57 )
• Replace string-based error handling with typed CommandError enum • Better error categorization (database, validation, not found, etc.) • Errors now include type information for easier debugging • Updated all command modules: display, queue, session, keep_awake, media_controls, youtube
• Associate existing queue and history with newly started session (#77 )
• Queue and history items are now migrated to the new session when clicking "Start Session" • Previous behavior would reset the UI and leave items orphaned in the old session
• Fix song duration display not updating when switching songs in detached mode (#71 )
• Duration from video metadata in detached window is now synced back to main window • Resets duration/currentTime when setting new video to prevent stale values
• Fix queue not continuing after playing from History or Search (#68 )
• Songs played from Search or History no longer cause auto-play to continue through history • When a song ends naturally, the next song always comes from the queue • "Next" button still navigates forward through history as expected
• Fix window restoring to wrong display and size (#60 )
• Use Tauri's monitor API for consistent physical pixel coordinates • Previously used CoreGraphics logical points which don't match window positions on Retina displays • Windows now correctly restore to their saved position on the correct monitor
0.3.5 - 2025-12-27
• Add missing Tauri permissions for window position/size operations
• Fixes "window.set_position not allowed" error during layout restore
0.3.4 - 2025-12-27
• "Replay All" button in History panel to move all history items back to queue (#47 )
• Moves all played songs back to the queue in their original order • Clears history after moving items • Persisted to database for session recovery
• Validate window bounds before restoring position (#52 )
• Prevents windows from being positioned off-screen after display changes • Windows are centered on main display if saved position is no longer valid • Constrains window size if larger than current display
0.3.3 - 2025-12-26
• Display hotplug detection and window layout restore (#48 )
• Automatically detects when displays are connected/disconnected • Save current window layout via View → Save Display Layout menu • Restore dialog appears when a saved display configuration is detected • "Remember my choice" option for automatic restore without dialog • Auto-restore saved layouts on app startup • Detach button appears on hover over video player • Database storage for display configs and window states with proper migrations
• Refactor: Extracted shared video playback logic into playVideo helper (#42 )
• Consolidated duplicate code from PlayerControls and useMediaControls • New playVideo() function in playerStore handles stream URL fetching, state updates, and error handling
• Media controls event polling thread now shuts down gracefully on app exit (#40 )
• Added shutdown flag mechanism with recv_timeout for responsive termination • Thread handle stored in AppState for proper cleanup
• Video loading indicator now works correctly when player is detached • Fixed double audio issue when starting with detached player window
0.3.1 - 2025-12-26
• macOS Now Playing widget integration (#38 )
• Display song title and artist in Control Center, Touch Bar, and AirPods controls • Support for media key controls (play/pause, next, previous) • Album artwork from YouTube thumbnails • Playback position and progress tracking
0.3.0 - 2025-12-26
• Queue and history persistence across app restarts (#31 )
• Queue and history data saved to SQLite database per session • Sessions menu in macOS menu bar for managing stored sessions • Load, rename, and delete stored sessions from dialog • Singer assignments preserved with queue items • Empty sessions automatically cleaned up on end • Singer avatars displayed in stored sessions list
• Infinite scroll pagination for search results (#35 )
• Automatically loads more results when scrolling to bottom • Fetches up to 50 results per search (displays 15 at a time) • Shows "Loading more..." indicator while fetching • Displays "End of results" when all results are shown
0.2.1 - 2025-12-26
• Singer picker button now has better contrast against queue item tiles (#30 ) • Singer picker button has distinct hover state with blue highlight (#30 ) • Singer assignment dropdown now fits within window bounds (#32 ) • Dropdown opens below button when insufficient space above • Dropdown is scrollable when list of singers exceeds available space
0.2.0 - 2025-12-25
• Debug logging mode with macOS app menu toggle (#21 , #22 )
• Persistent file logging via tauri-plugin-log (~20MB max, 4 rotated files) • View → Debug Mode menu toggle • View → Open Log Folder menu item • Structured logging with scoped loggers throughout the app
• Show next song overlay with countdown before video ends (#12 , #17 ) • Prefetch next video stream URL to reduce loading time (#11 ) • Detachable video player window (#6 , #7 , #20 )
• Pop out video to separate window • State sync between main and detached windows • Reattach functionality
• Microphone app icon for all platforms (#14 ) • UI Polish: Tabbed view, keep-awake, and draggable queue (#4 , #8 ) • YouTube integration with yt-dlp (#2 , #3 )
• Search YouTube videos • Stream playback • Auto-install yt-dlp if missing
• yt-dlp detection in built .app bundles (#16 ) • Detached player state synchronization issues (#20 ) • Various seek, progress bar, and error handling improvements
0.1.0 - 2025-12-01
• Initial release • Basic Tauri + React + TypeScript setup • SQLite database for persistence • Queue and history management • Basic video player controls