Ludusavi

Ludusavi is a tool for backing up your PC video game save data, written in Rust. It is cross-platform and supports multiple game stores.

Features

• Ability to back up data from more than 19,000 games plus your own custom entries.
• Backup and restore for Steam as well as other game libraries.
• Both a graphical interface and command line interface for scripting. Tab completion is available for Bash, Fish, Zsh, PowerShell, and Elvish.
• Support for:
  • Saves that are stored as files and in the Windows registry.
  • Proton saves with Steam.
  • Steam screenshots.
• Available as a Playnite extension: https://github.com/mtkennerly/ludusavi-playnite
• Works on the Steam Deck.

This tool uses the Ludusavi Manifest for info on what to back up, and it will automatically download the latest version of the primary manifest. The data is ultimately sourced from PCGamingWiki, so please contribute any new or fixed data back to the wiki itself, and your improvements will be incorporated into Ludusavi's data as well.

If you'd like to help translate Ludusavi into other languages, check out the Crowdin project.

Demo

GUI

GUI demo of previewing a backup

CLI

CLI demo of previewing a backup

Installation

Requirements

• Ludusavi is available for Windows, Linux, and Mac.
• Your system must support one of DirectX, Vulkan, or Metal. (If not, set the ICED_BACKEND environment variable to tiny-skia to use the software renderer.)

Methods

You can install Ludusavi one of these ways:

• Download the executable for your operating system from the releases page. It's portable, so you can simply download it and put it anywhere on your system. If you're unsure, choose this option.

• On Windows, you can use Winget.

  • To install: winget install -e --id mtkennerly.ludusavi
  • To update: winget upgrade -e --id mtkennerly.ludusavi

• On Windows, you can use Scoop.

  • To install: scoop bucket add extras && scoop install ludusavi
  • To update: scoop update && scoop update ludusavi

• For Linux, Ludusavi is available on Flathub. Note that it has limited file system access by default (~ and /run/media). If you'd like to enable broader access, see here.

• If you have Rust, you can use Cargo.

  • To install or update: cargo install --locked ludusavi

  On Linux, this requires the following system packages, or their equivalents for your distribution:

  • Ubuntu: sudo apt-get install -y gcc cmake libx11-dev libxcb-composite0-dev libfreetype6-dev libexpat1-dev libfontconfig1-dev

Notes

If you are on Windows:

• When you first run Ludusavi, you may see a popup that says "Windows protected your PC", because Windows does not recognize the program's publisher. Click "more info" and then "run anyway" to start the program.

If you are on Mac:

• When you first run Ludusavi, you may see a popup that says "Ludusavi can't be opened because it is from an unidentified developer". To allow Ludusavi to run, please refer to this article, specifically the section on How to open an app [...] from an unidentified developer.

Usage

Detailed help documentation is available for several topics.

General

• Backup automation
• Backup exclusions
• Backup retention
• Backup validation
• Cloud backup
• Custom games
• Duplicates
• Filter
• Game launch wrapping
• Redirects
• Roots
• Selective scanning

Interfaces

• Application folder
• Backup structure
• Command line
• Configuration file
• Environment variables
• Logging

Comparison with Other Tools

There are other excellent backup tools available, but not a singular cross-platform and cross-store solution:

• GameSave Manager (as of v3.1.512.0):

  • Only supports Windows.
  • Much slower than Ludusavi. On the same hardware and with default settings, an initial scan of the whole system takes 2 minutes in GSM versus 10 seconds in Ludusavi. Performing a backup immediately after that scan takes 4 minutes 16 seconds in GSM versus 4.5 seconds in Ludusavi. In this test, GSM found 257 games with 2.84 GB, and Ludusavi found 297 games with 2.95 GiB.
  • Closed source, so the community cannot contribute improvements.
  • Interface can be slow or unresponsive. For example, when clicking "select all / de-select all", each checkbox has to individually toggle itself. With 257 games, this means you end up having to wait around 42 seconds.
  • Minimal command line interface.
  • Can create symlinks for games and game data. Ludusavi does not support this.

• Game Backup Monitor (as of v1.2.2):

  • Does not support Mac.
  • Database only covers 577 games (as of 2022-11-16), although