More actions
No edit summary |
No edit summary |
||
| Line 2: | Line 2: | ||
|title=mii2studio | |title=mii2studio | ||
|image=mii2studionx.png | |image=mii2studionx.png | ||
|description=This tool converts any Mii to the Mii Studio format used on Nintendo | |description=This tool converts any Mii to the Mii Studio format used on Nintendo website and also renders them to PNGs. | ||
|author=HEYimHeroic | |author=HEYimHeroic | ||
|lastupdated=2022/01/17 | |lastupdated=2022/01/17 | ||
Latest revision as of 12:43, 6 July 2024
| mii2studio | |
|---|---|
 | |
| General | |
| Author | HEYimHeroic |
| Type | PC Utilities |
| Version | 2019 |
| License | AGPL-3.0 |
| Last Updated | 2022/01/17 |
| Links | |
| Download | |
| Website | |
| Source | |
mii2studio is a command-line tool written in Python that can take any Mii from a Wii, 3DS, Wii U, Miitomo, or Switch and output it into a file that Mii Studio can load. Mii Studio is Nintendo's official online Mii editor.
Furthermore, the tool also outputs a link to the Mii rendered in PNG form, thanks to an API endpoint that Nintendo made. The Miis are encoded and additional parameters for the API can be played with here (facial expressions, showing a full body, renders of multiple 360° angles of a Mii's body, etc).
Also, the tool can print out some useful information about a Mii, like its birthday, height, build, Mii name, gender, favorite color, and more.
User guide
Command Syntax:
mii2studio <input mii file / qr code / cmoc entry number> <output studio mii file> <input type (wii/3ds/wiiu/miitomo/switchdb/switch/studio)>
The script can also be ran without parameters, in which it will allow you to input them with text.
Examples
Using a Mii binary file from a Wii:
python mii2studio.py /path/to/MichaelTutori.rcd /path/to/MichaelTutori.mnms wii
Using a 3DS QR Code:
python mii2studio.py "https://cdn.discordapp.com/attachments/687051755174887425/729799032561729597/sensei01_Michael_Tutori.JPG" /path/to/MichaelTutori.mnms 3ds
Using a Check Mii Out Channel entry number:
python mii2studio.py 4661-9722-1903 /path/to/MichaelTutori.mnms wii
The script will output a .mnms file, along with image URLs of the Mii's face and body rendered as PNGs, and some useful information about the Mii. It will also print the Mii Studio code, ready to be copy/pasted into the site using my Mii Studio Mii Loader.
Input Types
You can use almost every Mii format with this script:
- Mii binary files from many platforms:
- Wii.
- DS.
- Wii U/3DS (after countless revisions).
- SwitchDB.
- Mii format used in the Mii DB on the Switch NAND.
- Switch.
- Mii format used in save files in Switch games.
- Mii Studio.
- Currently broken for some reason.
- Mii QR Codes from many platforms:
- 3DS.
- Wii U.
- Miitomo.
- Tomodachi Life.
- Miitopia.
For a complete list on the differences of all Mii data file format types, see here.
Kaitai
Kaitai is an incredibly useful tool that can document file structures and read them. We use them to document the Mii file structures.
The .ksy file is in the Kaitai language, and the .py is used at runtime for Python scripts (and can be compiled with Kaitai's IDE).
Screenshots
Example of a rendered Mii
Credits
- bendevnull for his support.
- HEYimHeroic for writing the Kaitais for Switch, SwitchDB, and Mii Studio (and fixing larsen's terrible Wii U/3DS Kaitai).
- jaames for the Mii QR decrypting script.
- Larsenv for writing this script. (Some of it, anyways... his code has broken so much, it'd be untrue to say he was the only one.)
- Matthe815 for figuring out the obfuscation used for the Mii Studio renderer.