LinuxCommandLibrary

ludusavi

backs up and restores video game save data

TLDR

Backup all known games

$ ludusavi backup
copy
Backup specific game
$ ludusavi backup --by-title "[Game Name]"
copy
Restore all backups
$ ludusavi restore
copy
Restore specific game
$ ludusavi restore --by-title "[Game Name]"
copy
Preview backup (dry run)
$ ludusavi backup --preview
copy
Backup to custom location
$ ludusavi backup --path [/path/to/backups]
copy
List backed up games
$ ludusavi backups
copy
Update game manifest
$ ludusavi manifest update
copy

SYNOPSIS

ludusavi [backup] [restore] [backups] [--by-title name] [--path dir] [options]

DESCRIPTION

ludusavi backs up and restores video game save data. It knows where games store saves and can handle thousands of titles automatically.
The manifest contains paths for game saves across Windows, Linux, and macOS. It covers Steam, GOG, Epic, and other platforms. Custom entries can be added for unsupported games.
Backup formats include simple directories and compressed ZIP files. Multiple compression algorithms balance speed versus size.
Scheduled backups can be configured to run automatically. The merge option adds new saves to existing backups without replacing old ones.
The tool integrates with Playnite and other game launchers through plugins. A GUI version provides visual management for those who prefer it.

PARAMETERS

backup

Back up save data.
restore
Restore save data from backup.
backups
List available backups.
--by-title NAME
Operate on specific game by title.
--by-steam-id ID
Operate on game by Steam ID.
--path DIR
Custom backup directory.
--preview
Show what would happen without doing it.
--force
Overwrite without confirmation.
--compression TYPE
Compression type (none, deflate, bzip2, zstd).
--format TYPE
Backup format (simple, zip).
--merge
Merge with existing backup.
manifest update
Update game database.
--config FILE
Use custom config file.
--help
Show help.

CAVEATS

Not all games are in the manifest. Cloud saves may conflict. Some games use registry entries (Windows). Very large saves may take time to compress.

HISTORY

ludusavi was created around 2020 as an open-source alternative to GameSave Manager. It uses the PCGamingWiki manifest for save locations, benefiting from community-maintained data about thousands of games.

SEE ALSO

restic(1), rsync(1), rclone(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community