ZEL.ZEL NiiEBLA

Usage guide | Reference | ZELZIP website

A parsing library for various Nintendo file formats. With accurate support for multiple niche entries and extensions (TikV1, Wii Savegame data, etc).

Supports:

• WAD/TAD files manipulation (with content adding, editing and removing), both installable (Is/ib) and backup (Bk) kinds.
• Encryption/Decryption of content data for Nintendo Wii and Nintendo DSi titles.
• Ticket (pre Nintendo Switch) TIK files.
• Title metadata (pre Nintendo Switch) TMD files.
• Nintendo certificate chain format.
• U8 archive files.
• Trucha bug based fakesigning for the Nintendo Wii.
• Nintendo Wii's savegame format.

Limitations

Be aware of the following limitations of the library: Soft limitations (will not be implemented unless a lot of interest is arised and documentation is improved):

• Content viewing and editing only available on Wii and DSi titles (TMD group hashes are not properly updated).
• CRL data on WAD files is not preserved.
• Arbitrary content types is not supported (understading and documenting the meaning of its bitflags would be required).
• Modifying contents on titles with TMD version 1 will not edit its content entry groups hashes.
• "Section total size" and "size of each region" are not checked for correctness when parsing.

Hard limitations (cannot or are to complex to be fixed):

• 1:1 byte match on the V1 section of a PreSwitchTicket is not ensured.

Quickstart

First of all add the library into your Rust project:

$ cargo add zelzip_niiebla

Parsing

From this you can parse any format you want using the new(...) method on the proper struct:

use zelzip_niiebla::PreSwitchTicket;
use std::fs::File;

let mut ticket_file = File::open("/just/any/path").unwrap();

let ticket = PreSwitchTicket::new(&mut ticket_file).unwrap();

println!(ticket.title_id);
// 00000001-00000002

Dumping

After making any change, let's say on the metadata of a title, you can compose the data again with the dump(...) method.

use zelzip_niiebla::TitleMetadata;
use std::fs::File;

let mut tmd_file = File::open("/just/any/path").unwrap();

let mut tmd = TitleMetadata::new(&mut tmd_file).unwrap();
tmd.boot_content_index = 1;

let mut new_tmd_file = File::open("/just/any/other/path").unwrap();
tmd.dump(&mut new_tmd_file).unwrap();

For more advanced use cases visit the usage guide

Legal notice

This project is a fan-made homebrew creation developed independently and is not affiliated with, endorsed by, or associated with Nintendo Co., Ltd or any of its subsidiaries, affiliates, or partners. All trademarks and copyrights referenced are the property of their respective owners.