Edit Infobox Switch Homebrews: LibHac and hactoolnet Switch

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:

LibHac is a .NET library that reimplements some parts of the Nintendo Switch operating system, also known as Horizon OS. One of the other main functions of the library is opening, decrypting and extracting common content file formats used by Horizon. Most content is imported and exported using a standard <code>IStorage</code> interface. This means that reading nested file types and encryptions can easily be done by linking different file readers together. For example, the files from a title stored on the external SD card can be read or extracted in this way. <code>NAX0 Reader</code> > <code>NCA Reader</code> > <code>RomFS Reader</code> > <code>Individual Files</code> ==User guide== ===LibHac=== ====Supported formats==== {| style="margin-left:0em;" | *NCA *XCI *NAX0 *PFS0/HFS0/NSP *RomFS *Save file *CNMT |width="10px"|  | *Package1 *Package2 *INI1/KIP1 *NACP *Ticket *PRODINFO *Switch NAND and SD card |} ====Additional features==== *Save file editing and signing. *PFS0 creation. *Switch key derivation. *Integrity verification of NCA, XCI, etc. *Personalized title key reading. *Read, parse and display information about a Switch NAND or SD card. *Extract NCA, RomFS and other formats directly from an SD card or NAND, including patched titles. *And more. ===hactoolnet=== Hactoolnet is a tool that uses LibHac for viewing and extracting data from common Nintendo Switch file formats. It partially mimics [[hactool Switch|hactool]]'s interface. ====Features==== *Dump the container formats that LibHac supports. *A progress bar. *Save file signing. *Dump RomFS directly from an XCI or SD card. *Dump SD card titles as NSP files. *Verify the integrity of all titles on a Switch SD card. *Switch key derivation. *Automatic integrity verification of NCA, XCI, etc.. *Give information about the titles and applications on a Switch NAND or SD card. *Extract NCA, RomFS and other formats directly from an SD card or NAND, including patched titles. ====Usage==== <pre> Usage: hactoolnet.exe [options...] <path> Options: -r, --raw Keep raw data, don't unpack. -y, --verify Verify all hashes in the input file. -h, --enablehash Enable hash checks when reading the input file. -d, --dev Decrypt with development keys instead of retail. -k, --keyset Load keys from an external file. -t, --intype=type Specify input file type [nca, xci, romfs, pfs0, pk11, pk21, ini1, kip1, switchfs, save, ndv0, keygen, romfsbuild, pfsbuild] --titlekeys <file> Load title keys from an external file. --accesslog <file> Specify the access log file path. --disablekeywarns Disables warning output when loading external keys. --version Display version information and exit. --help Display this help and exit. NCA options: --plaintext <file> Specify file path for saving a decrypted copy of the NCA. --ciphertext <file> Specify file path for saving an encrypted copy of the NCA. --header <file> Specify Header file path. --section0 <file> Specify Section 0 file path. --section1 <file> Specify Section 1 file path. --section2 <file> Specify Section 2 file path. --section3 <file> Specify Section 3 file path. --section0dir <dir> Specify Section 0 directory path. --section1dir <dir> Specify Section 1 directory path. --section2dir <dir> Specify Section 2 directory path. --section3dir <dir> Specify Section 3 directory path. --exefs <file> Specify ExeFS file path. --exefsdir <dir> Specify ExeFS directory path. --romfs <file> Specify RomFS file path. --romfsdir <dir> Specify RomFS directory path. --listromfs List files in RomFS. --basenca Set Base NCA to use with update partitions. --basetitlekey Specify single (encrypted) titlekey for the base NCA. --titlekey Specify single (encrypted) titlekey. --suppresskeys Suppress output of decrypted keys. KIP1 options: --uncompressed <f> Specify file path for saving uncompressed KIP1. RomFS options: --romfsdir <dir> Specify RomFS directory path. --listromfs List files in RomFS. RomFS creation options: Input path must be a directory --outfile <file> Specify created RomFS file path. Partition FS options: --outdir <dir> Specify extracted FS directory path. Partition FS creation options: Input path must be a directory --outfile <file> Specify created Partition FS file path. --hashedfs Create a hashed Partition FS (HFS0). XCI options: --rootdir <dir> Specify root XCI directory path. --updatedir <dir> Specify update XCI directory path. --normaldir <dir> Specify normal XCI directory path. --securedir <dir> Specify secure XCI directory path. --logodir <dir> Specify logo XCI directory path. --outdir <dir> Specify XCI directory path. --nspout <file> Specify file for the created NSP. Partition FS and XCI options: --exefs <file> Specify main ExeFS file path. --exefsdir <dir> Specify main ExeFS directory path. --romfs <file> Specify main RomFS file path. --romfsdir <dir> Specify main RomFS directory path. --listapps List application info. --listtitles List title info for all titles. --listncas List info for all NCAs. --title <title id> Specify title ID to use. Package1 options: --outdir <dir> Specify Package1 directory path. Package2 options: --outdir <dir> Specify Package2 directory path. --extractini1 Enable INI1 extraction to default directory (redundant with --ini1dir set). --ini1dir <dir> Specify INI1 directory path. Overrides default path, if present. INI1 options: --outdir <dir> Specify INI1 directory path. Switch FS options: --sdseed <seed> Set console unique seed for SD card NAX0 encryption. --listapps List application info. --listtitles List title info for all titles. --listncas List info for all NCAs. --title <title id> Specify title ID to use. --outdir <dir> Specify directory path to save title NCAs to. (--title must be specified) --exefs <file> Specify ExeFS directory path. (--title must be specified) --exefsdir <dir> Specify ExeFS directory path. (--title must be specified) --romfs <file> Specify RomFS directory path. (--title must be specified) --romfsdir <dir> Specify RomFS directory path. (--title must be specified) --savedir <dir> Specify save file directory path. -y, --verify Verify all titles, or verify a single title if --title is set. Save data options: --outdir <dir> Specify directory path to save contents to. --debugoutdir <dir> Specify directory path to save intermediate data to for debugging. --sign Sign the save file. (Requires device_key in key file) --trim Trim garbage data in the save file. (Requires device_key in key file) --listfiles List files in save file. --repack <dir> Replaces the contents of the save data with the specified directory. --replacefile <filename in save> <file> Replaces a file in the save data NAX0 options: --sdseed <seed> Set console unique seed for SD card NAX0 encryption. --sdpath <path> Set relative path for NAX0 key derivation (ex: /registered/000000FF/cafebabecafebabecafebabecafebabe.nca). --plaintext Specify file path to save decrypted contents. NDV0 (Delta) options: Input delta patch can be a delta NCA file or a delta fragment file. --basefile <file> Specify base file path. --outfile Specify patched file path. Keygen options: --outdir <dir> Specify directory path to save key files to. </pre> ====Examples==== List applications on a Switch SD card or NAND: <code>hactoolnet -t switchfs --sdseed <sd_seed> --listapps <sd_root_path></code> Extract a title from an SD card or NAND as NCA files: <code>hactoolnet -t switchfs --sdseed <sd_seed> --title <title_id> --outdir output <sd_root_path></code> Extract the RomFS from a title from an SD card or NAND: <code>hactoolnet -t switchfs --sdseed <sd_seed> --title <title_id> --romfsdir romfs <sd_root_path></code> Specifying the base title ID will extract the unpatched title. Specifying the patch title ID will extract the patched title. ====External Keys==== For more detailed information on keyset files, see [https://github.com/Thealexbarney/LibHac/blob/master/KEYS.md KEYS.md]. Keys can be loaded from a text file by specifying a filename with the <code>-k</code> argument. The file should be in the same format read by [https://github.com/SciresM/hactool#external-keys hactool]: "Keyset files are text files containing one key per line, in the form "key_name = HEXADECIMALKEY". Case shouldn't matter, nor should whitespace." Console-unique keys can be loaded from a text file by specifying a filename with the <code>--consolekeys</code> argument. The file format is the same as the main keyset file. Title keys can be loaded from a text file by specifying a filename with the <code>--titlekeys</code> argument. The file should contain one key per line in the form <code>rights_id,HEXADECIMALKEY</code>. If a keyfile is not set at the command line, hactoolnet will search for and load keyfiles in <code>$HOME/.switch/prod.keys</code>, <code>$HOME/.switch/console.keys</code> and <code>$HOME/.switch/title.keys</code>. ==Changelog== '''v0.19.0 2023/10/20''' *hactoolnet: Don't output unknown key warnings by default. '''v0.18.0 2023/02/12''' hactoolnet: *[https://github.com/Thealexbarney/LibHac/pull/268 #268] Reads personalized tickets in NSPs if <code>eticket_rsa_keypair</code> is in the key file. *[https://github.com/Thealexbarney/LibHac/pull/271 #271] Read TSEC secrets from the key file and use them to derive TSEC KEKs. *[https://github.com/Thealexbarney/LibHac/pull/271 #271] Validate the pk11 mac inside modern erista package1s if the proper key exists.] *[https://github.com/Thealexbarney/LibHac/pull/265 #265 Properly separate prod and dev derived device keys in the KeySet class. LibHac: *[https://github.com/Thealexbarney/LibHac/pull/268 #268] Load <code>eticket_rsa_keypair</code> from the key file and use it to decrypt personalized tickets. *[https://github.com/Thealexbarney/LibHac/pull/270 #270] Fix a bug in <code>EnsureApplicationSaveData</code> that wouldn't create a bcat save if any other bcat save already existed. *[https://github.com/Thealexbarney/LibHac/pull/271 #271] Read TSEC secrets from the key file and use them to derive TSEC KEKs. *[https://github.com/Thealexbarney/LibHac/pull/271 #271] Validate the pk11 mac inside modern erista package1s if the proper key exists. *[https://github.com/Thealexbarney/LibHac/pull/265 #265] Properly separate prod and dev derived device keys in the KeySet class. *[https://github.com/Thealexbarney/LibHac/pull/269 #269 Update to .NET 7 and C# 11 and use some of the new features **Use UTF-8 literals instead of manually defining byte spans. **Remove all uses of InlineIL.Fody. **Change the <code>Ref()</code> extension methods for <code>UniqueRef</code>/<code>SharedRef</code> to properties. **Use generic math throughout the project. **Use <code>scoped</code> and <code>UnscopedRef</code> so more lifetimes are tracked properly. [https://github.com/Thealexbarney/LibHac/releases Release notes.] ==Credits== Special Thanks: *This project uses NDepend for static code analysis. == External links == * GitHub - https://github.com/Thealexbarney/LibHac * GBAtemp - https://gbatemp.net/threads/libhac-hactoolnet-v0-1-3.521599/ [[Category:GBAtemp Homebrew Bounty 2018]]

Summary:

Cancel