Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

NX Dump Client Switch: Difference between revisions

From GameBrew
(Created page with "{{Infobox Switch Homebrews |title=NX Dump Client |image=NXDumpClientSwitch.png |description=A client program for dumping over USB with nxdumptool. |author=v1993 |lastupdated=2024/09/01 |type=PC Utilities |version=1.1.3 |license=GPL-3.0 |download=https://dlhb.gamebrew.org/switchhomebrews/NXDumpClientSwitch.7z |website=https://github.com/v1993/nxdumpclient |source=https://github.com/v1993/nxdumpclient |donation= }} NX Dump Client is a client designed for dumping data over...")
 
(fix image and text)
 
Line 1: Line 1:
{{Infobox Switch Homebrews
{{Infobox Switch Homebrews
|title=NX Dump Client
|title=NX Dump Client
|image=NXDumpClientSwitch.png
|image=NXDumpClientSwitch2.png
|description=A client program for dumping over USB with nxdumptool.
|description=A client program for dumping over USB with nxdumptool.
|author=v1993
|author=v1993
Line 13: Line 13:
|donation=
|donation=
}}
}}
NX Dump Client is a client designed for dumping data over USB using [[NXDumpTool Switch|nxdumptool]]. It's straightforward and reliable – it just works! You can enable autostart in the settings and let it run in the background if you prefer.
NX Dump Client is a client for dumping data over USB using [[NXDumpTool Switch|nxdumptool]].  


== Frequently asked questions ==
You can enable autostart in the settings and let it run in the background.
=== What is the preferred installation method? ===
Short version: AUR (stable) package if you're on Arch-based distro, flatpak from Flathub otherwise. Installing flatpaks from CI is normally heavily discouraged since those won't be automatically updated - please install from Flathub if possible instead.


Long version: Manual building or using unofficial packages may be viable options in non-Arch environments, but Arch's/GNOME Flatpak SDK's (whichever is less up-to-date at the moment) is what ultimately determines what is the highest library version features from which I'll consider using. While I'm willing to support more distros natively, I won't be going out of my way to do so (a few tweaks to build system are fine, having to manually implement a feature present in newer version of a library/tool is not).
==Installation==
Use the AUR (stable) package if you're on Arch-based distro, flatpak from Flathub otherwise.  


=== Where are the dumps stored? ===
Installing flatpaks from CI is normally heavily discouraged since those won't be automatically updated - please install from Flathub if possible instead.
By default in your Downloads folder. You can change path (and a couple of other handy settings) in preferences.


=== Why are there different NSP/NCA checksum modes and which one should I use? ===
The dumps are stored in your Downloads folder by default. You can change path (and a couple of other handy settings) in preferences.
A fragment of NCA's SHA256 checksum is contained within its filename, allowing to verify its contents. Among other possible file types, NSPs typically contain multiple NCAs as well as a list of filenames in their header (which is sent last during transfer). When dumping, the original name of NCA is sent with it, although it might not check out with its contents if certain dump options that modify them are enabled. However, nxdumptool later sends adjusted NCA names within NSP header.
 
* Compatible mode uses filenames from NSP header, so it will work correctly if NCAs are modified by nxdumptool, but can only detect errors after the transfer has finished.
* Strict mode uses original NCA filenames, so it can detect errors as soon as the NCA is transferred, but will erroneously fail if NCA was modified by nxdumptool.
* None, as its name implies, completely disables checksum computation and verification.
 
As a result, strict mode is recommended, but only if you do not use nxdumptool settings that mess with NCA contents -- which is almost everything save for "remove console specific data" and "generate authoringtool data". Compatible mode should be used if you, for whatever reason, want to use these options (hint: you probably don't). "None" should only be used in unorthodox cases like a badly named NCA file in a RomFS dump - files are hashed during transfer (i.e. never read back from drive) and checksum computation is very unlikely to have any meaningful impact on transfer speed.
 
P.S.: standalone NCAs are never tampered with, so strict mode check is used for them in both checksum modes. XCIs do not support additional verification.
 
=== I get permissions error. Why? ===
Installing special udev rules is required for user access to device. You should have been prompted to do so interactively on first launch if using flatpak; system-wide installation installs rules automatically. Please report an issue if you think udev rules should have been installed by now - make sure to mention installation method in your report.
 
=== Why does flatpak version require network access, anyways? ===
Because of how udev events are communicated on Linux. You can manually revoke it if you so desire, but that will break support for device hotplug - i.e. you'll have to always connect your switch before starting the program.


==Screenshots==
==Screenshots==
[[image:NXDumpClientSwitch.png]]
[[File:NXDumpClientSwitch2.png|link=]]


==Changelog==  
==Changelog==  
Line 65: Line 48:


== External links ==
== External links ==
* Github - https://github.com/v1993/nxdumpclient
* GitHub - https://github.com/v1993/nxdumpclient

Latest revision as of 06:08, 16 September 2024

NX Dump Client
NXDumpClientSwitch2.png
General
Authorv1993
TypePC Utilities
Version1.1.3
LicenseGPL-3.0
Last Updated2024/09/01
Links
Download
Website
Source

NX Dump Client is a client for dumping data over USB using nxdumptool.

You can enable autostart in the settings and let it run in the background.

Installation

Use the AUR (stable) package if you're on Arch-based distro, flatpak from Flathub otherwise.

Installing flatpaks from CI is normally heavily discouraged since those won't be automatically updated - please install from Flathub if possible instead.

The dumps are stored in your Downloads folder by default. You can change path (and a couple of other handy settings) in preferences.

Screenshots

NXDumpClientSwitch2.png

Changelog

v1.1.3

  • A maintenance release before 1.2.0.

v1.1.2

  • Add initial support for USB ABI 1.2
  • More comprehensive support for new features of ABI 1.2 is in works and will be released as 1.2.0.

v1.1.1

  • Add basic speed and remaining time estimation.

v1.1.0

  • Improve checksum verification - support non-standard dump options by default.

v1.0.2

v1.0.1

  • Fix StartupNotify functionality under flatpak.

v1.0.0

  • Support for running in background and autostart.
  • Confirm exit if file transfer is in progress.

v0.1.0

  • First Release.

External links

Advertising: