Toggle search
Toggle menu
303
299
452
7K
Hacks Guide Wiki
Toggle preferences 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
More actions
(2.0 and some cleanup)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Page WIP}}{{lowercase title}}{{Infobox homebrew
{{Page WIP}}{{lowercase title}}{{Infobox homebrew
| image = Ninfs-logo.png
| image = Ninfs-logo.png
| imagealt = The logo for ninfs, a 3DS game card silhouette inside a red circle with a white border.
| title = ninfs
| title = ninfs
| developers = ihaveamac/ihaveahax
| developers = ihaveamac/ihaveahax
| version = 2.0a9
| version = 2.0
| releasedate = 2024-02-24
| github = ihaveamac/ninfs
| github = ihaveamac/ninfs
| githubtag = v2.0a9
| githubtag = v2.0
| forwindows = 1
| forwindows = 1
| formac = 1
| formac = 1
Line 41: 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 ===


<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.
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.


=== 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.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).
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).
 
* 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 ==

Latest revision as of 18:29, 24 March 2024

ninfs
The logo for ninfs, a 3DS game card silhouette inside a red circle with a white border.
Developer(s)ihaveamac/ihaveahax
PlatformMicrosoft Windows, macOS, Linux
Version2.0 (February 24, 2024; 8 months ago (2024-02-24))
Links
GitHubihaveamac/ninfs
Download

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.

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. macFUSE must be installed separately.

As a Python module

ninfs is available on 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).

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

Retrieved from "https://wiki.hacks.guide/w/index.php?title=Ninfs&oldid=5522"