Nintendo File Formats

TypeScript library for interacting with several Nintendo file formats across various consoles.

Installation

npm i @pretendonetwork/nintendo-files

Usage

This package makes use of the "exports" entry point. Ensure your tsconfig.json is configured for this.

Each file type may be imported both individually through separate import paths, or as named exports from the package root.

import { BYAML } from '@pretendonetwork/nintendo-files/byaml';
import { BYAML as BYML } from '@pretendonetwork/nintendo-files/byml'; // Alias of byaml export
import { Certificate } from '@pretendonetwork/nintendo-files/certificate';
import { CIA } from '@pretendonetwork/nintendo-files/cia';
import { CMP } from '@pretendonetwork/nintendo-files/compression/cmp';
import { Yaz0 } from '@pretendonetwork/nintendo-files/compression/yaz0';
import { ME01 } from '@pretendonetwork/nintendo-files/me01';
import { MSBT } from '@pretendonetwork/nintendo-files/msbt';
import { SMDH } from '@pretendonetwork/nintendo-files/smdh';
import { Ticket } from '@pretendonetwork/nintendo-files/ticket';
import { TMD } from '@pretendonetwork/nintendo-files/tmd';

import {
	BYAML,
	BYML, // Alias of byaml export
	Certificate,
	CIA,
	CMP,
	Yaz0,
	ME01,
	MSBT,
	SMDH,
	Ticket,
	TMD
} from '@pretendonetwork/nintendo-files';

In order to parse each file, call one of the provided parser methods. Methods exist both as instance and static methods for convenience. Each method is designed for parse the data from various data sources. Each class has the same common parser methods. For file specific methods and fields, see the classes type defs.

import { CIA } from '@pretendonetwork/nintendo-files/cia';

let cia: CIA;

cia = CIA.fromFile(fs.openSync('./nimbus.cia')); // Open file `fd`
cia = CIA.fromFile('./nimbus.cia'); // File path on disk
cia = CIA.fromBuffer(Buffer.from('...')); // Data as a buffer
cia = CIA.fromString('...'); // Base64 encoded data string
cia = CIA.fromFileStream(stream); // Mostly used for internal use. Accepts a FileStream from this library

Some classes support encoding the data back into a buffer. This is done through a bytes() method on each class. See below for a list of file type support.

Supported files (parsing)

• [x] CIA. Does not decrypt contents
• [x] Certificates. Signature verification works, just not on illegitimate signatures (homebrew, forged tickets, etc)
• [x] SMDH. All data is extracted, but some pieces (like several sections of Application Settings) are left as Buffer blobs
• [x] TMD
• [x] Ticket. Does not decrypt title key
• [ ] Encrypted title parts (.app files)
• [ ] Title hash trees (.h3 files)
• [ ] Mii data
• [x] MSBT. Parses:
  • [x] LBL1
  • [x] ATR1
  • [x] TXT2
  • [x] NLI1
  • [ ] TSY1
• [x] BYML/BYAML
• [ ] SARC
• [x] SZS (Yaz0)
• [x] CMP (.cmp zlib compressed files)
• [x] ME01 / SA01

Supported files (encoding)

• [ ] CIA
• [x] Certificates
• [ ] SMDH
• [x] TMD
• [x] Ticket
• [ ] Encrypted title parts (.app files)
• [ ] Title hash trees (.h3 files)
• [ ] Mii data
• [ ] MSBT
• [ ] BYML/BYAML
• [ ] SARC
• [ ] SZS (Yaz0)
• [ ] CMP (.cmp zlib compressed files)
• [ ] ME01 / SA01

Example

import fs from 'node:fs';
import { CIA } from '@pretendonetwork/nintendo-files/cia';

const cia = CIA.fromFile(`${__dirname}/nimbus.cia`);

console.log(cia.CACertificate.verifySignature(cia.TMDCertificate)); // true. Certificates are signed by Nintendo, and should always pass
console.log(cia.CACertificate.verifySignature(cia.ticketCertificate)); // true. Certificates are signed by Nintendo, and should always pass
console.log(cia.TMDCertificate.verifySignature(cia.TMD)); // false. Example Nimbus is a homebrew title, not signed by Nintendo. Nintendo signatures return true
console.log(cia.ticketCertificate.verifySignature(cia.ticket)); // false. Example Nimbus is a homebrew title, not signed by Nintendo. Nintendo signatures return true

if (cia.meta) {
	const largeIconData = cia.meta.iconData.exportLargeImage();
	fs.writeFileSync('./icon-large.png', largeIconData); // 48x48px SMDH icon from the CIA meta section

	console.log(cia.meta.iconData.getEnglishApplicationTitle());
	//{
	//	descriptionShort: 'Nimbus',
	//	descriptionLong: 'Nimbus',
	//	publisher: 'Zaksabeast, shutterbug2000'
	//}
}