(2.0 and some cleanup) |
(image alt text) |
||
Line 4: | Line 4: | ||
| title = ninfs | | title = ninfs | ||
| developers = ihaveamac/ihaveahax | | developers = ihaveamac/ihaveahax | ||
| version = 2. | | version = 2.0a10 | ||
| releasedate = | | releasedate = 2023-08-07 | ||
| github = ihaveamac/ninfs | | github = ihaveamac/ninfs | ||
| githubtag = v2. | | 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 === | ||
<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. | 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
This page is a work in progress. |
Developer(s) | ihaveamac/ihaveahax |
---|---|
Platform | Microsoft Windows, macOS, Linux |
Version | 2.0a10 (August 7, 2023 | )
Links | |
GitHub | ihaveamac/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.
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
This section is a work in progress. |
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 thegui
argument. Example:- Windows:
py -3 -m ninfs gui
- Linux and macOS:
python3 -m ninfs gui
- Windows:
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
- Windows:
- 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
This section is a work in progress. |