JNUSTool/README.md

58 lines
2.9 KiB
Markdown
Raw Normal View History

# JNUSTool
JNUSTool is a Java application for download and decrypting NUS data from the WiiU and 3DS eShop. This tool allows users to browse and select individual files associated with a NUS titlekey before downloading, supports on-the-fly decryption (no cleaning up temporary files!), and allows for high-speed multithreaded downloads.
## Features:
- Download encrypted data from the eShop
- Seamlessly decrypt encrypted data from the eShop with on-the-fly decryption
- Decrypt pre-downloaded NUS data
- Support for downloading specific versions of a title
- Download/decrypt of the meta folder only
- On the fly download and decryption of single files (Updates, DLC, etc.)
- Bulk title downloads using filelist.txt
- Bulk downloads using [regular expressions](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions/Cheatsheet) (e.g all models or sounds)
- Automatically search for and notify of available software updates during download.
## Environment Requirements:
- [Java 8](https://www.java.com/en/download/)
## Note: eShop EOL Announcement
[Nintendo has announced that the WiiU and 3DS eShop will be permanently discontinued on or before March 2023.](https://en-americas-support.nintendo.com/app/answers/detail/a_id/57847) This tool will lose full download functionality at that time.
# Usage
There are two ways to run this application.
1. Automated:
Run the JNUSTool.jar file. Make sure you have a `config` file (with correct values) and `updatetitles.csv` in the same directory. A windows will popup and let you choose from the game updates. Feel free to add more titles.
2. Command line (when you want to provide a key or use a titleid that is not in the list)
`java -jar JNUSTool.jar <TITLEID>`
To download a specific version, specify the version after the title ID.
e.g. `java -jar JNUSTool.jar <titlekey> v16`
To disable on-the-fly decryption, append the string `-dlEncrypted`
Specific files, or a batch of specific files can be downloaded in isolation by appending `-file <file path or regex>` to the command
e.g.
- Download only app.xml with: `java -jar JNUSTool.jar <titlekey> -file /code/app.xml`
- Download only code folder with: `java -jar JNUSTool.jar <titlekey> -file /code/.*`
- Download all .szs files with: `java -jar JNUSTool.jar <titlekey> -file .*.szs`
## Sample config file
```
http://maschell.de/ccs/download
EE10040260BBB4ABD2C42DB25570B656
updatetitles.csv
TAGAYA 1 (latest_version)
TAGAYA 2 (versionlist)
```
# Data sources
The software will not work without the required titlekey, commonkey, and Nintendo URL - which can not be included here for legal purposes. GBATemp, Reddit, and other internet sources would be a good place to look. :stuck_out_tongue_winking_eye:
# Additional Information
- [GBATemp: JNUSTool Release Announcement](https://gbatemp.net/threads/jnustool-nusgrabber-and-cdecrypt-combined.413179/)
- [hacks.guide homebrew guides](https://hacks.guide/)