3DS:Cleaninty - Revision history

ManiacOfHomebrew: Remove broken link to autosoap

2026-02-22T13:55:52Z

Remove broken link to autosoap

← Older revision		Revision as of 13:55, 22 February 2026
Line 166:		Line 166:
	{{warning\|Although this script is far simpler to use than manually inputting commands, errors may still occur during edge cases. Knowledge of the command line will still likely be required to debug if this occurs.}}		{{warning\|Although this script is far simpler to use than manually inputting commands, errors may still occur during edge cases. Knowledge of the command line will still likely be required to debug if this occurs.}}

	If you are inexperienced with the command line or just don't want to type the commands manually every time, there is a ~~{{GitHub\|StarlitSkies/autosoap\|~~SOAP bash script}} made by StarlitSkies that heavily simplifies the process.		If you are inexperienced with the command line or just don't want to type the commands manually every time, there is a SOAP bash script made by StarlitSkies that heavily simplifies the process.

	Read the instructions on its page for setup and usage.		Read the instructions on its page for setup and usage.

	[[Category:Nintendo 3DS guides]]		[[Category:Nintendo 3DS guides]]

Ajl721: Sneaky...

2025-10-06T18:40:58Z

Sneaky...

Show changes

Ihaveahax: SOAP is a protocol, not a server

2025-09-18T03:49:32Z

SOAP is a protocol, not a server

← Older revision		Revision as of 03:49, 18 September 2025
Line 14:		Line 14:
	\| text = Nintendo Homebrew no longer offers SOAP transfer services. This page is about the tools used, and can be used by anyone with their own console data. Users must provide their own donor console data. Use at your own risk.		\| text = Nintendo Homebrew no longer offers SOAP transfer services. This page is about the tools used, and can be used by anyone with their own console data. Users must provide their own donor console data. Use at your own risk.
	}}		}}
	'''cleaninty''' is a PC tool used to communicate with Nintendo's [[wikipedia:SOAP\|SOAP]] ~~servers~~. For a 3DS, these servers deal with managing eShop accounts, downloading eShop titles, and system transfers. It is also the tool used for what is informally known as a "SOAP transfer".		'''cleaninty''' is a PC tool used to communicate with Nintendo eShop servers, using the [[wikipedia:SOAP\|SOAP]] protocol. For a 3DS, these servers deal with managing eShop accounts, downloading eShop titles, and system transfers. It is also the tool used for what is informally known as a "SOAP transfer".

	== Overview ==		== Overview ==

Tophatted: add necessary notice to downgrade cryptography to 43.0.3, add not super necessary but still good to have notice that cleaninty is not up to date on PyPI

2025-08-03T00:33:05Z

add necessary notice to downgrade cryptography to 43.0.3, add not super necessary but still good to have notice that cleaninty is not up to date on PyPI

← Older revision		Revision as of 00:33, 3 August 2025
Line 101:		Line 101:

	Regardless of your OS, you will need a 3DS with both custom firmware and [[3DS:GodMode9\|GodMode9]] installed to dump all of the files required to do <code>SetupConstants</code>. The vast majority of them are dumped using [https://raw.githubusercontent.com/luigoalma/cleaninty/master/gm9scripts/ExtractSystemElements.gm9 ExtractSystemElements.gm9], but the the [[wikipedia:Advanced_Encryption_Standard\|AES]] Constant "C" is found using the full set of instructions [https://3ds.goombi.fr/convertMii/0x31.html on this page].		Regardless of your OS, you will need a 3DS with both custom firmware and [[3DS:GodMode9\|GodMode9]] installed to dump all of the files required to do <code>SetupConstants</code>. The vast majority of them are dumped using [https://raw.githubusercontent.com/luigoalma/cleaninty/master/gm9scripts/ExtractSystemElements.gm9 ExtractSystemElements.gm9], but the the [[wikipedia:Advanced_Encryption_Standard\|AES]] Constant "C" is found using the full set of instructions [https://3ds.goombi.fr/convertMii/0x31.html on this page].

	{{critical\|The AES Constant, along with all other constants used by cleaninty, are copyrighted data. Obtaining them from your own console(s) is fine, but '''do not''' share the constants with anyone else.}}		{{critical\|The AES Constant, along with all other constants used by cleaninty, are copyrighted data. Obtaining them from your own console(s) is fine, but '''do not''' share the constants with anyone else.}}
	{{info\|These constants are the same on all consoles. Once one set is dumped, you will not need to redump in the future unless you lose access to them.}}		{{info\|These constants are the same on all consoles. Once one set is dumped, you will not need to redump in the future unless you lose access to them.}}
Line 123:		Line 124:
	First, ensure you have Python 3.7 or newer. You can check if your Python version is new enough by opening a terminal and running the command <code>python3 --version</code>. If you do not, install a compatible version from either your package manager or [https://www.python.org/downloads/ the Python website].		First, ensure you have Python 3.7 or newer. You can check if your Python version is new enough by opening a terminal and running the command <code>python3 --version</code>. If you do not, install a compatible version from either your package manager or [https://www.python.org/downloads/ the Python website].

	Then, either install cleaninty directly from <code>pip</code> or clone its repo via the command <code>git clone https://github.com/luigoalma/cleaninty.git</code> and then run the <code>setup.py</code> script.		Then, either install cleaninty directly from <code>pip</code> or clone its repo via the command <code>git clone https://github.com/luigoalma/cleaninty.git</code> and then run the <code>setup.py</code> script. Installing directly from <code>pip</code> will install an outdated but functional version of cleaninty.

			By default, the latest version of cryptography will be installed, which does not work with cleaninty. You should install the latest compatible version, 43.0.3, with <code>pip</code>.

	== Usage ==		== Usage ==

Ihaveahax: warning

2025-07-26T04:35:00Z

warning

← Older revision		Revision as of 04:35, 26 July 2025
Line 9:		Line 9:
	\| formac = 1		\| formac = 1
	\| forlinux = 1		\| forlinux = 1
			}}
			{{imbox
			\| type = delete
			\| text = Nintendo Homebrew no longer offers SOAP transfer services. This page is about the tools used, and can be used by anyone with their own console data. Users must provide their own donor console data. Use at your own risk.
	}}		}}
	'''cleaninty''' is a PC tool used to communicate with Nintendo's [[wikipedia:SOAP\|SOAP]] servers. For a 3DS, these servers deal with managing eShop accounts, downloading eShop titles, and system transfers. It is also the tool used for what is informally known as a "SOAP transfer".		'''cleaninty''' is a PC tool used to communicate with Nintendo's [[wikipedia:SOAP\|SOAP]] servers. For a 3DS, these servers deal with managing eShop accounts, downloading eShop titles, and system transfers. It is also the tool used for what is informally known as a "SOAP transfer".

StarlitSkies: fix interwiki link

2024-12-05T06:06:10Z

fix interwiki link

← Older revision		Revision as of 06:06, 5 December 2024
Line 33:		Line 33:
	</ol>		</ol>

	Additionally, it should be mentioned that there are four main parts of the 3DS eShop's servers that are related to SOAP operations. Connecting to most of them requires the use of two cerificates from the console(s) to verify it's a real console, those certificates being [[3dbrew:~~CLCertA~~\|~~CLCertA~~]] and [[3dbrew:CTCert\|CTCert]]. (The needed data from CTCert is stored inside the console's <code>otp.bin</code> [[3dbrew:OTP Registers\|from offsets 0x20 to 0x80]].)		Additionally, it should be mentioned that there are four main parts of the 3DS eShop's servers that are related to SOAP operations. Connecting to most of them requires the use of two cerificates from the console(s) to verify it's a real console, those certificates being [[3dbrew:ClCertA\|ClCertA]] and [[3dbrew:CTCert\|CTCert]]. (The needed data from CTCert is stored inside the console's <code>otp.bin</code> [[3dbrew:OTP Registers\|from offsets 0x20 to 0x80]].)

	<ol>		<ol>

StarlitSkies: overhaul to information, split overview into user-friendly and technical versions, revise descriptions of commands, & add {{warning}} to autosoap script

2024-12-05T02:12:50Z

overhaul to information, split overview into user-friendly and technical versions, revise descriptions of commands, & add {{warning}} to autosoap script

Show changes

Tophatted: MMM is dead, long live MM!

2024-11-19T01:27:36Z

MMM is dead, long live MM!

← Older revision		Revision as of 01:27, 19 November 2024
Line 19:		Line 19:
	The reason this allows for changing eShop regions easily, and at infinite range, are as follows:		The reason this allows for changing eShop regions easily, and at infinite range, are as follows:
	* '''Ease of Use''': Tickets for both system software & purchased apps are stored on Nintendo's servers, and some of these tickets are region-locked - meaning their presence blocks the console from registering to any other eShop region. (The most common of these tickets are from preinstalled games and the [[3dbrew:StreetPass Mii Plaza\|Mii Plaza 3.x]] update.) The only way to remove these tickets is to transfer them to another console, and cleaninty is able to move ''only'' the tickets with a single command.		* '''Ease of Use''': Tickets for both system software & purchased apps are stored on Nintendo's servers, and some of these tickets are region-locked - meaning their presence blocks the console from registering to any other eShop region. (The most common of these tickets are from preinstalled games and the [[3dbrew:StreetPass Mii Plaza\|Mii Plaza 3.x]] update.) The only way to remove these tickets is to transfer them to another console, and cleaninty is able to move ''only'' the tickets with a single command.
	* '''Infinite Range:''' System transfers are effectively divided into two parts: the content transfer (done entirely on consoles), and the NNID/title transfer (done entirely on servers).<br>On an actual console, these two must be done at the same time - but if cleaninty sends the commands for a server transfer, it doesn't start a content transfer and thus the consoles do not have to be next to each other. (Technically, this also means a [[3DS:~~MMM~~\|~~Manual~~ Movable Moveover]] is the exact opposite of a SOAP transfer.)		* '''Infinite Range:''' System transfers are effectively divided into two parts: the content transfer (done entirely on consoles), and the NNID/title transfer (done entirely on servers).<br>On an actual console, these two must be done at the same time - but if cleaninty sends the commands for a server transfer, it doesn't start a content transfer and thus the consoles do not have to be next to each other. (Technically, this also means a [[3DS:MM\|Movable Moveover]] is the exact opposite of a SOAP transfer.)

Tophatted: add missing ctr to a cleaninty command

2024-10-21T22:05:57Z

add missing ctr to a cleaninty command

← Older revision		Revision as of 22:05, 21 October 2024
Line 95:		Line 95:
	\|-\|Succeeded=		\|-\|Succeeded=
	<ol>		<ol>
	<li value="7"><code>cleaninty EShopDelete -C soap_target.json</code></li>		<li value="7"><code>cleaninty ctr EShopDelete -C soap_target.json</code></li>
	</ol>		</ol>

StarlitSkies: /* Installation */: the AES constant very clearly needs godmode9 too. also mention that the constants are not console-unique

2024-09-30T02:20:46Z

Installation: : the AES constant very clearly needs godmode9 too. also mention that the constants are not console-unique

← Older revision		Revision as of 02:20, 30 September 2024
Line 45:		Line 45:


	Regardless of your OS, you will need a 3DS with both custom firmware and [[3DS:GodMode9\|GodMode9]] installed to dump ~~the vast majority~~ of the files required to do <code>SetupConstants</code> using [https://raw.githubusercontent.com/luigoalma/cleaninty/master/gm9scripts/ExtractSystemElements.gm9 ExtractSystemElements.gm9]~~. A guide to legally deriving~~ the ~~only constant ''not'' dumped via this method,~~ the [[wikipedia:Advanced_Encryption_Standard\|AES]] Constant "C"~~, can be~~ found [https://3ds.goombi.fr/convertMii/0x31.html on this page].		Regardless of your OS, you will need a 3DS with both custom firmware and [[3DS:GodMode9\|GodMode9]] installed to dump all of the files required to do <code>SetupConstants</code>. The vast majority of them are dumped using [https://raw.githubusercontent.com/luigoalma/cleaninty/master/gm9scripts/ExtractSystemElements.gm9 ExtractSystemElements.gm9], but the the [[wikipedia:Advanced_Encryption_Standard\|AES]] Constant "C" is found using the full set of instructions [https://3ds.goombi.fr/convertMii/0x31.html on this page].
	{{critical\|The AES Constant, along with all other constants used by cleaninty, are copyrighted data. Obtaining them from your own console(s) is fine, but '''do not''' share the constants with anyone else.}}		{{critical\|The AES Constant, along with all other constants used by cleaninty, are copyrighted data. Obtaining them from your own console(s) is fine, but '''do not''' share the constants with anyone else.}}
			{{info\|These constants are the same on all consoles. Once one set is dumped, you will not need to redump in the future unless you lose access to them.}}
	=== Windows ===		=== Windows ===