mirror of
https://github.com/J-D-K/JKSV.git
synced 2026-04-25 16:15:11 -05:00
69 lines
4.0 KiB
Markdown
69 lines
4.0 KiB
Markdown
# JKSV
|
|
|
|
Data Dump/Restore tool for Switch.
|
|
|
|
<img width="640" src="https://i.imgur.com/3hAVzkQ.jpg"/>
|
|
|
|
## Info
|
|
JKSV on Switch started as a small project/port to test some things and get familiar with libnx. A list of what it currently can do:
|
|
1. Dump and restore save data.
|
|
* This includes the ability to dump and restore to/from any location on SD by pressing minus and using the Advanced Mode.
|
|
2. Dump system save data
|
|
* Dumping this data is allowed, but writing back is not.
|
|
3. Open and explore bis storage partitions via the Extras menu
|
|
* BIS Storage is opened inside a basic filebrowser. The partition's listing is on the left. Your SD is on the right.
|
|
* Only copying to SD and file properties work on BIS partitions. Writing to and deleting are disabled for now.
|
|
4. Misc Extras:
|
|
* Ability to remove downloaded firmware updates from NAND.
|
|
* Terminating processes by [ID](https://switchbrew.org/wiki/Title_list#System_Modules). Allowing you to dump normally unopenable system archives.
|
|
* Mount by System Save [ID](https://switchbrew.org/wiki/Flash_Filesystem#System_Savegames). Normally used when the terminated process makes JKSV unable to rescan titles without the Switch crashing.
|
|
* Mount and open RomFS of process the homebrew menu takes over (if launched as NRO).
|
|
* Hold R while opening a game or applet with Atmosphere so the homebrew menu loads. Open JKSV and press minus and select **Mount Process RomFS**. The romfs of the app should appear in the browser along with your SD on the right.
|
|
|
|
## Quick Guide
|
|
**A custom path can be defined by creating "sdmc:/switch/jksv_dir.txt" and typing the path you want to use. For example, `sdmc:/switch/JKSV/` will force JKSV to create its folder in the switch homebrew folder.**
|
|
|
|
1. User Select
|
|
* A opens the selected user's save files.
|
|
* Y Dumps __all__ save data from __all users__, device save data, and BCAT save data. System save data is not included in this.
|
|
* X Changes the UI mode to a text menu based one for people that prefer 3DS JKSM style text menus instead.
|
|
* ZR Opens the Options menu.
|
|
* Minus opens a small menu of extras.
|
|
|
|
2. Title Select
|
|
* A Opens the title for backup and restore.
|
|
* L and R change the current user.
|
|
* Y Dumps all saves for the currently selected user.
|
|
* X Adds the selected title to a list of ignored titles.
|
|
* Minus adds the selected title to a list of favorites that are pushed to the top of the title list/icons.
|
|
* ZR __ERASES__ The selected title's save from the system. This is the same as going into settings and deleting via data management. __THIS DOES NOT DELETE JKSV's SAVE FOLDERS__.
|
|
|
|
3. Backup/Folder Menu
|
|
* Minus opens file mode. File mode is a basic file browser for moving individual files and folders. This also adds the ability to restore saves from any location on your SD card.
|
|
* Holding L or R while selecting new with A will automatically name the backup for you without opening the keyboard.
|
|
* A creates a new backup
|
|
* Y Restores save data from the selected folder.
|
|
* X Deletes the selected folder.
|
|
* ZR __ERASES__ the current save data for the title from __your system__, but leaves the archive on NAND.
|
|
|
|
4. File Mode
|
|
* A opens directories.
|
|
* B goes back up a folder if possible.
|
|
* X opens a small menu of options for files and directories:
|
|
* Copy to [X] - Copies the currently selected item to the location opened on the other panel. Selecting the first `.` will use the directory opened as root to copy.
|
|
* Delete deletes the currently selected item.
|
|
* Rename renames the currently selected item.
|
|
* Make Dir creates a folder.
|
|
* Properties gets file size and directory size.
|
|
* ZL or ZR Change the controlled menu.
|
|
|
|
|
|
## Building:
|
|
1. Requires [devkitPro](https://devkitpro.org/) and [libnx](https://github.com/switchbrew/libnx)
|
|
2. Requires switch-freetype, libpng, and libjpeg-turbo
|
|
|
|
## Credits and Thanks:
|
|
* [shared-font](https://github.com/switchbrew/switch-portlibs-examples) example by yellows8
|
|
* Authors of switch-examples for account and save mounting code.
|
|
* [Iguniisu](https://github.com/igniscitrinus) for the icon.
|