# SonicColorsRecomp v0.3.3 Fixes Music Library Setup on Linux and Windows

> SonicColorsRecomp v0.3.3 adds Music Library dependency checks and Windows packaging for the native Wii recompilation of Sonic Colors.

- Published: 2026-11-20T19:17:48Z
- Score: 9/10
- Tags: wii, pc, recomp
- Web page: https://emu-radar.customfw.xyz/news/soniccolorsrecomp-v033-music-library-hotfix/
- Sources: https://github.com/VoltTMC/SonicColorsRecomp

[SonicColorsRecomp](https://github.com/VoltTMC/SonicColorsRecomp), a static recompilation of the Wii game Sonic Colors for Linux and Windows, released hotfix **v0.3.3** on November 20, 2026. The update covers Music Library tool detection, setup helpers, and Windows packaging so you can configure audio tools without manual PATH fixes.

Builds ship as `SonicColorsRecomp-v0.3.3-linux-x86_64.AppImage` for Linux and `SonicColorsRecomp-v0.3.3-windows-x86_64.zip` for Windows. You must supply your own Europe or PAL disc image (`SNCP8P` revision 00) in a format such as ISO, RVZ, WIA, WBFS, or GCZ, and a black screen after a graphics driver update may require clearing the shader cache under System.

### What Changed in v0.3.3

* **Music doctor and UI check:** A diagnostic reports which operations work right away and which need extra tools, flagging `missing` vs `unusable` items. The Music tab also includes a **Check tools** button showing ready and blocked operations.
* **Setup helper:** `tools/music_deps_setup` works on Linux and Windows to set up `.venv-music` with `cricodecs` and print Ready, Blocked, and Next steps.
* **Drop-ins and Windows DLL:** You place LGPL `ffmpeg` and ISC `vgmstream-cli` inside `tools/bin/`, since no GPL FFmpeg is bundled. The Windows ZIP also places `libwinpthread-1.dll` beside `tools/music_asset.exe` so the helper loads from a clean ZIP extract.
* **Earlier v0.3.2 additions:** Upgrading from older builds also includes updater install and catalog packaging.

### What Works and Current Caveats

Browsing the catalog and previewing replacement WAV files work without host audio tools. Preparing assets, previewing original tracks, and exporting still need host Python, `cricodecs`, `vgmstream-cli`, and `ffmpeg`.

On Linux, booting through the title screen into Tropical Resort Act 1 is verified, while full-game play is not claimed and many stages and abilities remain untested. Native Windows play on real hardware still has an unverified WASAPI, DPI, and gamepad checklist, and several issues remain deferred: a black-world bug after stomp, the opening spiral at 60 Hz, and in-game music listening.
