Skip to content

About

Free, open-source manager for FUSER custom songs: browse your library by album art, preview songs in a loop, enable/disable them and import .pak/.sig straight from zip, rar and 7z archives. Windows, portable.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

38 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Fuser Song Manager

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.

The library in action: album art grid, filters, and the song panel with the preview and the riser

Download

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.

Features

  • 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 (D hides 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_songs and disabled_songs, never while Fuser is running.
  • Import from .zip, .rar and .7z, at any folder depth, including "download all" archives that contain each song's own .zip or .rar. Only complete .pak + .sig pairs 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.

Keyboard

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

Where your data is

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).

Building from source

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 ./artifacts

Optional 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

Credits and license

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.

About

Free, open-source manager for FUSER custom songs: browse your library by album art, preview songs in a loop, enable/disable them and import .pak/.sig straight from zip, rar and 7z archives. Windows, portable.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages