Lyracist Pro is a premium, modern Windows WPF Karaoke hosting application designed for professional KJs and home entertainment. Built using WPF and .NET 10, it offers a safe, DJ-friendly Auto-Advance system with grace period timer and fill-in music ducking, advanced multi-monitor projection, rich audio customization, high-speed in-memory library scanning and metadata probing (TagLibSharp), local and streaming library search, an integrated mobile tablet server for performer lyrics, active rotation management with current performer top-floating, smart new singer round insertion, inactive singer filtering, intelligent name and artist proper-casing with mixed-case and apostrophe prefix support, spacious high-DPI singer cards with full button border visibility on 1080p laptops, global auto-highlighting/select-all on focus across all text and numeric inputs, responsive portrait/landscape tablet layouts and Android launch stability in KSRotation.Maui, dedicated cross-app landscape tablet kiosk request station (kiosk.html) with Attractor/Welcome screen and PWA fullscreen support, remote DJ web control with checkmark-first action buttons and popup modal performer addition (dj.html), integrated interactive pub/bar trivia with dedicated separate settings, manual DJ game flow controls with question jumping, timer adjustments, and keyboard shortcuts, multi-monitor auto-casting, randomized answer elimination, non-overlapping score and intermission screens, automated projection pause synchronization, dynamic tiered option value scoring (100% / 70% / 40%), Knockout Trivia standalone game-show module with phone/tablet QR connect, session security, testing module & DJ bot simulator, and automatic internal scoring (KnockoutTrivia.exe), a dedicated Trivia Database Creator (TriviaDbCreator.exe), Scaryoke standalone roulette wheel module with dual-monitor audience projection (ScaryokeWheel.exe), integrated Scaryoke singer rotation challenge spins with tablet remote control in KSRotation, and a unified, consolidated directory architecture across all apps (Settings/, Data/, Banners/, Packs/, Logs/).
๐ณ Patron Phone Turn Alerts ("Buzz My Phone") & DJ Manual Stage Pager (KSRotation, KSRotation.Maui, Lyracist, PatronPortal.html, mobile.html, dj.html)
- 2-Stage Automatic Phone Turn Alerts (
On Deck+Your Turn Now): Performers connected via theKSRotation/KSRotation.MauiPatron Portal (PatronPortal.html) orLyracistPerformer Portal (mobile.html) can enable "๐ณ Buzz My Phone When I'm Up" at the top of the portal (or tap "๐ Watch" next to their name in the Rotation list):- Stage 1 โ On Deck (1 Performer Ahead /
IsNext): Fires a medium double-pulse hardware vibration (navigator.vibrate([300, 150, 300, 150, 300])), a 5-note ascending Web Audio chime, and a full-screen flashing amber/navy pager modal ("๐ YOU'RE UP NEXT, [NAME]! You are On Deck (1 performer ahead) โ get ready!") with a "๐ Got It โ I'm Ready!" dismiss button. - Stage 2 โ Your Turn Now (Stage Call /
IsCurrent): Fires a strong pager vibration pattern (navigator.vibrate([500, 150, 500, 150, 700, 200, 500])), a 6-note Web Audio fanfare chime (repeating while open), and a full-screen flashing green/gold pager modal ("๐ค IT'S YOUR TURN, [NAME]! Head to the stage now!") with a "๐ค On My Way!" dismiss button.
- Stage 1 โ On Deck (1 Performer Ahead /
- Duet Partner Matching, Screen Wake Lock & Live Test Button: Alerts trigger automatically whether the watched name matches the primary singer (
name) or their duet partner (duetPartnerName/partner), maintain a Screen Wake Lock (navigator.wakeLock.request('screen')) while active so the phone doesn't sleep at the table, and include a "๐ณ Test" button to unlock iOS/Android Web Audio + Wake Lock and preview the pager modal immediately. - DJ Master Setting & Manual "๐ณ Buzz Singer's Phone" Action: Hosts can toggle
Enable Patron Phone Turn Alerts (Buzz / Chime)(EnablePatronTurnAlerts, defaulttrue) in Settings acrossKSRotation,KSRotation.Maui, andLyracist, and manually re-page any singer's phone on demand using the๐ณrow button or right-click๐ณ Buzz Singer's Phonecontext menu item inKSRotation(MainWindow.xaml&dj.html),KSRotation.Maui(MainPage.xaml), andLyracist(RotationPage.xaml).
๐ค Qualifying Singer & Performed Song Database (Data/singers.db) with Venue Tracking, Performance Counts & History Printing (KSRotation, Lyracist, Lyracist.Data, SingerHistoryService, SingerHistoryPrinter)
- Dedicated
Data/singers.dbDatabase (LyracistDbContext.GetSingersDatabaseFilePath(),EnsureAndSyncDedicatedSingersDatabase): Performer accounts (Singers), per-singer vocal/EQ settings (SingerAudioSettings), and song performance history (SingerHistory) are stored in their own dedicated SQLite databaseData/singers.dbโseparate from the 145,000-song karaoke catalog databaseData/lyracist.db. IfData/lyracist.dbis ever deleted and rebuilt, all singer profiles, vocal/EQ settings, and performance history edits remain completely intact inData/singers.dband are automatically restored intolyracist.dbon startup. - First & Last Name or Distinct Name Qualification (
NameFormatting.IsQualifyingDatabaseSingerName): The permanent singer and song history database (SingersandSingerHistoryinData/singers.db) only stores performers who have a First & Last name (e.g.,"Sharon Roberts","Bar Mike Gilmore"), a distinct multi-word identifier (e.g.,"Bar Mike","Big Mike","DJ Dave"), or a single-word stage name explicitly marked withDistinct Single Name(IsDistinctName = true) on their profile. Generic single first names ("Mike","John","Sarah") and system placeholders ("New Singer","Special Guest","Music Request") are automatically excluded from permanent database storage. - Per-Song Performance Counts (
SingerHistory.TimesPerformed/# SungColumn): Every time a singer completes a song,SingerHistory.TimesPerformedtracks how many times that singer has performed that specific song across shows (displayed as1x,2x,3x, etc. in the# Sungcolumn of the Performance History table in bothKSRotationandLyracist). Saved rotation report synchronization (SyncFromSavedReportsAndCleanup) aggregates all occurrences of each(Singer, Song, Artist)acrossReports/*.csvidempotently without double-counting on refresh, while account merges (MergeHistory) sum overlapping song counts. - Per-Singer & Per-Song Venue Tracking (
Singers.Venues,SingerHistory.Venue): Every completed performance records the active venue on both the song history entry (SingerHistory.Venue) and the performer's profile (Singers.Venues, deduplicated viaDatabaseService.MergeVenueLists). The Users tab in bothKSRotationandLyracistdisplays a๐ Venuessummary badge on each singer card and header, an editable Venues Performed field on the profile tab, and a dedicated Venue column in the Performance History table. - Print Singer History (
Shared/SingerHistoryPrinter.cs,๐จ๏ธ Print History): BothKSRotationandLyracistinclude๐จ๏ธ Print Historybuttons on the performer profile header card and inside the Performance History tab. Clicking Print History opens the native Windows Print Dialog and generates a clean, multi-pageFixedDocumentreport displaying the singer's name, custom title, vocal range, unique songs count, total performances count, consolidated venues performed, and a zebra-striped table sorted alphabetically by song title (#,Song Title,Artist,# Sung,Venue(s),Key / Speed, andLast Sung). - Edit, Add & Queue Singer Performance History (
UpdateHistoryEntry,AddManualHistoryEntry,QueueUserHistoricalSongCommand/QueueHistoricalSongCommand): BothKSRotation(Users -> Performance History tab) andLyracist(Users -> Performance History tab) provideQueue,Edit, andRemovebuttons on every song row plus anโ Add Songbutton in the header to edit Song Title, Artist,# Sung(TimesPerformed), Venue(s), Key, and Speed (Tempo). ClickingQueuechecks if the singer already exists in the active rotation: if they do, the song is assigned to their current song slot (if blank) or added to their queued songs list (QueuedSongs/_pendingSingerSongs) without duplicating the singer in the rotation; if they are not yet in the rotation, a new singer entry is added. Editing a song's title or artist to match another row for the same singer automatically merges the two rows (summing# Sungand mergingVenue(s)) and updates matching rows inReports/*.csvso corrections persist across future syncs. - Automatic Blank-Artist Consolidation & Legacy PDF/EML Venue Extraction (
SingerHistoryService,SavedRotationReportReader.ExtractVenueFromPdfOrEml): When a singer has performed a song with a blank artist ("") and also has an entry for the same song title with a non-empty artist (e.g.,"Green Door"with""and"Green Door"with"Shakin' Stevens"),SingerHistoryServiceautomatically consolidates them into the single non-empty artist row (summingTimesPerformedand mergingVenuelists). For legacy timestamped report files (Rotation_yyyyMMdd_HHmmss.csv) whose filename does not include the venue,SavedRotationReportReaderautomatically extracts the venue name from the companion.pdf/Title (Karaoke Rotation Report - <Venue>)metadata or.emlSubject:header. - Automatic Live & Saved Rotation Report Sync (
SingerHistoryService.RecordCompletedPerformance,SyncFromSavedReportsAndCleanup): Checking off a round inKSRotation, completing a song inLyracist, saving a rotation report, or clicking๐ Refreshin the Users tab automatically records the singer's performed song, artist, key, speed, duet partner, performance count, and venue intolyracist.db, while importing all qualifying singers, songs, counts, and venues from savedReports/*.csvfiles. - Seamless Name Consolidation (
SaveUser/SaveSinger&Merge Duplicate...): When a singer with a distinct nickname later provides their full name (for example, renaming"Bar Mike"to"Bar Mike Gilmore"and clicking Save Changes, or merging accounts via Merge Duplicate...), all performed songs, performance counts, venues, audio settings, and XP points consolidate automatically under the updated name.
๐ Saved Rotations Tab & Nightly Report Reader (KSRotation, Lyracist, Shared/SavedRotationReportReader.cs)
- Master-Detail Saved Rotation Browser (
KSRotation&Lyracist): BothKSRotation(Saved Rotations tab next toRotation) andLyracist(Saved Rotations top navigation tab) provide a dedicated workspace to browse, search, and inspect saved nightly rotation lists stored in the sharedReports/directory (Globals.KSRotationReportsDir), or open any.csv/.pdfrotation report from disk via๐ Open File.... - Two Inspection Views (
Singers & Rounds+All Report Rows): Selecting a saved rotation report displays its venue name, show date, total karaoke singers, active performers, total songs sung, and music request counts, along with an instant in-report filter bar and two sub-tabs:- Singers & Rounds: Groups each performer's completed songs in rotation order (
R1,R2, duet partners, and song counts, plus queued singers with 0 completed songs). - All Report Rows (CSV Table): Full tabular
DataGridview of every row in the saved report (#,Singer,Duet Partner,Type,Round,Song Title,Artist,Time).
- Singers & Rounds: Groups each performer's completed songs in rotation order (
- One-Click Actions (
Load Singers to Rotation,Open PDF,Open CSV,Save Rotation): Hosts can reload all karaoke singers from any past saved rotation directly into tonight's active rotation queue (โ Load Singers to Rotation), launch the companion.pdfor.csvfile in the system viewer, open theReports/folder in Explorer, or save the current rotation list from eitherKSRotationorLyracist(RotationPage.xaml->Save).
๐ญ Crowd Emoji Reactions: 7 Performer Vibe Sets & DJ Show Theme Override (KSRotation, KSRotation.Maui, Lyracist, PatronPortal.html, mobile.html, billboard.html, dj.html)
- Live Smartphone Audience Reactions in
KSRotation&Lyracist(160x160 HD 3D Shaded Multi-Color Graphics + 50% Larger Display Size): Patrons connected via theKSRotationRequest Portal (PatronPortal.html) or theLyracistPerformer Portal (mobile.html) can tap emoji reactions that float across the live audience rotation screens (SingerDisplayWindow,RotationWindow,LyricsWindow,KSRotation.MauiBillboardView, and Chromecast/Smart TVbillboard.html) using bundled 160x160 high-DPI 3D-shaded, multi-gradient PNG graphics (with specular highlights, bevels, and 500โ2,100+ color tones per icon) rendered at 130px (50% larger for high visibility across the venue), soft color-matched radial glow halos, and smooth 5.5-second flight trajectories from all four screen edges (capped at 20 concurrent on-screen reactions). BothKSRotationandLyracistalso render the 3D shaded emoji icons inside theHoliday Rotation ScreensandCrowd Emoji Reactions (Show Theme)GroupBox headers and dropdown selectors (LeadingEmojiImageConverter/LeadingEmojiTextConverter), whilePatronRequestServerserves/api/emoji/{key}.pngfor web/Chromecast billboards. - 7 Curated Performer Vibe Sets (6 Emojis Each): Because one singer may be performing a country ballad and the next a hip-hop or rock anthem, patrons can switch between 7 genre/vibe sets directly on their phones:
- ๐ Classic:
โค๏ธ ๐ฅ ๐ ๐ ๐ ๐ - ๐ค Country / Honky-Tonk:
๐ค ๐ป โค๏ธ ๐ธ ๐ถ ๐ - ๐ธ Rock & Metal:
๐ค ๐ธ ๐ฅ โก ๐ฅ ๐ค - ๐ค Hip-Hop / Rap:
๐ค ๐ฏ ๐ฅ ๐ฐ ๐ ๐ - ๐ฏ๏ธ Ballad / Slow Jam:
๐ฏ๏ธ ๐ ๐น โจ ๐ถ ๐ - ๐บ Party / Dance:
๐บ ๐ ๐ ๐ฅ ๐คฉ โก - ๐ Superstar / Encore:
๐ ๐ ๐ โญ ๐ฏ ๐
- ๐ Classic:
- DJ Show Theme Override (
PatronChoice, Locked Theme, orOff):- ๐ญ Patron's Choice (Default): Guests see all 7 vibe selector pills on their phones and can freely switch sets from singer to singer.
- Single Show Theme Lock: When the DJ selects a specific Show Emoji Theme (
Classic,Country,Rock,HipHop,Ballad,Party, orSuperstar) from the Display settings tab (KSRotation/Lyracist), the MAUI Billboard/Cast bar (KSRotation.Maui), or the Remote DJ Board (dj.html), all patron phones lock to that theme's 6 emojis for the night with a themed header badge, and server validation (EmojiReactionThemes.IsAllowedEmoji) enforces the active theme. - ๐ซ Off: Hides the reaction card on patron phones and disables incoming emoji reactions.
๐ Linked Singers Rotation List Integrity (Shared/RotationHelpers.cs, Lyracist, KSRotation, KSRotation.Maui)
-
Bidirectional Drag-and-Drop Pair Movement (
RotationHelpers.MoveSingerToIndex): Dragging either half of a linked singer pair upward or downward in the rotation list moves both partners together to the target slot while preserving their relative order, while dropping one partner directly onto the other swaps their internal order ([A, B]$\leftrightarrow$ [B, A]). Dragging an unlinked singer into a linked pair steps cleanly past the pair without splitting them. -
Float-to-Top Partner Promotion (
RotationHelpers.SetCurrentSinger): Manually promoting a linked singer to Current inFloatCurrentSingerToTopmode brings their active linked partner to index1(IsNext) so they still perform back-to-back. -
Paused Partner & Round Anchor Safeguards (
AdvanceRotationAfterFinished,EnforceLinkedAdjacency,InsertNewSinger): When a linked singer finishes while their partner is paused or skipped, the paused/skipped partner rotates to join the finished singer at the bottom of the active queue rather than pulling the finished singer back ahead of the round anchor. WhenIsRotationStartsits on the trailing partner of an adjacent linked pair,InsertNewSingerinserts new signups ahead of the entire linked pair so they are never pushed into the next round.
๐ Automatic Database Self-Repair, Music & Karaoke Library Search, Tab Layout & High-Speed Drive Rescan (Lyracist, Lyracist.Data, LyracistDbEditor)
- Automatic Database Schema, Migration Lock & FTS5 Self-Repair (
LyracistDbContext.EnsureSchemaAndRepair):- Automatically heals legacy, partially migrated, or interrupted
lyracist.dbfiles on startup, during directory scans, and on search retry so operators never have to manually deletelyracist.dband rescan from scratch. - Cleans abandoned
__EFMigrationsLocktables (DROP TABLE IF EXISTSbeforewritable_schemacatalog cleanup,PRAGMA integrity_check(1), andSqliteConnection.ClearAllPools()), idempotently verifies and adds any missing tables (Songs,Singers,PerformanceRecordings,SingerHistory, etc.) and columns (MixInMs,MixOutMs,NeedsRepair,MeasuredLoudnessLufs,Difficulty,Key,BPM,VocalPresence,Quality,AllowRecording), and recovers from corrupt FTS5 shadow tables or corrupt WAL sidecar files.
- Automatically heals legacy, partially migrated, or interrupted
- Full-Width TabItem Content Stretching (
LyracistTheme.xaml): RestoredHorizontalContentAlignment="Stretch"andVerticalContentAlignment="Stretch"on the high-contrast<Style TargetType="{x:Type TabItem}">style soTabControlcontent hosts (Karaoke Library,Music Library,Streaming Links,Singer History,SettingsPage,RotationPage,UsersPage) stretch to fill the full width and height of their parent container instead of collapsing star-sizedDataGridcolumns (Song,Artist,Duration,Genre). - O(log N) RowId-Indexed FTS5 Search, Live MATCH Probe & Automatic LIKE Fallback (
SearchService):- Bound
rowid = SongIdon allSongSearchFTS5 inserts/upserts and deletions (DELETE FROM SongSearch WHERE rowid = @SongId), eliminating 394,000-row unindexed full-table scans (~95ms per song) and preventing duplicate FTS5 entries on re-index. - Added
RemoveSongsFromIndexBatchand atomic synchronousEnsureFtsIndexSynchronizedverification (checking row counts,rowid != SongId, missingSongIds, unnormalized rows, and a live FTS5MATCHprobe) that automatically rebuilds out-of-sync or corruptSongSearchindexes in a single SQLite transaction. - Added automatic
SongstableLIKEfallback (Title,Artist,FilePath) whenever FTS5 returns 0 matches or encounters an error, triggering a background FTS5 self-repair when fallback matches are found. - Quoted FTS5 prefix tokens (
"word"*) inPrepareFtsQueryso queries containing FTS5 boolean keywords ("and","or","not","near", e.g."rock and roll") never fail or misparse.
- Bound
- Non-Blocking Drive Rescans, Zero-I/O Search List Mapping &
LyracistDbEditorUpgrades (ScanningService,LibraryService,SongPathResolver,KaraokeViewModel,PlaylistsViewModel,LyracistDbEditor):- Replaced 145,000+ redundant
File.ExistsUSB disk checks during drive rescans with an O(1) in-memoryHashSet<string>candidate lookup (candidateFilesSet), added real-time file discovery progress reporting inSafeEnumerateFiles, and switched dead/duplicate.cdgcleanup to batched FTS5 removal. - Added
SongPathResolver.ResolveCachedOrOriginalplus root/negative lookup caching soLibraryService.MapToKaraokeSongmaps search results and background music lists with zero synchronous disk I/O while preserving dynamic multi-drive path resolution on playback. - Marshaled
KaraokeViewModelpost-scan list updates (OnLibraryUpdated/RefreshFilteredList) to the WPF UIDispatcher, subscribedPlaylistsViewModeltoLibraryUpdated, and added automatic startup database migration inLyracistDbEditor. LyracistDbEditorFixes & Enhancements: Fixed the Duplicate Detection action buttons (Remove SelectedandRemove All But Suggested) by moving<Grid Grid.Row="6">out of the<ListBox.ItemTemplate>so it binds toMainViewModel; added an editableGenrefield,Open Folder(explorer.exe /select), andDeletebutton to theEdit Track Detailscard (and song right-clickContextMenu); added aBackup DBsnapshot button (VACUUM INTO) in the top header bar andRemove Selectedin Orphaned File Audit; updatedScanSongMetadatato clearNeedsRepair = falseand remove resolved tracks fromNoArtistStore; batched FTS5 (RemoveSongsFromIndexBatch) andNoArtistStore(RemoveBatchAsync) deletions during bulk duplicate/orphan cleanup; and offloadedGenerateBook()andPickKeeper()disk checks to background worker threads.
- Replaced 145,000+ redundant
๐ฏ Trivia Suite Enhancements, Performance Optimizations & Bug Fixes (Lyracist.Trivia.Core, Lyracist.Trivia, TriviaDbCreator, KnockoutTrivia, Lyracist, KSRotation)
- Core Trivia Engine & Mobile Web Buzzer (
Lyracist.Trivia.Core,trivia.html,TriviaDisplayViewModel):- Eliminated Answer Validation & Live Countdown:
TriviaGameEngine.SubmitAnswerrejects out-of-range or already-eliminated answer indices (EliminatedAnswerIndices) and firesLeaderboardUpdatedon every valid submission so the host's live response distribution and answered count update immediately.GetSnapshot()exposes_eliminationCountdownSecondsandAnswerEliminationIntervalSecondsduringEliminatingAnswers, andtrivia.htmlpopulates the question prompt, 4 option labels, and timer bar for players joining or refreshing mid-elimination while keeping.btn-buzzerbuttons disabled when the game is paused. - Zero-Point Void Rollback & Team Updates:
VoidCurrentQuestion()accurately rolls backTotalCorrectusingPlayerQuestionAnswer.IsCorrecteven whenLastPointsEarned == 0, andRegisterPlayer()updatesTeamNamewhen rejoining with a new team name. - 1-Second Poll Optimization & UTF-8 Serialization (
TriviaWebServer):/api/trivia/stateonly computes_engine.GetGameResult(allPlayers)whenState == TriviaGameState.GameCompleteinstead of sorting players and teams on every 1-second poll across all states, and usesJsonSerializer.SerializeToUtf8Bytesdirectly. - Thread-Safe TV Display Sync (
TriviaDisplayViewModel):SyncWithEngine()readsEliminatedIndicesfrom an atomicGetSnapshot()copy instead of reading_engine.EliminatedAnswerIndicesdirectly off the UI thread.
- Eliminated Answer Validation & Live Countdown:
- Trivia Database Creator & Banner Studio (
TriviaDbCreator,TriviaBannerGenerator):- Question Editor Correct Answer Selection, Time Limit & Difficulty Filter: Bound Options A, B, C, and D
RadioButtons two-way (IsCorrectA,IsCorrectB,IsCorrectC,IsCorrectD) toEditorCorrectIndex, added aTime Limit (s)field (EditorTimeLimit) in the Question Editor, added aDifficultyFilterOptionsdropdown (All,Easy,Medium,Hard) andDifficultySummaryText(Easy: X | Med: Y | Hard: Z) in the Questions panel, and boundDistributionWarningvisibility toHasDistributionWarning. - Unlocked Banner Preview & Single-Pack Banner Generation: Loaded banner previews into an in-memory
BitmapSource(BannerImage) usingBitmapCacheOption.OnLoad+BitmapCreateOptions.IgnoreImageCache+Freeze()so.pngfiles inBanners/CategoryBanners/are never locked on disk, allowing๐จ Generate 16:9 Banner(TriviaBannerGenerator.GenerateBannerForPack(...)) to overwrite and immediately refresh the preview on screen. - CSV Bulk Import, Unsaved-Changes Protection & SQLite Question ID Cleanup: Added
๐ฅ Import CSV(ImportCsvCommand) to bulk-import questions from.csv/.txtspreadsheets (Prompt, OptionA, OptionB, OptionC, OptionD, Correct, Difficulty, Explanation) into the active pack, trackedHasUnsavedChangeswith a save/discard prompt when switching packs or closing the window, prevented duplicate Question IDs within a pack, and removed deleted/renamed Question IDs fromData/trivia.dbwhen saving a pack.
- Question Editor Correct Answer Selection, Time Limit & Difficulty Filter: Bound Options A, B, C, and D
- Knockout Trivia Standalone Game Show (
KnockoutTrivia):- Bundled Pack Wrapper Deserialization, Non-Trivia DB Exclusion & Custom Pack Import: Updated
TriviaDataService.LoadQuestionsFromPackFileAsyncto deserialize{ "PackId", "Questions": [...] }pack files withJsonStringEnumConverterandPropertyNameCaseInsensitive = truealongside raw question arrays, excluded non-trivia databases (lyracist.db,lyracist_*.db) in the sharedData/folder and verifiedQuestionstable existence before querying (HasQuestionsTableAsync/EnsureQuestionsTableExistsAsync), stripped legacylyracist.dbentries fromSelectedSourcePathson settings load, and added a๐ Load Packbutton in Settings for importing custom.jsontrivia packs directly from disk. - Live Settings Sync, Super Streak Wheel & Winner Determination:
SettingsViewModelpushes updates toIGameStateService.UpdateSettings, restartsKnockoutWebServeron port changes, and prioritizesSettings.QuestionTimerSeconds;WheelViewresetsCanSpin/HasSpun, stops the question timer duringSuperStreak, auto-spins and auto-resumes inAutomaticadvance mode, and provides aโถ CONTINUE GAMEbutton inManualmode;EvaluateSubmittedAnswers()defersSuperStreakReachedtransitions until all players are graded andCheckGameWinner()has verified no winner was already crowned;SubmitPlayerAnswerguards the 1-second auto-reveal delay against question advances;RecordPlayerAnswerprevents double-grading and repeated manual button clicks on the same question;CheckGameWinner()crowns the highest-scoring surviving player when the question limit is reached with automatic tie-breaking by lowest strikes and fastestAverageResponseTimeMs; andknockout.htmlreturns removed players cleanly to the Join screen instead of loopingtryRejoin(), restores locked-in answer states across page reloads, syncs strike haptics after game resets, and highlights leaderboard rows by playerId. - Built-In Game Show Sound Engine (
ISoundService/SoundService): Generates crisp in-memory PCM WAV sound cues (SoundPlayer) for the final 5-second countdown ticks, answer reveal chimes, wrong-answer strike buzzers, shield absorption deflections, prize wheel ticks, Super Streak fanfare, and winner fanfare, plusMediaPlayeraudio snippet playback forAudioClipquestions. - Answer Option Badges, Reveal Highlighting & Live Audience Vote Distribution (
QuestionOptionDisplay): Both the Audience TV (QuestionView.xaml) and Host Console (MainView.xaml) displayA/B/C/Doption badges, highlight the winning option in vibrant green on reveal with live audience vote counts and percentage bars (VoteCount (VotePercentage%)), and supportEnableSpeedBonus(+1 to +5 bonus points for fast answers), Category / Topic Filtering (SelectedCategory), Host๐ Revive(RevivePlayer), and Custom Static Banner selection. - Memory Leak, Deadlock & Zombie Process Fixes: Set
ShutdownMode="OnMainWindowClose"and closed hiddenAudienceWindowinstances on exit soKnockoutTrivia.exenever lingers as a background process holding port 8088; unsubscribedWheelViewSegments.CollectionChangedonUnloadedwithBitmapCacheonWheelCanvas; loaded static banner images withBitmapCacheOption.OnLoad+Freeze()without locking disk files; replaced synchronousDispatcher.InvokeinGetPlayersSnapshot()with non-blockingInvokeAsync; cached top-15/api/stateleaderboard projections (250ms TTL) and network IP resolution; pooled HTTP header buffers viaArrayPool<byte>.Shared; and enabledVirtualizingStackPanelacross playerItemsControllists.
- Bundled Pack Wrapper Deserialization, Non-Trivia DB Exclusion & Custom Pack Import: Updated
- Host Trivia Consoles in
Lyracist,KSRotation, andLyracist.Trivia:- Guarded
UpdateSelectedPacksPreview/UpdateTriviaCategoryPreviewwhile a game is running so checking packs for the next game never overwrites the live TV category header; added pre-game countdown quick controls (+1m,+5m,Reset,โฏ), dynamicProgressBar.Maximumscaling (MaxDistributionCount), andโ CORRECTbadges on the 4 host option cards inLyracistandKSRotation; debounced Trivia settings saves; live-restartedTriviaWebServerwhen the port changes; ensured clean UI-thread window and server teardown on exit (ShutdownTrivia/App.OnExit); and boundAppVersiondynamically to the executing assembly's build version (Assembly.GetName().Version) acrossLyracist.Trivia,TriviaDbCreator, andLyracistKeyGen.
- Guarded
๐ Holiday Rotation Screens, Color-Coded Venue Tabs & Enhanced MAUI Rotation Transmission (KSRotation, KSRotation.Maui, Lyracist)
- Enhanced MAUI Rotation Screen Transmission (
KSRotation.Maui,billboard.html,BillboardView.xaml):KSRotation.Mauitransmits rich audience rotation screens across Chromecast (MauiCastingService), Smart TV browsers (billboard.html), and wired HDMI / wireless secondary displays (SecondaryDisplayService+BillboardView.xaml), now including:- Holiday Rotation Screens: Floating seasonal characters with palette glow halos, vignette tint, ground fog, and
Auto (by date)resolution controllable directly from the MAUI Billboard bar and Cast dialog. - All 12 Themed Rotation Views: Live View Mode switcher (
Normal List,Star Wars Crawl,Vegas Marquee,Vinyl Turntable,Disco Ball,Synthwave Grid,Concert Festival Lineup,Casino Slot Reels,Jukebox,Stadium Jumbotron,Movie Theater 'Now Showing',Purple Velvet Curtain) plus Scaryoke๐ {Category}challenge badges on Current Performer, Up Next, and Upcoming Queue rows. - Live Scaryoke Wheel Spin Projection: Spinning the wheel on the MAUI tablet (
ScaryokeWheelPage) broadcasts live spin physics and winner reveal to both Chromecast/web TVs (billboard.html) and HDMI secondary displays (BillboardView.xaml).
- Holiday Rotation Screens: Floating seasonal characters with palette glow halos, vignette tint, ground fog, and
- High-Contrast Color-Coded Navigation & Page Tabs (
Lyracist): All 14 top navigation bar tabs (MainWindow.xaml) and allTabControlpage tabs (SettingsPage,KaraokePage,RotationPage,UsersPage,OccasionSearchWindow,SingerSettingsWindow) feature distinct, color-coded backgrounds, contrasting borders, crisp white text, hover brightening, and an illuminated bottom active indicator bar (LyracistTheme.xaml) so individual tabs are immediately distinguishable in dark venues. - Shared Seasonal Holiday Rotation Screens (
HolidayThemes.cs,HolidayOverlayEffect,SingerDisplayWindow,RotationWindow): Adds a seasonal vignette, drifting ground fog, and floating full-color Twemoji characters with holiday-paletteRadialGradientBrushglow halos over the audience rotation display in bothKSRotation(SingerDisplayWindow) andLyracist(RotationWindow) across all 12 projection view modes (Halloween, Christmas, Thanksgiving, New Year's, Valentine's Day, St. Patrick's Day, Easter, Mother's Day, Father's Day, Independence Day, Memorial Day, Labor Day, Veterans Day, and Brenda's Birthday on Nov 1), plusOffandAuto (by date). - Late-Night Show Date Resolution:
Automode treats hours between midnight and 6:00 AM as part of the previous evening's show (HolidayThemes.ShowDate) and re-evaluates every 15 minutes in bothDisplayWindowService(KSRotation) andDisplayService(Lyracist) so late-night karaoke gigs crossing midnight keep their active holiday theme through the end of the show. - GPU-Cached & Reduced-Effects Friendly: Shared
HolidayOverlayEffect(Shared/ProjectionEffects.cs) usesBitmapCacheon fog, vignette, and particle containers, replaces per-particleDropShadowEffectpixel shaders with frozenRadialGradientBrushhalos, respectsReducedEffects, sits below the patron QR code overlay (ZIndex=95), and automatically suspends timers and animations while full-screen overlays (Scaryoke Wheel, Last Song Banner, Pre-Show Invite) cover or hide the rotation display. - Scaryoke Curse Round, Fortune Readings & Lightning Reveal (
KSRotation): Optional Curse mini-spin after category landing, Fortune-Teller readings on the audience wheel card, white lightning strobe + shake on DJ's Choice landings, and a pulsing red cursed frame around the rotation screen while a cursed performer sings.
๐ Scaryoke Mode: Post-Spin Category Reveal, Auto-Clearing Badges, & Monitor Routing (KSRotation, Lyracist, dj.html)
- Strict Post-Spin Category Assignment & Live Reveal: Categories are never pre-assigned to performers in advance. Challenge categories are assigned and revealed only AFTER the Scaryoke Wheel completes its spin animation and lands on a slice. While the wheel is in motion, all audience and stage displays show "SPINNING..." to build suspense.
- Category Badges Across All Rotation Screens & Themed Views (
KSRotation,Lyracist): Once the wheel lands and assigns a challenge, the performer receives an eye-catching, color-coded๐ {Category}badge across all rotation screens, queue rows, and venue projection displays in both KSRotation and Lyracist. Displayed for Current Singer and Next Singers across all 11 themed projection panels (Normal, Marquee, Curtain, Jumbotron, Vinyl, Disco, Synthwave, Festival, Slot Reels, Jukebox, Scoreboard), Star Wars 3D crawl perspective scroll, and host DJ consoles (Rotation Page and Karaoke Page queue rows). - Performer Challenge Badge Auto-Clearing: As each singer finishes their performance and is marked finished/done, their assigned Scaryoke category challenge badge and wheel color automatically clear until their next spin, keeping queue cards and billboard lists completely clean during wait periods.
- Dedicated Audience Wheel Monitor Routing (
KSRotation): Added an 'Audience Wheel Display & Monitor Routing' configuration panel in the KSRotation Scaryoke Settings tab, allowing the DJ to select the physical monitor or projector to display the Scaryoke Wheel for the audience, with device persistence across re-scans and an instant 'Identify' button. - Display Page Column Layout Optimizations (
KSRotation): Screen Rotation column narrowed from 1.0x to 0.7x to eliminate excess whitespace on standard 1920x1080 screens, while Columns 3 & 4 (DJ & Special Event Banners) are expanded to 1.25x each (+25% width), with clean vertical alignment of the 'Upload Banner' and 'Add Event' buttons to prevent any truncation or overlap. - Primary Toolbar Spin & Singer Execution: Clicking
๐ฒ Spinon the main toolbar immediately executes the spin for the currently selected performer. Clear all and individual category reset options remain available on the toolbar and singer row context menus. - Multi-Singer & Entire Rotation Sequential Targeting: Full ability to target multiple singers (
Next 3,Next 5,Next 10) or theEntire Rotationat once from the toolbar (โก Multi-Spin โพ), context menu, Scaryoke Controller window, and remote mobile DJ board (dj.html). The wheel spins sequentially for each targeted singer one after another, building excitement and assigning/revealing their category ONLY as each spin lands. Includes an in-flightโน Stopbutton on the controller and toolbar (CancelBatchSpin) allowing hosts to halt multi-singer spinning at any point. - Dual Spin Execution ("Booth Spin" vs "Project Spin"):
- Booth Spin (Quiet / Host Only): Performs a fast spin on the host laptop or DJ tablet (
dj.html) and assigns the category challenge to the selected singer upon completion without interrupting the live rotation display. - Project Wheel Spin (Audience Projection): Displays the full, high-energy animated roulette wheel overlay on the audience projection monitor with target singer callout banner, realistic deceleration physics, ticking sound effects, and fanfare, followed by an automatic 4.5-second reveal dismiss timer returning smoothly to the live rotation queue.
- Booth Spin (Quiet / Host Only): Performs a fast spin on the host laptop or DJ tablet (
- Host Console & DJ Remote Tablet Integration: Added target singer selection dropdowns, inline
๐ Spinrow buttons, right-click context menu options ("Spin for Singer (Booth / Quiet)", "Spin & Project to Screen", "๐ Scaryoke: Set Category Manually...", "โ Clear Scaryoke Challenge", "โ Clear All Scaryoke Challenges"), clickable๐ {Category}badges, manual category assignment inScaryokeControlWindow,ScaryokeWheelPage(MAUI),EditSingerWindow/ScaryokeWindow(Lyracist), and full remote DJ web portal synchronization viadj.html(๐ Setbutton, clickable badge modal, Add Performer optional challenge field, and Scaryoke Station manual category bar).
- Universal Special Event Overlay Projection: All active special event banners (Birthday, Wedding, Engagement, Anniversary, Last Song / Final Singer, Announcement, Connect Instructions, and Custom Events) automatically project as high-visibility full-screen overlays directly on the rotation display screen (
SingerDisplayWindowin KSRotation,RotationWindowin Lyracist). - Host Console Live Banner Preview & Full-Screen Viewer: Added an interactive 'Active Banner Live Preview' card with thumbnail preview and single-click full-screen launcher (
๐๏ธ Full Screen) inside the DJ & Special Event Banners settings tab on the host computer, ensuring the host can visually verify active graphics without looking at the venue monitor. - Instant Activation & Reversion: When a special event is activated by the host on the laptop or remotely by the DJ on
dj.html, the audience rotation screen transitions immediately to the event banner. Clearing the event or selecting "None" instantly dismisses the overlay and restores the live rotation billboard. - Dynamic Personalization with Real-Time Cache Bypassing: Custom celebratory messages and personalized birthday celebrant banners render on the fly and decode with
BitmapCreateOptions.IgnoreImageCache, guaranteeing newly composed graphics display instantly without stale frame caching. - Automatic Asset Deployment & Placeholder Fallbacks: Standard pre-packaged event banners under
Banners/EventBanners/are automatically packaged with application builds, with automatic procedural fallback generation if any file is missing at runtime.
๐ง Single DJ Name Entry & "Guest DJ" Default Across Apps (KSRotation, Lyracist, KSRotation.Maui, KnockoutTrivia)
- Simplified Single DJ Name Entry in KSRotation: Replaced the multi-DJ ListBox and Add/Remove buttons in the KSRotation Settings tab with a clean, single "DJ / Host Name" entry field (
TbDjName). Streamlines the settings layout and eliminates redundant list management. - Universal "Guest DJ" Fallback: Across KSRotation (WPF & MAUI), Lyracist, and KnockoutTrivia, the DJ/Host name defaults to
"Guest DJ"whenever none is entered or when the entry is cleared. - Synchronized Display & Title Updates: DJ/Host name changes update active TV billboards, crawler banners, rotation reports, and live window title indicators seamlessly.
- Dedicated Scaryoke Settings Tab: Added a dedicated 'Scaryoke Settings' tab in the Settings page, isolating wheel configuration, custom styling, probability rules, and audience overlay monitor routing into a balanced, clean 3-column view.
- Removed Redundant Duplicate Boxes: Removed duplicate 'Rotation & Queue Rules' and 'Wait Times & Durations' sections from the Scaryoke tab that duplicated controls on the Presentation and Display tabs.
- Target Audience Overlay Monitor: Added target overlay monitor selector under Audience Display & Overlay. Allows KJs to choose which monitor displays the live Scaryoke roulette wheel overlay (Rotation Billboard screen, Lyrics screen, DJ Banner screen, or any specific connected display device) with live test launch button.
- Max 11 Categories: Expanded the Scaryoke Wheel category capacity from 8 to 11 categories across settings persistence, category management, presets, and validation.
- Distinct 12-Color Scaryoke Palette (
KSRotation,KSRotation.Maui,Lyracist,ScaryokeWheel,dj.html): Each Scaryoke category is assigned its own distinct color from a 12-color high-contrast palette (#7C3AEDRoyal Purple,#FF6D00Blaze Orange,#0284C7Sky Blue,#DC2626Crimson Red,#0D9488Emerald Teal,#D97706Golden Amber,#DB2777Hot Pink,#2563EBCobalt Royal Blue,#65A30DAcid Lime Green,#C026D3Fuchsia Magenta,#B45309Copper Bronze,#4338CADeep Indigo) with collision-free auto-color assignment (PickDistinctPaletteColor) so no two categories on the wheel ever share the same color. BothKSRotationandLyracistinclude a 12-swatchChoose Palette Colorpicker in Settings alongsideSet ColorandAuto Color, anddj.htmlrenders each manual quick-pick category chip in its distinct category color. - Category Custom & Automatic Color Selection: Added option to assign custom slice colors from the 12-color palette or leave unassigned to use collision-free automatic app-assigned palette colors ("Auto by App") with a dedicated 'Auto Color' reset command and status indicator. Slice weight multipliers (1x, 2x, 3x) can also be customized.
- Wheel Rule Toggles: Integrated configurable toggles for including DJ's Choice slivers (
ScaryokeShowDjsChoice), Singer's Choice segment (ScaryokeShowSingersChoice), and duplicate spin prevention (ScaryokeAvoidRepeats). - Independent Display Page Column Scrolling: Converted all 4 columns on the
Displaysettings tab into independently scrollable panels (ScrollVieweron columns 0, 2, 4, 6), resolving content truncation issues on laptop displays and standard 1920x1080 screens with Windows display scaling (125%/150%).
โ Skipped Rotation Anchor Performer Rollover Restoration & Queue Bottom Prevention (KSRotation, Lyracist)
- Round-Scoped Skip Reset: When a performer is skipped (including the rotation anchor holding
IsRotationStart), the skip is strictly scoped to the active round. When the rotation advances and the round completes (crossing or reaching the rotation anchor), allIsSkippedflags are automatically cleared before choosing the next performer or evaluating floating queue positions. - Queue Bottom Prevention in Floating Mode: In floating mode (
FloatCurrentSingerToTop), an anchor singer who was skipped in the preceding round is restored to full active eligibility immediately when the final performer finishes. They are retained at index 0 and promoted to Current instead of being mistakenly treated as skipped and flushed to the bottom of the active queue. - Accurate On-Deck and Wait-Time Calculations: As the final singer of a round performs,
MarkNextSingerandRecalculateEstimatedWaitsrecognize that reaching the anchor initiates the new round, accurately highlighting the anchor singer as Up Next (IsNext) across laptop, projection, remote DJ, and billboard screens.
- Direct Singer Rotation Integration: KJs can launch the Scaryoke Wheel directly from the primary Rotation toolbar using
[๐ Scaryoke]. The wheel overlay onSingerDisplayWindowtakes highest Z-index precedence over any other display screens, bringing the audience view forward and immediately displaying the spinning wheel for the current performer. - DJ Booth Singer Spin Station (
dj.html): When Scaryoke is active, the DJ tablet screen provides dedicated๐ฒ Spin Wheelcontrols and a high-energy booth modal with a giant "๐ฒ TAP TO SPIN! ๐" button. Singers can walk right up to the DJ booth and spin the wheel themselves, and the live spinning wheel executes with full physics and audio on the host's laptop and the big audience projection screen without needing heavy canvas rendering on the DJ tablet. - Synchronized Real-Time Physics: Audience screens and the host control window animate their wheel rotation synchronously using identical cubic ease-out deceleration physics and audio cues.
- Consecutive Duplicate Prevention Across Shutdowns: Includes a toggle across
ScaryokeWheel,KSRotation,Lyracist, andKSRotation.Mauito ensure no two singers in a row land on the exact same challenge. Past spin results persist across wheel dismissals and app shutdowns, allowing duplicate prevention to stay active when the next singer steps up. Spin past history automatically clears when the rotation queue is cleared or nightly reports are saved.
- DJ's Choice Sliver Toggle: Added a toggle switch in Settings allowing KJs to enable or disable the two thin black "DJ's Choice" slivers independently from Singer's Choice. When turned off, custom categories and optional Singer's Choice distribute evenly across the 360ยฐ wheel without DJ's Choice interruptions.
- Dual-Monitor Audience Projection: Full support for running the wheel in a dual-monitor live show environment. KJs can click
[๐บ Audience Screen]to open a synchronized, full-screen projection window on an external projector or secondary monitor while keeping the primary control window and Spin button right in front of them on their laptop. - Synchronized Spin & Animation Engine: When the host clicks Spin on their laptop, the audience projection window executes the exact same physics-based deceleration curve, flashing tick lights, segment highlights, and DJ's Choice reveal animations in frame-accurate real-time lockstep.
- Dynamic Monitor Detection: Leverages
MonitorEnumeratorto automatically discover secondary monitors and projectors upon HDMI hot-plug, allowing seamless selection from the title bar or settings.
- SkiaSharp Vector PDF Engine: Replaced PDFsharp across all production projects (
KSRotation,Lyracist.Data,KSRotation.Maui) with SkiaSharp's native vector PDF generation API (SKDocument.CreatePdf). Completely avoids license traps, commercial verification exceptions, or third-party paywall transitions (The loaded license is not validintroduced in PDFsharp 6.5.0+). Both end-of-night rotation reports inKSRotationand printable song catalogs inLyracistrender with high-fidelity vector styling, custom borders, table formatting, and automatic pagination.
- Zero-Polling Windows Event Listener (
MonitorEnumerator): Statically listens to native Win32/WPFMicrosoft.Win32.SystemEvents.DisplaySettingsChangednotifications with an automatic 250ms debounce and UI dispatcher marshaling, completely eliminating periodic monitor polling overhead. - Synchronized In-Memory Cache: Monitor enumeration calls (
EnumDisplayMonitors) are served from an in-memory cache that updates only when display topology, resolution, or cable connections change. - Instant Hot-Plug Detection Across All Apps: Connecting or disconnecting an HDMI cable, stage TV, or projector immediately updates the monitor dropdowns in
Lyracist(SettingsPageandKaraokePage),KSRotation,KnockoutTrivia,LyracistTrivia, andScaryokeWheelwithout restarting the app or manual refreshing. - Event-Driven DJ Banner Monitor Cap: Replaced 30-second timestamp cache polling in
DjBannerWindowViewModelwith event-driven invalidation.
- Balanced 4-Column Distribution: Rebalanced GroupBox cards across 4 columns in
Audio & Engine,Library & Ratings,Display, andPresentation & DJtabs so settings fit cleanly on screen without vertical scrolling on standard laptop and 1080p monitors. - Audio & Engine: Distributed GroupBoxes into dedicated columns (Col 0:
Audio & Equalizers, Col 2:Performance Recording, Col 4:Decoders & Layout, Col 6:APIs & Logins), eliminating the single-column vertical pileup in Column 0. - Library & Ratings: Distributed GroupBoxes across columns (Col 0:
Music Library, Col 2:Tablet Server&KSRotation Sync, Col 4:Performer Ratings, Col 6:Test Mode), ensuring music library maintenance and tablet server settings are immediately visible without scrolling. - Display: Moved
Lyrics Screen Audio VisualizerandNew Performer Welcome Screento Column 4, leavingMonitors & Screen Assignmentsdedicated in Column 0, and removed test background styling. - Presentation & DJ: Moved
Auto-Advance Countdownto Column 4, leavingDJ & Venue Managementin Column 2 andTheme & Appearancein Column 0.
- Dynamic Drive Letter & Subfolder Probing (
SongPathResolver): Automatically probes all connected logical drives and subfolders (Music/,Karaoke/, etc.) when loading or playing tracks, seamlessly resolving songs even if the physical drive letter shifted (e.g. historicalE:\scan mounted asF:\Music\orF:\Karaoke\). - Selection Priority in Main Transport Play: In
KaraokeViewModel.Play(), user selection (SelectedSongin library orRotation.SelectedSingerin rotation) takes absolute precedence over generic auto-play logic, allowing the host to select any song or performer and immediately start playback. - Missing File User Diagnostics: Replaced silent failures with explicit warning dialogs if a media file cannot be found across any drive, maintaining player state integrity.
- EmptyStringToVisibilityConverter Resource Resolution: Added
NotEmptyToVisibilityConverterandEmptyStringToVisibilityConverterresource definitions in both SettingsPage.xaml and App.xaml, eliminating theXamlParseException("Cannot find resource named 'EmptyStringToVisibilityConverter'") when loading or opening Settings. - RedSettingsGroupBoxStyle Resource Resolution: Defined
RedSettingsGroupBoxStyleand accompanying red theme header/body/border brushes inSettingsPage.xamlso navigation to or instantiation of Settings loads cleanly withoutXamlParseException. - Progress Bar / Seek Slider Zero-Duration Handling: Added
DurationSliderMaximum(Duration > 0 ? Duration : 1.0) toKaraokeViewModeland bound the transport seek slider inMainWindow.xamlto it. Prevents the WPF slider from drawing 100% full whenDuration == 0andValue == 0. - LibVLC Clean Playback Initialization: Resolved silent playback start failures by using clean
new Uri(path)media instantiation inLibVlcVideoBackendwithout unawaited native background parse operations that conflicted with immediate_mediaPlayer.Play(). - Main Transport Play Command: The primary Play button now checks active rotation status, selected performer requests, and selected library songs in addition to
SelectedSongPath, preventing the player from failing to start when a performer track is queued in the rotation. If paused mid-track, it resumes cleanly; if a rotation singer or music track is ready, it loads and plays their song; if an audio track is loaded without explicit video, it starts playback and notifies show flow. - Projection Screen Lyrics Fallback Display: Lyrics screen (
LyricsWindow) now dynamically updates fallback text to display the current track's artist and title during playback for audio and music tracks (instead of remaining stuck on"Lyracist โ Ready"). Reverts back to"Lyracist โ Ready"when stopped. - Filler Music Ducking on Playback: Synchronized background music ducking (
_showFlow.OnKaraokeTrackStarted()) across all playback pathways including direct transport play and performer request playback.
- Lockup & Task Storm Prevention: Prevented application freeze caused by infinite dispatcher task recursion during rotation music auto-advance (
AutoPlayRotationMusicwith 0s delay). Re-entrant triggers are safely guarded, the player checks current playback state, and current singer identity is strictly evaluated by object reference. - Custom Performer Assignment for Music: Music tracks can now be assigned to specific performer names (existing or new) rather than forcing an anonymous "Music Request" title. Assigning a music track to an existing rotation performer without a song populates their current turn with
IsMusic = true; assigning to a performer who already has a song enqueues it to their pending song buffer, properly preservingIsMusicacross turn completion. If no performer name is specified, it gracefully defaults to "Music Request". - Music Library Direct Play & Transport Controls: Each music track row in the Music Library provides a dedicated
Playbutton and supports double-clicking to start playback immediately. Selecting a music track also primes the main transport controls, allowing the primary Play button to load and play the track. - Rotation Queue Playback: Performer entries in the rotation queue support double-clicking to load and play immediately (
LoadAndPlaySelectedPerformerCommand), working seamlessly for both singers and music tracks.
- Per-Track Loudness Leveling: Filler music playback now normalizes volume per track using EBU R128 integrated loudness metrics (
MeasuredLoudnessLufs) based on the standardnormFactor = 10^((target - measured)/20)clamped 0..200, matching the primaryMediaEnginebehavior. Adheres strictly toNormalizeVolumeEnabledand is safely bypassed in Hardware Mixer Mode. The applied gain is limited to roughly -16 dB..+10 dB so a mis-measured track can't blast or vanish. - Configurable Crossfade & Max Track Duration Automix: Hosts can set crossfade length from 1 to 15 seconds (default 5s) and configure maximum track play duration (
FillInMaxTrackSeconds, e.g. 180s for 3-minute automixing) to keep background energy fresh without letting long tracks drag out. Short track guard protects tracks shorter than twice the crossfade duration from premature cutting. - Cue-Point Aware Mixing: Tracks with detected
MixInMsandMixOutMsautomatically start playback skipping leading silence and trigger crossfades into the next track atMixOutMs - crossfaderather than the physical file end. Cue points are read once per track (cached per playlist load), the mix-in is applied as a LibVLC start-time option, and implausible mix-out points (past the end or too early) are ignored. Elapsed-time automix has a 30-second floor so a mistyped value can't cycle tracks every few seconds. - Smart Shuffle: Automatically selects the next filler track matching the current song's BPM within ยฑ8% tolerance (with half/double tempo folding), enforcing artist variety and preventing recent track fatigue.
- 16-Pad Hardware-Accelerated Soundboard: Built-in 4x4 matrix for sound effects, DJ drops, applause, and intro jingles using low-latency NAudio WASAPI output with multi-clip overlapping playback and master Stop All control.
- Low-Latency RAM Caching: Audio clips are preloaded into memory as 32-bit floating-point PCM buffers for instantaneous playback without disk latency. Clips are capped at 60 seconds each so 16 pads can never exhaust RAM, decoding has a 30-second timeout, and the audio render path is allocation-free.
- Drag-and-Drop & Customization: Drag audio files directly from Windows Explorer onto any pad to assign. Right-click pads to customize labels, button colors, and volume levels or clear assignments.
- Automated Fill-In Ducking: Filler background music automatically ducks when any sample or jingle pad is triggered and smoothly restores volume when all clips stop playing (retriggering a pad that is still sounding does not release the ducking early).
- Quick Keyboard Triggers: Dedicated F1-F12 hotkeys trigger pads instantly from anywhere in the window. Hotkeys are automatically suppressed whenever a text box has input focus, and are active from application startup (you do not need to open the Sample Pad page first). An existing app hotkey on the same key takes priority over a pad.
- Configuration Persistence: Pad assignments and colors are saved in
Settings/samplepad.json.
- USB Mixer & Windows Audio Input Capture: Directly records master stereo mixes from USB mixers (such as Yamaha MG10XU) or dedicated recording inputs via shared NAudio
WasapiCapturestreaming to disk. - Per-Singer Consent Gating: Disabled by default. Only performers with the per-singer opt-in flag checked (
AllowRecordingin singer profiles) are recorded, ensuring singer consent and compliance with venue recording policies. - Automated Lifecycle Synchronization: Recording automatically arms and captures only during active karaoke performances driven by
MediaEngine(ignoring filler music and sound effects). - Background MP3 Processing & History Tracking: Short takes (< 10 seconds) are automatically discarded. Valid recordings are encoded to MP3 via FFmpeg in the background, registered in the
PerformanceRecordingsdatabase, and tagged by singer and timestamp. Files are saved asData\Recordings\<local date>\<Singer> - <Title>.mp3; a repeat take of the same song becomes... (2).mp3instead of overwriting, and pausing/resuming a song stays one take. Recording continues about a second after the song ends so the last note is not clipped. The WAV is finalized before encoding, and if the encode fails or the app closes mid-encode the WAV is kept and finished automatically at the next startup. - Retention & Safe Storage: Configurable retention pruning (
RecordingRetentionDays, default 30 days) and automatic disk-space protection halting recordings if available disk space falls below 500 MB. - DJ Monitoring & Playback Controls: Settings page features an audio input picker, real-time VU meter, 5-second test clip recorder, and singer profiles contain a dedicated "Recorded Performances" history list for playback, opening storage folders, and deletion. An on-screen "REC" indicator signals active recording. The VU meter understands the usual WASAPI float format as well as 16/24/32-bit PCM inputs.
- Pure Managed BPM Audio Analysis: High-performance onset-strength envelope and zero-mean normalized autocorrelation analyzer detecting track tempo folded into 70-180 BPM with peak confidence validation and noise rejection.
- Silence & Cue Detection: FFmpeg
silencedetectaudit identifies leading silence (MixInMs) and trailing silence (MixOutMs) for seamless gapless automix transitions. - Library Health Audit Integration: Added "Missing Filler BPM" tracking and automated background analysis audit alongside existing loudness and duplicate diagnostics. BPM and cue-point analysis is limited to songs that are in the Opening, Fill-In, or End-of-Rotation playlists (analysis decodes audio, so it is not run across the whole library), tracks with no silence to cue on are marked so they are not re-decoded on every audit, and cancelling an audit stops the running ffmpeg process.
- Library Folder Management: Add, remove, and rescan library folders. Removing a folder removes only the songs that belong to it (case-insensitive; never a sibling folder sharing a prefix, and never songs still owned by another registered folder) and clears their search-index entries. This routine is shared with Lyracist (
Lyracist.Data/Services/LibraryMaintenanceService.cs), so both apps behave identically. - Automatic Safety Backups: Before any bulk destructive operation (Remove Directory, Remove All Orphaned Entries, Remove All But Suggested duplicates, Rename Files), the database is snapshotted to
Data\Backups\lyracist_<timestamp>_<operation>.db(newest 10 kept). Bulk deletes show the affected song count before asking for confirmation. - Library Health Tab: Duplicate detection with a suggested keeper per group (file exists, longest duration, largest file) plus one-click "Remove All But Suggested"; an orphaned-file audit that skips drives or shares that are not currently mounted so an unplugged external drive is never mistaken for deleted files; and a queue-readiness/loudness backlog audit.
- Safe Metadata File Renamer: Renames audio and zip files to match their Title tags (keeping companion
.cdgfiles and the database in sync). A Preview button lists every planned rename without changing anything, and repeated runs no longer re-rename already-correct files. - Careful Editing: Titles and artists are trimmed and validated on save, proper-casing applies only to fields you changed (with an opt-out checkbox for names like "AC/DC"), and confirmations appear on a non-blocking status line instead of modal pop-ups.
- Paged Browsing: Browse mode loads 100 songs at a time with "Showing N of M" and a "Load more" button.
- Operation Safety: Only one of the metadata scan, rename, and readiness audit can run at a time; background scans are cancelled when the window closes.
- Scan Reliability, Fast-Path Rescans & Standalone
noartist.db(sharedScanningService): A library rescan never removes songs from unmounted drives, persists updates across every 200-file batch, and no longer overwrites tag-resolved or hand-edited artists with filename guesses. Lyracist's own scans now run one at a time (extra requests are queued) and are cancelled cleanly on exit. In addition, existing cataloged files and tracks flagged withNeedsRepairskip disk I/O, regex parsing, and companion.cdgchecks, allowing newly added tracks to be indexed into large collections in seconds without re-probing known or tagless files. Tracks missing artist metadata are also mirrored into a separateData/noartist.dbSQLite database; even iflyracist.dbis deleted or reset, cold scans read known unresolvable files fromnoartist.dband avoid wasteful TagLib / FFprobe re-probing.
- Focus-Based Welcome Triggering: Replaced the legacy 2.5-second settle timer after typing with immediate welcome screen activation triggered when the singer name text box loses focus (
LostFocus). - Typing Interruption Prevention: Guarantees that the "Welcome to our new performer" screen only appears once the host has completely finished typing the performer's name and moved away (via Tab, Enter, or mouse click), preventing unwanted popups mid-keystroke.
- Direct Drag-and-Drop Positioning: Hosts can grab and move performers anywhere in the active rotation queue using the mouse to instantly reposition performers, accommodate singers temporarily stepping away, or adjust queue pacing. (Remote DJ screens retain standard button controls and do not require mouse dragging).
- Dedicated Drag Grip Handle (
โฎโฎ): Each performer row in both KSRotation and Lyracist features a dedicated drag grip handle on the left with a 4-way move cursor (SizeAll) and tooltip hint ("Drag to reorder singer in rotation"). - Protected Input Controls: Textboxes (Name, Duet Partner, Song, Artist) and buttons/checkboxes remain protected for normal clicking, typing, and editing without accidental drag initiation. Dragging from the grip handle or row background smoothly initiates reordering.
- Intelligent Midpoint Precision: Dropping on the top half of a performer row inserts the dragged singer directly above that row; dropping on the lower half inserts them directly below. Dropping into empty list space below the queue automatically moves the singer to the end of the rotation.
- Boundary & Partner Protection: Inactive performers cannot be dragged into the active queue partition, and active performers cannot be dragged into the inactive section. Linked duet partners are automatically kept adjacent via
EnforceLinkedAdjacency. - Full Live Synchronization: Dropping a performer immediately recalculates estimated wait times, updates next-performer highlights, refreshes audience billboard projection displays, updates rotation JSON caches for mobile devices, and saves changes to the database.
๐งช Test Mode Settings GroupBox & Performer Count Options (3, 5, 10, 15) (KSRotation, Lyracist, KSRotation.Maui)
- Dedicated Test Mode GroupBox (GBX): Test Mode settings are now segregated into their own GroupBox, separating testing workflows from operational session controls like duplicate song blocking.
- Configurable Performer Counts: Select from 3, 5, 10, or 15 sample performers to match test scenarios (3 for quick audio checks, 5 for rotation handoffs, 10 for multi-round pacing, or 15 for full billboard capacity).
- Curated 18 Performer Pool: Replaced legacy test names with 18 realistic performers: Brenda Bumps, James Smith, Raymond Carter, Sharon Roberts, Ami Anderson, Ali Davis, Randy Davis, Larry Strickland, Robert Roberts, Cynthis Nix, David Wayne, Danny Hinnant, Cerrina Culbert, Julia Stanton, Carol Henderson, Joe Bob Briggs, Craven Counts, and Dennis Starling.
- Randomized Seeding & Popular Songs: Each test generation shuffles and pairs names with popular hits from the curated song pool, preventing predictable or repetitive queue layouts.
- Instant "Load Test Singers Now": Populate or refresh test queues with a single click at any time without restarting the application.
- Automatic Orphan Row Pruning: Clicking "New Singer" inserts a new performer with the default placeholder "New Singer" selected for typing. If the host shifts focus or clicks elsewhere without altering the placeholder or typing a name, the unused row is instantly and silently deleted from the rotation without requiring a confirmation dialog.
- Smart Placeholder Stripping: If the user types a name without clearing the default text (e.g., typing "New Singertom", "New Singer Tom", or "Tom New Singer"), the application automatically removes the "New Singer" token and any surrounding delimiters, extracts the intended name ("Tom"), and applies intelligent proper-casing.
- Smooth Traversal & Keyboard Workflow: Hitting the Enter key in the singer name text box commits the sanitized name and advances focus to the next field (e.g., song title).
- Strict Single-Instance Execution: Every application across the suite (
Lyracist,KSRotation,KnockoutTrivia,Lyracist.Trivia,ScaryokeWheel,TriviaDbCreator,LyracistDbEditor,LyracistKeyGen) enforces a single instance per Windows user session. - Conflict Prevention: Completely prevents duplicate processes, database locking collisions, audio device loopback contention, and web server port conflicts (such as port 8080 or tablet lyrics servers).
- Auto-Restore & Foreground Activation: Launching a second instance never creates duplicate UI or processes; instead, it automatically locates the existing running window, un-minimizes/restores it if minimized, attaches thread inputs, and brings it directly to the front before exiting silently.
๐ฅ Duet Partner Remote Sync & DJ Tablet Display (KSRotation, dj.html, billboard.html, kiosk.html, PatronPortal.html)
- Complete Duet Synchronization: Duet partners added or edited on performers in KSRotation desktop immediately synchronize across the rotation cache, audience display screens, remote DJ tablets, and patron web portals.
- Dual-Property Compatibility:
RotationItemDtoand JSON rotation cache feeds provide bothpartnerandduetPartnerNamefields, and web remotes evaluateduetPartnerName || partner(andpartner || duetPartnerNameon billboards) for rock-solid cross-compatibility. - Instant Grid Invalidation: Editing a duet partner in the desktop rotation grid immediately triggers cache rebuilding, database dirty state tracking, and live TV screen updates via
Singer_PropertyChanged. - Inter-App Lyrics Server & Service Sync:
TabletLyricsServerandKSRotationSyncServicepropagate duet partner names across live tablet lyrics and inter-application synchronization.
โฉ Clear "Last Round Done" Flag & Restore Performer (Lyracist, KSRotation, KSRotation.Maui, dj.html)
- Accidental Finish Recovery: When managing the final round of the evening, a performer marked finished by mistake can now be instantly restored to the active queue without having to reset or recreate the entire round.
- Interactive Singer Badge: The "DONE (LAST ROUND)" indicator is an interactive clickable button badge (
DONE (LAST ROUND) โ). Clicking or tapping it on any singer row clears theHasSungInLastRoundflag immediately. - Instant Rotation Recalculation: Removing the flag immediately restores the singer's eligibility as the Next Performer (
IsNext), recalculates cumulative wait times and round duration estimations, and refreshes the full-screen audience rotation billboard. - Multiple Touchpoints Across All Apps:
- Lyracist (WPF): Click the red badge directly on the singer row, select "โฉ Clear 'Last Round Done' Status" from the singer row context menu (on either the Rotation or Karaoke control pages), or uncheck "Completed in Last Round" in the Edit Singer window.
- KSRotation (WPF): Click the red badge on the rotation row or right-click the performer and choose "โฉ Clear 'Last Round Done' Status".
- KSRotation.Maui: Tap the red badge on the performer card or edit the singer and uncheck "Done in Last Round".
- Remote DJ Web Portal (
dj.html): Mobile DJs managing the floor can tap the redDONE (LAST ROUND) โbadge directly from their phone or tablet to restore performers remotely.
๐ Lyrics Screen Audio Visualizer & "Adjust Synth Display" DJ Controls (AudioSpectrumService.cs, AdjustSynthDisplayWindow.xaml/.cs, LyricsWindow.xaml, KaraokePage.xaml, SettingsPage.xaml)
- Non-Audience DJ Controls ("Adjust Synth Display"): Dedicated "๐ Adjust Synth Display" buttons on the DJ's primary
KaraokePage(on the top playback strip, above the Lyrics Preview Monitor, and under Multi-Monitor Display controls) open a modal settings dialog centered over Lyracist without ever interacting with or interrupting the audience-facing projection display during a live performance. - Interactive Live Preview Dialog: The popup window provides instant real-time adjustment of enable state, motion mode, 7 color themes, 4 bar widths, opacity slider with quick presets, and an animated live preview canvas showing simulated bars before saving.
- Persistent Recall: All changes immediately update
appsettings.jsonand persist across application restarts. - Real-Time WASAPI Loopback FFT: Native Windows Core Audio loopback engine captures master playback audio with 1024-point Radix-2 FFT decomposition across logarithmic frequency bands (32 Hz to 16 kHz), reacting physically to real bass kicks, vocals, and instruments with dynamic high-frequency tilt pre-emphasis.
- Simulated & Ambient Motion Mode: Switch to simulated mode for rhythmic volume-scaled movement during playback and gentle ambient breathing when paused without active loopback recording.
- 7 Visual Themes & Gradients: Choose between Neon Sunset (Blue-Purple-Pink), Cyberpunk (Cyan-Violet-Fuchsia), Emerald Pulse (Dark Emerald-Jade-Lime), Solar Flare (Crimson-Amber-Gold), Electric Blue (Navy-Azure-Ice Cyan), Rainbow Spectrum (360ยฐ per-bar hue mapping), and Monochrome Glow (Slate-Silver-White).
- Bar Width & Density Control: Select from Slim (10px, high bar density), Normal (18px, balanced), Wide (28px, bold chunky bars), or Extra Wide (42px, retro broadcast equalizer).
- Opacity & Instant Context Menu: Adjust visualizer opacity from 10% to 100% via the popup dialog, Settings tab, or right-clicking anywhere on the active Lyrics Projection Screen.
๐ค Song End Return to Karaoke Screen & DJ Manual Start (AutoAdvanceManager.cs, KaraokeViewModel.cs, AppSettings.cs)
- Return to Karaoke Screen on Song Completion: When a song finishes playing,
MainWindowautomatically navigates back to the primary Karaoke control screen (KaraokePage), giving the DJ immediate access to performer queue controls, search, and audio settings without manual clicks. - Audience Display Reset to Rotation Billboard: The secondary projection window seamlessly hides the lyrics view and restores the full-screen Rotation Billboard, displaying the upcoming rotation queue and announcing the next performer to approach the stage.
- Manual DJ Next Song Start: Instead of automatically launching the next song over an empty stage, rotation advances the previous performer to completed, prepares the new current performer in the queue, starts/unducks fill-in background music, and waits in
ReadyToStart. The DJ initiates playback with "โถ Start Song" when the singer is situated on stage. - Dispatcher Shutdown Guarding: Fixed
System.Threading.Tasks.TaskCanceledExceptioncrashes during library metadata scanning by safely checkingHasShutdownStartedand catchingOperationCanceledExceptionduring background probe reporting.
- Automatic welcome: when a singer new to tonight's rotation is added, a full-screen "Welcome to our new performer: " screen appears in one of six random designs. Several new singers in a row are welcomed in order.
- Dedicated Settings GroupBox: organized in its own prominent "New Performer Welcome Screen" card on the Display tab for rapid discovery.
- DJ settings: on/off, display time (default 15 seconds), which screen to use (the rotation and DJ Banner screens by default, or a specific monitor), style selector (choose a specific modelโSpotlight, Neon Night, Sunset Stage, Confetti Party, Disco Rays, Red Velvet Curtainโor "All (Random)" to cycle through all designs without repeating), and a Preview button.
- Pre-Show Screen Mode ('Hold Screen'): A 1-click toggle button ("๐บ Pre-Show Screen") on the DJ playback toolbar and rotation monitor controls (and configurable hotkey shortcut) keeps the welcome and sign-up screen held on the audience projection display even after singers are queued up before showtime.
- Stacked QR Codes (~20% Canvas Width): When empty or in Pre-Show Mode, the audience display presents high-contrast stacked cards along the right ~20% of the screen:
- Venue Wi-Fi: Shows "๐ถ 1. CONNECT WI-FI", the venue Wi-Fi QR code, network SSID, and password for 1-scan instant connection. Entering or updating the password instantly regenerates the QR code and updates active audience projection displays in real time (
UpdateSourceTrigger=PropertyChanged). - Song Sign-Up: Shows "๐ฑ 2. SCAN TO SIGN UP", the web remote QR code, and direct patron portal URL.
- Wi-Fi Fallback: If no venue Wi-Fi is detected or configured, cleanly adapts to show only the single sign-up QR code card on the right side.
- Venue Wi-Fi: Shows "๐ถ 1. CONNECT WI-FI", the venue Wi-Fi QR code, network SSID, and password for 1-scan instant connection. Entering or updating the password instantly regenerates the QR code and updates active audience projection displays in real time (
- Welcome Screen Hold & Sequenced Release: While the Pre-Show screen is held, individual performer welcome screens remain hidden and queued in background order without interrupting audience Wi-Fi and sign-up instructions. When the KJ turns off Pre-Show mode to start the show, all held singer welcome screens automatically display one by one in exact sequence before returning to the active rotation billboard.
- Banners are never overwritten: the rotation, DJ Banner, Special Event and last-performer banners return exactly as they were when the welcome ends.
๐ฅ Knockout Trivia Core Fixes & Enhancements (KnockoutTrivia, KnockoutWebServer.cs, knockout.html)
- Real-Player Seeding & Disconnect Handling: Removed hardcoded fake player initialization on launch; added a 20-second inactivity disconnect timeout in
IGameStateService.csso disconnected players do not block early reveal in Automatic mode, and rejoining players reconnect smoothly without duplicate roster entries. - Snapshot Isolation & Socket Stability: Replaced live collection reads with immutable thread-safe snapshots (
_snapshotLock,_cachedSnapshot) for HTTP socket threads, eliminating 500 internal errors and cross-thread mutation exceptions. - Super Streak Phone Screen & Asynchronous Fonts: Added dedicated
screen-superstreakUI toknockout.html, preloaded Google Fonts asynchronously with noscript fallback for offline venue Wi-Fi, added auto-rejoin recovery, and unlocked submit buttons on failure. - Wheel Single-Spin & Token Deduction: Added single-spin guards to
WheelViewModel.cspreventing repeat spins, and appliedSuperStreakTokensRemovedPerHitdeduction to targets. - Bot Simulator & Config Protection: Guarded bot simulator loop against stale questions, switched
IConfigServiceto atomic JSON writes with.corrupt.bakbackups, and cached pack question counts by file timestamp.
- Disposable Event Subscriptions: Implemented
IDisposablewith named delegate unsubscriptions inTriviaDisplayViewModel.cs, eliminating 9 anonymous lambda memory leaks on TV window close/reopen. - Live Host Engine Rebinding: Added
RebindEngine(TriviaGameEngine)allowing open TV displays to instantly re-synchronize when a host resets a trivia session inLyracistorKSRotation.
- Question Revisit Protection (#11): Tracked answered question history (
_questionAnswers) per player inTriviaGameEngine.cs. Navigating back via Previous Question, Go To Question, or dropdown preserves answered state, prevents re-answering and duplicate scoring, and protects answer streaks. - Standby Timer Preservation on Pause/Resume (#12): Tracked
_wasTimerRunningBeforePauseinPauseGame()andResumeGame(), preventing standby reading mode timers from auto-starting when DJ banners resume. - Timer Drift Guard (#37): Added tick processing guard (
if (IsPaused || !_tickTimer.Enabled) return;) inProcessTick(). - Leaderboard Tie-Breakers & Pruning (#45): Deterministic player ordering by
TotalScore->TotalCorrect->LastResponseTimeMs->Name, plusPruneDisconnectedPlayers()andClearAllPlayers(). - Answer Leak Protection: Plugged state payload answer leak in
TriviaWebServer.csby gatingisCorrectandpointsEarnedonisRevealed. - Atomic File Operations & Database Cleanup: Added atomic settings write with corrupt backup in
TriviaStorageHelper.cs,SearchOption.TopDirectoryOnlyand wraparound de-duplication inTriviaPackManager.cs, andDeleteQuestion/DeleteQuestionsByIdsinTriviaDatabaseService.cs. - TriviaDbCreator Authoring Polish: Cleaned up old pack files on ID rename, deleted questions from SQLite
trivia.dbon deletion, used collision-free question ID generation, and prompted before overwriting existing packs on import. - Safe Pregame Question Validation: Validated question sets before stopping countdown timers or dismissing screens in
Lyracist.Trivia/ViewModels/MainViewModel.cs. - Leaderboard Auto-Advance Fix (#3): Round leaderboard interstitial display automatically advances to the subsequent question (
AdvanceToNextQuestion()) upon the 8-second countdown expiration whenAutoAdvanceQuestionsis enabled, rather than restarting the previously answered question. - Knockout Web Server & Companion Security/Performance:
- Request body buffer capped at 8 KB to prevent slow-body memory exhaustion.
- Registration rate limiter raised from 5 to 60 registrations per 5-minute window with automated expired-IP pruning to support packed venue Wi-Fi NAT environments.
- Pre-encoded UTF-8 bytes cached for
knockout.html(_cachedHtmlBytes) to avoid redundant encodings on repeated mobile browser hits. - Static
JsonSerializerOptionsreused across endpoints to eliminate allocation overhead during answer rushes. - Added
QuestionIdvalidation to both the server endpoint (/api/knockout/submit) and mobile buzzer client (knockout.html), rejecting stale answers submitted during question transitions. - Added in-flight request guard (
isPolling) toknockout.htmlto eliminate cascading request queues over cellular or high-latency Wi-Fi. - Client join handling hardened against HTTP 429 and 500+ server responses with visual feedback.
- Protected
OnTimerTick, auto-advance timer, and auto-reveal continuations inGameStateService.cswithtry / catchexception guards. - Updated
ConnectViewModel.csto accurately track active connected players (Count(p => p.IsConnected)).
- Universal Wi-Fi QR Reserved Character Escaping:
- Centralized
WifiHelper.EscapeWifiQrValue()to escape reserved characters (\,;,,,",:) in accordance with the MECARD specification across all apps (KnockoutTrivia,Lyracist.Trivia,KSRotation, andLyracist).
- Centralized
- Lyracist & KSRotation Trivia Stability & Performance:
- Guarded
OnPreGameTimerTickinLyracist/ViewModels/TriviaViewModel.csandOnTriviaPreGameTimerTickinKSRotation/ViewModels/MainViewModel.Trivia.cswithtry / catchexception handlers to prevent timer tick exceptions from crashing the host UI dispatcher. - Offloaded synchronous question pack database seeding in
Lyracist/ViewModels/TriviaViewModel.csto a background task so UI startup remains instantaneous.
- Guarded
- Leaderboard Auto-Advance Fix (#3): Round leaderboard interstitial display automatically advances to the subsequent question (
AdvanceToNextQuestion()) upon the 8-second countdown expiration whenAutoAdvanceQuestionsis enabled, rather than restarting the previously answered question. - Games-Played Counter & Multi-Run Support (#4): Explicitly resets the games-played counter on fresh manual game launches (
isAutoRestart: falseandResetGamesPlayedCount()), preserving accurate game progression (Game X of Y) and preventing subsequent runs from immediately tripping the game cap on game 1. - Stale Submission Prevention via Question ID Validation (#5): Added
QuestionIdvalidation to both the mobile client payload (trivia.html), the HTTP API server (TriviaWebServer.cs), and the game engine core (TriviaGameEngine.cs). In-flight answers submitted during question transitions cannot score against subsequent questions. - Option Un-fade Restoration on Timer Reset (#6): TV display projection windows (
DisplayViewModel.cs,TriviaDisplayViewModel.cs) and phone buzzer screens (trivia.html) correctly restore eliminated options back to full opacity and re-enable choices whenever the host triggers a Question Timer Reset. - Mobile Client Join and Submission Error Handling (#7): Phone client (
trivia.html) handles HTTP 429 rate limit delays and 500+ server errors with clear user feedback rather than failing silently, and validates submission responses to ensure rejected late answers reset submission states and display warnings. - Dynamic Score Ticker Marquee (#8): Screen projection windows across all three host applications (
TriviaDisplayWindow.xaml.cs) dynamically compute container and text widths at a constant 65 px/sec velocity, preventing pop-in and truncation across all display resolutions and patron counts. - Venue Registration Rate Limiting & Table Pruning (#9): Expanded registration throttling from 5 to 60 registrations per 5-minute window in
TriviaWebServer.csto support busy venue Wi-Fi NAT environments, with automatic pruning of expired entries to prevent memory growth. - Guarded Timer Callbacks (#11): Wrapped
OnPreGameTimerTickinMainViewModel.csin robust try/catch blocks with diagnostic tracing, preventing unhandled exceptions from terminating .NET Core / .NET 10 processes during unattended pre-game countdowns. - Web Server Allocations & Request Limits: Cached pre-encoded UTF-8 bytes for
trivia.html, reused staticJsonSerializerOptionsinstances to eliminate GC churn during answer bursts, and capped HTTP request bodies at 8 KB to prevent slow client body uploads from exhausting memory. - In-Flight Polling Guard: Added
isPollingguards totrivia.htmlstate requests so high-latency Wi-Fi connections do not pile up concurrent requests. - In-Place UI Synchronization & INotifyPropertyChanged: Implemented
INotifyPropertyChangedonTriviaPlayerand updatedMainViewModel,DisplayViewModel, andTriviaDisplayViewModelto update collections in place rather than wiping and rebuilding them on every poll or join. - Debounced Settings & Wi-Fi Generation: Debounced
SaveSettings()(400ms) and Wi-Fi QR updates (300ms) inMainViewModel.cs, preventing UI stalls and repeated disk/QR writes while typing. - Asynchronous SQLite Seeding: Moved initial question pack SQLite database synchronization off the UI thread into a background task in
LoadQuestionPacks(), ensuring instantaneous window startup. - Non-Blocking Netsh Fallback: Replaced synchronous
ReadToEnd()inWifiHelper.cswith an asynchronous read and 1-second timeout to protect UI threads from network shell hangs. - Uniform Viewbox TV Scaling: Wrapped trivia display canvases in uniform
Viewboxcontrols across all host apps, guaranteeing pristine, unclipped layouts at 125%, 150%, and 4K TV scaling.
- TV Hardware Overscan Prevention: When outputting the dedicated DJ Banner window to external TVs (particularly older 720p/1080p hospitality or venue screens), television hardware frequently applies default overscan processing, cropping and zooming into the edges of the banner graphics.
- In-App Warning Tooltip: Positioned directly beside the Target Monitor / DJ Banner Screen settings controls in both KSRotation and Lyracist, a help icon (
๎บ) provides DJs with instant reminder guidance on TV picture setup. - Recommended TV Picture Settings: Set TV aspect ratio / picture size to "Just Scan", "Screen Fit", "1:1 Pixel Mapping", "Full Pixel", or disable "Overscan" in the television's hardware menu to prevent edge cropping.
๐ Seamless Bidirectional Device Switching & Live Session Handoff (KSRotation, KSRotation.Maui, Web Portal)
- Zero-Beat Event Handover: Seamlessly transfer an active karaoke show between a Windows laptop running
KSRotationand a mobile tablet runningKSRotation.Maui(Android or Windows) when the host needs to leave with the laptop or return to the main DJ booth. - Architectural Flow: Live Session Handoff & Remote DJ Takeover:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ARCHITECTURAL FLOW: LIVE SESSION HANDOFF & REMOTE DJ TAKEOVER โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
DJ (Tablet: KSRotation.Maui) KJ Host (Laptop: KSRotation)
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Active rotation on tablet โ โ Arrives at venue & opens โ
โ Serves requests & portal โ โ 'Switch Device' on laptop โ
โโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโ
โ โ
โ [1] Wi-Fi Scan or IP
โ Selects tablet
โ โ
โ<โโโโโโโ 1. GET /api/session/handoff โโโโค
โ (Sends Laptop IP, Port & PIN) โ
โ โ
โโโโโโโโ 2. 200 OK + Full Session JSON โ>โ
โ (Queue, Checkmarks, History) โ
โ [2] Imports session
โ Takes over host
โ โ
[3] Auto-switches to in-app โ
Remote DJ (dj.html) โ
Pre-authenticated with PIN โ
โ โ
[4] DJ manages show from floor via embedded tablet UI โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโชโโโโโโโโโโโโโโโ
Seamless bi-directional synchronization over venue Wi-Fi!
- Automated In-App Remote DJ Transition: When the desktop host pulls an active session from the DJ's tablet,
KSRotation.Mauiautomatically transitions into a full-screen embedded in-app Remote DJ controller (dj.html), pre-authenticated with the host's credentials so the DJ never leaves the native app and can immediately continue queue management from the floor. - Complete State Preservation: Transmits the entire active queue, currently performing singer (
IsCurrent), on-deck singer (IsNext), rotation start anchor (IsRotationStart), paused and inactive performers, queued tracks, linked duet pairs, completed round checkmarks (rounds 1โ10), tonight's performance history with original timestamps, and pending patron requests. - Dedicated Switch Device QR Code & Web Portal (
handoff.html): Generates a dedicated high-resolution QR code (/handoff). Scanning with any camera opens a sleek mobile landing page showing live venue stats, current singer, active queue counts, and a 1-tap "Open in KSRotation MAUI" button. - Native Deep Linking (
ksrotation://handoff): Android tablets tap-to-launch directly intoKSRotation.Mauiwith pre-filled host IP, port, and security PIN, prompting for 1-tap takeover. - One-Tap Wi-Fi Auto-Discovery: Built-in 1-second subnet sweeper detects running host peers on the venue Wi-Fi automatically without requiring manual IP address typing. Selecting a discovered peer automatically focuses and selects the DJ PIN field for instant entry.
- Full Bidirectional Capability: Effortlessly push from Laptop to Tablet, and pull from Tablet back to Laptop without dropping a single song, singer, or round placement.
- Offline & Manual Resilience: Supports manual IP/PIN entry, manual JSON push, robust socket stream flushing, and downloadable standalone
.ksrsession backup files for isolated venue networks.
- Instant Wait Time Recalculation: Moving any performer up or down in the rotation (via desktop
โฒ/โผbuttons, context menu, tablet controls, or remote DJ web commands) immediately recalculates cumulative wait times based on the new queue position. - Display Synchronization: Immediately pushes updated wait times and position numbers to
SingerDisplayWindow(Normal list, Vegas Marquee, Vinyl Turntable, and Star Wars Crawl) and audience billboard displays. - Desktop Queue Badging: Singer rows in the desktop console (
MainWindow.xaml) feature an estimated wait badge (โณ {0}m) with tooltips, allowing the DJ to inspect wait estimates directly in the primary host window.
โฑ๏ธ Dynamic Round Completion Estimation & Full Round Duration Notice (dj.html, KSRotation, KSRotation.Maui, Lyracist, Shared)
- End-of-Night Decision Support: Instantly informs the host/DJ how much time is remaining in the active round and projects the exact completion clock time (ETA), answering the critical question: "Is there time for another round before last call or venue closing?"
- Remote DJ Status Notice (
dj.html): Pinned color-accented status banner directly beneath the Last Round banner displaying performers left in the round, estimated minutes remaining, projected finish time (e.g.ends ~11:42 PM), and full round duration. Auto-refreshes every 15 seconds and updates in real time on any queue modifications. - Desktop Karaoke Station (
KSRotation): Pinned notice badge beside active singer counts in the main Rotation header toolbar:โฑ๏ธ Round: 4 singers left โข ~20m (ends ~11:42 PM) | Full round: ~25m (5 singers). - Mobile Tablet App (
KSRotation.Maui): Pinned estimation banner above the singer rotation list on Android and Windows tablets. - Lyracist Pro Suite (
Lyracist): Pinned estimation banner above the singer queue on the Rotation management page. - Smart Round Progression: Accurately traces circular rotation from current performer to the rotation anchor (
IsRotationStart), handles Last Round mode (!HasSungInLastRound), and excludes paused, skipped, inactive performers, and filler background music tracks.
- Live Rotation Singer Count on Audience Projection Screens: The Broadway / Vegas Marquee and Vinyl Turntable screens on the detached rotation display window (
SingerDisplayWindow.xamlinKSRotationandRotationWindow.xamlinLyracist) prominently show the current number of active singers in the rotation. - Top Header & On-Deck Placement: Displayed as a glowing golden badge pill (
๐ค X Singers in Rotationor๐ค 1 Singer in Rotation) both in the main header (alongside now-spinning and marquee title headers) and beside the "UP NEXT" / "ON DECK" section banners. - Dynamic & Accurate: Automatically counts eligible non-music performers currently in rotation, handles singular vs plural grammar (
1 Singer in Rotationvs{N} Singers in Rotation), respects Last Round mode, and hides automatically when no active performers remain.
- One-Time Guest Performance: Accommodates guest performers, special dedications, or one-off singers who are called up to sing a single song without joining the permanent nightly rotation.
- Instant Top of Queue & Current Performer: When added or designated, the special singer is immediately placed at the top of the queue (index 0) and promoted to current performer, perfectly catering to spur-of-the-moment guest performances.
- Instant Name Selection on Add: Whenever a regular or special singer is added, the text in the performer name field is automatically selected so the host can immediately type the new name without clicking or dragging to highlight.
- Displaced Singer Preservation: Preserves the previous current or next singer as 'Up Next' so that rotation resumes with them seamlessly once the special performance concludes.
- "โญ Special" Badge While Performing: During their turn on stage, the performer is prominently highlighted with a
โญ SPECIALbadge across the DJ consoles, detached rotation display windows, external audience billboard screens, Chromecast TV displays, kiosk stations, and mobile web portals. - Automatic Inactive Transition: The moment their performance concludes (whether through automated track advancement or manual DJ completion), the special singer is marked inactive automatically.
- Seamless Rotation Resumption: The rotation queue resumes immediately with the displaced performer or next sequential singer as if the guest had never altered the rotation order.
- Round Anchor Immunity: Smart round-anchor heuristics (
EnsureRotationStartFlagandHandleSingerRetiredOrRemoved) ignore special performers so round boundaries are always anchored to regular performers.
โญ๏ธ Singer Skip (Round-Scoped Rotation Bypass) (Shared, Lyracist, KSRotation, dj.html, billboard.html, kiosk.html, PatronPortal.html)
- Single-Round Bypass: Allows the DJ to pass over a performer who needs to temporarily step away (e.g. stepping outside or grabbing a drink) without forfeiting their position in the rotation or dropping them to the back of the queue.
- Distinct from Inactive & Pause:
IsInactive: Marks the performer as inactive/deleted, moves them out of active rotation to the end of the line, and excludes them from active counts.IsPaused: Retains queue position, but halts performance turns indefinitely until the DJ manually unpauses them.IsSkipped: Retains queue position, passes over them for the current round only, and automatically clears when the round rolls over.
- Automatic Round Rollover: When rotation advances and the round completes (crossing or reaching the
โ Anchorsinger), allIsSkippedflags automatically clear so skipped performers sing normally in the following round without requiring manual DJ intervention. - Immediate Promotion When Skipping Current: If the currently performing singer is skipped, the rotation immediately advances to the next eligible singer.
- Synchronized Wait-Time Recalculation:
RecalculateEstimatedWaitsignores skipped performers so on-deck and waiting singers see true, accurate wait times. - Cross-Platform UI & Indicators: Amber
โญ SKIPbadges, row styling, andSkip / Unskipbuttons across Lyracist, KSRotation desktop, remote DJ board (dj.html), audience billboard (billboard.html), kiosk (kiosk.html), and patron mobile portal (PatronPortal.html).
- Hybrid Ground-Truth Detection: Uses high-precision GPS coordinates (Latitude/Longitude) with a 150-meter spherical Haversine radius (
GeoMath) as the primary ground truth, with house Wi-Fi SSID as a secondary fallback. - Travel Router Immunity: Addresses the DJ mobile reality where portable travel routers are deployed at venues without Wi-Fi. SSIDs marked as travel routers in
KSRotation.Mauior registered inSettings/ksrotation_travel_routers.jsonare excluded from Wi-Fi matching, preventing the system from falsely identifying new venues as old gig locations. - Tablet-to-Host GPS Bridge: Devices with real satellite GPS sensors (
KSRotation.Mauion Android tablets) automatically query hardware coordinates and push them to the host laptop viaPOST /api/venue/location. The desktop host caches these coordinates inWindowsLocationService, giving laptop hosts access to satellite precision even without onboard GPS chips. - Auto-Retrieval on Startup: Automatically checks detected coordinates against the venue database (
Settings/ksrotation_venues.json/venues.json) upon launching. If a known venue matches within 150m, it is automatically selected. - One-Click Venue Tagging & Auto-Save: "๐ Tag GPS" buttons across
KSRotation,Lyracist, andKSRotation.Mauiallow hosts to capture and save the current location to any new or existing venue with one click.
๐ก KSRotation.Maui Chromecast Web-Casting & TV Billboard Layout (KSRotation.Maui, billboard.html, BillboardView.xaml)
- Direct Chromecast / Google TV Web-Casting: Built-in DashCast web-receiver (
appId: 84912283,urn:x-cast:com.madmod.dashcast) integration allows DJs runningKSRotation.Mauion Android tablets, phones, or Windows laptops to cast the live audience billboard (billboard.html) directly to any Google Cast or Chromecast display on the local network. - Dedicated Full-Height Rotation Column: Redesigned the audience billboard so the Upcoming Rotation queue occupies a dedicated, full-height right-hand column. Singer names, song titles, and queue numbers remain completely visible and legible across the room on 720p, 1080p, and 4K TVs.
- Side-by-Side QR Code Arrangement: Relocated the Song Requests and Wi-Fi Join QR code cards to the bottom-left area directly below Now Performing and Up Next, arranging them side-by-side with crisp contrast and generous scannable sizing.
- Persistent DJ Name, Venue Name & Screen Listing Option: Hosts running
KSRotation.Mauican configure their DJ/Host Name, Venue Name, and choose whether to display them on the audience billboard and TV cast directly inside the "โ About" dialog. Values are stored locally on the device (Preferencesandksrotation_settings.json), persisting across app reboots, session resets, and tablet restarts until explicitly changed. - Asynchronous Discovery & Android Multicast Lock: Employs
ChromecastDiscoveryServicemDNS scanning with automatic AndroidWifiManager.MulticastLockhandling, ensuring reliable device discovery and one-tap casting across all mobile Wi-Fi chipsets.
๐ฅ๏ธ 1080p Resolution Layout Optimization & Internal Search DataGrid Scrolling (KaraokePage.xaml)
- Full HD (1920x1080) Workspace Alignment: Streamlined page margins (
16,10,16,12) and TitleBlock padding to prevent UI clipping and vertical scrolling on 1080p laptop displays and monitors running at 100% or 125% Windows DPI scaling. - Ultra-Compact Header Toolbar: Reduced the top TitleBlock from ~102px down to a sleek ~40px toolbar with inline Venue & DJ branding and compact request indicator bulbs, recovering over 60px of vertical space for the song library, queue, and lyrics preview.
- Interactive QR Code Thumbnail & 1-Click Popout: Scaled the inline QR code to a clean 30x30 thumbnail with Join URL; clicking the QR thumbnail instantly launches the enlarged, high-resolution QR modal (
KioskQrCodePopoutWindow) for easy patron scanning or tablet kiosk configuration. - Constrained 15โ20 Row Search Results DataGrid with Adaptive Fallback: Column 0 employs an adaptive
ScrollViewerbound toActualHeight(MinHeight="500"), preserving internal DataGrid scrolling, UI recycling virtualization, and 15โ20 visible song rows on 1080p displays while providing smooth outer scroll fallback on constrained or non-maximized windows. - Permanently Anchored Singer Assignment Card: Redesigned the Singer Assignment card into a compact two-column layout (Singer Name + Duet Partner, Key Slider + Notes), anchoring it directly beneath the search grid so DJs never have to scroll down to assign selected songs to performers.
- Compact Playback FooterBar & Anti-Impingement Layout (
MainWindow.xaml): Reduced the bottom playback bar height from ~94px down to ~52px (Padding="20,6"). Implemented a strict 3-columnGrid(MaxWidth="180"on performer,*on song title, both withTextTrimming="CharacterEllipsis"and golden song highlight), placing the seek bar on row 2 with dedicated right-margin breathing room (Margin="0,0,28,0") so text and progress controls never impinge on the center Play/Pause/Stop controls.
- Self-Healing Multi-RID Packaging Target: Integrated
EnsureOuterAssemblyForProcessAssembliesbefore Android assembly processing and package signing. Automatically bridges RID-specific inner compiled assemblies (android-arm64,android-x64) into the outer intermediate directory (obj\Debug\net10.0-android\), preventingXAPRAS7028missing DLL errors during direct-to-device deployments. - Direct Hardware Deployment: Guarantees seamless one-click Visual Studio and CLI deployment directly to connected tablets (e.g., Lenovo TB373FU).
- Projection Screen Customization: KJs can easily show or hide the patron mobile song request QR code badge displayed in the top-right corner of the lyrics projection window.
- Triple Access Points:
- Settings: Checkbox under Monitors & Screen Assignments -> Lyrics Projection Screen.
- Lyrics Page: Dedicated toggle inside the Audience Lyrics Screen configuration card.
- Live Right-Click Context Menu: Right-click anywhere on the running lyrics projection screen and toggle Show QR Code on the fly without navigating away from the show.
- Persistent State: Synced and persisted automatically via
AppSettings.ShowQrCodeOnLyricsScreen.
๐ต Karaoke & Music Library Separation & Search Isolation (ScanningService, SearchService, LibraryService, KaraokePage.xaml)
- Companion CDG Detection:
ScanningService.ParseStoreDownloadautomatically detects accompanying.cdggraphics files (Path.ChangeExtension(filePath, ".cdg")), reliably classifying unzipped MP3+G / WAV+G tracks asIsKaraoke = true, KaraokeType = "MP3G"and preventing them from mistakenly being routed to the background music library. - Expanded Audio Format Enumeration: The file crawler now catalogs standard music files in
.mp3,.mp4,.zip,.wav,.m4a,.flac,.wma,.aac, and.oggformats. - Dedicated Library Tabs & Live Match Badges: The search results view clearly distinguishes Karaoke Library and Music Library tabs, each displaying dynamic match count badges (e.g.
Karaoke Library (12)andMusic Library (3)). - SQLite FTS Search Query Isolation: SQLite FTS search queries now evaluate the
IsKaraokefilter directly in SQL (AND (@isKaraoke IS NULL OR s.IsKaraoke = @isKaraoke)), preventing voluminous karaoke results from starving out music tracks under the 150-match query limit.
- Instant Visual Distinction: Search result rows feature subtle, semi-transparent row tinting to immediately distinguish track formats at a glance: emerald green (
#1522C55E) for karaoke tracks (IsKaraoke = true) and warm gold (#15F59E0B) for standard background music tracks (IsKaraoke = false). - Help Topic Integration: Topic 1 in the in-app help system documents search result row tinting alongside direct database scan and compact DJ toolbars.
๐ Special Event Banner Mutual Exclusion, Two-Way Sync & Quiet Updates (KaraokePage.xaml, KaraokeViewModel.DjBanner.cs, KSRotation/MainWindow.xaml, PatronRequestServer.cs, KSRotationSyncService.cs)
- Guaranteed Single Selection & Mutual Exclusion: Added explicit
GroupName="SpecialEventBanner"to the RadioButton template in Lyracist's KaraokePage and KSRotation, coupled with an active synchronization loop across SpecialEventOptions. Ensures only one special event banner can be selected at a time. - Instant 'None' Selection Reset: Selecting the "None" radio button immediately clears all active banner selections and restores standard DJ branding banners seamlessly.
- Two-Way Synchronization & Local Grace Window: Added
POST /api/special-event/activeinPatronRequestServer.csand wiredKSRotationSyncService.NotifyLocalSpecialEventChangedto push DJ selections from Lyracist to KSRotation immediately, accompanied by a 5-second local selection grace window to prevent polling reversion races. - Quiet Sync & Modal Suppression: Background synchronization utilizes
SetSelectedQuietlyto update radio button UI states without invoking user-action callbacks, preventing automatedShowPersonalizedBirthdayPromptmodal dialog popups on unattended host laptops. - Dynamic Custom Event Synchronization: Custom event banners created in either app dynamically appear and select in the other rather than deselecting all radio buttons. All event sync guards enforce case-insensitive comparison (
OrdinalIgnoreCase). - Elimination of Redundant Re-Sync Passes: Streamlined event setters by relying cleanly on
OnActiveSpecialEventChangedpartial dispatches, eliminating double sync iterations and secondary banner updates. - Direct Production Method Verification (
SpecialEventBannerSelectionTests.cs): Unit tests verify production synchronization routines (SyncSpecialEventOptionSelections,UpdateActiveSpecialEventFromSync) against liveKaraokeViewModelinstances, ensuring dynamic custom event addition and quiet modal-free updates execute correctly. - DJ & Special Event Banner Monitor Selection Persistence (
KSRotation/MainWindow.xaml,KSRotation/ViewModels/MainViewModel.cs): Fixed an issue where the selected monitor device in the "DJ & Special Event Banners" settings ComboBox did not stay visible. Wired explicit two-way binding and hardenedRefreshAvailableMonitors()to store, restore, and properly default the target monitor device without losing the DJ's selection during monitor re-enumeration. - Dynamic Special Event Announcement Banner Studio: DJs can select 'Announcement' from the Special Event Banner selector in either Lyracist or KSRotation to broadcast custom, dynamically generated 16:9 celebration announcements on venue TVs and projection screens (e.g., "Welcome to Jill & Robert, 1st timers tonight"). An interactive modal dialog on the host laptop allows entering any custom text with auto-scaling typography, dual gold borders, ambient radial glow, and corner celebration fireworks. The Web Remote DJ Board (
dj.html) includes a full-screen modal allowing mobile DJs to author and launch announcements remotely from tablets and phones.
๐ Rotation Invariants & Shared Logic Consolidation (Shared/RotationHelpers, KSRotation, Lyracist)
- Unified Song & Singer Matching (
Shared/RotationHelpers.cs): ConsolidatedNormalizeForComparison,IsSameSingerName,IsSameSong, andIsSameSongLenientinto shared routines across bothLyracistandKSRotation, eliminating cross-application logic divergence. - Thread-Safe Collection Reads (
ReadWithConcurrentRetry): Replaces hazardous background-thread UI dispatcher calls with lockless, non-deadlocking snapshot retries, preventingInvalidOperationExceptioncollection enumeration races between web request threads and the UI. - Linked Singer Adjacency & Active Boundary Preservation: Restored
EnforceLinkedAdjacencypost-invocations on singer pause/promote flows so duet partners remain strictly adjacent, and added active/inactive boundary guarding to remote singer moves (MoveSingerUp,MoveSingerDown). - Duplicate Singer Auto-Merge Safety: Hardened singer merging to properly execute full singer cleanup (reassigning current performer and rotation anchor) rather than raw collection removal.
- Web Remote & Network Performance: Cached WiFi SSID queries (30s) to eliminate recurring 1-second
netshstalls on patron polling, released singer-login locks before 429 rate-limit responses, and added dynamic byte inspection for patron avatar uploads.
- Proactive Lock Table Cleanup: Automatically drops abandoned
__EFMigrationsLocktables on application startup viaLyracistDbContext.ClearAbandonedMigrationLocks(), preventing SQLite Error 11 (malformed database schema (__EFMigrationsLock) - table already exists) caused by interrupted previous sessions or sudden process termination. - Automated Migration Recovery & Setup Parity: Startup automatically recovers from migration lock exceptions, ensuring post-migration setup (
ApplyPostMigrationSetup: song deduplication, index rebuilds, andSingerHistorytable creation) executes reliably on both normal and retry branches.
- Direct Database Search & Scan: Clicking the "Scan" button right beside the search input or pressing Enter immediately executes a database query (
SearchDatabaseCommand) against the local SQLite library for matching songs and artists, eliminating unintentional Windows File Explorer prompts. - Dedicated Disk Folder Scan Button: An independent folder icon button (
ScanFolderCommand) provides direct access to disk folder scanning with clear tooltips. - Ultra-Compact DJ Control Toolbar: Streamlined Auto-Advance & DJ control strip compressed from ~80px down to a sleek ~32px horizontal toolbar, recovering over 50px of vertical workspace for the song library, singer queue, and player columns.
- Streamlined DJ Flow Actions: Compact "โถ Start Song" and "โญ Skip Singer" buttons provide rapid queue advancement with minimal screen footprint.
-
Store Tab Placement:
- Exclusively available in the Lyracist desktop application navigation bar. This tab is strictly isolated and does not appear in any other apps (KSRotation, Lyracist Trivia, Knockout Trivia, etc.).
-
Store Notifications & Toast Alerts (
StoreNotificationService,ToastNotificationControl):- Non-Intrusive Toast System: Automatically displays animated slide-in toast notifications in a dedicated bottom-right overlay container inside the Store tab and Bulk Import Wizard without blocking UI interaction or scrolling.
-
Real-Time Lifecycle Alerts: Triggers toasts for Track Imported (
Imported: Artist - Title (Provider)), Audio Normalized (Audio normalized: Artist - Title), Silence Trimmed (Silence trimmed: Artist - Title), Waveform Generated (Waveform ready: Artist - Title), Store Sync Completed, and Bulk Import Completed. -
Dynamic Badge Bar: Displays format tags (
MP3+G,MP4,ZIP) and audio pipeline execution badges (NORM,TRIM,WAVE). - Smart Dismissal: Automatically fades and slides out after 5 seconds or dismisses instantly upon clicking the close button. Maximum 5 toasts stacked vertically.
-
Store Plugin API & Modular Providers (
IStoreProvider,BaseStoreProvider,ProviderRegistry):-
Modular Plugin Architecture: Each commercial karaoke provider (Karaoke Version, Party Tyme, Sunfly, Karaoke.com) is modeled as a pluggable module implementing
IStoreProviderand inheritingBaseStoreProvider. Future commercial vendors can be added by implementing the interface without modifying core ingestion pipelines. -
Multi-Vector Detection Fingerprinting: Centralizes search URL building, filename regex heuristics, ZIP internal hierarchy inspection, CDG magic binary header matching (KV
0x01 0x0F, PT0x02 0x0A, SF0x03 0x0C), ID3 audio tag scans (TXXX:KV,TXXX:PT,TXXX:SF,TXXX:KCOM), and MP4 container metadata watermarking. -
Central Provider Registry: Manages registered providers with dynamic registration capabilities (
RegisterProvider) and thread-safe cross-vector detection lookups (DetectProviderFromFilename,DetectProviderFromZip,DetectProviderFromCdg,DetectProviderFromId3,DetectProviderFromMp4). -
Dynamic ViewModel Actions: Powers Store search actions, URL routing, and dynamic button generation through
ProviderRegistry.
-
Modular Plugin Architecture: Each commercial karaoke provider (Karaoke Version, Party Tyme, Sunfly, Karaoke.com) is modeled as a pluggable module implementing
-
Provider Settings Panel (
ProviderSettingsControl,ProviderSettingsViewModel):- Centralized Host Preferences: Collapsible configuration panel embedded in Section 3 of the Store tab, empowering KJs to configure preferred commercial providers (KV, PT, Sunfly, Karaoke.com), file packaging types (MP3+G, MP4, Audio-only), target folder categories (Karaoke or Music), and companion lyrics format priority (LRC vs. TXT).
- Default Search & Button Highlighting: Automatically highlights the host's preferred provider button with a gold "โ PREFERRED" badge in the search toolbar, and routes Enter key queries directly to the preferred provider.
- Baseline Processing Defaults: Configures global default toggles for EBU R128 loudness normalization (-16 LUFS), silence trimming (-50dB), and peak waveform rendering across the Store watcher and Bulk Import Wizard.
-
Smart Import & Sync Hints: Provides fallback provider attribution for unbranded files during Store Sync and Bulk Import operations, ensuring canonical renaming rules (
Artist - Title (Provider).ext) apply seamlessly.
-
Track Preview Player (
TrackPreviewControl,TrackPreviewViewModel):- Acoustic & Video Inspection Engine: Built directly into the Recent Imports panel on the Store tab and the candidate review grid in the Bulk Import Wizard, allowing KJs to audition and inspect tracks before or after import without initiating full karaoke sessions.
-
5-Second Rapid Audio Preview: Powered by FFmpeg stream extraction (
-ss 0 -t 5) with built-in WPFMediaPlayerplayback, millisecond-accurate elapsed tracking, and interactive scrub bar. -
Dual-Audio Channel Auditioning: Automatically detects multi-stream dual-audio tracks (e.g. guide vocals vs. backing instrumental) and provides an interactive toggle between Channel A (Guide Vocals) and Channel B (Instrumental), dynamically re-extracting audio per channel (
pan=mono|c0=c0vspan=mono|c0=c1). -
Waveform & Spectrogram Visualizations: Generates high-contrast PNG waveform peaks (
showwavespic) and acoustic frequency spectrograms (showspectrum=s=800x300:color=intensity) for visual inspection of dynamics, clipping, and frequency balance. -
MP4 Video Preview: For MPEG-4 karaoke files, extracts the opening 5-second video clip and plays it smoothly inside an embedded WPF
MediaElementwith hardware acceleration. - Technical Metadata Dashboard: Displays filename, provider badge, container format, track duration, musical key, BPM, fidelity quality rating, performance difficulty, and vocal presence classification.
- Trigger Points: Automatically displays when selecting an item in Recent Imports, clicking the dedicated "Preview" button, or selecting a candidate in the Bulk Import Wizard.
-
1-Click Store Sync (
PurchasedTrackSyncService,StoreSyncSummaryWindow):- Toolbar Primary Action: "Sync Purchased Tracks" button triggers an immediate on-demand scan of the configured purchase directory or Downloads folder.
-
Multi-Format & Companion File Pairing: Scans for ZIP (MP3+G), MP3+G pairs, MP4 video, and lyrics (.lrc/.txt) while filtering incomplete browser download temp files (
.crdownload,.part,.tmp,~$*). -
Catalog Verification & Deduplication: Checks SQLite
Songsdatabase table to skip previously imported tracks and prevent duplicate reprocessing. - Pipeline Execution: Automatically invokes Provider Intelligence, Smart Import auto-renaming, FFmpeg loudness normalization/silence trimming, waveform generation, and database ingestion.
- Modal Summary Dialog: Elegant dark acrylic summary dialog displaying total scanned, imported, skipped, errors, providers involved, and average processing time per track.
- Auto-Refresh Integration: Seamlessly refreshes Store Analytics metrics and triggers library update notifications upon completion.
-
Bulk Import Wizard (
BulkImportWindow,BulkImportViewModel,PurchasedTrackBulkImporter):- Batch Folder Ingestion: Select any folder containing downloaded karaoke files (MP3, CDG, ZIP MP3+G, MP4, LRC/TXT).
-
Automatic Media Pairing & Lyrics Linking: Automatically pairs
.mp3and.cdgcompanion files into unified candidate entries and binds companion lyrics files without creating duplicates. - Provider Intelligence Preview Grid: Live candidate inspection displaying detected provider origins (Karaoke Version, Party Tyme, Sunfly, Karaoke.com, Local), technical audio/video specs, duration, musical key, BPM, quality tier, vocal difficulty, and vocal presence.
- Global & Granular Audio Processing Toggles: Global batch toggles for EBU R128 loudness normalization, silence trimming, waveform peak rendering, and target folder routing, with individual per-track override toggles.
-
Throttled Multi-Threaded Execution: Parallel FFmpeg batch execution throttled via
SemaphoreSlim(3)to a maximum of 3 concurrent worker processes to guarantee UI responsiveness and avoid disk thrashing. - Combined Audio Pipeline Pass: Chains silence trimming and volume normalization into a single FFmpeg pass when both options are enabled for 2x faster batch processing.
- Bulk Import Completion Summary: Comprehensive summary modal reporting total tracks imported, skipped, errors, providers involved, and average processing time per track.
-
Smart Import Rules (Auto-Rename, Tagging, Classification & Enrichment):
-
Auto-Rename Imported Files: Renames incoming tracks and all companion files (.cdg, .lrc, .txt, waveforms) into canonical naming format:
Artist - Title (Provider).ext(e.g.Adele - Hello (KV).mp3,Bon Jovi - Wanted Dead or Alive (PT).cdg,Queen - Don't Stop Me Now (SF).mp4). Standardizes publisher abbreviations: Karaoke Version$\rightarrow$ KV, Party Tyme$\rightarrow$ PT, Sunfly$\rightarrow$ SF, Karaoke.com$\rightarrow$ KCOM. - Auto-Tag Genres: Detects and maps provider-specific genres (Pop, Rock, Country, Soul, R&B, Jazz, Hip-Hop, Gospel, Dance, Standards) using FFprobe tags and catalog heuristics.
-
Auto-Tag Difficulty: Classifies tracks into
Easy,Medium, andHardbased on tempo (BPM), duration, dynamic range, and vocal range/stamina indicators. -
Auto-Tag Musical Key: Identifies and normalizes key signatures (e.g.
Am,C#m,G) from ID3 frames (TKEY,initialkey) and metadata tags. -
Auto-Tag BPM: Detects track tempo and parses numeric BPM values from ID3 tags (
TBPM,bpm,tempo) and comment notations. -
Auto-Tag Vocal Presence: Classifies tracks into
guide vocals,background vocals, orno vocalsusing multi-stream container inspection and tags. -
Auto-Tag Quality: Evaluates bitrates, sample rates, channels, codecs, and video resolutions into
High,Medium, andLowtiers. -
Extended Schema: Stores smart attributes in SQLite
Songsdatabase table,PurchasedTrackItem, and FTS5 search index tags.
-
Auto-Rename Imported Files: Renames incoming tracks and all companion files (.cdg, .lrc, .txt, waveforms) into canonical naming format:
-
Multi-Provider Licensed Store Deep Links:
- Direct search buttons for Karaoke Version (
https://www.karaoke-version.com/custombackingtrack/search.html?query={query}), Party Tyme (https://www.partytyme.net/songshop/cat/search.php?search_what=all&search_keyword={query}&submit=GO), Karaoke.com (https://karaoke.com/search?type=product&q={query}), and Sunfly Karaoke (https://www.sunflykaraoke.com/?s={query}&post_type=product). - Opens store catalogs directly in the user's default browser, adhering strictly to zero-scraping and zero-audio-proxying architecture.
- Direct search buttons for Karaoke Version (
-
Provider Intelligence ("Advanced Fingerprinting"):
-
ZIP Internal Signatures: Automatically scans archive table of contents for publisher patterns:
/custom_backing_track/andtrack.mp3+track.cdgpairs (Karaoke Version),/karaoke/folders and_PTsuffixes (Party Tyme),SFcatalog codes (Sunfly), andKCOMdescriptors (Karaoke.com). -
CDG Magic Header Detection: Inspects initial 24 bytes of CDG streams for publisher magic bytes (
0x01 0x0Ffor KV,0x02 0x0Afor PT,0x03 0x0Cfor SF). -
MP3 ID3 Tag Fingerprinting: Inspects
TXXX:KV,TXXX:PT,TXXX:SF, andTXXX:KCOMframes via FFprobe. - MP4 Container Watermark Detection: Probes container title, artist, and comment metadata for publisher watermarks.
- Referrer Hints: In-memory tracking of the last store provider clicked from the search bar as an intelligent fallback.
-
ZIP Internal Signatures: Automatically scans archive table of contents for publisher patterns:
-
Purchased Tracks Folder Watcher (
PurchasedTrackWatcherService):- Background folder watcher on the user's download directory (defaulting to the user's Downloads folder).
- Automatically captures new
.mp3,.cdg,.zip, and.mp4downloads, debounces write events, and verifies file lock completion before importing. - Asynchronously reconciles separately arriving
.mp3and.cdgfiles into unified MP3+G entries.
-
FFmpeg-Powered Audio & Video Processing Pipeline:
-
Loudness Normalization: EBU R128 (-16 LUFS) broadcast audio normalization via
loudnorm. -
Silence Trimming: Automatic removal of leading and trailing dead air below -50dB via
silenceremove. -
Waveform Previews: Automated high-contrast PNG visual waveform previews via
showwavespic. - MP4 Dual-Audio Detection: Inspects container streams via FFprobe and tags multi-channel/dual-stream tracks (guide vocal vs. instrumental backing).
-
Automated Lyric Pairing: Automatically discovers matching
.lrcand.txtfiles in the download folder and associates synchronized lyrics.
-
Loudness Normalization: EBU R128 (-16 LUFS) broadcast audio normalization via
-
Target Folder Routing:
- Allows designating separate destination directories for Karaoke tracks (
.zip,.cdg+.mp3,.mp4) and Music / Audio tracks (standalone.mp3). - Automatically moves files into their target folders upon download.
- Allows designating separate destination directories for Karaoke tracks (
-
Library & FTS5 Database Integration:
- Parses titles, artists, and formats; tags provider source as
"Karaoke Version","Party Tyme","Karaoke.com","Sunfly", or"Local"; saves toLyracistDbContext; updates the SQLite FTS5 index; and refreshes library search in real time.
- Parses titles, artists, and formats; tags provider source as
-
Manual Import & Activity Tracker:
- "Import Purchased Track..." button opens a multi-file picker to ingest downloaded tracks on demand.
- Live activity table logs recent imports with technical badges: Format, Lyric file indicator, Dual-Audio streams, Normalization status, and Waveform preview indicator.
- Collapsible Import Activity Log showing the last 20 file processing events with status codes and full event details.
-
Store Analytics & Library Insights:
- Collapsible Store Analytics dashboard displaying provider breakdown (KV, PT, SF, KC, Local), file format distribution (MP3+G, MP4, ZIPCDG, Audio-only, Lyrics), FFmpeg audio benchmarks (normalization, silence trimming, waveforms, average/min/max processing times), quality and difficulty distributions, top musical keys bar chart, BPM tempo histogram, and 14-day timeline & 24-hour activity heatmaps.
-
Web Reference Modules:
- Reusable React/TypeScript components (
storeTab.tsx,storeSearch.tsx,settingsStore.tsx) and Node.js watcher (purchasedWatcher.ts,importMetadata.ts,deepLink.ts,ffmpegUtils.ts,types.ts) included underLyracist/WebModules/Store.
- Reusable React/TypeScript components (
- Performer Directory & Account Browser:
- Dedicated primary "Users" navigation tab in both Lyracist (sidebar) and KSRotation (top navigation bar between Settings and Trivia).
- 2-pane master-detail interface featuring a searchable list of registered singers, search filter by name, email, or custom title, level badges, XP points, and total song performance tallies.
- Account lifecycle actions to instantly create new singer accounts or delete obsolete accounts.
- Performer Profile & Credentials Editor:
- Edit Singer Name, 4-digit Patron Portal PIN code, Email, Vocal Range (Soprano, Mezzo-Soprano, Contralto, Countertenor, Tenor, Baritone, Bass), Custom Title / Stage Nickname, Experience Score (XP), and DJ Notes.
- Synchronized in real-time with the unified SQLite database (
Data/lyracist.db) shared across both applications.
- Per-Singer Vocal & Audio Defaults:
- Dedicated tab for audio preferences: Microphone Gain (Volume), Key Transposition (-12 to +12 semitones), Playback Speed (0.8x to 1.2x), 3-Band Parametric EQ (Treble, Mid, Bass), Dynamics (Compressor, Limiter), and Sound Check Remarks.
- Settings automatically preload whenever the performer is queued or takes the stage.
- Comprehensive Performance History Record:
- "Performance History" tab displaying a complete historical record of every song sung by the performer.
- Columns for Song Title, Artist, Key Transposition, Playback Speed (Tempo), Source (Local, YouTube, etc.), and Date/Time stamp.
- Direct Actions: "Queue" button instantly re-queues the past performance back into the live rotation preserving the performer's exact key and tempo settings; "Remove" button purges individual entries.
- Merge Duplicate Singer Accounts:
- Dedicated "Merge Duplicate..." consolidation modal tool.
- Allows the DJ to select a secondary/duplicate singer account to merge into the primary account.
- Consolidates performance history, past requests, active rotation entries, audio profile defaults, and XP points into the primary account, then permanently deletes the duplicate account.
- Live DJ Webcam Photo Capture:
- Dedicated "Take Photo" button on the "Users" tab in both Lyracist and KSRotation allowing DJs to snap a headshot of the performer on the spot using any connected USB or integrated webcam.
- Powered by
FlashCapwith zero native dependency overhead. - Includes real-time camera selection, live video preview with circular headshot framing guide, snapshot freeze/review, retake option, and automatic center-square cropping to 400x400 JPEG saved to
Data/Avatars/{guid}.jpg.
- Patron Portal Selfie Uploads:
- Patrons can upload a selfie or profile image directly through the smartphone patron portal (
/api/singer/avatar/upload). - Safe validation and storage in
Data/Avatars/with database record linking. - DJs can view, upload, take webcam photos, or clear photos in the desktop "Users" tab.
- Patrons can upload a selfie or profile image directly through the smartphone patron portal (
- Vegas Billboard ("Vegas Marquee") Display:
- On the Broadway/Vegas marquee rotation screen, a high-resolution circular framed photo with gold neon glow effect is prominently rendered right above the singer's name on the big screen.
- Vinyl Record ("Now Spinning") Turntable Display:
- On the turntable rotation screen, the circular framed photo is showcased beside the "โช NOW SPINNING" banner and singer title while the vinyl record spins.
- Independent DJ Banner Multi-Monitor Projection:
- Projects customized DJ promotional graphics and looping MP4 video animations (
Banners/DJBanners) to any dedicated secondary monitor, stage TV, or patron display screen. - Supports automatic looping for animated video banners with soundless background playback (
BannerVideo_MediaEndedrewind loop).
- Projects customized DJ promotional graphics and looping MP4 video animations (
- Live In-App Visual Previews:
- Live preview cards embedded directly under the DJ Banner selector in both the Display Settings tab (
SettingsPage.xaml) and Karaoke Control Center (KaraokePage.xaml). - Displays instant scaled visual previews for image files (
.png,.jpg,.jpeg,.gif,.bmp), dedicated animated video badges for.mp4video files, and fallback indicators when no banner is selected.
- Live preview cards embedded directly under the DJ Banner selector in both the Display Settings tab (
- Intelligent Same-Screen Deconfliction & Seamless Auto-Toggle:
- When the DJ Banner and Singer Rotation Billboard share the same physical display output, toggling the DJ Banner ON automatically steps down Rotation, immediately projecting the selected banner to the screen without manual multi-step configuration.
- Special Event Overrides & Safe Precedence:
- Supports quick-switch special event overlays ("Birthday", "Last Song", "Anniversary", "Custom") with instant revert back to the chosen DJ banner when switched to "None".
- Selecting any standard DJ banner automatically clears prior special event states, ensuring the DJ's selection takes immediate effect on stage displays.
- Dual-Tier Key & Playback Speed Memory:
- Per-Song Performance Memory: Whenever a performer sings a song, their exact key transposition semitone offset and playback tempo multiplier (e.g. 1.1x) are saved in the SQLite
SingerHistorydatabase table. Re-queuing that song in the future automatically recalls the performer's exact key and tempo. - Performer Profile Defaults: Global performer vocal preferences stored in
SingerAudioSettingsact as the initial baseline when a performer sings a track for the first time without prior history. - Live Pitch & Speed Synchronization: Recalled key and tempo are passed into
ActivePerformerKeyandActivePerformerTempoonMediaEngine, instantly setting the Live Deck pitch and speed sliders as soon as the track begins.
- Per-Song Performance Memory: Whenever a performer sings a song, their exact key transposition semitone offset and playback tempo multiplier (e.g. 1.1x) are saved in the SQLite
- Per-Singer Mic Level & Vocal EQ Recall:
- Automatically loads the performer's saved vocal gain (
Volume), 3-band parametric EQ (Treble,Mid,Bass), dynamic compressor threshold, and peak limiter fromSingerAudioSettingswhen their turn begins. - On-screen Audio Controls sliders update live to match the active performer's profile.
- Automatically loads the performer's saved vocal gain (
- Quick-Action Audio Controls [Save to Singer] & [Recall Singer] Buttons:
- Located on the Audio Controls card header next to "Reset Audio":
- Save to Singer: Instantly saves current Audio Controls slider values (Volume as Vocal Gain, Treble, Mid, Bass, Compressor, Limiter) as the active performer's defaults in
SingerAudioSettings, and records active Key and Tempo intoSingerHistory. - Recall Singer: Reloads stored profile audio defaults on demand, resetting the DSP chain and slider controls if adjustments were made during the performance.
- Save to Singer: Instantly saves current Audio Controls slider values (Volume as Vocal Gain, Treble, Mid, Bass, Compressor, Limiter) as the active performer's defaults in
- Located on the Audio Controls card header next to "Reset Audio":
- Singer History DataGrid Tracking:
- Dedicated "Key" and "Speed" columns in the Singer History tab (
KaraokePage.xaml) display historical transposition and tempo settings for every completed song. - Re-adding songs from Singer History back into the rotation queue retains historical key and tempo settings automatically.
- Dedicated "Key" and "Speed" columns in the Singer History tab (
- Native Windows WASAPI mmdevice Audio Pipeline:
LibVlcVideoBackendandBackgroundMusicPlayernow route all audio output directly through Windows Core Audio WASAPI (mmdevice) for both default and custom audio output devices, completely bypassing legacy DirectSound/WaveOut software mixer attenuation.- Expanded software volume headroom up to 200% (+6 dB clean digital gain boost), ensuring playback loudness matches native media player levels without cranking volume controls to maximum.
- Recalibrated default integrated loudness normalization to -12 LUFS (matching commercial live performance/DJ standards), delivering punchy, loud audio output.
- Master Output Boost / Preamp (USB Mixer Mode):
- Adjustable digital preamp slider from 0 dB to +12 dB with dedicated quick presets for
0 dB (Standard),+6 dB (USB Mixer), and+12 dB (Maximum). - Specifically designed for external sound cards and USB audio interfaces like the Yamaha MG10XU (Channel 9/10 USB stereo return), supplying a robust, punchy +4 dBu professional line-level signal directly from Windows without having to crank mixer channel gain knobs to their physical limits.
- Master preamp boost settings automatically apply across all playback channels (Karaoke performances, Opening Music, Fill-in Music, and End-of-Rotation Music) ensuring seamless, matched volume levels throughout the entire show.
- Adjustable digital preamp slider from 0 dB to +12 dB with dedicated quick presets for
- Anti-Clipping Peak Limiter:
- Embedded a transparent soft-knee peak compressor/limiter into LibVLC's playback pipeline (
--audio-filter=compressor), protecting against digital clipping, distortion, or harsh speaker spikes when high-gain tracks are played.
- Embedded a transparent soft-knee peak compressor/limiter into LibVLC's playback pipeline (
- Instant Search & Query Isolation:
- Batched collection updates replace individual item additions, updating search tables instantaneously without visual stuttering or UI thread thrashing.
- External streaming queries (Spotify, YouTube, Amazon) are isolated exclusively to the "Streaming Links" tab, ensuring local library song lookup is immediate and free of background network overhead.
- Dedicated one-click clear button (
โ) integrated directly inside the search box for rapid query resets. - Fully enabled UI recycling virtualization on all search DataGrids, ensuring smooth scrolling across thousands of tracks.
- Responsive Tablet Touch Sizing & Column Protection:
- Locked action buttons in search results (Add to Rotation, Singer History, and Singer Queue) to dedicated 52px non-collapsing columns with generous 38x32px touch targets.
- On 1920x1080 tablets operating at 150% or 175% Windows DPI scaling, action buttons maintain their full proportions and never compress into thin vertical lines.
- Enforced a 360px minimum width on the search panel to prevent column squishing on compact screens.
- One-Click Host & Remote Activation: Standout emerald green "Last Round" button positioned directly after the Clear button across host interfaces (
RotationPage.xaml,MainWindow.xaml,MainPage.xaml) and on the Remote DJ Board (dj.html), immediately synchronizing across the rotation lifecycle, embedded servers, and display services. - Audience Screen Announcement: Bold crimson banner (
โ THE LAST ROUND FOR THE NIGHT IS CURRENTLY UNDERWAY โ) displayed prominently on the LyracistRotationWindow, KSRotationSingerDisplayWindow(across all display projection styles), KSRotation.MauiBillboardView(on-device attractor and external HDMI/Presentation displays), Remote DJ Board (dj.html), and the real-time web billboard (billboard.html). - Dynamic Queue Pruning: Once a performer has sung in the last round, they are automatically hidden from the audience rotation queue (now singing, next, on-deck), while remaining visible on host and remote DJ screens with a distinct
DONE (LAST ROUND)indicator badge.
- Two-Click DJ Linking: Click the ๐ button on one singer, then on another, to link them - no other singer can ever be inserted between them (a new signup, a drag/drop reorder, or a move up/down all respect the pairing). Clicking ๐ on an already-linked singer unlinks it; linking a singer that's already linked elsewhere breaks the old link first. The link stays in effect all night until the DJ unlinks it - there's no auto-unlink.
- Perform Back-to-Back, Then Reunite for Next Time: When the current half of a pair finishes and floats to the bottom (with "Float Current Singer to Top" on) while the other is promoted to sing next, they're expected to separate for that moment - adjacency enforcement steps aside while either half is the current singer, so the finished singer isn't dragged back up mid-handoff. Once neither half is current anymore (both have had their turn), they're automatically pulled back together for their next joint turn - the link never needs to be re-applied.
- Pause-Safe, Not Inactive-Safe: A linked singer can be Paused without losing its place or its partner - it's simply skipped over, same as any paused singer. Marking one half Inactive ("out for the night") is different: the still-active partner isn't forced to follow it into the retired section.
- Shared Enforcement:
RotationHelpers.LinkSingers()/UnlinkSinger()/EnforceLinkedAdjacency()(Shared/RotationHelpers.cs) drive all three apps identically. Shows as a "๐ [partner]" badge in Lyracist'sRotationPage, KSRotation'sMainWindow(list + right-click menu), and KSRotation.Maui'sMainPage.
- Per-Singer Wait Badge: Every waiting singer's name on the audience-facing rotation displays shows an estimated wait in minutes, e.g.
Dennis {5} Only Make Believe- the cumulative estimated performance length of everyone ahead of them, using each song's actual known duration + 30 seconds where available, or a DJ-configurable default-length fallback otherwise. - DJ Can Turn It Off Entirely: A "Show Estimated Wait Time on Rotation Screens" toggle (Lyracist's Settings page, Display tab; KSRotation's Settings tab) hides the badge everywhere at the DJ's discretion - some DJs don't want the audience seeing wait estimates at all. On by default; takes effect immediately.
{N} = Estimated Wait TimeLegend on Every Display: So patrons aren't left guessing what the number in braces means, a small explainer appears alongside the badge on every display it can show on - Lyracist's Normal List and Star Wars Crawl, KSRotation's Normal List, Star Wars Crawl, Vegas/Broadway Marquee, and Vinyl Record views, and KSRotation.Maui's Billboard view. On the Marquee/Vinyl/Normal-List views the section label itself ("UP NEXT"/"ON DECK") always stays visible - only the explainer suffix hides with the toggle. Patron-facing web pages (kiosk, DJ remote, billboard, patron portal, mobile tablet) don't currently show the badge at all, so there's nothing to gate there yet.- Configurable Default Song Length: A "Default Song Length" setting (same Settings screens) controls the fallback used when a song's actual duration isn't known - defaults to 4.75 minutes (closer to a typical song's actual runtime than a flat 5), adjustable in quarter-minute steps from 2 to 8 minutes; grayed out while the toggle above is off. KSRotation.Maui shares both settings (no dedicated UI of its own yet) and falls back to the same defaults (shown, 4.75-minute).
- Shared Calculation: A single
RotationHelpers.RecalculateEstimatedWaits()(Shared/RotationHelpers.cs) drives all three apps identically, recalculated automatically the moment a singer is added, marked current, reordered, paused/inactive-toggled, removed, or marked finished, so waiting singers' estimates never go stale. - Wired Into Every Display Mode: Lyracist's
RotationWindow(queue list, Star Wars Crawl, scrolling marquee), KSRotation'sSingerDisplayWindow(Normal List, Marquee, Vinyl), and KSRotation.Maui'sBillboardView.
- Microsecond In-Memory Header Extraction:
- Embedded
TagLibSharpinLyracist.Datafor direct in-memory audio/video duration and genre extraction (<0.1ms per track), eliminating external process spawning overhead (ffprobe.exe).
- Embedded
- Direct ZIP-CDG Stream Extraction (
StreamFileAbstraction):- Probes MP3 streams directly from inside
.ziparchives in RAM without decompressing temporary audio files to%TEMP%on disk.
- Probes MP3 streams directly from inside
- Embedded ID3/MP4 Metadata Recovery:
- Automatically resolves track artists and titles from embedded ID3v2/MP4 tags when filename conventions omit the artist name.
- Loop-Free Probed Tracking:
- Automatically populates
song.Genreand marksTags = "none"when tags are absent, ensuring subsequent library scans skip already-probed tracks immediately.
- Automatically populates
- Parallel Scaled Concurrency:
- Scales background probing workers up to
Math.Max(8, Environment.ProcessorCount * 2)(16โ32 parallel workers) with batched SQLite transactions and FTS5 search index synchronization, reducing 50,000-song follow-up scan times from 3+ hours to under 1โ2 minutes.
- Scales background probing workers up to
- Centralized Application Taxonomy:
Settings/: Consolidated application configuration folder with distinct per-app naming (lyracist_settings.json,ksrotation_settings.json,knockout_trivia_settings.json,lyracist_trivia_settings.json,scaryoke_settings.json,dbeditor_settings.json,keygen_settings.json,ksrotation_venues.json,ksrotation_djs.json,VenueGraphics/).Data/: Centralized database and persistence folder (lyracist.db,trivia.db,ksrotation_night_db.json,ksrotation_singers.json,wifi_passwords.json,keygen.db).Banners/: Centralized root banners repository organized into dedicated per-app subdirectories:Banners/: shared by every app -DJBanners/,EventBanners/(including 16:9 standard event banners),Announcements/,CategoryBanners/(15 themed trivia category graphics) andCustomBanners/.
Packs/: Single shared packs repository containing 16 curated JSON trivia packs used interchangeably across all trivia applications.Logs/: Centralized log directory with sanitized app-distinguished logs ({app}_app_{date}.logand{app}_err_{date}.log).
- Transparent Legacy Migration: All services across all applications automatically check for legacy configuration/data files in
%AppData%,%LocalAppData%, or old subfolders on startup, transparently copying them forward to the consolidated directories without user intervention.
- Fast-Paced Bar-Friendly Elimination Game:
- Standalone MVVM WPF desktop app targeting .NET 10 with modern Fluent UI dark styling (
WPF-UI). - Compatible with the shared
Data/trivia.dbSQLite database andPacks/*.jsontrivia packs.
- Standalone MVVM WPF desktop app targeting .NET 10 with modern Fluent UI dark styling (
- ๐ฑ Phone & Tablet Connect Screen (
ConnectView.xaml/ConnectViewModel.cs):- Dual QR Code Cards:
- ๐ถ Wi-Fi Connect QR: Automatically generates a high-resolution dark purple QR code (
#4C1D95,WIFI:S:...) for instant venue Wi-Fi connection. - ๐ฑ Game Arena QR: High-resolution dark green QR code (
#064E3B) linking tohttp://<local-ip>:<port>for zero-install smartphone/tablet browser play.
- ๐ถ Wi-Fi Connect QR: Automatically generates a high-resolution dark purple QR code (
- Live Connected Player Roster: Shows connected mobile players in real-time with strike dots, shield tokens, and online indicators.
- Secondary Screen Projection: Instant sync with
AudienceWindowto display large QR codes on venue TVs and projectors.
- Dual QR Code Cards:
- ๐ Embedded Asynchronous Web Server & Mobile Companion App (
knockout.html):- Built-in
TcpListenerserver hosting REST endpoints (/api/knockout/join,/api/knockout/submit,/api/knockout/state) with GUID session token authentication and payload validation. - Mobile web app with touch buttons, haptics, Web Audio synthesized sounds, live strike counters (๐ข๐ข๐ข -> โ -> ๐ฅ), shield badges (๐ก๏ธ), and spectator mode.
- Built-in
- ๐งช Testing Module & In-App DJ Bot Simulator (
KnockoutTrivia.Tests/SimulatorView.xaml):- Automated Test Project (
KnockoutTrivia.Tests): xUnit v3 automated test suite for game state transitions, scoring, token defense, streaks, web server endpoints, and wheel/banner services. - In-App DJ Bot Simulator Tab (
MainWindow.xaml): Virtual bot player manager (spawns 1 to 30 bots), automated answer simulation with configurable accuracy and reaction times, auto-play round execution, instant Super Streak wheel rehearsal, and live diagnostics terminal.
- Automated Test Project (
- โก Automatic Game Flow & Internal Scoring Engine:
- Automated question timer with real-time countdown.
- Automatic answer evaluation upon timer expiry or DJ reveal (shield tokens absorb strikes; wrong answers without shields accumulate strikes).
- Autonomous advance cycling in Automatic Mode (
GameAdvanceMode.Automatic).
- Horizontal Dynamic Scoreboard:
- Dynamic strike-tinted player status bars: Green (0 strikes), Yellow (1 strike), Orange (2 strikes), and dimmed Red (Knocked Out / 3 strikes).
- Shield Tokens: Hold 0 to 3 shield tokens that absorb strikes when an incorrect answer is given.
- Streak Meters: 5-block continuous streak progress meters that award a shield token on every multiple of 5 consecutive correct answers without wiping streak progression.
- โก Super Streak Scaryoke-Style Target Wheel:
- Reaching the Super Streak threshold (default: 20 consecutive correct answers) triggers a rotary wheel containing all opponents who currently hold tokens.
- ๐ Automatic Question Randomization & Inter-Category Shuffling:
- Uniform Fisher-Yates deck shuffling across all loaded SQLite databases and category packs on startup and game resets, ensuring categories are thoroughly mixed rather than presented in sequential category chunks. Includes on-demand DJ '๐ Shuffle' control.
- โ Comprehensive DJ Help & Rules Guide:
- Built-in split-pane Help system covering game rules, elimination mechanics, shield token defense, 5-block streak meters, Super Streak wheels, live DJ adjudication, 16:9 banner projection, and configuration options.
- 3-Column DJ Settings & Multi-Database Selection ListBox:
- 3-column responsive layout preventing vertical scrolling:
- Column 1: Game scoring, question count, auto/manual flow buffers, and audio/visual FX toggles.
- Column 2: Shield caps, streak requirements, and Super Streak wheel settings.
- Column 3: Interactive Database & Pack selection ListBox (with individual checkboxes, 'All' and 'Clear' buttons, and live question count badges) alongside Multi-Monitor & TV Routing controls.
- 3-column responsive layout preventing vertical scrolling:
- ๐ฅ๏ธ Multi-Monitor Routing & Dedicated Audience Projection Window (
AudienceWindow):- Automatically enumerates all connected physical displays, laptops, secondary TVs, and venue projectors with hardware names and resolutions.
- Independent monitor routing: DJ Host Screen assignment and Audience Big Screen assignment.
- Dedicated borderless 16:9 auto-scaling Audience Window (
AudienceWindow.xaml) that displays high-contrast questions, reveals, rotary wheels, and scoreboards to the crowd while keeping DJ controls (scoring, adjudication, settings, help) private to the host. - Titlebar quick-action
๐บ Audience Screenbutton for instant one-click projection toggle.
- 16:9 Auto-Scaling Presentation Banners:
- Dynamically generated 16:9 game-show screens (Intro, Intermission, Champion Winner, Elimination, Super Streak) with official Knockout Trivia branding (
kotrv_logo.png/kotrv_logo.webp).
- Dynamically generated 16:9 game-show screens (Intro, Intermission, Champion Winner, Elimination, Super Streak) with official Knockout Trivia branding (
- DJ Control Center & Multi-Monitor Support:
- Dual-monitor routing for DJ host console and audience screens.
- Configurable points per answer, question limits, timers, token caps, super streak thresholds, and audio/visual toggles.
- Centralized Smart Proper-Casing (
Shared/NameFormatting.cs):- Automatically capitalizes singer names, duet partners, artists, and song titles cleanly across all applications (
Lyracist,KSRotation,KSRotation.Maui,LyracistDbEditor,ScaryokeWheel).
- Automatically capitalizes singer names, duet partners, artists, and song titles cleanly across all applications (
- Mixed-Case Preservation:
- Capitalizes the initial letter of every word while preserving user-typed internal or trailing uppercase letters (e.g.
DeaR->DeaR,deaR->DeaR,LeBron->LeBron,vanBuren->VanBuren,MacDonald->MacDonald). - Completely fixes the bug where previous lowercase transformations wiped out custom performer or band stylizations (e.g. turning
DeaRintoDear).
- Capitalizes the initial letter of every word while preserving user-typed internal or trailing uppercase letters (e.g.
- Apostrophe Name Prefixes:
- Automatically detects single-letter surname prefixes with apostrophes (e.g.
O',D',L',M') and capitalizes both the prefix and the root surname (e.g.o'neal/O'neal/O'NEAL->O'Neal,d'angelo->D'Angelo,l'amour->L'Amour).
- Automatically detects single-letter surname prefixes with apostrophes (e.g.
- Scottish & Irish "Mc" Prefixes:
- Surnames starting with
Mcautomatically receive root-letter capitalization (e.g.mcdonald/MCDONALD->McDonald,mccartney->McCartney).
- Surnames starting with
- Hyphenated Compound Names:
- Capitalizes words separated by hyphens (e.g.
mary-ann smith->Mary-Ann Smith,smith-o'neal->Smith-O'Neal).
- Capitalizes words separated by hyphens (e.g.
- Acronyms, Roman Numerals & Contractions:
- Intelligently preserves uppercase for standard audio acronyms (
DJ,MC,TV,CD,DVD) and Roman numerals (II,III,IV,VI,VII,VIII,IX,X,XI,XII), while keeping song title contractions correctly lowercased (e.g.Don't Stop Believin',Rock 'N' Roll).
- Intelligently preserves uppercase for standard audio acronyms (
-
Split-Screen Venue Kiosk UI Across All Apps (
KSRotation,KSRotation.Maui,Lyracist):- Designed specifically for venue-mounted landscape tablets, giving patrons a self-service kiosk to search songs and join rotation without disturbing the DJ.
- Attractor / Welcome Screen: Fullscreen ambient welcome screen when idle with glowing microphone hero, animated pulsing "TOUCH SCREEN TO JOIN THE ROTATION" call-to-action, live stage snapshot (Now Singing, Up Next, Queue Count), and 4 visual step-by-step instructions.
- Touch-to-Start & Auto-Return: Touching anywhere on the screen immediately enters the request station. The station automatically returns to the Attractor screen after 45s of inactivity or upon completing a request submission.
-
PWA Standalone & Fullscreen Mode: Includes web app manifest meta tags and an interactive
โถ Fullscreentoggle button in the header bar for full screen presentation without browser address bars on iOS/iPadOS and Android tablets. -
Left Side (62% width): Performer details with auto-fill, request type toggle (Karaoke vs Background Track), instant Apple iTunes catalog search with debounced dropdown, manual song & artist entry, and pitch key adjustment selector (
$-2, -1, 0, +1, +2$ ). - Right Side (38% width): Real-time rotation queue with high-visibility ๐ค NOW SINGING and โณ UP NEXT spotlight cards at the top.
- Tap-to-Select Performer Name: Tapping any singer row on the right automatically populates that name into the request form on the left, preventing spelling variations across rounds.
-
Queue Slot Prediction: Shows prospective singers where they will enter in the rotation (e.g.
โ Spot #6 in rotation) before submitting. - Auto-Reset & Inactivity Protection: 5-second post-submission confirmation countdown modal and a 45-second inactivity watchdog that clears abandoned forms.
-
Kiosk Setup & QR Popout in
KSRotation&Lyracist:- One-click
[ Kiosk ]button on the desktop Patron Portal panel and Settings pages opensKioskQrCodePopoutWindow.xamlwith high-contrast QR code, direct URL, and clipboard copy.
- One-click
-
3-Way QR Portal Selector in
KSRotation.Maui:-
ConnectQrOverlayprovides quick one-tap switching between๐ฑ Patron,๐ Kiosk, and๐ง DJQR codes and URLs.
-
- Grace Period Timer & Fill-In Music:
- Automatically initiates a configurable grace period countdown (default 15s) when a song finishes.
- Automatically spins up ducked fill-in background music between performers.
- Broadcasts stage announcement:
"Next singer: {name} โ please come to the stage"on the rotation billboard.
- Large High-Contrast DJ Control Buttons:
โถ START SONG(StartSongButton): Stops grace timer and fill-in music, loads the song, updates projection and tablet lyric displays, and immediately begins playback.โญ SKIP SINGER(SkipSingerButton): Advances singer queue without scoring the skipped song, keeps fill-in music running, and restarts the grace period for the next performer.
- State Machine Protection (
AutoAdvanceState):- Guards against accidental double-starts via
StartingSongtransition lock. - Interlocks with Trivia and Scaryoke modes so auto-advance never triggers during mini-games.
- Safely falls back to
WaitingForSongSelectionif the upcoming singer has not chosen a track yet.
- Guards against accidental double-starts via
- Global Select-All on Focus:
- Across every application in the suite (
KSRotation,Lyracist,Lyracist.Trivia,TriviaDbCreator,LyracistDbEditor,LyracistKeyGen,ScaryokeWheel), clicking or tabbing into anyTextBox,PasswordBox, or numeric input box automatically highlights and selects all existing text. - Game masters, KJs, and hosts can immediately begin typing new values without having to backspace, clear, or double-click to select existing text.
- Subsequent clicks within an already-focused text box allow natural caret placement, character editing, and partial text selection without interference.
- Across every application in the suite (
- New Singer Addition Auto-Focus & Select-All:
- When adding a new performer to the rotation queue, the system automatically scrolls the list directly to the newly inserted row, focuses the singer name field, and highlights the default
"New Singer"text so the host can instantly type the performer's actual name.
- When adding a new performer to the rotation queue, the system automatically scrolls the list directly to the newly inserted row, focuses the singer name field, and highlights the default
- Vertical Mode (Portrait Orientation):
- When the tablet is held vertically, the layout automatically reflows to place the Active Rotation Queue at the top of the screen across full width, and positions the Patron Request Portal (QR code) and Incoming Requests side-by-side at the bottom of the screen.
- This eliminates wasted screen real estate on portrait tablets, maximizing vertical space for the performer list.
- Horizontal Mode (Landscape Orientation):
- In landscape orientation, the layout retains the two-column view with Rotation on the left (
*) and the Portal & Requests sidebar on the right (280px).
- In landscape orientation, the layout retains the two-column view with Rotation on the left (
- Layout Dispatch Safeguarding:
- Orientation layout updates are safely dispatched via
Dispatcher.Dispatchwith atomic collection assignment to guarantee smooth orientation transitions without re-entrant layout cycles.
- Orientation layout updates are safely dispatched via
- Android Self-Contained Deployment:
- Embedded assembly packaging (
EmbedAssembliesIntoApk = true) and platform OS guards ensure reliable, standalone deployment and launch on Android tablets without fast-deployment synchronization failures.
- Embedded assembly packaging (
- First-Button Finished Checkmark (
โ):- Reordered performer card action buttons so the finished song checkmark (
โ) is positioned as the first button in the actions bar, matching the ergonomics and muscle memory of the desktop and MAUI consoles.
- Reordered performer card action buttons so the finished song checkmark (
- Modal Popup Performer Addition:
- Converted the static inline "Add Performer to Rotation" form into a dedicated action button and top rotation toolbar button that opens a focused modal overlay dialog (
#add-performer-modal). - Automatically focuses and selects the singer name field upon opening, submits on
Enter, and dismisses onEscapeor backdrop click for frictionless singer additions from anywhere in the venue.
- Converted the static inline "Add Performer to Rotation" form into a dedicated action button and top rotation toolbar button that opens a focused modal overlay dialog (
- Visual Category & Question Authoring: Standalone WPF MVVM desktop app using Fluent UI (
WPF-UI) for creating, editing, and expanding trivia question databases. - Left Sidebar Pack Explorer: Auto-discovers and navigates all JSON question packs in
Packs/with search filtering and question count indicators. - Interactive Question Editor: Real-time editor with colored option cards (โฒ Purple, โ Cyan, โ Amber, โ Rose), correct answer radio toggles, difficulty dropdown, and explanation notes.
- 1-Click Option Balancing: Automatically shuffles option positions across all questions in a pack to guarantee an even ~25% distribution across choices A, B, C, and D.
- 16:9 Banner Studio: Generates high-resolution 16:9 Category Announcement Banners (
Banners/CategoryBanners/{pack}.png) with one click. - Direct SQLite Seeding: 1-click database synchronization updating
Data/trivia.db.
- High-DPI Singer Box & Action Button Sizing:
- Singer display boxes in
KSRotationfeature expanded vertical padding (Padding="2,6,2,10",MinHeight="80"), clean 30px outlined buttons, and bottom margins, ensuring the bottom border of the"โ Finish","โฒ", and"โผ"buttons is crisp and completely visible on 1080p laptop displays under any DPI scaling.
- Singer display boxes in
- Smart End-of-Round Singer Insertion:
- Newly added singers are placed at the end of the current active rotation round (right before the 1st singer round anchor
IsRotationStart), ensuring they perform in the current cycle before already-sung performers repeat in the next round.
- Newly added singers are placed at the end of the current active rotation round (right before the 1st singer round anchor
- Accurate Inactive Performer Accounting:
SingersInRotationCountstrictly excludes inactive singers (IsInactive = true) and background music tracks, reflecting the true number of performers waiting in rotation.
- Float Current Singer to Top Option:
- Toggling
"Float Current to Top"keeps the currently performing singer at index 0 (top of the rotation list). - When songs finish, the performer shifts to the end of the queue and the next active singer automatically floats to the top, eliminating scrolling down long rotation queues during busy live shows.
- Toggling
- Rotation Anchor (Round Start Flag & DJ Tablet Sync):
- Displays a visual red
โ ANCHORbadge next to the performer the rotation round is anchored to. - Highlights the Rotation Anchor's card with a subtle red background (
--row-start-bg) and border across the desktop app, Remote DJ Board (dj.html), Mobile Performer Portal (mobile.html), and Patron Request Portal (PatronPortal.html). - Allows the DJ to instantly see when a full rotation cycle/round has completed once that singer returns to the top.
- Any singer can be designated as the Rotation Anchor via the
"Set as Rotation Anchor"context action, desktopโbutton, or DJ tabletโaction button.
- Displays a visual red
- Move to Top of Rotation Option:
- Adds a dedicated option on each singer across all applications to "Move to Top of Rotation", allowing hosts to immediately move a skipped or returned singer to the top of the active queue to perform next without having to click Move Up repeatedly.
- Places the singer at slot 1 (Next Up) when an active performer is currently singing, or at index 0 when no singer is performing.
- Anchor Singer Preservation: Moving a performer to the top does not in any way change, reassign, or alter the Rotation Anchor (
IsRotationStart). The anchor singer marks round progression and remains strictly preserved; re-anchoring still requires manual assignment if desired. - Automatically clears any skipped (
IsSkipped), paused (IsPaused), or inactive (IsInactive) flags (andHasSungInLastRoundin last round mode) so the performer is immediately restored to full active eligibility. Duet/linked partners remain adjacent. - Accessible via right-click ContextMenu across Lyracist and KSRotation, individual singer row buttons (upload arrow /
โค), toolbar buttons, and the Remote DJ web portal.
- Manual Game Flow Controls for DJ / Game Master (
Lyracist.Trivia):- Interactive Host Pacing (Manual Mode): When
โก Auto-Run Gameis toggled off, questions load into a ready Reading/Standby state with the timer paused, giving the DJ full control to read the question over the venue microphone before initiating the countdown timer. - Question Navigation & Direct Jump: Seamlessly move backwards (
โฎ Prev) or forwards (Next โญ), or select any question index directly from the jump dropdown to review or present questions on demand. - Dynamic Timer Bump & Trim: On-the-fly adjustment buttons (
[-5s],[+5s],[+10s],[๐ Reset]) let the host give players more thinking time or accelerate countdowns dynamically based on live room reactions. - Staged Fade, Instant Reveal & Question Voiding: Manually eliminate incorrect choices one by one (
โ Fade Option), instantly reveal answers (โก Instant Reveal), or nullify flawed questions (โ Void Question) without penalizing player scores or streaks. - DJ Keyboard Shortcuts: Complete hands-on-keyboard operation via
Spacebar(Pause/Resume Timer),Right Arrow/PageDown(Next Question), andLeft Arrow/PageUp(Previous Question).
- Interactive Host Pacing (Manual Mode): When
- Live Settings Synchronization & Instant Persistence:
- Modifying question countdown duration, elimination fade intervals, post-reveal delay, point values, or auto-run settings immediately syncs to the active game engine and persists to storage without requiring manual saves or game restarts.
- Randomized Wrong Answer Elimination:
- Uses Fisher-Yates randomization so wrong answers fade in unpredictable sequences on every question, eliminating any positional pattern tells.
- Responsive Game Complete & Intermission Screen:
- Side-by-side leaderboard table and intermission sign-up QR cards ensure Wi-Fi and join QR codes never overlap the bottom connection or copyright bar on any display resolution.
- Tiered Option Value Scoring (100% / 70% / 40%):
- Dynamic Multiplier Tiers: Base points awarded scale dynamically based on how many options remain visible when a player buzzes in:
- 4 Options Visible: 100% Points (1,000 pts default). Awards full points to players with instant knowledge before any wrong options fade.
- 3 Options Visible: 70% Points (700 pts default). Automatically drops as the 1st wrong option fades at the 2/3 countdown mark.
- 2 Options Visible (50/50): 40% Points (400 pts default). Automatically drops as the 2nd wrong option fades at the 1/3 countdown mark.
- Live Mobile Multiplier Pill (
trivia.html): Mobile devices display a real-time point multiplier badge (โก 100% VALUE,โก 70% VALUE,โก 40% VALUE) above the buzzer buttons, visually syncing with fading options on the big screen. - Configurable in Trivia Settings: Enable/disable tiered scoring and customize option percentages across all applications.
- Dynamic Multiplier Tiers: Base points awarded scale dynamically based on how many options remain visible when a player buzzes in:
- 15 Category Starter Databases (2,250 Questions) with Balanced Option Distribution:
- Every single category database contains 150 curated, accurate questions with explanations, and multiple-choice answers evenly distributed across all 4 options (~25% A, ~25% B, ~25% C, ~25% D).
- Dynamic Auto-Discovery: Users can create and drop unlimited custom JSON question packs into
Packs/with automatic database seeding on startup:- Famous Lines & Sayings From Movies (
famous_movie_quotes.json) - 150 questions - Bikers & Motorcycles (
biker_trivia.json) - 150 questions - Rock & Roll (
rock_and_roll.json) - 150 questions - Country Music (
country_music.json) - 150 questions - Complete the Lyric (
complete_the_lyric.json) - 150 questions - Music Legends (
music_legends.json) - 150 questions - Blockbuster Movie Soundtracks (
movie_soundtracks.json) - 150 questions - 80s & 90s Pop Culture (
pop_culture_80s_90s.json) - 150 questions - TV Shows (
tv_shows.json) - 150 questions - Logos & Slogans (
logos_and_slogans.json) - 150 questions - World Geography (
geography.json) - 150 questions - State & World Capitals (
state_capitals.json) - 150 questions - World History (
history.json) - 150 questions - Sports & Athletes (
sports.json) - 150 questions - Pub Trivia All-Stars (
pub_general_knowledge.json) - 150 questions
- Famous Lines & Sayings From Movies (
- Unified 70:30 Pre-Game Lobby & Category Showcase (
TriviaDisplayWindow):- 70% Left Hero Column: High-resolution 16:9 Category Announcement Banner (
Banners/CategoryBanners/{pack}.png) with ambient illuminated border, tonight's category theme title, and topic subtitle. Dynamic cross-pack syncing automatically updates the big screen whenever the Game Master selects a category from the dropdown. - 30% Right Onboarding Stack:
- โฑ๏ธ Game Start Countdown Clock: Large digital timer with pulsing amber badge that ticks down to game launch.
- ๐ถ 1. Connect to Wi-Fi Card: Dedicated scan-to-connect Wi-Fi QR code with venue SSID and WPA password.
- ๐ฑ 2. Join Trivia Game Card: Dedicated scan-to-join mobile buzzer QR code pointing to
http://<LAN-IP>:8085/triviawith direct URL.
- Bottom Connection & Copyright Bar: Displays mobile buzzer play address, company copyright information (
ยฉ 2026 PAROLE Software - Licensed under GPL-3.0-or-later.), and app branding. - Full-Width Ticker Bar: Continuous horizontal marquee scrolling venue announcements, host branding, game rules, and buzzer tips.
- 70% Left Hero Column: High-resolution 16:9 Category Announcement Banner (
- Single-Click Pre-Game Launch (
๐ฏ Launch Pre-Game Lobby & Countdown):- A single primary action button in the Game Master console that opens/focuses the big screen, locks the category banner, starts the pre-game countdown, and activates the lobby with one click. Accompanied by
"โถ Start Game Now (Skip Countdown)"for instant kickoff which immediately opens and hydrates the live question projection screen and halts background lobby timers.
- A single primary action button in the Game Master console that opens/focuses the big screen, locks the category banner, starts the pre-game countdown, and activates the lobby with one click. Accompanied by
- 16:9 Category Announcement Banners (
Banners/CategoryBanners/):- Clean 1920x1080 (16:9) graphic banners generated for all 15 categories, focusing on category branding and theme callouts without hardcoded question counts or timers so banners stay accurate regardless of host configuration.
- Automated Solution Asset Copying:
- Configured
Packs\**\*,Banners\**\*, andData\**\*withCopyToOutputDirectory=PreserveNewestacross all projects, ensuring category packs, announcement banners, databases, and configuration automatically copy to build outputs.
- Configured
- Accurate Multi-Monitor Projection: Select any connected monitor (TV, secondary HDMI, projector) from the host console and cast seamlessly with physical resolution DPI awareness without forcing to Monitor 0.
- Venue & Game Master Customization: Customize Venue Name and Game Master / Host Name directly in the โ๏ธ Settings & Display tab with instant two-way live update across projection monitors and mobile buzzer devices.
- Application Exit & Projection Screen Controls: 1-click โ Exit button in the main Game Master header bar immediately and cleanly terminates all background socket servers and timers. Press Escape (
Esc) to close/exit the venue projection window, click the floatingโclose button in the top-right corner, or right-click anywhere for context menu options. - Dedicated Venue Connect Instructions Screen:
- Dual QR Code Architecture: Projects two enlarged high-contrast QR cards (380ร380 px) on venue screens:
- 1. Connect to Wi-Fi: High-resolution scan-to-connect QR code with SSID and password for 1-tap phone connection.
- 2. Join Trivia Game: High-resolution mobile buzzer QR code and URL for mobile buzzer login (
http://<ip>:8085).
- Pre-Game Countdown Clock: Live digital countdown clock (
"โฑ TRIVIA GAME STARTS IN: 04:59") that automatically starts ticking when the screen is cast to the monitor, and auto-starts the game upon reaching 00:00. - Host Game Master Controls: Rapid timer adjustments (
+1m,+5m,Reset), screen toggle button, and one-click Wi-Fi auto-detection.
- Dual QR Code Architecture: Projects two enlarged high-contrast QR cards (380ร380 px) on venue screens:
- Top Scrolling Player & Score Marquee: Continuous horizontal ticker across the top of the venue display window displaying registered players, teams, and live scores, with a special gold crown badge highlighting the top scorer.
- 3-Tab Game Master Console & Settings Page:
- ๐ฏ Live Game Master: Streamlined live command deck with pack picker, auto-run switch, live question visualizer, QR connection code, scoreboard, and round flow controls.
- โ๏ธ Settings & Display: Dedicated 3-column no-scroll settings tab for Intermission delay (minutes), auto-start toggle, display monitor selector, question timers (15s), wrong answer elimination speed (5s), post-reveal buffer (5s), scoring rules, sound effects, port, and venue branding.
- ๐ฅ Players & Teams: Full roster grid with player names, team names, total points, streaks, answer statistics, and player kick/removal tools.
- Post-Game Intermission Countdown & Automatic Next Game Start:
- When a game finishes, if auto-start is enabled, an intermission countdown runs for the configured duration (e.g. 3 minutes).
- Venue display, GM console, and mobile web app display a live ticking countdown banner (
"๐ฎ NEXT TRIVIA ROUND STARTS IN: mm:ss"). - Host can click
"โถ Start Now (Skip)"to bypass the intermission, and once expired, the engine automatically selects the next question pack (or reshuffles) and launches the new round.
- Connect Instructions Screen & Dedicated Trivia Pages:
Lyracist: Access"๐๏ธ Preview Connect Screen"inSettingsPage(Column 4: Connect & Request Instructions), with full Trivia controls and configuration cleanly located in dedicated Trivia and Trivia Settings pages.KSRotation: Preview the Wi-Fi and Request Connect screen directly from theConnect & Request Instructionsdisplay settings, while Trivia rounds and configuration remain organized in dedicated Trivia and Trivia Settings tabs without cluttering the primary Rotation toolbar.
- Configurable Questions Per Game: Set the number of questions per game round (5, 10, 15, 20, 25, 50, 100, or custom). Slices the randomized question pack to the exact number desired.
- Game Complete Winner Celebration & Team Announcements:
- Automatically calculates final rankings upon completing the allotted questions.
- Venue Display Screen (
TriviaDisplayWindow): Shows a gold trophy celebration screen with the winning score and announces the champion. If a team wins, prominently shows"๐ WINNING TEAM: {TeamName}"and lists all team members. - Mobile Player App (
trivia.html): Mobile devices display the winner announcement, full team member breakdown, personal placement rank, final score, and full top 10 leaderboard. - Host Console (
MainWindow): Displays winning team/player banner with roster and score breakdown.
- Zero-Config LAN Mobile Web Server (
TcpListener): Direct socket HTTP server listening on0.0.0.0(all interfaces) with RFC 1918 LAN IP resolution, allowing smartphones and tablets on local Wi-Fi to load buzzers and buzz in without Windows URL reservation restrictions or admin privileges. - Dynamic Question Shuffling: Questions are automatically shuffled when a category pack is selected and when each game begins, ensuring questions appear in a unique randomized sequence each time a category is played.
- Dynamic Multi-Monitor Selection: Host console allows selecting any connected display monitor (Monitor 1, Monitor 2, TV / HDMI) to dynamically project the venue display screen with DPI awareness.
- Auto-Running Gameplay & 5-Second Progressive Elimination:
- Automatically progresses through questions with a live 15-second countdown timer on big screen and mobile buzzers.
- After 15 seconds, incorrect answers sequentially fade out one every 5 seconds until only the correct answer remains illuminated.
- After showing the correct answer with full explanation, pauses for 5 seconds before automatically advancing to the next question.
- Dedicated Solution Folders (
Data/,Settings/,Packs/,Banners/): Centralized repository containing SQLite databaseData/trivia.db, game settingsSettings/lyracist_trivia_settings.json, customizable JSON question packs inPacks/, and 16:9 high-resolution category announcement banners inBanners/CategoryBanners/. - 14 Curated Category Question Databases (1,450 Questions Total, No Duplicates):
- ๐๏ธ Bikers & Motorcycle Culture: 150 high-octane questions covering Harley-Davidson, Indian, classic choppers, engine mechanics, famous biker movies, historic rallies, MC culture, and legendary rides.
- ๐ธ Rock & Roll: 100 questions on classic rock, 70s/80s arena bands, iconic albums, guitar legends, and rock history.
- ๐ค Country Music: 100 questions on outlaw country, 90s anthems, Grand Ole Opry legends, and honky-tonk history.
- ๐ Geography: 100 questions on world continents, oceans, mountain peaks, rivers, borders, islands, and landmarks.
- ๐๏ธ State Capitals: 100 questions on all 50 U.S. state capitals, territorial capitals, and major world capitals.
- ๐ History: 100 questions on ancient civilizations, American revolutions, world wars, space race, and historic moments.
- ๐ค Complete the Lyric: 100 questions on karaoke singalong lyrics across rock, pop, 80s/90s classics, and country anthems.
- ๐บ TV Shows: 100 questions on classic sitcoms, drama series, sci-fi cult classics, and Emmy-winning television.
- ๐ Sports: 100 questions on NFL football, MLB baseball, NBA basketball, NHL hockey, soccer, and Olympics.
- ๐ท๏ธ Logos & Brand Slogans: 100 questions on famous advertising taglines, company mascots, brand history, and logos.
- ๐ Music & Karaoke Legends: 100 questions on chart-topping superstars, iconic frontmen/frontwomen, and music history.
- ๐น๏ธ 80s & 90s Pop Culture: 100 questions on retro toys, video game classics, 80s/90s movies, fashion fads, and trends.
- ๐ฌ Blockbuster Movie Soundtracks: 100 questions on iconic film scores, Oscar-winning theme songs, and needle-drops.
- ๐ป Pub Trivia All-Stars: 100 questions on science, literature, food & drink, myths, idioms, and pub favorites.
- Zero-Install Mobile Player Buzzers (
/trivia): Audience members scan an on-screen QR code on their smartphones to join with their team name and buzz in with 4 large responsive touch buttons with real-time feedback and haptics. - 16:9 Multi-Monitor Projection Screen (
TriviaDisplayWindow.xaml): TV and projector output featuring category banners, live animated countdown timer with configurable 3-second warnings, 4-color answer options with progressive opacity elimination fading, room distribution stats, and live team leaderboard podium. - Game Master Host Console: Complete control deck with monitor picker, auto-progression switch, question pack selector, manual/auto question triggers, timer controls, live answer graphs, and team score management.
- 4-in-1 Audience Billboard & Connect Screen System (
KSRotation.Maui&KSRotation):- Option 1 (Hardware HDMI & Secondary Display Presentation): Cross-platform
SecondaryDisplayServiceintegrating AndroidDisplayManagerandAndroid.App.Presentationto automatically cast an independent audience billboard window to any connected USB-C to HDMI adapter or wireless display, preserving full DJ controls on the tablet. Also supports Windows multi-window secondary projection. - Option 2 (Wi-Fi Web Billboard โ
/billboard): Serves an embedded 16:9 audience display over the DJ Travel Router (http://<ip>:5005/billboard) compatible with any Smart TV browser, Fire TV Stick Silk browser, Chromecast with Google TV, or mobile device. Displays live Now Performing stage spotlight, Up Next card, upcoming rotation queue, live ticking clock, and dynamic server-rendered QR codes (/api/qr?text=...) for both the Song Request Portal and Venue Wi-Fi auto-join. - Option 3 (On-Device Attractor / Intermission Mode): Dedicated
๐บ Billboardbutton inPortalConnectionCardlaunching a full-screenBillboardOverlaymodal on the DJ tablet touchscreen during breaks, featuring a floating dismiss bar to quickly return to DJ controls. - Option 4 (Chromecast Web-Casting โ Built-in Google Cast Support): In-app mDNS device discovery (
ChromecastDiscoveryService) and one-click casting to any Chromecast or Google TV on the Wi-Fi network. Leverages DashCast web-receiver protocol to stream the live responsive audience billboard (billboard.html) at native TV resolution with no mobile video compression overhead.
- Option 1 (Hardware HDMI & Secondary Display Presentation): Cross-platform
- Multi-Project Solution Deployment & Standalone Build Workflow (
.slnx): Configured with<Deploy Solution="Debug|*" />and<Deploy Solution="Release|*" />across solution files, withKSRotation.Mauiexcluded from default rebuilds of the main solution (Lyracist.slnx) via<Build Solution="*|*" Project="false" />so it is built separately without slowing down desktop WPF application builds. - Performer Row Legend & Guide (
KSRotation.Maui): Dedicated "Legend" button on the bottom control card opening an in-app visual modal guide (LegendOverlay) explaining all row color indicators (Rotation Anchor [Red], Now Performing [Orange], Next [Blue], Music Track [Green], Paused/Dimmed), action buttons (โ,โ,๐,โ,โฒ,โผ,โโ/โถ Resume,๐/โบ), and multi-colored song round checkboxes (1โ10) across portrait and landscape orientations. - Duet & Backup Partner Support: Full end-to-end integration of duet/backup singer tracking across Lyracist, KSRotation (WPF), KSRotation.Maui, the mobile Patron Request Portal, and the Remote DJ Web Console. Displays
(with {PartnerName})across billboard displays, requests queues, and rotation cards. - Interactive Singer Queue: Dynamic list matching performer names with requested song, artist, key changes, and custom notes.
- Session Performed Songs History: Dedicated Column 2 on Singer Rotation page tracking all completed performances with 5-color rotating theme cards (Violet, Cyan, Emerald, Amber, Rose) and multi-line copyable text logs.
- Performer XP & Levels: Automatic XP and Leveling system (
XP = TotalSongsSung * 100 + Score) that tracks history, displays custom titles (e.g. Shower Singer, Karaoke Legend), and unlocks visual milestone badges directly in the queue and leaderboard. - Customizable Feedback Ratings: Symmetrical DJ tab controls allowing hosts to customize positive symbol choices (โญ, โค๏ธ, ๐ฅ, ๐, ๐) with strict safety guidelines (preventing negative feedback) and regular emoji preset support.
- Click-to-Deselect: Easily toggle current singer selection on/off (highlighted in red) to allow correcting misclicks.
- Manual "Set as Current Performer" Override: Star-toggle on any singer row to manually designate who's currently singing, taking priority over automatic sequencing on both the Karaoke and Rotation pages.
- Paused & Inactive (Deleted) Singer Controls: Pause singers to skip them in rotation while retaining their position, or mark them inactive ("delete" them) to move them to the end of the queue with one-click restoration to the active section.
- Add From Singer History: Re-queue a returning performer directly from the Singer History tab via row selection or double-click, without re-searching the catalog.
- Pending Request Indicator Bulbs: Two glowing "K" (yellow) and "M" (neon green) bulbs on the Karaoke page light up and pulse the instant a karaoke or music request comes in from a singer's phone, so hosts never miss one.
- Test Mode: Accessible under Settings โ Theme & Appearance to instantly seed default performers for audio/video checks, or clear them when ready for the show.
- Theme Mode Selector: Three-way Light/Dark/System theme dropdown on the Karaoke page header and Settings, with live system-theme watching and instant application.
- Active Venue & DJ Title Bar Integration: Displays the active Venue and DJ name dynamically in the main window's title bar, maximizing vertical screen real estate on smaller screens.
- Customizable Scaryoke Categories: Add, edit, or remove categories (2 to 12 total) from the settings page. The Scaryoke wheel will dynamically rebuild its structure, sector colors, play a mechanical pointer clicking sound synchronized to sector crossings, and project the active wheel and category announcement onto the rotation billboard window.
- Scaryoke Standalone Wheel DJ's Choice Toggle & Display Monitor Selection (
ScaryokeWheel):- Configurable DJ's Choice Slivers: Operators can toggle the two black "DJ's Choice" slivers on or off independently from Singer's Choice in Settings, with configurable sliver width (Small, Medium, Large).
- Target Display Monitor Selection: Directly select which connected display or TV to show the wheel on via dropdown in both the Title Bar and Settings tab. Supports full-screen presentation mode (
F11or Title Bar button), centering on screen in windowed mode, and instant hot-plug monitor updates.
- Dedicated 4-Column Display Tab: Structured into 4 equal columns (Monitors & Screen Assignments, DJ & Event Banners, Star Wars Crawl & Spaceship, Connect & Request Instructions) matching KsRotation.
- Screen Activation Checkboxes: Explicit checkboxes for "Enable Lyrics Projection Screen", "Enable Singer Rotation Billboard Screen", and "Enable DJ Banner Screen".
- Dual-Window Projection: Supports launching standalone windows for Lyrics Projection, Singer Rotation Billboard, and DJ Banner.
- Twelve Dynamic Billboard View Modes:
- Normal List: A standard listing of the current singer and upcoming rotation queue.
- Star Wars Crawl: High-fidelity 3D projection rendering a starry night sky with cool/warm twinkling star layers, and a 3D-angled text block crawling upward in space.
- Vegas Marquee: Theatrical Broadway stage layout displaying the current performer's name in glowing letters inside a brass frame ringed by lavender/purple "marching ants" chase bulb animations.
- Vinyl Turntable: Classic warm DJ-booth theme with a dynamic rotating vinyl 45 record, tonearm, and clean center label showing the current singer and song metadata.
- Disco Ball: A mirror-ball dance club spectacle featuring rotating mirror-ball facets, floating reflected floor spots, sweeping stage light beams, and a bold neon hero performer card.
- Synthwave Grid: Retro 80s outrun aesthetic with an animated perspective horizon grid in neon cyan and magenta, a glowing retro sun backdrop, and synth-styled typography.
- Concert Festival Lineup: Main-stage music festival poster vibe featuring towering stage trusses, drifting golden concert sparkles, and dynamic sweeping spotlights framing the headlining performer.
- Casino Slot Reels: High-roller casino excitement with spinning slot-machine reels that clunk to a stop on paylines, accompanied by a glittering jackpot coin flourish and golden glow.
- Jukebox: Classic 1950s rock-and-roll diner cabinet with glowing chrome arches, animated rising bubble-tube light columns, prominent illuminated selector pushbuttons, and a split two-line queue layout (singer name with inline estimated wait time on top; song title in cyan italics below).
- Stadium Jumbotron: Massive arena LED scoreboard with sweeping stadium floodlights crisscrossing the venue as the headlining singer is announced like a stadium superstar.
- Movie Theater 'Now Showing': Vintage Hollywood premiere aesthetic featuring a vintage 35mm film leader countdown (3...2...1) sweep, flickering cinematic projector beam, and marquee coming-attraction lobby poster cards.
- Purple Velvet Curtain: Opulent full-screen royal purple velvet theater curtain inspired by the performer welcome screen, featuring procedural undulating fabric drapery folds with soft specular nap highlights, warm champagne-gold outer perimeter marquee bulbs pulsing in alternating theatrical dual-phase chase, and floating theatrical typography with deep drop shadows directly over the velvet.
- High-Visibility Queue Typography (Up Next / Right Column): All right-side upcoming performer queue sections, headers, position numbers, wait time badges, round anchor tags, and "Up Next" / "On Deck" cards are rendered 2 font sizes larger across all 7 right-column audience projection themes, mobile tablet billboards (
BillboardView.xaml), and web projection displays (billboard.html) for clear legibility across large venue monitors. - Automated Random Screen Rotation (
KSRotation,Lyracist):- Single Unified Interval Setting: Replaced per-row time inputs with a single global setting (e.g.,
180seconds) to dictate how often the display rotates. - Intelligent Random Cycling: Automatically and randomly cycles among enabled screens at each interval, avoiding immediate repetition of the active screen when multiple views are selected.
- One-Click "โ Select All" and "โ Clear All": Quickly toggles all 12 projection themes with a single button click.
- Optimized Two-Column Display Layout: Reorganized
KSRotationDisplay tab so Target Monitor, Connect Instructions, and Casting Controls are conveniently grouped in Column 0 on the left, while Screen Rotation occupies Column 1 on the right.
- Single Unified Interval Setting: Replaced per-row time inputs with a single global setting (e.g.,
- Dynamic Chroma-Keying: Automatically strips standard
.cdgfile backgrounds and borders (pixel index0,0) in real time to render lyrics transparent. - GPU-Accelerated 4K Backdrops: Beautiful, responsive vector backdrops layered behind transparent lyrics, wrapped in Viewbox controls to fit HD and 4K displays.
- Flexible Monitor Assignment & Dropdowns: Direct dropdown selection in the KJ interface to target specific connected monitors for both the Rotation Display and DJ Banner windows, with real-time dynamic window relocation and automatic fallback to secondary/primary screens if unplugged.
- DJ Banner Projection Screen: Upload, select, delete, and project borderless full-screen custom DJ branding/promotional banners (supporting PNG, JPG, GIF, BMP, and looping MP4 video). Includes Show request QR Code overlay on DJ Banner checkbox setting.
- Scan-to-Connect Wi-Fi & Request Instructions Dynamic Graphic: Auto-detects connected Wi-Fi SSID, request portal URL, and target display resolution (
1080p,1440p,4K 3840x2160) to generate custom vectorConnectInstructions.pngbanners with dual high-density QR codes for Wi-Fi join and song requests. - Wi-Fi Password Persistence Manager (
wifi_passwords.json): Automatically saves and recalls Wi-Fi passwords per SSID (venue Wi-Fi, travel router, mobile hotspot) so passwords never have to be re-entered at recurring venues. - Same-Screen Deconfliction Priority: Automatically disables and hides the DJ Banner if the Rotation Display is targeted or moved to the same monitor.
- Wireless Casting Support: Stream the singer rotation billboard directly to Miracast, Chromecast, AirPlay, Wireless HDMI, or Browser Cast using high-performance off-screen buffer rendering.
- Browser Cast Server: Self-hosts a local web server (http://localhost:8080/rotation/) to allow any browser on the local network to view the singer rotation billboard in real-time.
- "None" Targeting (Deselection): Support for selecting None (Do not show) in settings or projection controls to immediately close or hide projection windows when not in use.
- Rear-Projection Mirroring: Mirror the lyrics screen horizontally for custom projector arrangements.
- Advanced Audio Engine: Master volume, latency compensation, and active output device selection.
- Active Performance Key Transposition: Real-time pitch transposition from
-6to+6semitones. Automatically hot-reloads the audio track and seeks back to the exact millisecond in under 150ms to apply FFmpeg-based pitch shifting (asetrate+atempo) during active playback. - Audio Processing Controls: Fully adjustable 3-band EQ (Bass, Mid, Treble) alongside integrated Compressor and Limiter.
- Per-Singer Key & Tempo Recall: Automatically tracks each singer's customized pitch shift (key) and tempo (playback speed multiplier) per song in
SingerHistory. When a singer is added to rotation or re-queues a track from search or singer history, their preferred key and speed are instantly recalled. Global profile defaults inSingerAudioSettingsact as the initial baseline when a singer performs a new track. - Per-Singer Mic Level & Vocal EQ Recall: Automatically loads and applies the on-stage performer's saved vocal gain (mic level), 3-band EQ (Treble, Mid, Bass), Compressor, and Limiter settings from
SingerAudioSettingsto the audio engine andKaraokePagesliders when their performance starts. Includes dedicated [Save to Singer] and [Recall Singer] action buttons right on the Audio Controls card header for one-click live preset saving and instant recall. - Automatic Volume Normalization: Measures each track's integrated loudness (LUFS) via a single-pass FFmpeg
loudnorm(EBU R128) analysis the first time it's loaded for playback, then applies a corrective gain so every song lands near the same perceived loudness without the DJ manually riding the volume between tracks. Configurable target loudness and an on/off toggle in Settings; measurement runs in the background and is cached permanently per song. - Show Flow Automation: Automatically manages background music levels between tracks (Opening Music, Fill-in Music, and End of Rotation sets).
- Configurable Fill-In Music Delay: Settings slider (0-30s) to set the exact delay before fill-in background music starts.
- Special Occasion Audio: Add custom sound bites and clips (Birthdays, Holiday jingles) with individual tone (Bass/Treble) and gain overrides.
- Local Scanner & Rescan Maintenance: Scans folders for
.mp3 + .cdg,.mp4or.zipfiles and builds a local query database. Cleanly deletes obsolete database logs and search indexes for files that were renamed or deleted on the drive during rescans. - Catalog Book Exporter: Export the entire song library (Karaoke or Music) directly into professionally formatted, paginated PDF, plain text (.txt), or Word (.docx) documents with repeating table headers from the Database Manager.
- Streaming & Search Integration: Includes search support for YouTube (direct URL stream linking and metadata lookups) and Spotify & Amazon Music links.
- Singer History DB: Automatically saves matching song, artist, singer, and links for instant lookup in future sessions.
- Live Online Backups: Instantly back up settings, singer logs, playlists, and performer queue to an external SQLite
.dbfile using liveVACUUM INTOoperations. - Graceful Restore: Restore data from backup files; the application closes database connections safely and shuts down for reboot validation automatically.
- Local Web Server: Serves a mobile-friendly web page (defaulting to port
5005) over the local network. - Singer Preview Monitor: Allows singers to scan a local QR code and follow the live scrolling lyrics directly from their phone or tablet.
- "Scan to Join" QR Badges: Auto-generated QR codes linking to the tablet portal appear as a badge on the Karaoke page header and as a floating overlay on the Lyrics projection window.
- Online Song & Artist Lookup: Real-time lookup querying the iTunes search index from the patron's mobile browser with automatic form populating and offline fallback.
- Emoji Crowd Reactions: Singers can send ๐ ๐ฅ โค๏ธ ๐ ๐ ๐ reactions from their device that render in full color and float in from a random edge of the screen, drifting and fading across both the Lyrics and Rotation projection screens in real time.
- Live Rating Sync: The tablet dashboard shows the current performer's live average rating and labels the rating card with the host's chosen feedback icon, updating instantly after each new submission.
- Live Server Log Viewer: A "Logs" tab in the tablet portal surfaces the most recent app and error log entries for on-the-fly troubleshooting.
- Karaoke & Music Song Requests: Singers can search the karaoke catalog to request a song to perform, or search a separate background-music library to request a track just be played โ both flow into the KJ's Requests queue, and approving a Karaoke request adds the singer straight into the active rotation.
- Auto-Accept Requests: Optional toggle (Requests page in Lyracist, next to the Incoming Requests list in KSRotation) that skips manual approval entirely โ Karaoke requests go straight into the rotation and Music requests go straight to Approved the instant they arrive.
- Scaryoke Access Control: The Scaryoke tab and wheel spin are only available on singers' phones once the host enables Scaryoke Mode, and only the currently-performing singer can trigger a spin โ everyone else watches it live.
- Interactive Index Menu: Left-pane sidebar allowing direct navigation between 12 detailed help categories covering every user-facing page and setting.
- Resizable Index Column: Integrated a vertical
GridSplitterallowing users to click and drag the column boundary to manually resize the index list width, preventing text truncation on different screen sizes. - Rich Detail Panel: Right-pane scroll-contained viewer displaying page guides, setting definitions, tone balancing parameters, decoders, and API settings, preventing excessive page scrolling.
- Framework: WPF (.NET 10.0-windows)
- Design System:
Wpf.Ui(harmonious dark/light theme management) - Database: SQLite backed by Entity Framework Core (EF Core)
- MVVM Pattern: CommunityToolkit.Mvvm (source generators, observable properties, relay commands)
- Media Playback: LibVLC / LibVLCSharp & FFmpeg interop for high-performance
.cdgand video rendering
- OS: Windows 10 / 11
- Runtime: .NET 10.0 SDK or Desktop Runtime
- External Dependencies: FFmpeg (expected at
C:\ffmpeg\bin\ffmpeg.exeandffprobe.exe)
- Open Settings on the left menu.
- In Service Logins & API Keys, enter credentials for YouTube or Spotify if using streaming search.
- In Theme & Appearance, toggle Test Mode on to test queue workflows.
- Set up monitor assignments under Display & Projection Monitors or the main control panel.
- Manage backups and database restorations in the Database Maintenance section under the Music Library group box.
- Curate the DJ Name, active Venues catalog list, Billboard View Mode, and Star Wars Crawl Text Template (Dramatic, Comedic, Over-the-Top, or Custom) on the Settings page, with real-time text previews.
The Lyracist suite is free software, licensed under the GNU General Public License v3.0 or later
(GPL-3.0-or-later). See LICENSE. Third-party components remain under their own licenses;
see THIRD-PARTY-NOTICES.txt.