Troubleshooting
Troubleshooting & Logging
How to recover from common operator, display, audio and logging issues without resetting the whole match.
Audio
Audio not ready
Explains the AUDIO NOT READY warning shown at the top of SOUND > Music Live & Levels.
Steps
- Read the reason in the warning.
- Music controls can remain visible but the backend cannot play until the audio dependency/device issue is resolved.
Unsupported or unplayable music file
What to check when a catalogue item will not play.
Steps
- Confirm the file still exists and is MP3, WAV, OGG or M4A/AAC.
- Re-add or edit the catalogue entry if the path moved.
- For M4A/AAC, allow the app's cached conversion path where available.
music_cache
Explains why converted audio can appear in the music_cache folder.
Display
Scoreboard monitor / borderless issue
Recovery steps if the scoreboard is covered, minimised, hidden, opens on the wrong monitor or has incorrect geometry.
Steps
- First press Show scoreboard in the control header.
- Press F11 (or F) to toggle the secondary display between borderless and windowed modes; Esc always returns it to a decorated window.
- Monitor movement itself never changes display mode, which prevents multi-monitor flashing.
- On a one-screen laptop Show scoreboard restores/lifts the normal preview without restarting RinkScore.
Settings
Settings files
Persistent configuration and shared presentation media are stored under the RinkScore application-data folder.
Steps
- Normal configuration changes save automatically.
- Period/intermission values are staged together and become authoritative when APPLY TIMING is pressed; there is no separate global Save/Load Settings control.
Saved settingsPersistent scoreboard configuration remains in scoreboard_settings.json; Music, Advertising usage, the shared Media Library, GameSheets, Recovery and Diagnostics keep their own data.
System
Match-day keep awake
Keeps a Windows rink laptop awake while RinkScore is running so idle power saving does not blank the scoreboard or suspend the application.
Steps
- No operator action is required.
- RinkScore requests System Required and Display Required at startup and temporarily disables an enabled Windows screensaver for the match-day session.
- ADMIN > Extras > Diagnostics shows separate green/red Power protection and Screensaver protection status lines.
- When Engineering Diagnostics is enabled, the log records KEEP_AWAKE_ACTIVE/FAILED and SCREENSAVER_PROTECTION_ACTIVE/FAILED.
What happens
While RinkScore is open, normal idle PC sleep and display power-off are inhibited, and an enabled Windows screensaver is temporarily disabled. Deliberately choosing Sleep/Shut down, closing the lid where Windows/hardware policy forces sleep, critical-battery hibernation, or exiting RinkScore still behaves normally.
Advertising
Advertising media problems
Explains the safe recovery behaviour for a missing, unassigned or unreadable shared sponsor image/video.
Steps
- If an advert will not play, first check its Advertising row.
- RinkScore automatically removes obsolete pre-Media-Library usage rows that have no media_id.
- Re-import any media you still want in DISPLAY > Media Library, then add it again to Advertising.
- For an assigned item, verify the shared Media Library asset still exists, enable the LIVE diagnostic log, start the break and reproduce the issue.
- Inspect AD_VIDEO_PERF and VIDEO_PLAYBACK_CACHE_READY/FAILED records; use Skip or switch the Advertising master OFF to recover immediately.
- Re-import corrupt source media into Media Library if necessary.
What happens
An unassigned, missing or corrupt advert is skipped. If no eligible advert can be rendered, the normal intermission scoreboard remains available rather than leaving a blank public screen.
Logging
Engineering diagnostic logging
Use this only while reproducing a problem so additional UI/music/penalty/media diagnostic events are captured.
Steps
- Enable LIVE diagnostic log, reproduce the issue, then press Create UPLOAD snapshot / Open Diagnostics.
- The background writer drains queued lines and the closed _EXPORT snapshot can be attached or uploaded without closing RinkScore.
- DIAGNOSTICS_FLUSH_COMPLETE records queued_lines, written_lines, write_errors and queue_depth.
- For startup, interactive_ready_ms is the usable operator time while background_prewarm_completed_ms records when deferred hidden work eventually finished; background_prewarm_delayed_by_activity explains long pre-warm elapsed times.
- For video, inspect AD_VIDEO_PERF, VIDEO_PLAYBACK_CACHE_READY/FAILED and Media Library events.
- Turn Diagnostics off when finished.
Performance
Startup and first few seconds
Explains interactive readiness and the deliberately deferred background UI/media preparation.
Steps
- The match-critical LIVE and core ADMIN controls are built first.
- Diagnostics report interactive_ready_ms when the operator UI is usable.
- Penalties, DISPLAY, Advertising, SOUND and GUIDE can then pre-warm after genuine idle time; clicks, typing, scrolling, active Intro/Advertising video, a running clock or active music postpone hidden work. background_prewarm_completed_ms records when that deferred work eventually finishes and background_prewarm_delayed_by_activity records whether operator/presentation activity postponed it.
What happens
A large background_prewarm_completed_ms does not mean startup took that long: use interactive_ready_ms for perceived startup. Public display/video/audio retains priority while hidden work yields.
Guide captures are suppressed during running game time and repeated captures are cooled down.
Recovery
Clock or display mode is not what you expect
Recover without starting a new game.
Steps
- Stop the clock.
- Use Reset (current), Add time, Correct time / Set time, End intermission, or ADMIN > Game > Period / Intermission REG/OT/SO mode correction as needed.
- DISPLAY Pre-Match/Post-Match previews are local-only and do not change display phase.
- Use NEW GAME only for a new fixture.
Related: 8. Manual recovery without New Game
Penalty entry is wrong
Correct a player/type/time or remove a slot while preserving the rest of the queue.
Steps
- Stop the clock.
- For player/type, update the slot and press Add/Update.
- For time only, use Correct seconds/Correct time.
- Use Clear slot to remove the record.
Related: Add/Update, Correct seconds / Correct time