Ninfs

ninfs

Developer(s)	ihaveamac/ihaveahax
Platform	Microsoft Windows, macOS, Linux
Version	2.0a10 (August 7, 2023 (2023-08-07))
Links
GitHub	ihaveamac/ninfs
Download
GitHub release

ninfs is a PC tool for mounting files from Nintendo consoles.

Features

ninfs can mount and expose the contents of many different file 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")

Installation

The latest release can be downloaded from GitHub.

Standalone on Windows

Standalone builds support Windows 8.1 or later. Windows 7 may work (until it doesn't). WinFsp must be installed.

ninfs-2.0a9-win32-installer.exe contains WinFsp and will automatically install it if needed (though it will not update it).

ninfs-2.0a9-win32.zip requires WinFsp to be installed separately.

Windows on ARM

Official support for Windows on ARM will come eventually. In the mean time, running the x86 version has been tested and seems to work properly. Make sure to install the latest WinFSP version with ARM64 support.

Standalone on macOS

ninfs-2.0a9-macos.dmg contains a signed and notarized application for Macs with Apple Silicon and Intel. Requires OS X 10.9 and later. macFUSE must be installed separately.

As a Python module

ninfs is available on PyPI and can be installed like any other package. Python 3.6.1 or later is required. Support depends on the availability of libfuse 2.x or a similar implementation. Nintendo Switch NAND support requires OpenSSL 1.1 or later (pre-included for Windows and macOS).

• Windows: py -3 -m pip install ninfs==2.0a9
• Linux and macOS: python3 -m pip install --user ninfs==2.0a9

Usage

Graphical interface

The GUI can be started in various ways depending on how it was installed.

• Windows: Find "ninfs" in the Start Menu. Or run ninfsw.exe in the standalone release.
• macOS: Run the ninfs application. If this is the first time, Gatekeeper might ask you if you are sure you want to start it.
• Python module: Run the ninfs module with the gui argument. Example:
  • Windows: py -3 -m ninfs gui
  • Linux and macOS: python3 -m ninfs gui

Command line

Mount types can be accessed through the command line in all setups.

• Windows: If added to PATH, use ninfs <type>. For example: ninfs cia game.cia E:
• macOS: Use the ninfs binary in the application. For example: /Applications/ninfs.app/Contents/MacOS/ninfs cia game.cia ~/Desktop/cia
• Python module: Use the ninfs module. For example:
  • Windows: py -3 -m ninfs cia game.cia E:
  • Linux and macOS: python3 -m ninfs cia game.cia ~/Desktop/cia
• Python module entrypoints: If Python is added to PATH (by default it is not on Windows), entrypoints can be used. For example: mount_cia game.cia ~/Desktop/cia