Skip to content

shell script to automate cleaninty-based eshop region changes for a 3DS

License

Notifications You must be signed in to change notification settings

StarlitSkies/autosoap

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 

Repository files navigation

autosoap

A bash script that automates SOAP transfers done via a combination of cleaninty and donor files from unusuable consoles.

Important Notes

First off, 95% of consoles need a donor to be SOAP transferred. This script accounts for the 5% of cases that don't, but you will almost always need donor files to run it. If you do not already have donor files, this script will likely be useless to you as under no circumstances should a working console be used as a donor.

Second, the folder structure inside cleaninty is not an accident and should not be modified.

Compatibility

This script is not POSIX-compliant and relies on PCRE in grep. As a result, it is somewhat less portable than the average bash script - only Unix-based systems with bash v4 or higher and GNU grep are compatible.

Most Linux distros - including those ran through WSL - have both of these this out-of-the-box. Alpine Linux, *BSD, and macOS are more notable examples of ones that don't.

If your system does not have these, the easiest way to obtain them is by installing bash and grep through the Homebrew package manager. However, be aware that if you do this, Homebrew will install grep as ggrep, which the script does not account for. Manually adding PATH="/usr/local/opt/grep/libexec/gnubin:$PATH" to your profile file will be needed to reassign it back to grep.

Usage

Clone this repo, put the essential.exefs for the console that will receive the SOAP transfer into the Latest folder, and put your donor .json files into the Donors folder. Once your donors are ready, open a terminal directly inside the Latest folder and execute the script from there.

You must have already setup cleaninty's constants for this to work. Detailed information and instructions about the constants can be found on the Nintendo Homebrew Wiki.

Credits

  • luigoalma, for creating cleaninty and generally being a 3DS wizard.
  • danny8376, for creative usage of dd. Why? Because that dd is the reason you don't need to install anything else for this script.

About

shell script to automate cleaninty-based eshop region changes for a 3DS

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages