Edit Infobox 3DS Homebrews: 3DS Save File Extraction Tools

You do not have permission to edit this page, for the following reason:

The action you have requested is limited to users in one of the groups: Users, Administrators.

Title:
Image:	Upload file
Description:
Author(s):
Last Updated:
Contributor(s):
Ported by:
Type:
Version:
License:
Language(s):
Format:
Download:
Download Raw:
Website:
Source:
Discussion:
Donation:

Free text:

These are tools parsing save (DISA file) and extdata (DIFF file) and extracting files from them. The tools work with decrypted files. They also support encrypted SD files if necessary keys are provided. Create file <code>secrets.py</code> from the template <code>secrets.py.template</code> to provide your keys. This repo also contains some old documentations of the save data format. They were migrated to 3dbrew and the version here is outdated and unmaintained. Please refer to the pages on 3dbrew instead. '''Note:''' For richer functionality, use [[Save3DS|Save3DS]]. ==User guide== Required: python 3. Some typical usage of the tools is listed here. These commands assume that you already have python 3 in the system PATH. * All the file/folder paths in the examples are just a hint of where you can find them. * "nand" is where you have the decrypted & mounted NAND. "sdmc" is where the SD card is mounted. * "output" is where you store the extracted files. * "0123456789abcdef0123456789abcdef" is a random ID (id0) that you will have a different one from your 3DS, and "fedcba9876543210fedcba9876543210" as well (id1). The general command form is <code>python disa/diff-extract.py INPUT OUTPUT OPTIONS</code>. In all examples below, the output path can be omitted, in which case the tool will only print the information of the input file(s) without extracting the data. For more advanced usage, see the output by running the scripts without arguments. ===Extracting save data=== ./disa-extract.py \ "nand/data/0123456789abcdef0123456789abcdef/sysdata/00010026/00000000" \ "output/sysdata-00010026" This extracts system save data 00010026 (CECD data) from NAND to folder <code>output/sysdata-00010026</code>. ----- ./disa-extract.py \ "sdmc/gm9out/00000001.sav" \ "output/savedata" This extracts game save data that has been decrypted using GodMode9 (or any other tools) to folder <code>output/savedata</code>. ----- ./disa-extract.py \ "sdmc/Nintendo 3DS/0123456789abcdef0123456789abcdef/fedcba9876543210fedcba9876543210/title/00040000/00164800/data/00000001.sav" \ "output/pokemon-sun-save" \ -sd \ -decrypt \ -id 0004000000164800 This extracts encrypted save data of Pokemon Sun from SD card to folder <code>output/pokemon-sun-save</code>. Some requirement and notes of this command: * You need to create <code>secrets.py</code> from <code>secrets.py.template</code> and fill in the keys. * The parameter <code>-id XXXXXXXXXXXXXXXX</code> is the game title ID in 16-digit hex and must match the game. * An additional library <code>Cryptodome</code> is needed. * If the script outputs "Error: CMAC mismatch.", it means that some of the keys or the title ID is incorrect. ===Extracting extdata=== ./diff-extract.py \ "nand/data/0123456789abcdef0123456789abcdef/extdata/00048000/f000000b" \ "output/sysextdata-f000000b" This extracts system extdata 00048000f000000b (contains coins info etc.) from NAND to folder <code>output/sysextdata-f000000b</code>. '''Note:''' Do not enter the <code>00000000</code> folder inside <code>f000000b</code>. ----- ./diff-extract.py \ "sdmc/gm9out/12345678" \ "output/extdata" This extracts extdata that has been decrypted using GodMode9 (or any other tools) to folder <code>output/extdata</code>. When using GodMode9, please copy the entire folder <code>sdmc/Nintendo 3DS/<id0>/<id1>/extdata/00000000/<id>/</code> (and do not enter the inner folder <code>00000000</code>) to somewhere else in SD card (<code>gm9out/</code> for example). ----- ./diff-extract.py \ "sdmc/Nintendo 3DS/0123456789abcdef0123456789abcdef/fedcba9876543210fedcba9876543210/extdata/00000000/00001554" \ "output/mhx-save" \ -decrypt \ -id 00001554 This extracts encrypted game extdata of Monster Hunter X from SD card to folder <code>output/mhx-save</code>. Some requirement and notes of this command: * You need to create <code>secrets.py</code> from <code>secrets.py.template</code> and fill in the keys. * The parameter <code>-id XXXXXXXX</code> is the extdata ID in 8-digit hex and must match the game. Usually similar to the game title ID. * An additional library <code>Cryptodome</code> is needed. * If the script outputs "Error: CMAC mismatch.", it means that some of the keys or the extdata ID is incorrect. ===Extracting single DIFF file (titledb file, extdata subfile etc.)=== ./diff-extract.py \ "nand/dbs/ticket.db" \ "output/ticket" This extracts the ticket database file from NAND to folder <code>output/ticket</code>. ----- ./diff-extract.py \ "sdmc/gm9out/title.db" \ "output/title" This extracts the title database file that has been decrypted using GodMode9 (or any other tools) from SD to folder <code>output/title</code>. ----- ./diff-extract.py \ "sdmc/Nintendo 3DS/0123456789abcdef0123456789abcdef/fedcba9876543210fedcba9876543210/dbs/title.db" \ "output/title" \ -titledb \ -decrypt \ -id 2 This extracts the encrypted title database file from SD to folder <code>output/title</code>. Some requirement and notes of this command: * You need to create <code>secrets.py</code> from <code>secrets.py.template</code> and fill in the keys. * The parameter <code>-id X</code> is title database ID: 2 for title.db and 3 for import.db. * An additional library <code>Cryptodome</code> is needed. * If the script outputs "Error: CMAC mismatch.", it means that some of the keys or the ID is incorrect. ===Extracting Title databse (<code>*.db</code> files, except for <code>certs.db</code>)=== ./db-extract.py \ "output/ticket" \ "output/tickets" This extracts all ticket subfiles from file <code>output/ticket</code> to <code>output/tickets</code>. The input file of this command is this output file of the <code>./diff-extract.py</code> command shown above. A bash file that pipes the two commands is also provided. It takes the original <code>ticket.db</code> file as input. ./db-fast.sh \ "nand/dbs/ticket.db" \ "output/tickets" ==Screenshots== https://dlhb.gamebrew.org/3dshomebrews/3dssavetool3.png https://dlhb.gamebrew.org/3dshomebrews/3dssavetool4.png ==External links== * GitHub - https://github.com/wwylele/3ds-save-tool

Summary:

Cancel