UNX Save Sync Switch

uNX Save Sync
General
Author	prodeveloper0
Type	Save Managers and Editors
Version	1.0.0
License	MIT License
Last Updated	2026/04/15
Links
Download
Website
Source

uNX Save Sync (aka. uNSS) is a Nintendo Switch application that allows synchronization of save data between multiple devices through a central remote server.

The central remote server manages save data with internal revision IDs for each user and title.

Installation

Client

To use remote server synchronization, settings must be configured first. The uNSS client reads settings from sdmc:/uNSS/config.ini.

[remote]
enabled=1
serverUrl=http://your.hostname.com:8989

[account]
; Nickname of the Switch user profile to operate on.
; Must exactly match the nickname shown in the system's "My Page".
defaultAccountName=MyNickname
; 1 (default): use psel applet (profile selector) first,
;              fall back to defaultAccountName only when that fails
;              (this is always the case in applet mode, since a
;              library applet cannot launch psel).
; 0          : skip psel entirely and always resolve the account
;              from defaultAccountName.
useProfileSelector=1

[title]
; Which titles to include when pushing save data (archiving).
; "created" (default): only titles that already have save data on this console.
; "all"               : every installed title, even if it has never been saved.
archiveBy=created

; Which titles to include when pulling save data (restoring).
; "all" (default)     : every installed title, even if it has never been saved.
;                       uNSS will automatically create save data for titles
;                       that don't have any yet.
; "created"           : only titles that already have save data on this console.
restoreBy=all

; Exclude specific titles by title ID (hex, comma-separated).
; excludedTitleIds=0100000000010000,010000000000100B

; Exclude specific titles by name (separated by "||").
; excludedTitleNames=uNSS||DBI

Save data is pushed to the remote by pressing the Push button, and pulled from the remote by pressing the Pull button.

[account] behavior:

Launch context	useProfileSelector=1 (default)	useProfileSelector=0
Full application mode (forwarder / title takeover)	Use psel applet → fall back to defaultAccountName	Always use defaultAccountName
Applet mode (hbmenu via album applet)	Use defaultAccountName (psel is unavailable to library applets)	Use defaultAccountName

If defaultAccountName is unset (or does not match any registered user) when the client needs it, uNSS prints an explanatory message and only the Exit option is available.

Server

Running the server via the Python interpreter requires some dependencies. Install the dependencies first:

pip install -r requirements.txt

Linux / macOS

Background mode:

nohup run-linux.sh

Foreground mode:

./run-linux.sh

or:

python main.py --host 0.0.0.0 --port 8989

Windows

Just use the prebuilt binary made by PyInstaller.

Screenshots

Changelog

1.0.0

• Support SDL2 based GUI
• Support profile selection in applet mode
• Add application icon

0.0.3

• Support creating title's save data file system. Now don't need to run game first time to restore save data.
• Support title probing policies (when restore, when archive)
• Support title exclusion filter by ID or name

0.0.2

• Fix not working on HOS 20+
• Fix failed to restore save file from archive
• Support profile selector applet
• Support fallback account name to run on applet mode
• Refactor something
• Support building homebrew application on docker container

0.0.1

• First Release

External links

• Github - https://github.com/prodeveloper0/uNSS
• HB-App - https://hb-app.store/switch/microNXSaveSync