Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Answering all questions about r21freak and r21/ITG.
Feel free to ask questions/add information.

Moderator: Admins

Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby mute on Thu Nov 17, 2011 2:01 am

This guide is to [hopefully] help anyone who's unclear about the process of adding custom songs and themes to an ITG dedicab. "Hacking" might sound like something that requires highly specific knowledge and lots of time and effort, but in regards to adding custom content to an ITG machine it certainly isn't. The hacking process involves starting up the ITG machine with a special version of Linux from a USB drive, which acts as the vehicle for you to access the machine's hard drive and add the custom content. From there, all you're really doing is copying/pasting the data folders from Stepmania to the ITG machine's hard drive and then ensuring that the game recognizes that extra content. This entire process shouldn't take more than 30 minutes or so, and subsequent "hacks" to add/change custom content should only take 10-15 minutes.


<<< What You Will Need >>>

• USB keyboard
• (2) USB drives
• SLAX Linux 6.1.2 *
• Universal USB Installer 1.8.6.9 *
• StepMania 3.95

* - current versions as of when this guide was posted


<<< Step 1 - Preparing Linux >>>

• Download SLAX
Download Universal USB Installer
• Install SLAX onto your first USB drive using the Universal USB Installer program. (It's pretty self-explanatory and hard to mess up. Honest.)


<<< Step 2 - Preparing Simfiles >>>

• Simfile audio must be in .ogg format with a frequency of 48khz.
• Simfile graphics must be in .png format.
• With all simile content properly formatted, cache your custom song content with StepMania 3.95. (StepMania caches all content each time it boots.)
• Copy your StepMania's "Cache" and "Songs" folders (and "Courses", if you're adding any) to your second USB drive, putting them into another folder named "custom".


<<< Step 3 - Booting Linux on the Machine >>>

3a) Does your machine show a "Roxor" screen when it is booting? Follow these steps:

• Plug your first USB flash drive into the machine's P1 memory card slot.
• Plug your USB keyboard into the machine's P2 memory card slot.
• Remove the security dongle from the machine's CPU, wait 30 seconds, plug the dongle back in. DO NOT REMOVE THE SECURITY DONGLE'S BATTERY.
• Turn the machine on.
• Enter the Boot Menu by hitting F11 at the "Roxor" screen. (Note: Timing this can be tricky. It may help to just keep rapidly hitting the F11 key as soon as you turn the machine on.)
• Select your USB flash drive from the list of mounted drives. SLAX will boot.

3b) Does your machine not show a "Roxor" screen when it is booting? Follow these steps:

• Plug your first USB flash drive into the machine's P1 memory card slot.
• Plug your USB keyboard into the machine's P2 memory card slot.
• Turn the machine on.
• At the BIOS loading screen (the one with the Energy Star logo), hit the Delete key. This takes you into the BIOS settings.
• Go down to the second menu option, enter it, and change the first boot priority to "USB-HDD." Hit F10 to save and exit; the machine will reboot with SLAX. NOTE: When you reboot the machine after adding custom content, re-enter this menu and change the first boot priority back to "Hard Drive."


<<< Step 4 - Adding Your Custom Songs >>>

• Once SLAX has booted, navigate to your machine's hda3 partition. Open up the Static.ini file you find there. (If there is none, just create a blank text document named "Static.ini".) Add the following text to the file:

Code: Select all
[Options]
AdditionalFolders=/itgdata/custom/


• Save and close the Static.ini file.
• Plug your second USB drive into one of the USB slots on the back of the machine's computer.
• Navigate to your machine's hda5 partition. In here, copy your entire "custom" folder that contains your Songs and Cache folders. (This process may take a while, depending on how much stuff you're adding!)
• If installing a custom theme, proceed to Step 5. If not, reboot the machine. One way you can do this is by opening up the Terminal in SLAX, entering the command "reboot", then hitting Enter. Once the machine has rebooted past the Roxor screen, it is safe to remove your USB drive(s).
• That's it! Your custom songs should all show up on the song select wheel.


<<< Step 5 - Adding A Custom Theme >>>

• In hda5/custom, create a folder called "Themes".
• Copy your custom theme folder to hda5/custom/Themes.
• Ensure that your custom theme's metrics.ini file says the following:

Code: Select all
[Global]
FallbackTheme=fallback

[Preferences-arcade]
Theme=arcade-custom


• In hda5/custom/Themes, create another folder called "arcade-custom".
• Create a blank text document there and name it "metrics.ini".
• Add the following text to the metrics.ini file (and change "THEME NAME" to the folder name of your theme, obviously):

Code: Select all
[Global]
FallbackTheme=THEME NAME

[Common]
InitialScreen=@GetArcadeStartScreen()


• Save and close the metrics.ini file.
• Navigate to your machine's hda3 partition. Open up the Static.ini file you find there. Add the following text:

Code: Select all
[Dance]
Theme=arcade-custom


• Save and close the Static.ini file.
• Reboot the machine as described in Step 4. ITG should start up with your new theme!


<<< Credits >>>

This guide is based on the original ITG2AC hacking tutorial from boxorroxors.net, so credit is due to CMCM and whoever else originally compiled that. Special thanks to Ryan (Rynker) and Brandon (Cosmic Pope) for the vast amount of help they gave me in solving problems along the way.
User avatar
mute
100%
100%
Former Staff
Former Staff
((( dx_xb )))
((( dx_xb )))
Comp V - 3rd
Comp V - 3rd
 
Posts: 2216
Joined: Mon Jun 11, 2007 2:07 am

Re: Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby SM MaxX on Thu Nov 17, 2011 2:21 am

Much apprieciated.
Does it matter if it's 3.95 or oITG you use to cache? I would imagine not, but just being sure.
Yoshi is better than Mario and you know it's true.
Image
Image
It's gonna suck. -Nobody
User avatar
SM MaxX
100%
100%
 
Posts: 2705
Joined: Fri Mar 25, 2011 12:03 am
Location: Phoenix, AZ

Re: Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby mute on Thu Nov 17, 2011 2:36 am

SM MaxX wrote:Much apprieciated.
Does it matter if it's 3.95 or oITG you use to cache? I would imagine not, but just being sure.

I've never used oITG, so I couldn't tell you.
User avatar
mute
100%
100%
Former Staff
Former Staff
((( dx_xb )))
((( dx_xb )))
Comp V - 3rd
Comp V - 3rd
 
Posts: 2216
Joined: Mon Jun 11, 2007 2:07 am

Re: Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby TEEX on Thu Nov 17, 2011 5:17 am

This is awesome, thanks a lot, Dave!
User avatar
TEEX
102%
102%
 
Posts: 4008
Joined: Mon Jul 09, 2007 5:57 pm

Re: Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby Xynn on Thu Nov 17, 2011 6:17 pm

Sweet. By any chance would you know how to add custom marathons?

Image


TEEX wrote:Bzzt, wrong opinion! That album was bad.
User avatar
Xynn
102%
102%
 
Posts: 5667
Joined: Thu Jun 26, 2008 2:20 pm

Re: Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby TYLR on Thu Nov 17, 2011 6:18 pm

mute wrote:
SM MaxX wrote:Much apprieciated.
Does it matter if it's 3.95 or oITG you use to cache? I would imagine not, but just being sure.

I've never used oITG, so I couldn't tell you.


I use oITG, so apparently not.
User avatar
TYLR
90%
90%
 
Posts: 1603
Joined: Mon May 12, 2008 4:42 pm
Location: GVCCI HVCCI FVCKING GL△M

Re: Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby mute on Thu Nov 17, 2011 6:53 pm

Xynn wrote:Sweet. By any chance would you know how to add custom marathons?

mute wrote:<<< Step 2 - Preparing Simfiles >>>

• Simfile audio must be in .ogg format with a frequency of 48khz.
• Simfile graphics must be in .png format.
• With all simile content properly formatted, cache your custom song content with StepMania 3.95. (StepMania caches all content each time it boots.)
• Copy your StepMania's "Cache" and "Songs" folders (and "Courses", if you're adding any) to your second USB drive, putting them into another folder named "custom".
User avatar
mute
100%
100%
Former Staff
Former Staff
((( dx_xb )))
((( dx_xb )))
Comp V - 3rd
Comp V - 3rd
 
Posts: 2216
Joined: Mon Jun 11, 2007 2:07 am

Re: Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby SM MaxX on Thu Nov 17, 2011 7:42 pm

hehe owned.
Also on the Get Slax screen, is it the .iso or the .tar file I'm supposed to install (I'm guessing the usb one?)
Yoshi is better than Mario and you know it's true.
Image
Image
It's gonna suck. -Nobody
User avatar
SM MaxX
100%
100%
 
Posts: 2705
Joined: Fri Mar 25, 2011 12:03 am
Location: Phoenix, AZ

Re: Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby Wastum on Thu Nov 17, 2011 8:10 pm

Sweet guide mute, thanks for posting. I highly appreciate this!
FURR wrote:i tried to change to ogg but the song was without a stepchart
User avatar
Wastum
60%
60%
 
Posts: 795
Joined: Sat Jul 12, 2008 7:42 pm
Location: The Netherlands

Re: Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby Xynn on Fri Nov 18, 2011 12:53 am

mute wrote:
Xynn wrote:Sweet. By any chance would you know how to add custom marathons?

mute wrote:<<< Step 2 - Preparing Simfiles >>>

• Simfile audio must be in .ogg format with a frequency of 48khz.
• Simfile graphics must be in .png format.
• With all simile content properly formatted, cache your custom song content with StepMania 3.95. (StepMania caches all content each time it boots.)
• Copy your StepMania's "Cache" and "Songs" folders (and "Courses", if you're adding any) to your second USB drive, putting them into another folder named "custom".


Ha, my bad. I actually didn't read through the guide yet, but based on the thread titled I made the assumption that courses weren't included in this tutorial. :P

Image


TEEX wrote:Bzzt, wrong opinion! That album was bad.
User avatar
Xynn
102%
102%
 
Posts: 5667
Joined: Thu Jun 26, 2008 2:20 pm

Re: Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby mute on Fri Nov 18, 2011 1:53 am

Xynn wrote:Ha, my bad. I actually didn't read through the guide yet, but based on the thread titled I made the assumption that courses weren't included in this tutorial. :P

Yeah, luckily they function just like the songs in that they just need to be cached. Then "Courses" is just a fourth subfolder in "custom," along with "Cache," "Songs" and "Themes." You can of course have "Noteskins" in "custom" too if you're adding those, but those don't need to be cached, only referred to properly in the custom theme's metrics.ini and English.ini.


SM MaxX wrote:hehe owned.
Also on the Get Slax screen, is it the .iso or the .tar file I'm supposed to install (I'm guessing the usb one?)

Yep, get the USB one which is the .tar. The .iso is for burning a bootable CD for a personal computer containing an optical drive.
User avatar
mute
100%
100%
Former Staff
Former Staff
((( dx_xb )))
((( dx_xb )))
Comp V - 3rd
Comp V - 3rd
 
Posts: 2216
Joined: Mon Jun 11, 2007 2:07 am

Re: Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby Xynn on Fri Nov 18, 2011 8:45 am

mute wrote:
Xynn wrote:Ha, my bad. I actually didn't read through the guide yet, but based on the thread titled I made the assumption that courses weren't included in this tutorial. :P

Yeah, luckily they function just like the songs in that they just need to be cached. Then "Courses" is just a fourth subfolder in "custom," along with "Cache," "Songs" and "Themes." You can of course have "Noteskins" in "custom" too if you're adding those, but those don't need to be cached, only referred to properly in the custom theme's metrics.ini and English.ini.


Not gonna lie, that's a lot simpler than I assumed it would be, haha.

Image


TEEX wrote:Bzzt, wrong opinion! That album was bad.
User avatar
Xynn
102%
102%
 
Posts: 5667
Joined: Thu Jun 26, 2008 2:20 pm

Re: Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby SM MaxX on Fri Nov 18, 2011 8:06 pm

mute wrote:
SM MaxX wrote:hehe owned.
Also on the Get Slax screen, is it the .iso or the .tar file I'm supposed to install (I'm guessing the usb one?)

Yep, get the USB one which is the .tar. The .iso is for burning a bootable CD for a personal computer containing an optical drive.


okay, but when I use the Universal USB Installer, it asks for the SLAX 6.1.2.iso., yet I'm supposed to use the .tar file?
Yoshi is better than Mario and you know it's true.
Image
Image
It's gonna suck. -Nobody
User avatar
SM MaxX
100%
100%
 
Posts: 2705
Joined: Fri Mar 25, 2011 12:03 am
Location: Phoenix, AZ

Re: Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby mute on Fri Nov 18, 2011 11:08 pm

SM MaxX wrote:
mute wrote:
SM MaxX wrote:hehe owned.
Also on the Get Slax screen, is it the .iso or the .tar file I'm supposed to install (I'm guessing the usb one?)

Yep, get the USB one which is the .tar. The .iso is for burning a bootable CD for a personal computer containing an optical drive.


okay, but when I use the Universal USB Installer, it asks for the SLAX 6.1.2.iso., yet I'm supposed to use the .tar file?

Alright, just download the ISO then. I think the .tar is the same thing, just compressed. I don't remember. I was forever ago that I made my SLAX USB drive.
User avatar
mute
100%
100%
Former Staff
Former Staff
((( dx_xb )))
((( dx_xb )))
Comp V - 3rd
Comp V - 3rd
 
Posts: 2216
Joined: Mon Jun 11, 2007 2:07 am

Mute's ITG Hacking Guide ~ Adding Custom Songs & Themes

Postby SM MaxX on Sat Nov 26, 2011 12:35 am

Alright, I got it installed.
But I got another problem; whenever I plug everything in, it asks for a password. It shows the energy star logo though.
1. What am I doing wrong?
2. Where is the security dongle located just in case i misread something?
3. Is the password something obvious?
Yoshi is better than Mario and you know it's true.
Image
Image
It's gonna suck. -Nobody
User avatar
SM MaxX
100%
100%
 
Posts: 2705
Joined: Fri Mar 25, 2011 12:03 am
Location: Phoenix, AZ

Next

Return to FAQ and Guides

Who is online

Users browsing this forum: No registered users and 1 guest