About

CTRTool is a general purpose reading/extraction tool for Nintendo 3DS file formats.

Supported File Formats

• ExeFs (.exefs)
• RomFs (.romfs) (and RomFS wrapped in IVFC)
• NCCH Format Variants:
  • CTR Executable Image (.cxi)
  • CTR File Archive (.cfa)
  • CTR Initial Process (.cip)
• NCCH ExtendedHeader (.exhdr)
• CTR Importable Archive (.cia)
• NCSD Format Variants:
  • CTR Card Image (.cci/.3ds/.3dz)
  • CTR System Update (.csu)
• ES TitleMetaData (.tmd)
• ES eTicket (.tik)
• Firmware Images (.firm)
• CRR (.crr)

Change Log since v1.2.0

• [BugFix] Support some prototype 0.10 CXI files that specified the exheader size as 0x800 (previously not defined, and later defined as 0x400) #154 (thanks @Wack0)

Change Log since v0.18.3

• [BugFix] Makerom no longer requires an ELF to have a data segment #142

About

CTRTool is a general purpose reading/extraction tool for Nintendo 3DS file formats.

Supported File Formats

• ExeFs (.exefs)
• RomFs (.romfs) (and RomFS wrapped in IVFC)
• NCCH Format Variants:
  • CTR Executable Image (.cxi)
  • CTR File Archive (.cfa)
  • CTR Initial Process (.cip)
• NCCH ExtendedHeader (.exhdr)
• CTR Importable Archive (.cia)
• NCSD Format Variants:
  • CTR Card Image (.cci/.3ds/.3dz)
  • CTR System Update (.csu)
• ES TitleMetaData (.tmd)
• ES eTicket (.tik)
• Firmware Images (.firm)
• CRR (.crr)

What's Changed since v1.1.1

• Update for 9.6 CCI changes by @liamadvance in #135
• Remove incorrect ExeFS header hash validation. by @Steveice10 in #137

New Contributors

• @liamadvance made their first contribution in #135

Full Changelog: ctrtool-v1.1.1-r2...ctrtool-v1.2.0

About

CTRTool is a general purpose reading/extraction tool for Nintendo 3DS file formats.

Supported File Formats

• ExeFs (.exefs)
• RomFs (.romfs) (and RomFS wrapped in IVFC)
• NCCH Format Variants:
  • CTR Executable Image (.cxi)
  • CTR File Archive (.cfa)
  • CTR Initial Process (.cip)
• NCCH ExtendedHeader (.exhdr)
• CTR Importable Archive (.cia)
• NCSD Format Variants:
  • CTR Card Image (.cci/.3ds/.3dz)
  • CTR System Update (.csu)
• ES TitleMetaData (.tmd)
• ES eTicket (.tik)
• Firmware Images (.firm)
• CRR (.crr)

Change Log since v1.1.0

• [BugFix] Honour plain flag (-p/--plain) when processing CIA content encryption

Change Log since v0.18.2

• [BuildSystem] makefile for makerom and libyaml updated to define -D_GNU_SOURCE for linux builds.
  • This addresses issue #122 where some functions were implcitly defined causing segfaults on linux.

Change Log since v0.18.1

• [BugFix] Correctly initialize prod InitialData KeyX.
• [BugFix] Properly select CCI CryptoType when not manually specified.

Change Log since v0.18

• [BugFix] Fixes bug where initial data wasn't generated correctly ( #107 ).
• [Change] Failures in generating RSA signatures is now a warning, not an error.
• [Change] MakeROM will now give more information about fatal errors. This should help diagnose confusing errors.
• [Change] MakeROM will warn users if the CCI crypto-type isn't supported by the target.

About

CTRTool is a general purpose reading/extraction tool for Nintendo 3DS file formats.

Supported File Formats

• ExeFs (.exefs)
• RomFs (.romfs) (and RomFS wrapped in IVFC)
• NCCH Format Variants:
  • CTR Executable Image (.cxi)
  • CTR File Archive (.cfa)
  • CTR Initial Process (.cip)
• NCCH ExtendedHeader (.exhdr)
• CTR Importable Archive (.cia)
• NCSD Format Variants:
  • CTR Card Image (.cci/.3ds/.3dz)
  • CTR System Update (.csu)
• ES TitleMetaData (.tmd)
• ES eTicket (.tik)
• Firmware Images (.firm)
• CRR (.crr)

Change Log since v1.0.4

• [NEW] Add CLI option -q/--quiet which enables silent mode ( #113 )
• [Change] When displaying ExHeader fields, Access info was renamed to FS access
• [Change] CTRTool now distingushes between three types of output
  • General output (information about a file)
    • These are printed to stdout.
    • These are the only output silenced in silent mode.
  • Warnings & Progress Indicators
    • These are printed to stderr.
    • This information is only shown in verbose mode.
    • These are prefixed in output with a tag [ctrtool::ClassNameHere LOG] ...
    • Progress indicators include output like Extracting X to Y...
  • Errors
    • These are printed to stderr.
    • These will always be shown.
    • These are prefixed in output with a tag [ctrtool::ClassNameHere ERROR] ...
    • Note verification errors are only shown in verify mode.
      • Errors with IVFC blocks will invalidate the whole IVFC layer, which is displayed as one error. To display where each block is invalid use verbose output mode.
      • Errors with ExtendedHeader FsAccess bits invalidate the whole bit-field, which is displayed as one error. To display where each bit is invalid use verbose output mode.
      • Errors with ExtendedHeader ServiceAccess entries invalidate the whole set, which is displayed as one error. To display where each entry is invalid use verbose output mode.

About

CTRTool is a general purpose reading/extraction tool for Nintendo 3DS file formats.

Supported File Formats

• ExeFs (.exefs)
• RomFs (.romfs) (and RomFS wrapped in IVFC)
• NCCH Format Variants:
  • CTR Executable Image (.cxi)
  • CTR File Archive (.cfa)
  • CTR Initial Process (.cip) (These are the processes bundled with the kernel image)
• NCCH ExtendedHeader (.exhdr)
• CTR Importable Archive (.cia)
• NCSD Format Variants:
  • CTR Card Image (.cci/.3ds/.3dz)
  • CTR System Update (.csu)
• ES TitleMetaData (.tmd)
• ES eTicket (.tik)
• Firmware Images (.firm)
• CRR (.crr)

Change Log since v1.0.3

• [BugFix] Fixed bug where CCI CryptoType 1,2 weren't processed correctly when evaulating InitialData. #116

About

CTRTool is a general purpose reading/extraction tool for Nintendo 3DS file formats.

Supported File Formats

• ExeFs (.exefs)
• RomFs (.romfs) (and RomFS wrapped in IVFC)
• NCCH Format Variants:
  • CTR Executable Image (.cxi)
  • CTR File Archive (.cfa)
  • CIP (.cip) (These are the processes bundled with the kernel image)
• NCCH ExtendedHeader (.exhdr)
• CTR Importable Archive (.cia)
• NCSD Format Variants:
  • CTR Card Image (.cci/.3ds/.3dz)
  • CTR System Update (.csu)
• ES TitleMetaData (.tmd)
• ES eTicket (.tik)
• Firmware Images (.firm)
• CRR (.crr)

Change Log since v1.0.2

• [BugFix] Fixed bug where extracting exefs/.code did not decompress when compressed flag was set. #114