Toggle search
Toggle menu
383
310
482
10.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.

3DS:Fastboot3DS and Ninfs: Difference between pages

From Hacks Guide Wiki
More actions
(Difference between pages)
VisualWikitext
m clarify that other wiki articles will probably only be b9s-based instructions
 
2.0 and some cleanup
 
Line 1: Line 1:
{{lowercase title}}{{Infobox homebrew
{{Page WIP}}{{lowercase title}}{{Infobox homebrew
| title = fastboot3DS
| image = Ninfs-logo.png
| for3ds = 1
| imagealt = The logo for ninfs, a 3DS game card silhouette inside a red circle with a white border.
| version = v1.2
| title = ninfs
| github = derrekr/fastboot3DS
| developers = ihaveamac/ihaveahax
| githubtag = v1.2
| version = 2.0
| releasedate = 2024-02-24
| github = ihaveamac/ninfs
| githubtag = v2.0
| forwindows = 1
| formac = 1
| forlinux = 1
}}
}}
'''fastboot3DS''' is a firmware loader for the Nintendo 3DS. It works like [[3DS:boot9strap|boot9strap]], but offers additional features such as:
'''ninfs''' is a PC tool for mounting files from Nintendo consoles.


* A menu that can be accessed by holding (Home) on boot to perform certain actions
== Features ==
* The ability to chainload payloads directly from fastboot3DS itself (instead of through Luma3DS)
** For example, you could configure it so that holding ''multiple'' buttons at once boots you into a payload
* The ability to display a splash screen on startup, before Luma3DS has booted
* The ability to backup / restore your NAND, as well as backup your bootroms and otp.bin
** The latter can no longer be done with boot9strap as of boot9strap v1.4, but can still be done through GodMode9
* Compatibility with HOME Menu FIRM payload shortcuts, such as [https://gbatemp.net/download/open-agb-launcher.36828/ this one] for [[3DS:open_agb_firm|open_agb_firm]]


[[3dsguide:index|Our guide]] installs boot9strap since it's what most end users will be fine with, but if you're a power user, then you may be interested in installing fastboot3DS.
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")


{{warning|While the installation of fastboot3DS is a generally safe process (equally safe as installing boot9strap), there is still a chance that something goes catastrophically wrong. Installing fastboot3DS (just like boot9strap) involves writing to the 3DS's FIRM partitions, so if something goes wrong, you may need ntrboot to fix it.}}
== Installation ==


{{info|Two things you should know:
The latest release can be {{GitHub|ihaveamac/ninfs/releases/latest|downloaded from GitHub}}.
* Troubleshooting may differ for some situations (generally for things relating to FIRM-based payloads) when fastboot3DS is installed, so you should disclose that when getting help with such a situation.
* The vast majority of pages on this wiki will assume that you're using a boot9strap-based installation. If you choose to install fastboot3DS, you'll need to adapt the wiki's instructions to your personal setup (and/or figure it out on your own).}}


== Installation ==
=== Standalone on Windows ===
 
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 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.
 
=== 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).
 
== Usage ==
{{Section WIP}}
 
=== Graphical interface ===


=== What you need ===
The GUI can be started in various ways depending on how it was installed.
* The latest release of {{GitHub|derrekr/fastboot3DS/releases/latest|fastboot3DS}} (the <code>.7z</code> file)
* The latest release of {{GitHub|d0k3/OpenFirmInstaller/releases/latest|OpenFirmInstaller}} (the OpenFirmInstaller <code>.zip</code> file)


=== Section I - Prep Work ===
* Windows: Find "ninfs" in the Start Menu. Or run <code>ninfsw.exe</code> in the standalone release.
# Insert your SD card into your computer
* macOS: Run the ninfs application. If this is the first time, Gatekeeper might ask you if you are sure you want to start it.
# Create a folder named <code>ofi</code> on the root of your SD card
* Python module: Run the <code>ninfs</code> module with the <code>gui</code> argument. Example:
# Copy <code>fastboot3DS.firm</code> from the fastboot3DS <code>.7z</code> file to the <code>ofi</code> folder
** Windows: <code>py -3 -m ninfs gui</code>
# Copy <code>OpenFirmInstaller.firm</code> from the OpenFirmInstaller <code>.zip</code> file to the <code>/luma/payloads/</code> folder
** Linux and macOS: <code>python3 -m ninfs gui</code>
# Remove your SD card and put it back into your 3DS


=== Section II - OpenFirmInstaller ===
=== Command line ===


# Hold (Start), then power on your device while still holding (Start) to enter the Luma3DS chainloader
Mount types can be accessed through the command line in all setups.
# Navigate to "OpenFirmInstaller" in the list, then press (A)
# Follow the on-screen prompts to install fastboot3DS


{{success|text=fastboot3DS has been successfully installed!}}
* 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>


== Configuration ==
== Guides ==
WIP
{{Section WIP}}

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; 21 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=3DS:Fastboot3DS&oldid=5522"