LinuxmacOSWindows

Where Does Museeks Store Library and Settings?

Where Museeks keeps its library, playlists, and config files on each OS, and what resetting deletes.

Last updated

Museeks keeps library, playlists, and settings in one storage folder per OS, reachable from Settings without memorizing paths. Linux builds moved from a capitalized folder to lowercase, which dates old guides. The config file inside is plain TOML.

Resetting means deleting that folder with the app closed, a documented fix for freezes. Everything rebuilds on next launch at the cost of playlists and ratings. Back up the folder before major version jumps, since migrations occasionally stumble. The pattern matches most Electron apps.

Where Museeks stores this, by platform

Linux
~/.config/museeks

Library database, playlists, and config.toml together. Older installs used a capitalized folder name; current builds use lowercase. Flatpak paths differ. Reset by deleting contents with the app closed.

macOS
~/Library/Application Support/museeks

Same storage layout under Application Support. The Settings button opens it directly on every OS. Copy the folder between machines for full migration.

Windows
%APPDATA%\museeks

Identical contents under Roaming AppData. Audio stream troubleshooting edits config.toml here. Keep a backup before resetting, since deletion is total.

Frequently asked questions

how do I reset Museeks

Open Settings and use Open Storage Directory to land in the right folder per OS, then delete everything with the app closed. Restarting rebuilds defaults. This fixes freezes and crashes from corrupt state, but wipes playlists and ratings too.

how do I move Museeks to a new computer

Copy the whole storage folder to the new machine at the matching OS path. Library, playlists, and settings travel together. Note the lowercase rename from older Museeks builds when migrating vintage installs.

how do I disable the audio stream server

Open config.toml from the storage directory and set the audio stream flag to false, then restart. Recent versions document this escape hatch for playback trouble. The file sits beside the database in the same folder.

Notice an outdated path? Let us know.