Manage your library of FUSER custom songs in a look inspired by the game's own crate screen: browse every song by its album art, listen to it in a loop with each part on its own disc, rate it and take notes, enable or disable songs, import new ones straight from the archives you download, and start the game.
Get FuserSongManager-<version>-win-x64.zip from the Releases page, unzip it anywhere and run
FuserSongManager.exe. It is a portable app: nothing to install, Windows 10 or 11 (64-bit).
The executable is not signed, so the first time Windows SmartScreen may say it protected your PC: choose More info → Run anyway.
- Album art grid of your library, read from the songs' paks. Hover a song to see its genre, year and the instrument of
each part, in the game's colours. Each tile shows the song's key and BPM above its title (
Dhides them). Disabled songs are dimmed; songs with problems (no.sig, unreadable pak) are flagged. - Song panel with the album art, genre, year, BPM and key, your rating, the custom song's author and your notes.
- Preview that loops like the game: four phrases of eight bars, with a bar ruler to jump around. Beat, bass, loop and lead are four discs; click one to mute that part. Audio is only played, never written to disk.
- Riser: the round button next to play, with the game's riser icon, plays the song's riser: the transition effect the game uses to go to the next song, which is different for every custom song. If the song is playing, the riser comes in on the next bar, the song fades out under it over two bars, and the song starts again from its beginning as the riser's four bars end, with no gap. Press it again to cancel. Some songs ship the riser empty; the app says so. Riser effect chooses what the song does while the riser comes in, with the names DJs use: Fade Out, Low Pass Filter (muffles the song as the filter closes), Echo Out and Dub Echo (the song is cut and its last beat rings in an echo), Trance Gate (a gate chops it faster every bar), Strip Down (the parts leave one per bar) and Rhythm Hold (only beat and bass hold the groove). The choice is remembered.
- Enable and disable songs (one or many: Ctrl+click, Shift+click, Ctrl+A). Files are moved between
custom_songsanddisabled_songs, never while Fuser is running. - Import from
.zip,.rarand.7z, at any folder depth, including "download all" archives that contain each song's own.zipor.rar. Only complete.pak+.sigpairs are installed; anything skipped is explained. - Search, filters and sorting by title, artist, genre, year, BPM and rating, instant even with thousands of songs. The filter button next to the search opens a panel like the game's tempo and key settings: a BPM range, a key and major or minor, each of which can be left on "any". Hover the button to see what is filtered.
- Play Fuser clears the game's custom song cache and starts it (Steam, Epic or a local executable).
- Coming from Fuser Custom Song Manager v1: on first run it brings your ratings, notes and authors. The v1 files are only read.
| Key | Action |
|---|---|
Z |
Autoplay on/off: the song plays as soon as you select it |
D |
Show or hide the key and BPM over each song's title |
Space |
Play / pause |
Enter |
Enable or disable the selected songs |
| Arrow keys | Move between songs |
Ctrl+A |
Select every song shown |
Ctrl+F |
Search |
Ctrl+I |
Import songs |
F5 |
Rescan the library |
Esc |
Clear the selection, or leave the search box |
Everything lives in %LocalAppData%\FuserSongManager: settings.json, the library database songs.sqlite, daily
logs\ (Settings → Open log folder) and an art\ cache of album art (safe to delete). Your songs stay in the game's
Fuser\Content\Paks\custom_songs and Fuser\Content\disabled_songs folders (disabled songs live outside Paks
because Fuser loads every .pak under Paks).
Requires the .NET 10 SDK on Windows.
dotnet run --project src/FuserSongManager.UI # run the app
dotnet test FuserSongManager.slnx # run the tests
./tools/publish.ps1 # tests, then the portable zip in ./artifactsOptional test inputs: set FSM_SAMPLE_PAKS to a folder of real custom song paks to run the tests that read them, and
FSM_SCREENSHOTS to a folder to save screenshots of the windows rendered by the UI tests.
| Project | What it does |
|---|---|
src/FuserSongManager.Core |
Song model, library scan and sync, filters, enable/disable and import rules |
src/FuserSongManager.Infrastructure |
Reading paks with CUE4Parse, album art and audio, SQLite, file moves, archives |
src/FuserSongManager.UI |
The Avalonia app (MVVM) |
src/FuserSongManager.Tools |
Diagnostic command line (list, dump, read, sync, import…) |
docs/ |
Plan, requirements and the technical notes on the pak format |
The code is released under the MIT License.
- The instrument icons are traced from the game FUSER and belong to Harmonix Music Systems / NCSoft; they are not covered by the MIT License.
- Audio decryption follows the work in FuserCustomSongCreator.
- Font: Kumbh Sans (SIL Open Font License 1.1).
- Every third-party package and its license is listed in THIRD-PARTY-NOTICES.txt.
This is a fan-made tool. It is not affiliated with or endorsed by Harmonix, NCSoft or Epic Games. FUSER is a trademark of its owners.
