Ninfs: Difference between revisions

ninfs
Developer(s)	ihaveamac/ihaveahax
Platform	Microsoft Windows, macOS, Linux
Version	2.0a9
Links
GitHub	ihaveamac/ninfs
Download
	GitHub release;
	v; t; e;

Revision as of 08:49, 26 June 2022

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.

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.

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

Usage

Guides

@@ Line 1: / Line 1: @@
 {{Page WIP}}{{lowercase title}}{{Infobox homebrew
-| image = Ninfs-logo.png
-| imagealt = The logo for ninfs, a 3DS game card silhouette inside a red circle with a white border.
 | title = ninfs
 | developers = ihaveamac/ihaveahax
-| version = 2.0
+| version = 2.0a9
-| releasedate = 2024-02-24
 | github = ihaveamac/ninfs
-| githubtag = v2.0
+| githubtag = v2.0a9
 | forwindows = 1
 | formac = 1
@@ Line 43: / Line 40: @@
 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.
 === 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 ===
-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.
+* 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 ==
 {{Section WIP}}
-=== 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 <code>ninfsw.exe</code> 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 <code>ninfs</code> module with the <code>gui</code> argument. Example:
-** Windows: <code>py -3 -m ninfs gui</code>
-** Linux and macOS: <code>python3 -m ninfs gui</code>
-=== Command line ===
-Mount types can be accessed through the command line in all setups.
-* Windows: If added to PATH, use <code>ninfs &lt;type&gt;</code>. For example: <code>ninfs cia game.cia E:</code>
-* macOS: Use the <code>ninfs</code> binary in the application. For example: <code>/Applications/ninfs.app/Contents/MacOS/ninfs cia game.cia ~/Desktop/cia</code>
-* Python module: Use the <code>ninfs</code> module. For example:
-** Windows: <code>py -3 -m ninfs cia game.cia E:</code>
-** Linux and macOS: <code>python3 -m ninfs cia game.cia ~/Desktop/cia</code>
-* Python module entrypoints: If Python is added to PATH (by default it is not on Windows), entrypoints can be used. For example: <code>mount_cia game.cia ~/Desktop/cia</code>
 == Guides ==
 {{Section WIP}}