WindowsLinuxmacOS

Where Does Ludusavi Store Config and Backups?

Where Ludusavi keeps config.yaml and backups on each OS, plus portable mode and manifest file details..

Last updated

Ludusavi keeps its config.yaml beside the app data on every OS: Roaming AppData on Windows, XDG config on Linux, Application Support on Mac. Backup roots default to home with per-store subfolders. The manifest of known games downloads fresh and stays hands-off.

Portable mode collapses everything next to the executable with one marker file. Backups mirror absolute paths per drive, so cross-machine restores need redirect rules. Config edits matter mostly to CLI users; the GUI writes its own changes.

Where Ludusavi stores this, by platform

Windows
%APPDATA%\ludusavi

Config.yaml plus cached manifest under Roaming AppData. Backup default is a home folder with per-game mapping files. Portable marker file beside the exe keeps everything local. Registry saves land in registry.yaml here.

Linux
~/.config/ludusavi

XDG config home with the same config.yaml layout; Flatpak nests under its app ID. Proton reg files join file backups on Linux. Same portable marker behavior as Windows.

macOS
~/Library/Application Support/ludusavi

Mirrors the other platforms under Application Support. Redirects handle username and library differences on restore. Manifest stays auto-managed everywhere.

Frequently asked questions

how do I move Ludusavi to a new PC

Copy config.yaml and the backup root to the new machine at matching OS paths. Roots differ per machine, so re-point store folders in config afterward. Manifests redownload themselves; never hand-edit the cached copy.

how does portable mode work

Drop an empty ludusavi.portable file beside the executable to keep config local. Backups still go wherever backup path says. USB setups travel with settings intact this way.

what does a Ludusavi backup contain

Each game gets a folder with mapping.yaml plus drive folders or zips of saves. Registry keys land in registry.yaml on Windows; Proton reg files back up on Linux. Restores only consider folders containing mapping files.

Notice an outdated path? Let us know.