Fuse-NX Switch: Difference between revisions

Fuse-Nx
Fuse-Nx
General
Author	averne
Type	PC Utilities
Version	1.1
License	GPL-3.0
Last Updated	2021/02/24
Links
	Download
	Website
	Source

Latest revision as of 13:34, 4 August 2023

Fuse-Nx is an utility tool that exposes the internals of various Nintendo Switch formats as a filesystem though FUSE.

It can also search for file inside archives, and directly extract them.

Installation

fuse-nx:

sudo meson install -C build
For users of Arch-based distros, an AUR package is available.

Python bindings:

sudo python setup.py install
Or just pip install -U git+https://github.com/averne/Fuse-Nx.git.

User guide

Supported formats

Nca (only AES-CTR encrypted/plaintext NCA3s are supported, BKTR encryption (for update NCAs) is unsupported)
Xci
Pfs
Hfs
Romfs

Formats are recognized based on magicnums/numeric contants present in their headers, and not their extensions.

How to use

Refer to the built-in help (-h/--help). You can find help on a specific subcommand using fuse-nx <subcmd> --help, or fuse-nx --help-all.

Windows is supported via:

WinFsp - Make sure that winfsp-x64.dll (found in C:\Program Files (x86)\WinFsp\bin after installing) is present in the same directory as the executable;
WSL - To access the filesystem through the explorer, you will need to pass the -o allow_other flag to FUSE when mounting, and add user_allow_other to /etc/fuse.conf.

Project layout

lib - Library (fnx) for parsing the supported file formats;
src - Source code for the main application;
bindings - CPython (3) bindings for the library;
scripts - example Python scripts using these bindings.

Screenshots

Changelog

v1.1

Native windows support.

External links

GitHub - https://github.com/averne/Fuse-Nx
GBAtemp - https://gbatemp.net/threads/fuse-nx.574503/

@@ Line 1: / Line 1: @@
 {{Infobox Switch Homebrews
 |title=Fuse-Nx
-|image=fusenxswitch.png
+|image=fusenx.png
-|description=Fuse-Nx is an utility tool that exposes the internals of various Nintendo Switch formats as a filesystem though FUSE.
+|description=Utility tool that exposes the internals of various Nintendo Switch formats as a filesystem though FUSE.
 |author=averne
 |lastupdated=2021/02/24
@@ Line 8: / Line 8: @@
 |version=1.1
 |license=GPL-3.0
-|download=https://dlhb.gamebrew.org/switchhomebrews/fusenxswitch.7z
+|download=https://dlhb.gamebrew.org/switchhomebrews/fusenx.7z
 |website=https://gbatemp.net/threads/fuse-nx.574503/
 |source=https://github.com/averne/Fuse-Nx
 |donation=
 }}
-{{#seo:
-|title=Switch Homebrew PC Tools (PC Utilities) - GameBrew
-|title_mode=append
-|image=fusenxswitch.png
-|image_alt=Fuse-Nx
-}}
-{{cleanup|article|Needs cleanup}}
 Fuse-Nx is an utility tool that exposes the internals of various Nintendo Switch formats as a filesystem though FUSE.
-==Media==
+It can also search for file inside archives, and directly extract them.
-<youtube></youtube>
+==Installation==
+fuse-nx:
+* <code>sudo meson install -C build</code>
+* For users of Arch-based distros, an [https://aur.archlinux.org/packages/fuse-nx-git AUR package] is available.
+Python bindings:
+* <code>sudo python setup.py install</code>
+* Or just <code><nowiki>pip install -U git+https://github.com/averne/Fuse-Nx.git</nowiki></code>.
+==User guide==
+===Supported formats===
+*Nca (only AES-CTR encrypted/plaintext NCA3s are supported, BKTR encryption (for update NCAs) is unsupported)
+*Xci
+*Pfs
+*Hfs
+*Romfs
+Formats are recognized based on magicnums/numeric contants present in their headers, and not their extensions.
+===How to use===
+Refer to the built-in help (<code>-h</code>/<code>--help</code>). You can find help on a specific subcommand using <code>fuse-nx <subcmd> --help</code>, or <code>fuse-nx --help-all</code>.
+Windows is supported via:
+* [http://www.secfs.net/winfsp/rel/ WinFsp] - Make sure that <code>winfsp-x64.dll</code> (found in <code>C:\Program Files (x86)\WinFsp\bin</code> after installing) is present in the same directory as the executable;
+* WSL - To access the filesystem through the explorer, you will need to pass the <code>-o allow_other</code> flag to FUSE when mounting, and add <code>user_allow_other</code> to <code>/etc/fuse.conf</code>.
+===Project layout===
+*[https://github.com/averne/Fuse-Nx/blob/master/lib lib] - Library (fnx) for parsing the supported file formats;
+*[https://github.com/averne/Fuse-Nx/blob/master/src src] - Source code for the main application;
+*[https://github.com/averne/Fuse-Nx/blob/master/bindings bindings] - CPython (3) bindings for the library;
+*[https://github.com/averne/Fuse-Nx/blob/master/scripts scripts] - example Python scripts using these bindings.
 ==Screenshots==
-https://dlhb.gamebrew.org/switchhomebrews/fusenxswitch-01.png
+{| style="width: 80%; margin-left:0em;"
-https://dlhb.gamebrew.org/switchhomebrews/fusenxswitch-02.png
+|
-https://dlhb.gamebrew.org/switchhomebrews/fusenxswitch-03.png
+https://dlhb.gamebrew.org/switchhomebrews/fusenx.png
-https://dlhb.gamebrew.org/switchhomebrews/fusenxswitch-04.png
+https://dlhb.gamebrew.org/switchhomebrews/fusenx2.png
-https://dlhb.gamebrew.org/switchhomebrews/fusenxswitch-05.png
+https://dlhb.gamebrew.org/switchhomebrews/fusenx3.png
-https://dlhb.gamebrew.org/switchhomebrews/fusenxswitch-06.png
+https://dlhb.gamebrew.org/switchhomebrews/fusenx4.png
-https://dlhb.gamebrew.org/switchhomebrews/fusenxswitch-07.png
+|}
-https://dlhb.gamebrew.org/switchhomebrews/fusenxswitch-08.png
 ==Changelog==
-'''v.1.0'''
+'''v1.1'''
-* First Release.
+* Native windows support.
 == External links ==
-* Gbatemp - https://gbatemp.net/threads/fuse-nx.574503/
+* GitHub - https://github.com/averne/Fuse-Nx
-* Github - https://github.com/averne/Fuse-Nx
+* GBAtemp - https://gbatemp.net/threads/fuse-nx.574503/
-* Reddit -