Tutorial: Compile Payloads for the TI-84+ Calculator
*Linux (either Virtual Machine or actual PC with Linux as the OS)
*Windows XP, Vista, or 7 (either Virtual Machine or actual PC with Windows as the OS)
*To8xv with Windows Scripts
This tutorial will cover how to compile the KaKaRoTo, Vidarino, EvilSperm, and Hermes payloads. The PL3 payloads (KaKaRoTo, Vidarino, and EvilSperm) are very similar to compile. All you have to do is change the syntax of your commands. The Hermes payload is a little different, but just as easy. I have included Linux scripts and Windows XP/Vista/7 scripts that help to automate compiling the payloads. This will help to reduce errors when you try it yourself.
NOTE: As of right now, you need both Linux and Windows to compile properly. If I figure out a way to compile the payloads completely in one OS, the scripts will be changed.
Step 1- Setting up the Linux and Windows Environments
Step 1b-Decide which Operating Systems you are going to use. I personally use EvilSperm's VM image for Linux compiling and Windows 7 x64 for Windows compiling.
For your Linux OS, you need to use these files:
If you are going to use Windows Vista or 7, you need to use these files:
To8xv with Windows Vista and 7 Scripts.zip
If you are going to use Windows XP, you need to use these files:
To8xvXP with Windows XP Scripts.zip
Step 1c-Extract the .zip files and place them where they need to be. First, extract the "Padding Tools" .zip to your Windows XP/Vista/7 desktop. Inside of the newly extracted "Padding Tools" folder, you will find "msdos.exe" and "resize.com".
If you're using Windows Vista/7-
Copy "msdos.exe" and "resize.com" to C:\Windows\System32
If you're using Windows XP-
Copy "resize.com" to "C:\Windows\System32" Do NOT use "msdos.exe"
Step 1d-Download the appropriate files for your Windows Operating Systems. For Windows 7, it will be "To8xv with Windows Vista and 7 Scripts.zip". For Windows XP, it will be "To8xv with Windows XP Scripts.zip"
If you're using Windows Vista/7-
Extract the contents of "To8xv with Windows Vista and 7 Scripts.zip" to your desktop. You will have a folder called "to8xv". Inside of that folder will be the Windows scripts needed to compile for Windows Vista/7.
When you are done, your Windows Vista/7 desktop should look similar to this:
If you're using Windows XP-
Extract the contents of "To8xvXP with Windows XP Scripts.zip" to your desktop. You will have a folder called "to8xvXP". Inside of that folder will be the Windows scripts needed to compile for Windows XP.
When you are done, your Windows XP desktop should look similar to this:
Now that your Windows environment is set up, we need to move on to your Linux OS. Regardless if you are using a Virtual Machine (as I am) or using Linux on another computer or dual-boot setup, the steps will be the same.
For your Linux OS-
Extract the contents of "Linux Scripts.zip" to your desktop. Once extracted, you will have 4 shell scripts on your desktop that will aid us in the Linux portion of this tutorial. These scripts basically download the latest version of each payload and compile them. It will then neatly place the .bin files in folders that are needed for the Windows portion of this tutorial.
When you are done, your Linux desktop should look similar to this:
Step 2- Configuring the Linux scripts for Automation
Congratulations! You've made it this far, which means you have been following directions. The next step in the process is to make the Linux shell scripts automatically run. Yo do this, we need to change some file permissions.
On your Linux OS, open up a terminal windows. If you don't know how to do this, do a little Googling. In this window, type:
xxxxxx is the name of the shell script you want to use. The command for each payload would be:Code:cd Desktop sudo chmod 777 xxxxxx.sh
Vidarino PL3-Code:sudo chmod 777 kakaroto_PL3.sh
EvilSperm PL3-Code:sudo chmod 777 vidarino_PL3.sh
Hermes-Code:sudo chmod 777 evilsperm_PL3.sh
Remember, Linux is CASE-SENSITIVE!!! After changing your file permissions, your screen should look something like this:Code:sudo chmod 777 hermes.sh
Step 3- Compiling the .bin Files Needed for Later
Now that we have completely set up our environment, let's get down to the fun stuff... compiling!
Now that we are ready to compile, we have to open up a terminal window again. Then, we need to run our newly permisison-changed shell scripts. The correct syntax for this is:
xxxxxx is the name of the shell script you want to use. The command for each payload would be:Code:cd Desktop ./xxxxxx.sh
This will compile the needed .bin files needed to compile with the To8xv program. When compiling, you will get a bunch of text scrolling through the terminal window. You will see something like this on your screen:Code:./hermes.sh
The payload folders are pretty self-explanatory. The payloads are as follows:
NOTE: When compiling the Hermes payloads, you will encounter errors. This is perfectly normal. As long as you get the port1_config_descriptor.bin, you'll be okay. These errors will look like this:Code:KaKaRoTo- Kakaroto_PL3_Payloads Vidarino- Vidarino_PL3_Payloads EvilSperm- EvilSperm_PL3_Payloads Hermes- Hermes_Payloads
Step 4- Copying the Payload Folder of Your Choice to Windows
We're all done with Linux for now! All we have to do is get the folders with the payloads back to Windows.
Copy the desired payload folder to your flash drive.
After that, copy the desired payload folder to your Windows Desktop. It should look something like this when done:
Step 5- Running the Compile Scripts
We're almost done. Just a couple of clicks away! Now that we've copied the payload folder of our choice to our desktop, open the "to8xv" folder if you're on Windows Vista/7, or the "to8xvXP" folder if you're on Windows XP.
From there, double click the batch file for the payload you want to compile. A list of payload batch scripts are as follows:
If you're using Windows Vista/7:
If you're on Windows XP:
The batch files will look something like this:
Once the .bat file of your choice has completed, you'll notice all of the .bin files are gone and are now replaced with .8xv payloads, fully compatible with your TI-84+ calculator! Check the original payload folder to find them. Just load the payload of your choice onto your calculator and Jailbreak away!
How to Update Your Payloads
I hope you enjoyed reading this long tutorial. Maybe it will help people to understand what has to be done just so you can "download a file and use it". This should also help people who want to be early adopters, but can't be because I'm at work.Now that you have figured out how to do what I do, all you have to do to get the newest payloads is as follows:
On your Windows Machine:
Delete any payload folders such as:
On your Linux machine:Code:Kakaroto_PL3_Payloads Vidarino_PL3_Payloads EvilSperm_PL3_Payloads Hermes_Payloads
Then, all you have to do is repeat Steps 3 - 5 in this tutorial. When you get used to compiling using my scripts, it will take less than 5 minutes to have ALL the newest payloads.Code:NOTHING! The scripts will delete any unnecessary folders/files.
If you have any questions, please post them here.
Thanks to CuriousG for testing these scripts for me.