Checkpoint

A fast and simple homebrew save manager for 3DS and Switch written in C++.

Why use Checkpoint?

Checkpoint is created following ideas of simplicity and efficiency. The UI has been designed to condense as many options as possible, while keeping it simple to work with.

Moreover, Checkpoint is extremely lightweight - while being packaged with a nice graphic user interface - and is built using the most recent libraries available.

Checkpoint doesn't rely on external title lists or filters to work: titles are detected and filtered automatically, so it doesn't need constant user maintenance to retain full functionality.

Features

Checkpoint backs up and restores save data for:

• 3DS: 3DS cartridges and digital titles (including demos), extdata, DS cartridges, DSiWare and GBA Virtual Console titles
• Switch: saves for the titles you have played, with title information loaded automatically

Both versions share the same core feature set:

• A completely redesigned user interface, with light and dark mode theming
• A Settings section to configure everything directly from the console: favorites, filters, additional save folders and more, with no manual file editing required
• Internationalization support: English, Italian, French, German, Portuguese, Spanish, Dutch, Japanese and Chinese
• Fast, responsive file operations: backups and restores run on a worker thread, and backups can be cancelled while in progress
• Additional save folders, configurable per title through a built-in folder browser
• A background FTP server, to access your save backups directly from your PC
• Wireless save transfer between consoles
• An HTTP log server, to view Checkpoint's logs in real time from any browser on your network

On Switch, Checkpoint also provides:

• A rendering backend built on deko3d, which makes the application ~70% smaller than before
• 1080p docked mode support, alongside 720p in handheld
• File-by-file verification after restore, and safer handling of large save restores

chlink

Checkpoint comes with chlink, a companion command line app for your PC that talks to Checkpoint's wireless save transfer feature. With chlink you can send save backups from your PC to the console and receive backups from the console to your PC, over your local network - no cables and no SD card swapping required.

Transfers are protected by a 4-digit PIN displayed on the console, and chlink automatically recognizes backups coming from a Checkpoint SD card layout, so title and backup information are filled in for you.

chlink is a single, dependency-free executable available for Windows, macOS and Linux. You can download it from the releases page, or build it yourself from the tools/chlink folder.

Usage

You can use Checkpoint for 3DS with both cfw and Rosalina-based Homebrew Launchers. *hax-based Homebrew Launchers are not supported by Checkpoint.

Checkpoint for Switch runs on homebrew launcher. Make sure you're running up-to-date payloads.

The first launch will take longer than usual, due to the working directories being created - Checkpoint will be significantly faster upon launch from then on.

Working path

Checkpoint relies on the following folders to store the files it generates. Note that all the working directories are automatically generated on first launch (or when Checkpoint finds a new title that doesn't have a working directory yet).

3DS

• sdmc:/3ds/Checkpoint: root path
• sdmc:/3ds/Checkpoint/config.json: configuration file
• sdmc:/3ds/Checkpoint/logs: log files
• sdmc:/3ds/Checkpoint/saves/<unique id> <game title>: root path for all the save backups for a generic game
• sdmc:/3ds/Checkpoint/extdata/<unique id> <game title>: root path for all the extdata backups for a generic game

Switch

• sdmc:/switch/Checkpoint: root path
• sdmc:/switch/Checkpoint/config.json: configuration file
• sdmc:/switch/Checkpoint/logs: log files
• sdmc:/switch/Checkpoint/saves/<title id> <game title>: root path for all the save backups for a generic game

Configuration

All the options that used to require manual edits to the configuration file can now be managed from the Settings section, directly on the console. The config.json file is still stored in Checkpoint's working directory, but you're not required to touch it anymore.

Troubleshooting

Checkpoint displays error codes when something weird happens or operations fail. If you have any issues, please ensure they haven't already been addressed, and report the error code and a summary of your operations to reproduce it.

Additionally, you can receive real-time support by joining FlagBrew's Discord server (link below).

Building

devkitARM and devkitA64 are required to compile Checkpoint for 3DS and Switch, respectively. Learn more at devkitpro.org. Install or update dependencies as follows.

3DS version

dkp-pacman -S libctru citro3d citro2d tex3ds

Switch version

dkp-pacman -S libnx switch-pkg-config deko3d switch-freetype switch-libjpeg-turbo

Build from the repository root with make 3ds or make switch.

License

This project is licensed under the GNU GPLv3. Additional Terms 7.b and 7.c of GPLv3 apply to this. See LICENSE.md for details.

Credits

• Bernardo for creating Checkpoint.
• J-D-K for the original JKSM version.
• TuxSH for TWLSaveTool, from which SPI code has been taken.
• LiquidFenrir for the GBA Virtual Console save support.
• SNBeast for the DSiWare save support proof of concept.
• edu1010 for the wireless save transfer feature.
• piepie62 and all other PKSM contributors for some code that has been ported to Checkpoint.
• WinterMute, fincs and devkitPro contributors for devkitARM, devkitA64 and dkp-pacman.
• Yellows8 and all the mantainers for switch-examples.
• rakujira for the awesome Checkpoint logo.
• achinech for helping to debug the infamous 3.8.x crash issue.
• Fellow testers and troubleshooters for their help.
• The huge amount of supporters that this project has gained over the years.

Without you, this project wouldn't have existed. Thank you.