Here's a list of notes-to-myself about hacking the iPod Touch. I'm posting it here in the hope that it may be useful to other owners, who are happy with their new toys but can't help thinking that there might be more fun to be had.
Perhaps you bought the 16-gigabyte model, which now costs exactly what the 8-gig iPhone does, and you're wondering why it didn't come with e-mail, or an RSS reader, or an IRC client, and why you can't just go ahead and add one. Maybe you'd like to read Cory Doctorow's books on it. Or maybe you agree with the Owner's Manifesto and would like to crack into the thing a little bit and see what's inside. Remember, if you can't open it, you don't own it.
This list is not guaranteed to be definitive, all encompassing, or kept up-to-date. Comments are open, however, and I do hope for help from fellow travelers.
Oh, and: yeah. I know. It's an "iPod Touch," not an iTouch. Sorry if that makes you crazy; I'm not going to stop saying it.
Please seriously consider not doing this. It's painful.
If you are not a dedicated hobbyist, hacker, or both, and all you want is the iPhone application bundle--including Mail, Maps, Weather, Stocks, and Notes--update to 1.1.3, visit iTunes, and pay for it. It's supported by Apple, works on all the mail providers (not just Gmail, which now has IMAP support), and the Maps application has been upgraded to do some really neat stuff with IP location.
If you absolutely must do this, kindly heed the following warnings:
To install third-party applications, you'll need to jailbreak your iTouch. When we're done, you'll have a new application, Installer, which will allow you to download and install other programs.
If you just got your iPod out of the box, please go through the steps to download iTunes to your computer and synch it for the first time.
Important: if iTunes offers to install new software on your iPod when you first set it up, say No.
Also take a moment to familiarize yourself with a few important features, namely the Home button, which is a white square inside a round button on the front of your iTouch, and the Sleep button, which is a thin raised line on the top edge of your iTouch, the opposite edge from where the docking cable and earphones plug in.
Make sure you can get to the Internet. Find the Settings function--the square icon with gears on it--touch WiFi, and then choose a network. If you can't get to a wireless network, you're not going to be able to get much further than this. Once it looks like you've joined a network, press your Home button to get out of Settings, and bring up Safari. If Safari will show you a Web site (any Web site) you are ready to move on.
Check your version. Press your Home button to get out of Safari, bring up Settings again, go to General, and then About. If your version starts with 1.1.1--mine says 1.1.1 (3A110a)--skip the next step. (If you got your iTouch for Christmas, you've probably got 1.1.2. If you got it after January 18th, you may have 1.1.3; please read the next paragraph carefully!)
If your version number says 1.1.3, you've either got a brand-new post-Macworld iTouch, or you've inadvertently upgraded since the push went out. If you're not already on firware version 1.1.3 and/or iTunes 7.6 or above, you're going to want to be very careful not to get the iTunes updates.
Before you begin, check your iTunes version. If it says 7.6, much of what we're going to try to do below won't work. Make sure all your music is safe in a different directory, uninstall iTunes, and download and install version 7.5, which you can get from filehippo.com.
Alert reader Nick says this works to get out of 1.1.3:
Warning: what we're about to do is absolutely guaranteed to wipe everthing on your iTouch. Please make sure that any music, video, photos, or other content is backed up before you continue!
http://appldnld.apple.com.edgesuite.net/content.info.apple.com/iPod/SBML/osx/bundles/061-3932.20070927.p23dD/iPod1,1_1.1.1_3A110a_Restore.ipsw
When your iTouch reboots, it should come up with version 1.1.1, ready for our next step, Jailbreak.
Next, we're going to break your iTouch out of jail. Left at factory settings, you won't be able to access your own file system, add programs, or do anything else our Cupertino overlords don't want you to do.
http://jailbreakme.com
If you like, you can stop right here. Many applications run on 1.1.1; feel free to jump right in with Installer and try out a few games. (Labyrinth is my personal favorite.)
You're not really done, because iTunes will bug you constantly about updating your iTouch, and if somebody inadvertently does this for you--say you sych to a different machine, for instance--all your hard work can be wiped in an instant.
Download and save this file. It's your 1.1.2 software, which you want to use instead of 1.1.3:
http://appldnld.apple.com.edgesuite.net/content.info.apple.com/iPod/SBML/osx/bundles/061-4036.20071107.9g3DF/iPod1,1_1.1.2_3B48b_Restore.ipsw
Jailbreaking 1.1.2 is not quite as easy as the 1.1.1 jailbreak, but it's close. Here we go:
http://conceitedsoftware.com/iphone/1.1.2-jailbreak.zip... to a folder on your desktop.
windows.bat; if you're using a Mac, double-click jailbreak.jar. If you already know what OpenSSH is, go ahead and tell it to install; it's handy later. (If you don't know what OpenSSH is, don't bother. You can get it later with Installer.)Sit back, relax, and watch your iTouch being jailbroken. When your main menu comes back, you should see your old friend Installer, plus your optional new friend OpenSSH, all jailbroken and ready to rumble.
If you're seeing mysterious "cannot connect to your device" errors, you may be missing an /opt directory that needs to be installed in your root. I found details on macrumors.com that seem like they may help. I'm not totally clear whether this is a Mac-only problem, or an Intel vs. non-Intel problem; if it happens on PCs as well, I'm not sure where that "root" directory is.
Before you do anything else, use Installer to load up the BSD Subsystem. Many third-party applications (including the one we're about to install) require it to work.
Do yourself a favor here: any time you're doing package installations on your iTouch, go to Settings, General, and then Auto-Lock, and tell it never to automatically lock. Some of the stuff you're going to download will take more than five minutes to download and install, and it's chancy, coming back from a lock.
Got Term-VT100? Excellent; bring it up and try this:
pwd
If all has gone well, you should see this:
/var/root
If you're getting a command not found error message, go back to Installer and try installing the BSD Subsystem again. It didn't take.
When all is well, let's make an important change so you won't run out of storage space when adding more third-party programs.
Again: this is optional but highly recommended for people who plan on installing more than a few tiny third-party applications.
Since the factory-set iTouch comes with an artificially small size limit on its /Applications directory, you may receive an error message--"Warning: You are running out of disk space. Please delete some photos or videos"--even though you're quite sure you've got lots of space left.
DANGER DANGER WILL ROBINSON: please do this next part slowly and carefully. Screw it up and you'll have to go back, restore version 1.1.1, and start all over again.
cd / cp -pr Applications /var/root mv Applications Applications.old ln -s private/var/root/Applications /ApplicationsIf you're seeing error messages like
command not found when you try cd /, you didn't install the BSD Subsystem. Please go back to Your First Installation and fix this.cd / ls -alSomewhere in the resulting list--you may need to scroll the screen up to see it; to do this, drag it gently upwards at one of its edges--you'll see something like this:
rwxr-xr-x 1 root admin 29 Dec 26 23:27 Applications -> private/var/root/ApplicationsIf it looks like
/Applications has been linked to private/var/root/Applications, you're done. If not, you'll want to keep trying that last ln command again until you get it./Applications directory, thusly:
cd / pwdIf the output from pwd doesn't look like this:
/, try the cd / command again. You need to be in your root directory for the next command to work. Once you're there, do this:
rm -rf Applications.old
Relax, the hairy part is over. From now on, everything we do will go through Installer. Let's have some fun monkeying with the interface next.
Using Installer, load up two new packages, Customize and SummerBoard. After you have them both, reboot your iTouch, by pressing and holding the Sleep button until the Power Off slider comes up. (If you get further into this process and Summerboard says it's "inactive" down at the bottom, you didn't reboot. Told you so.)
Summerboard will allow you to add desktop wallpapers, themes, hide labels, and other cool stuff; Customize will allow you to hide and change the images for your onscreen icons. I run both, personally; I like the green-grass Leopard background, no icon labels, and a dock containing anything that might have an alert on the icon with number of messages, etc. I also push as many of my customization options (like Term-VT100) off to the second page as possible, to discourage casual goofballs from messing around with my setup.
What? Mail? Yes. And Maps, too. And games ... sweet tasty games for everyone! Hold tight: it's finally time to add some Cool New Toys.
Lots of fun may be had with the Installer; it's getting fun-er by the day. My personal favorites include:
Especially when dealing with apps that were originalliy intended for the iPhone, install slowly and carefully. Always go back to the home screen, every time, and pay special attention to those "prep" packages.
If you skipped to here instead of reading the rest of the page, please go back to the top and read the warnings, and the strong advise that if all you want are these apps, go pay for them from Apple.
To run Mail, Weather, Stocks, Notes, and Maps on your iTouch, you will need to download and install some Apple property not specifically intended for the iTouch. You will need to lie, cheat, and steal even more than you already have to do this; if you believe in karma, be very, very careful here.
Maps and Mail are hairy; you'll want to follow the instructions about installing the "prep" software first. Notes, Stocks, and Weather jump right up and run; Notes is really cool, especially when integrated with Mail.
Google Maps on the iTouch may be the single most useful thing I've ever held in one hand. It's what's got me seriously considering an iPhone ... but that's just not gonna happen until I can run the provider of my choice.
http://applerepo.com/ to your list of sources. (Sources, Edit, Add) If you have the old repo.us.to repository, your iPhone apps won't show on the list of packages any more.As far as I can tell, Mail won't work with Yahoo! via an iPod Touch. I can't see myself giving access to my personal IMAP server to a hacked client, and I can't bring myself to start an AOL or .mac account, so ... it's GMail for me.
The next update from Apple is almost guaranteed to hose everything we've done here, and may even make it impossible to downgrade to 1.1.1.
In addition to following several really great tutorials for building Safari web apps that run on the iTouch, I've recently downloaded and installed Jiggy, a very impressive little integrated developer's environment and runtime. Jiggy actually allows you to do iTouch and iPhone development right there on your device. Inside is a tiny Web server; you bring it up, it tells you its IP address, you log in from a full-sized computer on the same wireless network, and program in JavaScript, inside a Web form. This is just plain spectacular work on the part of the Jiggy crew; you can (seriously) get an application working in minutes. More on this, as things develop.
modmyifone.com/installer.xml to your installer sources.Heinlein was right, as usual: supreme artistic appreciation may only be expressed by the phrase "Pay to the Order Of."
Third-party projects for the iTouch and iPhone are shoestring-budget affairs, done for the love of it. You can help increase the love many times, by donating to the project of your choice. (Hint: jailbreakme.com, Nullriver, and the iPhone Dev Team are really, really good choices.) $20 is a tiny amount compared to the $300 or $400 you paid for the thing, and doesn't even begin to compare to that one crucial opportunity you'll gain because you had an RSS reader, or maps, or e-mail. Your iTouch is a tool, not a toy, and these unsung heroes have set you free to swing that hammer as hard as you want. Donate!
And the worst thing about this is, that my iPod won't show up on my iTunes anymore, not even after I disconnect and reconnect, or even restart and then disconnect and reconnect. What should I do? I have the feeling now that the only possible solution to getting my iPod back so I can try this again (or not? :/) is to go to the Apple Store and see about getting a new iTouch. :(
I did mine really easy, it took me 5 minutes and it works perfect.
Just put ur iphone/itouch in recovery mode and put in in ur comp. Restore it and once its done close itunes.
Go to http://www.ziphone.org/ and download the program and run it. If u have an itouch, click jailbreak and let it do its job. if you have an iphone, press do it all and let it work. tada!
Any ideas?
For those package download errors: please check that your repositories are all correct, and that your queue has not gotten stuck on a broken download.
carroll
for my itouch, i updated my itouch yesterday to 1.1.4(4A102).
would i still be able to jailbreak it?
oh and p.s. kent applerepo.com seems to still work for me as a source and i managed to download mail and mapss etc. (which was strange due to the fact that they were insecure sources and i could install them unlike the other insecure sources!)
BTW NES roms can be added using WinSCP from theoldcomputer.com
Under the media folder I added a new folder ROMs and an NES folder inside the ROMs this is where I copied my ROM files to.
what should i do?
(i'm assuming that the problem is that a command prompt flashes for a second, then goes away)
It's simple, really.. all you have to do is open up winZip, and drag and drop Windows.Bat into a folder on your desktop. Not sure why this fixes it, but when i open it from the folder it's fine....
Anonymoose: I haven't tried it, but no, I don't think you can fool iTunes by changing the version number. Sorry!
I followed your steps, but my iPod seems to just be sitting there, doing nothing(in 1.1.2, without installer or anything). It has something to do with Windows.bat, because every time i double click on it(straight from win-zip) it flashes a command prompt for a split second then disappears. help, please.
So the purpose of this post is not to complain, I want to ask if there is a way to artificially change the version number so that it appears the version is up to date (so I can manually change the version number everytime the Apple overlords update). I don't think I am ever going to update to 1.1.3 because there was a huge change in the Library folder which removed a lot of the functionality (especially for some of the hacks I was developing). 1.1.2 will suffice, especially since there are 1.1.2 Google App hacks now... I could probably hack the version number myself, but I figured i would ask first. Thanks in advance =)
Thanks everyone again!
_henry
download independence and run the program and it will reboot it for you! here is the guide I found when i was poking around no need for finding another computer or creating another log in!
http://guides.macrumors.com/Jailbreaking_and_updating_to_1.1.3
I hope this helps! (oh i know that the guide is for iphones currently the only thing i did was used the independence program to reboot my ipod touch when it was sleeping [at least that is what i did i am going to go through the process again to see if it wasn't a fluke])
_henry
THANKS YOU GUYS SO MUCH!
_henry
"To restore your iPhone or iPod Touch, hold down the Power and Home buttons on the device until the Apple logo appears on the screen, at which point you can let go of the Power button-- but keep holding the Home button. When you see the Connect to iTunes logo appear, you may let go of the Home button, connect your device to your computer, and use iTunes to restore."
You need access to XP with iTunes 7.5.
You can't downgrade your OSX iTunes, so if your at 7.6 like I am, your stuck.
There also seems to be something wierd with the jailbreak 1.1.2 jar and XP vs Mac (Intel, I have a Mini CoreDuo). The jailbreak never reboots twice on the Mac USB/iTunes- however, on a windows XP with iTunes 7.5 it jailbreaks properly (i.e. reboots twice after flashing).
So this works.
On the mac, using iTunes 7.6 you can do these steps:
- restore to 1.1.1
- install jailbreak app on touch
- install octoprep
- update to 1.1.2
NOW SWITCH TO XP w/ iTunes 5.
- Connect touch and make sure iTunes see's it.
- Eject it from iTunes
- Quit iTunes
- Run jailbreak 1.1.2 jar
- watch as touch reboots twice (it will go it restore mode for a second, then reboot)
- start touch, you'll see the installer and SSH (if you choose to install it)
NOW YOU CAN SWITCH BACK TO OSX and iTunes 7.6. It will recognize the touch!!!
Then continue with the excellent instructions here, and have fun.
Thanks for these directions!
http://www.oldapps.com/download_iTunes_mac.php
So, I'm off to find a mac with an older version of iTunes to do the 1.1.2 jailbreak and see if that works.
However, the touch is fine. Just OPTION-CLICK RESTORE and it works fine.
When it comes time to put back 1.1.2, you can use the UPDATE button.
Makes sense, if you think about it.
Thanks for getting back to me so fast! I am going to download 7.4.2 and which is the only version closest to yours that I could find then if that doesn't work I will try 7.5 I will get back to you on the results.
Thanks again.
_henry
I tried following your guide and I have the same problem as Sandra and Russ, After I complete the whole process (after the jailbreak.jar) My ipod will enter recovery mode again.
I have Mac OSX 10.4.11 and Itunes 7.6. I used your links to get the firmware and jailbreak.
I am sure that itunes is closed after I option + update to 1.1.2
The jailbreak.jar runs throught the entire thing and says it will reboot several times but it does not I have waited once for 20 minutes and I have meticulously gone through the guide again and again and each time it has the same ending with the recovery screen on my ipod. I am really at a loss HELP!!
Thanks in advance
_henry
singleuser boot -- fsck not done
root device is mounted read-only
launch[12]: can't exec /bin/sh for single user: no such file or directory
Problem is it sticks there so I can't get it recognized in itunes to restart at 1.1.1
Any thoughts would be MOST appreciated!!!
And also, my bad if this post repeats, tried to post once but it seemed not to stick!
Please be absolutely sure you have 1.1.1, 1.1.2, and the 1.1.2 jailbreak from conceitedsoftware.com, and please do read through the comments that have already been left by your fellow explorers; this can be a long, tedious process.
Leoncito: no idea, sorry. I searched for ROMs before attempting to install the NES emulator, and was disappointed enough at the results not to even try.
JJ: updated, thanks. I'm going to start thinking about ways to re-organize this page; it's getting huge and unwieldy, and I'm starting to hear comments from people who are pretty clearly not reading all the instructions before beginning.
again
The point i made below was my bad.
it's fixed.-i was installin the iphone firmware not the ipod one soz.
But there is another problem its when i double-click the windows file and the screen comes up. i jailbreak but the it says 'cannot connect to your device'.
i no it says about that in ur guide but i dont understand that. and was wunderin if u cud help.
nb there is no root file in my c drive. Is that a problem ?
Hi,
I think ur guide is gr8.
i have followed ur steps exactly. But when i get to 'Get Version 1.1.2' i have problems i hav java for defo and downloaded the file to desktop. then i have installed oktprep successfully. I hold shift and click UPDATE (im on a pc(laptop) xp) the box appears and i choose the 1.1.2 file. It extracts but when it finishes it says unable to update Unknow error ocured (5). And then it puts my itouch into recovery mode wipping every thing off.
Plz help im stumpped.
thanks.
Sandra: if your iTouch is stuck in recovery mode--won't come up, even if you power it on and off multiple times--you are probably going to have to recover firmware. I'd try restoring to 1.1.2 first and running jailbreak.jar again; OktoPrep might still be back there ready to run. If it doesn't work, you're going to need to start over with 1.1.1. Sorry the news isn't better.
I am using a MacBook - "Recover" is "Restore" for some reason on a Mac. justa FYI
thank you for this wonderful resource you've put together! :)
Reinforcing what Nick said: you cannot jailbreak 1.1.3 yet! Don't upgrade; you'll need to slide back down to 1.1.1 and start over.
thanks!(or maybe i'll just wait till 1.1.3 jailbreak comes out!)
1: Connect your ipod, and bring up itunes. Turn off your ipod(red slider). Hold the home button and the sleep button for 10 seconds(together), then let go of the sleep button and continue holding the home button for 10 more seconds. You won't see anything on the screen(of ipod), but it'll be connected to the computer, and you can restore as usual(with the 1.1.1 firmware).
#2: http://www.tuaw.com/2008/01/16/downgrading-your-1-1-3-iphone-or-ipod-touch/
But i've given up until the 1.1.3 is jailbroken. Everyone else, DO NOT UPDATE TO 1.1.3! UNTIL THEY JAILBREAK IT THERE IS NO WAY TO DOWNGRADE OR JAILBREAK(so far)!
Cheers.
Will this step still work now that 1.1.3 is out? Havn't tried it yet since I am worried at what Apple threw into this firmware release.
I am sure there are a ton more sites that will show you how to navigate in a command prompt.
Evan - I ran into the same problem when I tried downloading the .ipsw using Safari. For some reason it cut off the extension and most of the end of the file name. Attempts to simply rename the file was unsuccessful. Try using Opera to download the .ipsw It worked for me...
Nick: to downgrade to 1.1.2 you'd want to grab the 1.1.2 firmware, save it to your desktop, and restore to it the same way you did it for 1.1.1. Given that I haven't tried this myself, I'm not at all sure this is the way to go; please do more research.
so how would i go about downgrading to 1.1.2?
cd "C:\Program Files\Java\jre1.6.0_03\bin"
kinda complicated for me... i mnot really that good with this sorta thing
From my limited understanding of the Stevenote, they will be selling the iPhone apps (mail, maps, notes, stocks, and weather) for an extra $20, which--if that's all you're hacking your iTouch to get at--is probably worth it.
If what you want is a wide-open iTouch, however ... you still need to jailbreak.
will i be able to use the layout of the new 1.1.3 update once i jailbreak my ipod? or is that not out yet...?
022-3642-8.dmg, and 022-3655-1.dmg. please pick the right one. thanks.
cd "C:\Program Files\Java\jre1.6.0_03\bin"
... and you should be there.
Evan, you want to chose the file you downloaded:
iPod1,1_1.1.1_3A110a_Restore.ipsw
java -jar jailbreak.jar
Spencer: nope, I haven't tried the NES emulator. (Given a reliable source of ROMs, I might.)
I'm retarded
I feel so dumb.
It turns out even though when i went to the java web site and it said that it was installed... it wasnt. So i installed and its working. Thanks for the help though. I really appreciate it. I'm really glad to get the full potential from my itouch. Thanks again.
If you see Java in Add or Remove Programs, you have a path problem. Try moving your 1.1.2 jailbreak files into the most recent directory (mine is C:\Program Files\Java\jre1.5.0_06\bin) that contains your copy of java.exe.
It reads:
'java' is not recognized as an internal or external command, operable program or batch file.
Basically when i do the windows.bat file its inserts the java/jar file directly after i press enter then gives me that error message
so if the guy or girl from Lifehacker has it that would be great!
thanks a ton again
In other interesting news, anyone with Windows and the .NET framework installed who wants a really easy way to encode video for the iPod Touch (yes, this works with .flv files!) should check out Noda's iPodME video converter. Docs are in french but the app is in English.
- Open a command window (Start, then Run..., and then enter CMD in the Open: box)
- Navigate to the folder where you saved all the 1.1.2 jailbreak files. (The command window ought to come up in your home directory, so you probably want to cd Desktop and then your jailbreak folder.)
- Enter this:
java -jar jailbreak.jar
When I do it, the jailbreak window pops up. You ought to see some sort of error if there's a problem.
ive got no clue as to whats goin wrong
thanks for the help btw
iTunesMobileDevice.dll
jailbreak.jar
QTMLClient.dll
readline5.dll
... are in the same directory as windows.bat. If you're missing iTunesMobileDevice.dll, poke around in your iTunes directory and copy it over.
http://conceitedsoftware.com/iphone/
Installer is cranky sometimes about adding sources; for best results, close Installer (hit Home) and restart your iTouch--sleep + home, slide to power off, wait, power back on--to see your changes.
I'd love to hear from anyone else who's had trouble finding OktoPrep once Installer is running; that would be Bad.
If you're on OSX and seeing mysterious "cannot connect to your device" errors, you may be missing an /opt directory that needs to be installed in your root. I found details on macrumors.com that seem like they may help.
Basically, to me the iPhone is a portable computer that can make calls. Not a cell phone with advanced capabilities.
"I'd rather have a device that works" sounds a bit specious to me. The device is fine; its manufacturer is refusing to ALLOW it to work the way I want it to. :)
I had the opportunity to own an iPhone but passed. Why? Because I hate telephones and all they represent--somebody ELSE can make this thing go off any time they want, and I feel duty-bound to respond--and did not want to fall in love with this horrible thing I've hated all my life. (I know, sounds inconsistent when you consider how close to synchronous communication they're getting with the iTouch ... but there it is.)
so, i ended up selling my ipod touch on ebay and just getting an iphone because i did not want to carry two devices. my iphone has yet to be jailbroken or hacked because i have all the apps that i really need on a day-to-day basis. though, i am really looking forward to seeing third party applications on the platform, that would truly make the porta-MacOSX platform a contender -- it is a helluvalot better than the Windows Mobile platform and even Symbian.
the other thing that drove me to get an iphone was that i didn't want to continue to be paranoid of updates from apple ruining my jailbroken ipod touch. i'd rather have a device that works.