ninfs

ninfs v2.0

ninfs (formerly fuse-3ds) is a FUSE program to extract data from Nintendo game consoles. It works by presenting a virtual filesystem with the contents of your games, NAND, or SD card contents, and you can browse and copy out just the files that you need.

Windows, macOS, and Linux are supported.

cia-mount-mac.png

Supported types
  • Nintendo 3DS
    • CTR Cart Image (".3ds", ".cci")
    • CDN contents ("cetk", "tmd", and contents)
    • CTR Importable Archive (".cia")
    • Executable Filesystem (".exefs", "exefs.bin")
    • Nintendo 3DS NAND backup ("nand.bin")
    • NCCH (".cxi", ".cfa", ".ncch", ".app")
    • Read-only Filesystem (".romfs", "romfs.bin")
    • SD Card Contents ("Nintendo 3DS" from SD)
    • Installed SD Title Contents ("*.tmd" and "*.app" files)
    • 3DSX Homebrew (".3dsx")
  • Nintendo DS / DSi
    • Nintendo DSi NAND backup ("nand_dsi.bin")
    • Nintendo DS ROM image (".nds", ".srl")
  • iQue Player
    • iQue Player NAND backup (read-only) ("nand.bin")
  • Nintendo Switch
    • Nintendo Switch NAND backup ("rawnand.bin")
Example uses
  • Mount a NAND backup and browse CTRNAND, TWLNAND, and others, and write back to them without having to extract and decrypt them first.
  • Browse decrypted SD card contents. Dump installed games and saves, or copy contents between two system's SD contents.
  • Extract a game's files out of a CIA, CCI (".3ds"), NCCH, RomFS, raw CDN contents, just by mounting them and browsing its files. Or use the virtual decrypted file start playing the game in Citra right away.
Watch a video demonstration
Want to see a video demonstration? Here is one with Pokémon Ultra Moon, using ninfs v1.0.

In this short video, I show that the CIA is encrypted, then I use ninfs to mount it and browse its contents in Windows/File Explorer. I can also use the decrypted.cxi file to immediately start playing it in Citra.

(Note that slowness is due to the virtual machine, speed would be faster on a normal computer!)


See some screenshots
Root of a CIA mounted at F:

ciamount-win.png

Root of an NCCH mounted at A:

ncchmount-win.png

Root of a NAND backup mounted at E:\NAND

nandmount-win.png

Extra tools
  • Windows users can use OSFMount to browse the FAT12/FAT16 partitions of the NAND. macOS can use the built-in DiskImageMounter, or hdiutil from Terminal.
    • On Windows, make sure you choose a directory, not a drive letter. On macOS/Linux, enable allow_root or allow_other.
  • 3ds-save-tool can be used to extract data from DISA and DIFF files (savedata and extdata).
Change log
Changelog can be viewed at: https://github.com/ihaveamac/ninfs/releases
Author
ihaveahax
Downloads
4,883
Views
5,444
First release
Last update
Rating
4.80 star(s) 5 ratings

More resources from ihaveahax

Latest updates

  1. ninfs 2.0

    There have been many changes since 1.6.1. The highlights are: New graphical interface -...
  2. There are alpha releases on GitHub

    https://github.com/ihaveamac/ninfs/releases If you're waiting for updates to ninfs on this...
  3. ninfs v1.6.1

    CCI: Fix oversight with passing boot9 to the NCCH mount, causing the partitions to not be...

Latest reviews

Very useful tool for RomHacks / FanGames creators or simply people who are curious and who search everything
General chit-chat
Help Users
    K3Nv2 @ K3Nv2: The mutated Axolotl was awesome