MUSIC.fm

•data/ — empty YouTube and SoundCloud catalog templates.

•tests/ — offline catalog, cache-protocol, logo-state, and WebView smoke tests.

•third_party/ — vendored build dependencies and WebView2 SDK files with notices.

•platform/ — required external FH2 Mod Platform source; not included. Download and rename it as described below.

•NOTICE.md — upstream-code attribution and licensing context.

•scripts/ — Windows build and release-installer scripts.

•CMakeLists.txt — CMake targets and source registration.

Build outputs, cache data, logs, and installed Azimuth files are not part of this source tree.

How it works

The platform registers the plugin as MUSIC.fm. The source selector displays YouTube and SoundCloud. Both catalogs remain separate in fh2-radio/songlist.json and fh2-radio/soundcloudlist.json; both ship empty so users add their own links.

YouTube keeps its background predownload cache. SoundCloud tracks predownload in the background to fh2-radio/soundcloud-music; the radio prefers a completed cached track and streams when it is not ready yet. The SoundCloud link editor reports per-track download progress while the game is running.

The editor is a standalone Windows application with a local HTML interface hosted by WebView2. It does not run a browser dashboard or local web server.

Build

Requirements: Windows, CMake 3.20+, Ninja, Git, PowerShell, and an x86-64 llvm-mingw toolchain. The checked-in build script expects the MSYS2 toolchain under C:\msys64\mingw64\bin; adjust scripts/build.ps1 if yours is elsewhere.

Clone the project:

This clone URL is the intended public repository. It may not be available until the source is published there; until then, build from the local source package.

Before building, download the FH2 Mod Platform source from the URL above. Extract its ZIP, rename the extracted folder (usually fh2-mod-platform-main) to platform, and move it into the MUSIC.fm source root. The final layout must be musicfm/platform/CMakeLists.txt.

If you place the platform checkout elsewhere, configure CMake with -DFH2_MOD_PLATFORM_DIR=C:/path/to/fh2-mod-platform; the supplied scripts/build.ps1 expects the default platform/ location.

Build and stage the release package:

The script configures CMake, builds the plugin, editor, worker, and matching platform runtime, then creates dist/MUSIC.fm.zip. It also builds the offline test targets. Run the tests with:

The FH2 Mod Platform source is a separate dependency and is not tracked here. When creating a GitHub release, publish a tag matching the CMake project version (for example v1.0.0) and attach dist/MUSIC.fm.zip. The plugin advertises angelizado/musicfm to the FH2 Mod Platform update checker; update notices require that public repository and a matching GitHub Release to exist.

Install and use

1. Close Azimuth.

2. Extract the release archive and run its installer, passing your Azimuth directory and the game's Mount directory:

3. Start FH2 through Azimuth.

4. Open Pause → Settings → MODS and enable MUSIC.fm. Select YouTube or SoundCloud under Music source.

5. Open the song picker or the provider's link manager from the in-game menu. SoundCloud background-download status appears in its link manager.

The installer preserves existing configuration, catalogs, and music caches. Keep a backup of the Azimuth installation befor