CastBoard Debugger

Desktop Qt WebEngine tester for the CastBoard frontend.

Tech stack: Python 3.11+ · PySide6 · Qt WebEngine (Chromium) · watchdog

Run

uv sync
uv run castboard-debugger

By default it opens ..\colink-android\app\src\main\assets\castboard when that folder exists.

Features

• Load index.html and related assets from any local folder.
• Adjust preview resolution without resizing the app window.
• Hot reload on file changes.
• Apply editable mock track, lyric and progress data.
• Open Chromium DevTools from the DevTools button, F12, or Ctrl+Shift+I.
• Substitute local fonts for testing font rendering.
• Persist target folder, entry file, resolution and mock data across sessions.

Build (standalone executable)

uv run pyinstaller --collect-all PySide6 --windowed --name CastBoardDebugger castboard_debugger/__main__.py

Output is placed in dist/CastBoardDebugger/.