Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Ninfs: Difference between revisions

From Hacks Guide Wiki
(2.0 and some cleanup)
(image alt text)
Line 4: Line 4:
| title = ninfs
| title = ninfs
| developers = ihaveamac/ihaveahax
| developers = ihaveamac/ihaveahax
| version = 2.0
| version = 2.0a10
| releasedate = 2024-02-24
| releasedate = 2023-08-07
| github = ihaveamac/ninfs
| github = ihaveamac/ninfs
| githubtag = v2.0
| githubtag = v2.0a10
| forwindows = 1
| forwindows = 1
| formac = 1
| formac = 1
Line 43: Line 43:


Standalone builds support Windows 8.1 or later. Windows 7 may work (until it doesn't). [https://winfsp.dev/rel/ WinFsp] must be installed.
Standalone builds support Windows 8.1 or later. Windows 7 may work (until it doesn't). [https://winfsp.dev/rel/ WinFsp] must be installed.
<code>ninfs-2.0a9-win32-installer.exe</code> contains WinFsp and will automatically install it if needed (though it will not update it).
<code>ninfs-2.0a9-win32.zip</code> requires WinFsp to be installed separately.
=== Windows on ARM ===
Official support for Windows on ARM will come [https://github.com/ihaveamac/ninfs/issues/91 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 ===
=== Standalone on macOS ===


The DMG download contains a signed and notarized application for Macs with Apple Silicon and Intel. Requires OS X 10.9 and later. [https://osxfuse.github.io macFUSE] must be installed separately.
<code>ninfs-2.0a9-macos.dmg</code> contains a signed and notarized application for Macs with Apple Silicon and Intel. Requires OS X 10.9 and later. [https://osxfuse.github.io macFUSE] must be installed separately.


=== As a Python module ===
=== As a Python module ===


ninfs is available on [https://pypi.org/project/ninfs/ PyPI] and can be installed like any other package. Python 3.8.0 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).
ninfs is available on [https://pypi.org/project/ninfs/ 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: <code>py -3 -m pip install ninfs==2.0a9</code>
* Linux and macOS: <code>python3 -m pip install --user ninfs==2.0a9</code>


== Usage ==
== Usage ==

Revision as of 02:09, 17 October 2023

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

Guides