In this tutorial I will go over how to build iosuhax from either my branch (for wupserver only) or dimoks branch (for rednand and signature patches) without having anything related installed yet.

Getting python
The first thing you want to do is download python, for this guide you will click download python 3.5, this will give you the current 3.5 32bit installer of python. If you already have a python 2 installation and you dont want to uninstall for python 3 then skip this step but note that you may have to add the python installation path into the PATH variable yourself if you didnt do that during that installation.
After opening the 3.5 32bit installer make sure to enable "Add Python 3.5 to PATH" because we want to be able to call python from anywhere, now let it install.

Installing pycrypto
To easly install pycrypto we will install it from this github page for the current 3.5 or this page for 2.7 if you have that. Open up a command prompt by for example pressing windows+r and typing in "cmd", in this command prompt you want to enter the following (just copy paste this depending on your python version):

Spoiler

PYTHON 3
Python 3.5 32bit:

pip install --use-wheel --no-index --find-links=https://github.com/sfbahr/PyCrypto-Wheels/raw/master/pycrypto-2.6.1-cp35-none-win32.whl pycrypto

Python 3.5 64bit:

pip install --use-wheel --no-index --find-links=https://github.com/sfbahr/PyCrypto-Wheels/raw/master/pycrypto-2.6.1-cp35-none-win_amd64.whl pycrypto

PYTHON 2
Python 2.7 32bit:

pip install --use-wheel --no-index --find-links=https://bitbucket.org/alexandrul/wheels/downloads/pycrypto-2.6.1-cp27-none-win32.whl pycrypto

Python 2.7 64bit:

pip install --use-wheel --no-index --find-links=https://bitbucket.org/alexandrul/wheels/downloads/pycrypto-2.6.1-cp27-none-win_amd64.whl pycrypto

If you have any older python 2/3 version then maybe just consider upgrading to the current version of python 2/3.

This will automatically install pycrypto for your python version, just let it finish up.

Getting devkitARM
Download the devkitpro updater from here and start it up, it will give you quite a few options on things to install, all you need to select is "Minimal System" and "devkitARM", you can uncheck everything else. Now just let it download and install everything.

Getting armips
For armips you can just download my pre-compiled exe and put it into "C:\devkitPro\msys\bin" so it can be directly used on compilation.

Downloading and preparing iosuhax
Depending on what you want head over to my branch or dimoks branch, click on "Clone or download" and if you have git then clone it, if you dont have git just click "Download ZIP" and extract the contents of it into a new folder on your computer. Make sure that new full folder path does not contain any spaces, a wrong path would be "C:\my folder\iosuhax", a correct folder would be "C:\my_folder\iosuhax".

Now if you have "the 2 keys" already you can edit the getfwimg from the little guide below:

Spoiler

Go into the "bin" folder, right click on getfwimg and select "Edit with IDLE", put the 2 keys in like this:

wiiu_common_key = "D7000000000000000000000000000000"
starbuck_ancast_key = "B5000000000000000000000000000000"

Of course these are not the full keys but only their first 2 digits. Now just save it.

If you dont have "those 2 keys" you can easly get them from your wiiu itself like this without having to edit any scripts:

Spoiler

Go grab otp2sd and start it via the homebrew launcher, it will just restart you and place a otp.bin on your wiiu sd card. Copy that otp.bin one folder above the iosuhax one so in our example let iosuhax be in "C:\my_folder\iosuhax", so you copy otp.bin into "C:\my_folder", iosuhax will find that otp.bin and use it automatically, you dont need to edit any scripts this way.

Now that you finally prepared iosuhax its time to compile it! Shift-right click in the iosuhax main folder, click on "Open command window here" and just type in "make" and press enter, this will get you a fw.img as output which you can put on you sd card root and use in cfw booter! If it failed to compile because of commands being unknown you may have to reboot your computer to make sure it properly installed all of the software.

I hope with this you were able to successfully compile iosuhax, now have fun with it

Note by Cyan:
Dimok branch can now build both CFW with and without NAND redirection to SD card, while Fix94 branch only compile a SysNAND CFW.

Fix94 branch : sysNAND. doesn't have latest cfw patches, but fix94 version contain new wupserver command instead.
Dimok branch : sysNAND and redNAND. This branch has currently more features than fix94 branch (allows HBL channel version installation, unrestricted NAND FTP access, NAND to SD dump, FAT32 USB mount support, etc.)

When you are at the compiling step,
fix94 sysNAND, type : make
dimok sysNAND, type : make cfw
dimok redNAND, type : make redNAND
by default, typing only "make" on dimok branch, it will build redNAND

 

[x65943]

Yes, I chose that when I installed, *sigh* this is aggravating Could it be because it's the 64-bit version and not the 32-bit version? I installed 3.5, not 3.5.1, 3.5.2, just 3.5 64-bit.... Maybe I really wasn't meant to do this.... I should probably uninstall it, reinstall it and start over -_- Ugh.

Make sure you're typing only "make" in command prompt, and you're in the same folder as the makefile.

 

[the_randomizer]

Make sure you're typing only "make" in command prompt, and you're in the same folder as the makefile.

What make file? I downloaded the getfwimg.py, where is it supposed to go? Where in the DevkitPro folder?

The guide didn't say where the makefile is though.

 

[x65943]

What make file? I downloaded the getfwimg.py, where is it supposed to go? Where in the DevkitPro folder?

Sorry, got confused.

Type "python getfwimg.py"

in a command prompt that you opened in the respective folder.

I was jumping to the last step.

 

[the_randomizer]

Sorry, got confused.

Type "python getfwimg.py"

in a command prompt that you opened in the respective folder.

I was jumping to the last step.

I have everything installed, the fact it just said "make" was confusing, but that was my fault, I'll try it when I get back later.

 

[BigPanda]

You should always use Python 2.7.x (32-bits)

 

[Supster131]

You should always use Python 2.7.x (32-bits)

The guide recommends python 3.5, and it does work with python 3.5.

 

[BigPanda]

Regardless, Python 2.x all the way.

Fanboy speaking !

 

[the_randomizer]

Sorry, got confused.

Type "python getfwimg.py"

in a command prompt that you opened in the respective folder.

I was jumping to the last step.

Tried python getfwimg.py

Got this stupid error, I installed Crypto though....

Traceback (most recent call last):
File "getfwimg.py", line 12, in <modul
from Crypto.Cipher import AES
ImportError: No module named 'Crypto'

This is really starting to gnaw at me >.>

What folder does this have to be in? That part was never explained. The what and where I place the script is not clear, as I don't know where this makefile is.

 

[Supster131]

Tried python getfwimg.py

Got this stupid error, I installed Crypto though....

Traceback (most recent call last):
File "getfwimg.py", line 12, in <modul
from Crypto.Cipher import AES
ImportError: No module named 'Crypto'

This is really starting to gnaw at me >.>

What folder does this have to be in? That part was never explained.

Looks like you forgot to run this:

pip install --use-wheel --no-index --find-links=https://github.com/sfbahr/PyCrypto-Wheels/raw/master/pycrypto-2.6.1-cp35-none-win32.whl pycrypto

 

[the_randomizer]

Looks like you forgot to run this:

pip install --use-wheel --no-index --find-links=https://github.com/sfbahr/PyCrypto-Wheels/raw/master/pycrypto-2.6.1-cp35-none-win32.whl pycrypto

Ignoring indexes: https://pypi.python.org/simple
Requirement already satisfied (use --upgrade to upgrade): pycr
c\appdata\local\programs\python\python35\lib\site-packages

Already installed, still not working. The py file is by itself, I've been told it has to be in a folder where a makefile is, what makefile, where? That part needs explaining.

 

[x65943]

Tried python getfwimg.py

Got this stupid error, I installed Crypto though....

Traceback (most recent call last):
File "getfwimg.py", line 12, in <modul
from Crypto.Cipher import AES
ImportError: No module named 'Crypto'

You need to install pycrypto. Open up a command prompt and type "python -m pip install pycrypto"

 

[the_randomizer]

You need to install pycrypto. Open up a command prompt and type "python -m pip install pycrypto"

That would've been nice to know beforehand -_-

Still ain't working, same error as before, even after updating Crypto....this is really....ugh....


C:\iosuhax\bin>python getfwimg.py
Traceback (most recent call last):
File "getfwimg.py", line 12, in <module>
from Crypto.Cipher import AES
ImportError: No module named 'Crypto'

Very close to quitting altogether...I feel like I royally screwed something up:

I followed the guide, step by step, people keep alluding to the getfwimage.py to be in the same folder as some kind of makefile, but they don't tell me what makefile in what directory.

 

[Supster131]

Ignoring indexes: https://pypi.python.org/simple
Requirement already satisfied (use --upgrade to upgrade): pycr
c\appdata\local\programs\python\python35\lib\site-packages

Already installed, still not working. The py file is by itself, I've been told it has to be in a folder where a makefile is, what makefile, where? That part needs explaining.

Once you place all the keys in the file, just run make on the root of the folder.

Spoiler: big screenshot?

You will have less files because you haven't compiled it yet

 

[the_randomizer]

Once you place all the keys in the file, just run make on the root of the folder.

Spoiler: big screenshot?

You will have less files because you haven't compiled it yet

It's not working. At all. I tried doing this at the root, nothing is working for me, this is really starting to get at my nerves, I am on the very cusp of giving up on this altogether


Traceback (most recent call last):
File "getfwimg.py", line 12, in <module>
from Crypto.Cipher import AES
ImportError: No module named 'Crypto'
make: *** [bin/fw.img.full.bin] Error 1

 

[x65943]

That would've been nice to know beforehand -_-

Still ain't working, same error as before, even after updating Crypto....this is really....ugh....


C:\iosuhax\bin>python getfwimg.py
Traceback (most recent call last):
File "getfwimg.py", line 12, in <module>
from Crypto.Cipher import AES
ImportError: No module named 'Crypto'

Very close to quitting altogether...I feel like I royally screwed something up:

I followed the guide, step by step, people keep alluding to the getfwimage.py to be in the same folder as some kind of makefile, but they don't tell me what makefile in what directory.

The makefile is in the main directory iosuhax. Don't worry about it for now. Just get getfwimg.py running.

Can I have a screenshot of your command prompt? I find it weird you extracted iosuhax to your hdd's root.

 

[the_randomizer]

The makefile is in the main directory iosuhax. Don't worry about it for now. Just get getfwimg.py running.

Can I have a screenshot of your command prompt? I find it weird you extracted iosuhax to your hdd's root.

Yes, but doesn't the getfwimg.py have to be in the bin folder? Anyways, Why do you need a screenshot? I copied and pasted exactly what the CMD posted after I tried the command.



That's just it, I can't get the thing to run at all. I've followed everything, installed Python and Crypto.

 

[FIX94]

do you have multiple versions of python installed or something? you just need to go to the python website and click download python 3.5.2 and thats it, it'll get you the current 3.5.2 32bit version which is all will need, just dont ever go for 64bit versions, it gives far too much trouble anyways.

 

[the_randomizer]

do you have multiple versions of python installed or something? you just need to go to the python website and click get python 3.5 and thats it, it'll get you the current 3.5.2 32bit version which is all will need, just dont ever go for 64bit versions, it gives far too much trouble anyways.

Son of a... maybe that's why....I installed the 64-bit version....ugh....... I always assumed to get the 64-bit version because I have a 64-bit OS

Guess I have to uninstall it now.


Edit: Figured out what was wrong, I think. Sorry about that man.


Edit 2: Python reinstalled, Crypto installed without issue either

I was off by one character, it works now

 

[barak06]

Last questions @FIX94
- is the fw.img needs to be patched to be used in wiiU ? Because i found lot og .img on forums : fw_dumper, iosuhaxsigpatched, NANDDUMPER... with not the same size as my fw.img nor the same crc32 sig
- what's fw.img.full for ?
THX

 

[Cava]

@FIX94 @dimok I can't compile dimok's new repo just yours. The old one worked. Can u please help in this?