Tutorial  Updated

Building iosuhax on windows

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):
PYTHON 3
Python 3.5 32bit:
Code:
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:
Code:
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:
Code:
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:
Code:
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:
Go into the "bin" folder, right click on getfwimg and select "Edit with IDLE", put the 2 keys in like this:
Code:
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:
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
 
Last edited by Cyan, , Reason: Added new compile steps and differences between Fix94 and Dimok branches.

Tarantus

Well-Known Member
Member
Joined
Mar 11, 2015
Messages
105
Trophies
0
Age
37
Location
-24.100361, -45.689251
Website
ow.ly
XP
137
Country
Brazil
how could you possibly get a bad compiled fw.img

Couldn't figure it out either... or you DO compile it or not. If any error comes from a comp, simply it wont finish. The only thing that came to my mind was the possible existence of a "malicious code" inside the source before compiling it, but since we are working with our "good guys devs" sources, we don't need to fear anything.

I was just "intrigued" with this guys posts from another forum:
upload_2016-11-19_3-21-0.png
 

retrofan_k

Well-Known Member
Member
Joined
May 31, 2013
Messages
2,077
Trophies
2
Location
Caves
XP
2,462
Country
Belarus
That is old (Vwii) and not compiled with Dimoks latest commit, which now allows unrestricted FTP access, etc. The MD5 matches on that fw.img from that iso site, which is produced from Dimoks latest update.

md5: 1939BA4F75856E3DCE68718FEA379F59
 

Cyan

GBATemp's lurking knight
Former Staff
Joined
Oct 27, 2002
Messages
23,749
Trophies
4
Age
45
Location
Engine room, learning
XP
15,649
Country
France
the first post is not reflecting the new update yet, but there are two different "sysNAND" cfw now.

Fix94 branch : sysNAND. doesn't have latest cfw patches, but fix94 worked on wupserver instead (adding new commands)
Dimok branch : sysNAND and redNAND. has currently more features than fix94 branch (allows HBC channel install, unrestricted ftp, NAND to SD dump, 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") it will build redNAND
 

George35000vr

hippity hoppity get off my property
Member
Joined
Jun 22, 2013
Messages
252
Trophies
1
Age
24
Location
Chania, Crete
XP
1,232
Country
Greece
RL63fvo.png

I made a splash screen with the wii u styled font,background which also shows the "version" of the CFW. In order to have the splash screen feature you have to use Dimok's CFW.
Note: In case you edit it make sure its flipped vertically (check my splash_image.tga) also keep in mind that it would show a part of the image(the white/invisible part on my psd is the one that it doesnt display on the gamepad's screen). Lastly, you have to export it as 16bit uncompressed tga file.
TGA File,PSD File
 
Last edited by George35000vr,

Rubberduckycooly

Well-Known Member
Newcomer
Joined
Nov 21, 2016
Messages
63
Trophies
0
XP
130
Country
United States
i am getting this error "
C:\IOSUHAX_Folder\iosuhax>make
make[1]: Entering directory `/c/IOSUHAX_Folder/iosuhax'
make[2]: Entering directory `/c/IOSUHAX_Folder/iosuhax/wupserver'
Makefile:2: *** "Please set DEVKITARM in your environment. export DEVKITARM=<path to>devkitARM". Stop.
make[2]: Leaving directory `/c/IOSUHAX_Folder/iosuhax/wupserver'
make[1]: *** [wupserver/wupserver.bin] Error 2
make[1]: Leaving directory `/c/IOSUHAX_Folder/iosuhax'
make: *** [redNAND] Error 2"

and i dont understand what it means can some one help me?
 
Last edited by Rubberduckycooly,

jorgehntx

Active Member
Newcomer
Joined
Nov 20, 2016
Messages
28
Trophies
0
Age
43
XP
56
Country
United States
I have a question...i use make command for compile fw.img and everything is ok...(i use this for my rednand) and my question is...what i have to do if i want to make iosuhax fw.img?..tanx for u help guys
 

George35000vr

hippity hoppity get off my property
Member
Joined
Jun 22, 2013
Messages
252
Trophies
1
Age
24
Location
Chania, Crete
XP
1,232
Country
Greece
I have a question...i use make command for compile fw.img and everything is ok...(i use this for my rednand) and my question is...what i have to do if i want to make iosuhax fw.img?..tanx for u help guys
If you mean a SysNand version of it you can just type "make cfw". AFAIK this applies on the Dimok's version only.
 

Site & Scene News

Popular threads in this forum

General chit-chat
Help Users
    K3Nv2 @ K3Nv2: I like to interact with my smut ok