User Manual

Copyright © 2008 spoonforknife. All rights reserved.

Apple, Apple Logo, CoverFlow, iPod, iTunes, Leopard, Mac, Macintosh, Multi-Touch, Safari are
registered trademarks of Apple, Inc. © 2008 Apple, Inc.
YouTube is a registered trademark of YouTube, LLC. © 2008 YouTube, LLC.
Google, and Google Maps, are trademarks of Google Inc. © 2008 TeleAtlas.
All other materials are registered to their respective owners.

This page is here for my well being as well as yours, so don’t skip it.

DISCLAIMER

I, spoonforknife, am not responsible for any damage caused to any device from
following the instructions detailed in this guide. This guide should only be used for
educational purposes. Neither is this guide, or myself, affiliated to Apple, Inc. in any
way, shape, or form.

I strongly advise you read all of Apple’s Legal Documents, the End User License
Agreement (EULA), and the Apple Limited Warranty before proceeding any farther into
this guide.

This guide was made with Pages, Skitch, and Safari.

introduction
Hi everybody, Iʼm spoonforknife and Iʼm a guide writer and a member at iPod touch
Fans forum. Due to the amount of people that need some serious help on this device,
Iʼm packing everything I know into this guide. It isnʼt meant for a developer, but for the
people that need to know some of the basics and things like that.

In this guide, I will start out with a brief description of everything in the glossary (which
will come first) and then move on to define each term in a more detailed fashion with
diagrams, pictures, etc.

It will cover all the firmwares that have been released by Apple® and I will try to keep
this guide as updated as I possibly can. It will include tips, tricks, and handy information
for almost everyone and yes, it will include jailbreaking and the “hacking” of the iPod
touch.

Thank you for showing interest in this guide and reading this. You will probably want to
use that handy find command in order to find what you want, but other than that -
reading all the way through is a great idea for people who are just getting into this to
become experts.

Please note that this guide is for the 2.0 and above firmwares. I would also like to give
a shout out to the iPod touch Fans community, of which this guide comprises of its
findings and tips. Also note that this guide has not been “fine tuned” for the new touch.

Sincerely,

spoonforknife
shout out
Thank you to the iPod touch Fans community, Manic Nimrod, Kiks52, jamil_d, bgizzle,
Modmyi, Ste Packaging, the iPhone Dev Team, and everybody else. Thanks. :)

donations
This guide took a lot of research, a lot of time, and a lot of patience to write. If you
would like to help out, I accept any amount of donations via PayPal.

To donate, send any amount of money to spoonforknife@gmail.com for donations.

Thanks a bundle! Every penny counts, so even if you have 3 cents, I will take that as
generosity. Thank you for reading this guide.
the old device

Well, Iʼm going to refer to quite a few of these terms when I am describing things. So,
when I say Home Button, that means the circular button near the bottom of the device
on the front.
the new device

This is the same thing as the page before except is shows the parts for the new iPod
touch.

RIGHT NOW, THE NEW IPOD TOUCH CANNOT BE JAILBROKEN. RIGHT NOW. :)
the stuff (whatʼs in the box)
▪ iPod touch
▪ Earphones
▪ USB 2.0 cable
▪ Dock adapter
▪ Polishing cloth
▪ Stand
▪ Quick Start guide
glossary
A

App - Abbreviation for Application. See Application.

App Store - The application store. The App Store is a default application on firmwares
2.0 and above, allowing users to buy and download applications right to their device.

Application - A “program” that can be used on the iPod touch/ iPhone. These can be
installed from the App Store, the Cydia Installer, Installer, or via SSH.

Autocorrection - See Keyboard Autocorrection.

BIOS - A file needed to play games on some emulators on the iPod touch. It tells the
emulator how to run. Note that BIOS files are illegal.

Boot Logo - The apple logo that appears when turning on your device. This can be
changed with such computer applications like Pwnage Tool, Winpwn, Xpwn, or
QuickPwn.

Brick - When a device completely ceases to function. An iPod touch cannot be bricked
without trying extremely hard, or just being incredibly stupid.

chmod - A utility to change permissions of a file.

Community Sources - A variety of sources which host many community made

applications on Cydia and Installer such as Ste, BigBoss, and ModMyiFone.

Customize - An application by thespicychicken to customize a variety of aspects on your

device including images.

Cydia - An advanced installation application by saurik to install packages onto your

device.
D

Dev Team - See iPhone Dev Team

DFU Mode - Mode allowing a complete, total restore of the device, even more complete
than a regular force restore.

DiskAid - Computer application to put files on your device via USB.

Dock - (1) The 4 icons on each page of your home screen. (2) An application launcher
by Nate True.

Emulators - Applications for the iPod touch that allow you to emulate (recreate) a
gaming system such as the Playstation 1 on the iPod touch itself. Many of these
emulators are made by zodttd and some require ROMs and BIOS files. For more
details, see ROMS and BIOS.

Firmware - The software file of the iPod. For more details, see the Firmware section.

Force Restore - A way to set your iPod back to factory settings, erasing everything on
your iPod and making jailbreaking undetectable.

FTP - See SSH.

FW - Abbreviation for Firmware. See Firmware.

gpSPhone - Game Boy Advance emulator by zodttd.

Home Button - The circular button below the touch screen of the iPod touch that takes
you back to the Home Screen.

Home Screen - The screen on your iPod touch with a variety of icons. This is also
called the SpringBoard.
I

iLiberty+ - Now defunct jailbreaking method of jailbreaking the 1.1.3 and 1.1.4
firmwares.

Installer - Application used to Install packages onto an iPod touch or iPhone developed
by RiP Dev.

IPA - Format used by iTunes to put official App Store applications on your iPod.

IP Address - Your internet identity. You will need this when you SSH into your iPod
touch.

iPhone Apps - See January App Pack.

iPhone Dev Team - Developers of many jailbreaking tools including Pwnage Tool and
Winpwn.

iPlus - See iLiberty+.

iPod touch Fans - Large forum for the iPod touch with a wiki, forum, RSS feed,
repository, and more.

iPot - Abbreviation for iPod touch. See iPod touch.

iPTF - Abbreviation for iPod touch Fans. See iPod touch Fans.

iTouch - Abbreviation for iPod touch. See iPod touch.

iTunes - Apple application for interacting with your iPod.

Jailbreak - Adding unauthorized applications not approved by Apple onto the iPod touch.

January App Pack - The five applications originally on the iPhone officially released for
the iPod touch in January. The applications are Stocks, Mail, Notes, Weather, and
Maps. These applications come with any new purchase of an iPod touch with firmware
1.1.3 and above. It has since been merged with the 2.0 firmware upgrade.

JB - Abbreviation for Jailbreak. See Jailbreak.

Jiggy - An easy tool on the 1.1.x firmwares to write javascript based applications on the
iPhone and iPod touch.

Keyboard Autocorrection - The sometimes irritating feature that “corrects” the words that
youʼre typing on the iPodʼs touch keyboard.

MMi - Abbreviation for ModMyI. See ModMyI.

ModMyI - Large forum for the iPhone.

Nullriver - Original developers of Installer and Summerboard.

Other.Artwork - A set of images that modifies the basic look of the device such as the
blue navigation bars.

Package - A set of files that can be downloaded off of the Cydia Installer or Installer.

Pwnage Tool - A mac application by the iPhone Dev Team that allows you to jailbreak
firm ware 2.0 and create custom firmwares with custom boot logos.

QuickPwn - A windows application by the iPhone Dev Team that allows you to quickly
jailbreak firmware 2.0 without the need to restore.

Recovery Mode - The mode when your iPod has the Connect to iTunes logo on its
screen. It must be restored through iTunes.

Repo - Abbreviation for Repository. See Repository.

Repository - A URL that contains packages to be downloaded off of Cydia Installer or
Installer onto an iPod touch or iPhone.

Respring - To restart the SpringBoard, allowing changes to the SpringBoard visually

appear.

RiP Dev - Russian Development team that now develops Installer and Kate.

ROMS - A copy of a game that can be played on an emulator. Most ROMs are illegal,
the ones that are legal, are not very good and homemade.

Saurik - Developer of many applications and utilities including Cydia Installer, Cycorder,
and Winterboard.

SDK - Software Development Kit released by Apple enabling developers to create

applications for the iPod touch and iPhone.

SMB - Abbreviation for Summerboard or Super Monkey Ball. See Summerboard.

Source - See repository.

SpringBoard - The home screen. See home screen for more details.

SSH - Connecting to your iPod touch over wireless internet.

Ste - A Community Source on all firmwares, and both Installer and Cydia, who would be
more than happy to host your packages.

Summerboard - An application on 1.1.x firmwares that extended the springboard to be

themed.

SWoD - The Spinning Wheel of Death. This is an error that usually results in a restore
causing a spinning wheel to be on the iPodʼs screen for “all of eternity.”

Theme - A set of images customizing the look of the iPod touch.

TTR - An abbreviation for the popular Tapulous game, Tap Tap Revenge.
U

Unlock - To be able to use an iPhone on various GSM based carriers around the world.
This cannot be done with an iPod touch.

Verbose Mode - Mode that allows the iPod touch to boot (turn on) faster with scrolling
lines of code showing the processes it is going through.

VoIP - Voice Over IP. This allows one to use the iPod as a phone when wifi is available.

Web Application - Applications accessed via Safari optimized for the iPod touchʼs
browser.

Winpwn - Pwnage Tool for Windows. See Pwnage Tool for more details.

WinSCP - A Windows SSH client.

Winterboard - Powerful, open source Summerboard replacement on 2.0 and above by

saurik.

Xpwn - Command Line Pwnage Tool for Linux.

ZiPhone - Tool for jailbreaking 1.1.3 and 1.1.4 by Zibri that wasnʼt terribly reliable.

ZiPhoned - When ZiPhone breaks your iPhone.

zodttd - Creator of many emulators.

For more definitions, check the Glossary, in the iPod touch Fans Wiki.
restoring
First, the most important thing you can do with your iPod. The Restore.

WHAT RESTORING IS

Restoring is a way to completely reset your device back to factory settings. It erases the
information on your iPod and replaces it with the information from a stock firmware,
which will fix anything to do with corruption of data in your device, because it replaces
bad files.

It is a last resort. It erases your music, your notes, you preferences, your videos, your
themes, your skins, your apps, your everything.

A restore will fix any software related problem with your device. If it is hardware related,
then a restore cannot help you.

WHAT RESTORING IS NOT

It is not something you want to do often, because restoring is not a desirable activity. It
is time consuming, boring, and you have to set up your device again from scratch and
set all of your preferences again. It doesn't feel like the same as the device you put into
Recovery Mode.

WHAT YOU SHOULD KNOW

You should know how to restore.

1. Make sure iPod is completely powered off.

2. Hold the home button while its off.
3. While holding the Home button, connect the cable. The iPod should power on.
4. Keep holding the Home button.
5. The Connect to iTunes image should come up.
6. Congrats, you in recovery mode.
You should also know what a restore is and isn't.

WHAT YOU SHOULD DO

Do not recommend restoring at the tiniest issues.

If the volume doesn't work, don't instantly say Restore. Try a reset of all settings, reboot,
respring, or something along those lines. Take time to research what the problem
actually is rather than saying Restore.
.
jailbreak
RIGHT NOW, THE NEW IPOD TOUCH CANNOT BE JAILBROKEN. RIGHT NOW. :)

Since you have bought your iPod touch, you've probably been wondering what you can
do to it. Here are some questions you should ask yourself before thinking about a
jailbreak, or adding extra applications and customizing your iPod.

WHY SHOULD I JAILBREAK?

You should jailbreak because there is almost no risk to jailbreaking. While you may think
that there could be problems like breaking your iPod, you should think again. The only
ways you can break your iPod are simply if you are
really, really stupid, or you're trying to actually break it.
Here are the difficult ways to break your iPod.

• Physical Mutilation. If you physically kill the iPod,

it is irrelevant if the hardware works. Try
smashing your microwave with a sledge hammer
(or rather, don't.) What happens? It breaks. Same
concept.
• Other than that, it's really hard to kill your iPod. If
I haven't scared you off yet, keep reading to find
out what you can do and how.

Plus, jailbreaking gives you cool new applications that

you can use on your iPhone, awesome themes and
wallpapers, and games! Look at the screenshot of
toomuchcaffeineʼs Ultimate Leopard! Thinks like this
are cool and easy with a jailbreak.

If youʼre thinking, that sounds quite dangerous, and I

donʼt want to break my iPod, it really isnʼt dangerous at
all. But continue to read.

WHY SHOULDNʼT I JAILBREAK?

Jailbreaking your iPod touch voids your warranty. Apple's End User License Agreement
(EULA) states that you cannot modify your iPod touch, and can't use iTunes for nuclear
facilities, blah, blah, blah. Jailbreaking, or installing 3rd party applications, voids your
warranty. You will be unable to use your warranty. That's pretty big.
Let that sink in.

Fortunately for you, you can restore your iPod, so they cannot trace your iPod being
jailbroken, and your warranty is magically back! Yay!

Jailbreaking your iPod touch is debatably illegal. While most of us believe that
jailbreaking is not illegal, there are a few people that believe it is, including Apple
employees. You can decide for yourself. I donʼt believe it is, and neither does the
jailbreaking community.

It is possible to break your iPod.

Some things that you can do with your iPod touch with a jailbreak are illegal. For
example, if you donʼt want to pay for apps. There are cracked applications. Those are
ILLEGAL.

WHAT CAN I DO WITH THIS?

With a jailbreak, you can install

applications. These applications can be
useful, like the BossPrefs application, or
even as crazy and fun as Macman, a
great PAC-MAN clone. There are well
over 400 applications out there for you to
easily install. You can even play Game
Boy, Playstation, and even Quake!

In addition, you can trick out your iPod

with cool themes like Ultimate Leopard
(toomuchcaffeine) and Badge
(TheAppleTree). These themes can be
really beautiful and elegant, and a good
deal of them can be installed right off of
your iPod - No Computer Required!

Before you jailbreak, see which firmware

you want to jailbreak, and see this firmware comparison, coming up on the next page.
Just a tip, you want to be on a recent firmware for the best support and most
applications.

For more details on Jailbreaking check out the 1.1.x and 2.x Jailbreaking Sections.
firmware comparison
1.1

Firmware 1.1 was the first release of the iPod touch firmware. It included the default
applications Safari, YouTube, Calendar, Contacts, Clock, Calculator, Settings, Music,
Videos, Photos, and iTunes, with the latter 4 applications being on the dock.

1.1.1

Firmware 1.1.1 followed up shortly on the initial firmware 1.1, with no feature changes
but made a significant bug fix to correct “washed out blacks” on some units. No new
features were added. It can be jailbroken with the AppSnapp jailbreak featured on the
website http://jailbreakme.com and a variety of other sites. More details about this
jailbreak are in the jailbreak section.

PROS

- Very Easy Jailbreak

- Almost All 1.1.x Applications are compatible
- Better for skinning
- Supports full skinning, keyboard skinning, and almost all themes.
- Stability
- Easy to re-jailbreak
- Very good compatibility

CONS

- Cannot add calendar events without fix

- Not as optimized
- Sound quality slightly worse
- No wiggling icons / No Webclip Creation
- Limited to 400 MHz

1.1.2
Firmware 1.1.2 followed up on 1.1.1, with a variety of bug fixes and small feature
additions including the add calendar event button in the Calendar application which was
mysteriously missing in 1.1.1. The main thing was that it patched the TIFF exploit that
enabled the AppSnapp jailbreak on firmware 1.1.1.

PROS

- Very little bugs

- Still quite easy to jailbreak
- More Stable
- Add Calendar Events
- Very stable
- A little faster than 1.1.1
- Processor Speed Bumped to 412 MHz.

CONS

- Cannot do Keyboard Skinning

- No wiggling icons / No Web Clip Creation
- Crashes on occasion

1.1.3

Firmware 1.1.3 added a plethora of changes including webclips and rearranging the
home screen at a hefty price of $20. It also added lyrics, bug fixes, and support for
iTunes movie rentals.

PROS

- Better Battery Life than 1.1.1 or 1.1.2

- Adds many new features
- More Stable
- Faster than Previous Firmware Versions

CONS

- Seems a little buggier than previous firmwares

- Locate Me in Google Maps doesn't always work
- Ugly New Dock
- Slightly Reorganized File System (1.1.1 and 1.1.2 repos do not work well with it)
- Soft Jailbreaks often crash to the Force Restore (Connect to iTunes) screen
- Some applications unusable, others don't work well
- Needs quite a few fixes to get many common applications to work
- Purchased songs from iTunes might not work
- Springboard runs as different user, causing some older apps from 1.1.1 and 1.1.2 to
not work.

1.1.4

Firmware 1.1.4 fixed a few bugs from 1.1.3. Seems to be a placeholder for 2.0 with
nothing really new at all.

PROS

- Many Nice Bug Fixes

- More Stable
- Most Recent
- Still Faster

CONS

- Doesn't really improve very much. Seems to be

a placeholder.
- Some applications do not work very well with it.

1.1.5

Firmware 1.1.5 fixed a few bugs from firmware 1.1.4. and was an alternative for people
who didnʼt want to pay for 2.0.

PROS

- Bug Fixes

CONS

- It is simply a placeholder for people that chose not to upgrade to 2.0, couldn't afford it,
or cannot use the iTunes Store to buy products.
- The Jailbreak status is known to be a bit buggy.
Firmware 2.0 added the App Store, a whole new calculator, and seemed to completely
revamp the Operating System. Unfortunately, this comes at $10 through iTunes.

PROS

- Many, many new features.

- Great scientific calculator.
- Enterprise features with Cisco VPN, MobileMe support, and Microsoft Exchange.
- Ability to purchase applications.
- January Update comes bundled with it.

CONS

- Very buggy. Random reboots and lag are not appreciated.

- All applications from previous firmwares must be ported to 2.0.
- A bit pricy.

2.0.1

Firmware 2.0.1 added more bug fixes to 2.0.

PROS

- Bug Fixes make it a much more valuable version of 2.0.

CONS

- Still rather buggy.

- Applications from previous firmwares do not work on 2.0.1.

2.0.2

Firmware 2.0.2 added yet more bug fixes to the incredibly buggy 2.0 set of firmwares.

PROS

- Bug Fixes make it a much more valuable version of 2.0.

CONS

- Still rather buggy.

- Applications from previous firmwares do not work on 2.0.1.
2.1

Firmware 2.1 added a bunch of new bug fixes and was released with the new iPod
touch. Genius playlists, epic bug fixes, Nike+ iPod integration, and better display
information were just some of the new features.

PROS

- Far less buggy

- Shorter Backup time
- Genius
- Nike+iPod integration
- Added Music display

CONS

- Still a bit buggy.

- Applications from previous firmwares do not work.

Remember that 2.1 is probably your best bet to jailbreak, and use for right now because
it has 3 different installers (Installer, Cydia, App Store) and has the most applications
due to the App Store.

On the next page will be a guide to jailbreak all firmwares.

You can download firmwares from http://felixbruns.de/iPod/firmware for your

convenience. If youʼre using Safari, use Firefox to download them as Safari will
automatically unzip the files and mess the download up.

For more Firmware Comparison, see my guide.

push
THIS SECTION COURTESY OF KIKS52

Push is a feature on the 2.x firmwares you should know about, so you're probably
wondering what "push" is. With the addition of Firmware 2.0, we now see support for
Microsoft Exchange ActiveSync, which utilizes "push". Now, this can be confusing if you,
simply, have no idea what that is. Hopefully we can answer those questions.

WHAT IS PUSH?

"Push" refers to the technology known as Webcasting which "pushes" updates to you
periodically, such as email, rather than having to manually check yourself. Usually, the
mail would go to your ISP's (Internet Service Provider) mail server, which means you
would have to go check, and "pull" the email. Basically, instead of wondering when
you're going to receive that important email from your cousin, you'll be alerted when this
email has arrived, therefore "pushing" the email straight to you. If you're still confused,
think of RSS Feed. For example, when a new front page post is made on
iPodTouchFans, a user subscribed to iPodTouchFans' RSS Feed would automatically
receive the new article, therefore "pushing" it to them, while another unsubscribed user
would have to go to iPodTouchFans and check for themselves.

WHAT DOES PUSH SUPPORT ON 2.X?

• Push email
◦ Emails are pushed to you, instead of having to manually check yourself.
• Push contacts
◦ Contact lists are constantly up to date.
• Push calendar
◦ Upcoming events on the calendar are pushed to you, alerting you.

HOW DO I ENABLE PUSH?

Microsoft Exchange ActiveSync is automatically connected out of box. Through the

Exchange ActiveSync application, you have the option to turn On/Off push email,
calendar and contacts. There is also settings you can enable, and you can select which
days to sync.

Alongside Push comes a service called MobileMe.

mobile me
THIS SECTION COURTESY OF KIKS52

The long awaited successor to .Mac technology, MobileMe keeps all of your information
in sync, through web servers. Commonly referred to as the "cloud" of information,
MobileMe keeps your devices in sync - whether you be using a Mac, PC, iPhone or
iPod touch. Staying in sync is as simple, and quick, as heading to Me.com and using
your MobileMe account to login.

• Individual MobileMe Account

◦ $99/Year
◦ 20GB of File Storage
◦ 200GB of Data Transfer
• Family MobileMe Accounts
◦ $149/Year
◦ 1 Account with 20GB of File Storage
◦ 4 Additional Accounts with 5GB of File Storage
◦ 200GB of Data Transfer

MobileMe - Mac:
• Syncs any changes made in iCal or Address Book every 15 minutes.
• Sync emails, contacts, calendars and bookmarks Mac-to-Mac.
• Upload photo albums to MobileMe, where family members can add photos to the
album. When photos are added, they're synced to your Mac.
• Upload movies using iMovie.
• Create custom websites with MobileMe & iWeb.
• Upload files using iDisk and when on-the-go, view them at Me.com.
MobileMe - PC:
• Compatible both with Windows XP (SP2) and Windows Vista.
• Sync email with Outlook and/or Outlook Express.
• Sync any changes in contacts using Windows Contacts.
• Sync bookmarks from Internet Explorer or Safari.
• Sync from PC-to-PC or PC-to-Mac.
• Upload files using iDisk and when on-the-go, view them at Me.com.
MobileMe - iPhone/iPod Touch:
• Any changes of contacts or calendars made are updated on Me.com and synced
to Mac/PC.
• Any new email messages are pushed straight to your iPhone or iPod touch,
within seconds. If you read or delete an email on your iPhone or iPod touch, the
changes are synced back to Me.com and your Mac/PC.
• Take photos using iPhone's camera, and sync them to your photo galleries on
Me.com.
how to jailbreak
ONCE AGAIN, THE NEW IPOD TOUCH CANNOT BE JAILBROKEN NOW.

After downloading the firmware, you'll likely need to downgrade/upgrade to it. To

downgrade or upgrade to a firmware, open iTunes, plug your iPod in, and navigate to
your iPod's pane. You can get to this by clicking on your iPod's name in the sidebar.

On a PC, hold shift and click restore.

On a Mac, hold option and click restore.

Then, select your downloaded firmware, and your iPod will restore to that firmware.

1.1.1

- Brief Summary: Use the AppSnapp Jailbreak.

- Detailed method: On firmware version 1.1.1, on your iPod, go to http://
jailbreakme.com. At the bottom, hit "Install AppSnapp". You have jailbroken 1.1.1! Note
that if this method doesn't work the first time, you should just try again.

1.1.2

- Brief Summary: Use the AppSnapp jailbreak, use oktoprep, and do the TouchFree
Jailbreak.
- Detailed method: Jailbreak 1.1.1 with the method above. Then, go to Installer and
download the package "oktoprep." You don't need to add any sources but Community
Sources, which will already have oktoprep in it. On your computer, download the 1.1.2
jailbreak at this link http://conceitedsoftware.com/iphone/112jb.html, and follow the
onscreen instructions. This is for both Mac and PC computers.

1.1.3

- Brief Summary: Use ZiPhone or iLiberty+.

- Detailed method: Download one of the above from the links above, connect your
iPod, and click Jailbreak.

1.1.4

- Brief Summary: Use either winpwn, or Pwnage Tool.

- Detailed method: Download one of the above from the links above connect your iPod,
download a copy of the firmware and select it. Itʼs pretty simple.
1.1.5

- Brief Summary: Use ZiPhone.

- Detailed method: Plug it in and click jailbreak.

2.0

- Brief Summary: Use either winpwn or Pwnage Tool.

- Detailed method: Download a 2.0 firmware and customize it with WinPwn or Pwnage
Tool, follow the onscreen instructions, and restore to your custom firmware via iTunes.

2.0.1

- Brief Summary: Use either winpwn, Quickpwn, or Pwnage Tool.

- Detailed method: Download a 2.0.1 firmware and customize it with WinPwn or
Pwnage Tool, follow the onscreen instructions, and restore to your custom firmware via
iTunes. Or just quickly plug in your iPod and quick jailbreak with Quickpwn.

2.0.2

- Brief Summary: Use either winpwn, Quickpwn, or Pwnage Tool.

- Detailed method: Download a 2.0.2 firmware and customize it with WinPwn or
Pwnage Tool, follow the onscreen instructions, and restore to your custom firmware via
iTunes. Or just quickly plug in your iPod and quick jailbreak with Quickpwn.

2.1

- Brief Summary: Use Pwnage Tool, Quickpwn.

- Detailed method: Download a 2.1 firmware and customize it with Pwnage Tool, follow
the onscreen instructions, and restore to your custom firmware via iTunes. Or use
Quickpwn.

WHICH IS THE BEST?

For customization, I recommend PwnageTool or Winpwn. If you just want to get the
jailbreak over fast and easily with no complications, Quickpwn is your ticket.

WAIT!

Wait, wait! What's this I've heard about Soft Upgrades? Soft upgrade is short for
Software upgrade. It is a horrible method to jailbreak an iPod. Firstly, it requires you be
jailbroken. Then, it fools your iPod, iTunes, and you into believing that you are on
another firmware. These are very buggy and have even been known to put your iPod
into restore mode on random occasions. Under no circumstances should you do a Soft
Upgrade.
applications
This section will give you suggestions on what you should get, and is thus divided into
several categories:

- Installers Comparison

- Utilities

- Games

- Emulators

- Multimedia

They will be in that order, so feel free to browse in whatever order you enjoy, or just
skim around. I will be covering App Store applications and applications from the
Jailbreak, including my personal favorites and great deals.
comparison of installers
installer 4
• Manufacturer: RiP Dev
• Source: Closed Source

• Pros:
◦ Simple user interface
◦ Faster source refreshing.
◦ Tasks menu.
◦ Applications don't close when they are no longer shown.
◦ Applications not restricted by Apple's restrictions.

• Cons:
◦ Closed source.
◦ Incredibly laggy
◦ Messy source adding interface.
◦ So-so interface.
◦ Not many sources or applications at this point.
◦ Little to no support from RiP Dev and developers.
◦ Repeat packages.
◦ Not very good for developers.
◦ New applications aren't shown.

• Review: Installer 4 was awaited by many and fell the farthest from expectations.
It's laggy interface due to "extra graphical flair," and lack of features implemented
long before in previous versions alienated some users. It's also closed source
and had a new source format. The new source format helped make Installer
refresh sources faster, but old sources from previous versions become invalid
and had to be recoded. Installer 4 is not very good, and I also advise waiting for
updates.
cydia
• Manufacturer: Saurik (Jay Freeman)
• Source: Open Sourced

• Pros:
◦ Open sourced.
◦ Fast and not laggy.
◦ Many developer tools.
◦ Variety of FAQs on home view.
◦ Changes view for updates and new packages.
◦ Search function includes both repositories and packages.
◦ Fully customizable including which types of packages you want to see,
and what sections you want viewable.
◦ Repository adding easy and quick.
◦ Applications don't close when they are no longer shown.
◦ Applications not restricted by Apple's restrictions.
◦ Support for terminal commands for updates, installs, refreshes, and
uninstalls.

• Cons:
◦ Some people do not like the interface.
◦ Repository refreshing is sometimes rather slow.
◦ Applications not supported as well as App Store applications.
◦ Cannot exit Cydia until the package installs.

• Review: Cydia was the first jailbreak application to 2.0, and the best. It's easy to
use interface, supplemented with new source adding, plus with far more features
than the laggy Installer 4, Cydia dominates the competition. Its customizable lists
help narrow down results to help the end user and it can only get better.
app store
• Manufacturer: Apple, Inc.
• Source: Closed Source

• Pros:

◦ No jailbreak required.
◦ Full Apple and Developer support staff.
◦ Very snazzy visuals and interface.
◦ No sources to manage.
◦ Very little lag.
◦ Apps install in the background.
◦ App Reviews available.
◦ No repositories or manual refreshing to deal with.
◦ Easy updates.

• Cons:
◦ Closed Source.
◦ Applications close when exited.
◦ Requires iTunes account.
◦ Requires credit card or iTunes gift card.
◦ Many applications far overpriced.
◦ New applications aren't shown.

• Review: The App Store was the first

tool for distribution of applications for
the iPod touch and iPhone on 2.0. The
first of its kind, the App Store was done
incredibly well. With Apple support, a
fantastic interface, and thousands of
applications ready for download, the
App Store was incredibly well done.
Unfortunately, it requires iTunes being
supported in your country. If you don't
have a credit card or iTunes not being
supported in your country: you have no
App Store. Despite minor gripes, the
App Store is a fantastic application
installer for the iPhone and iPod touch.
verdict
Based on counting the ratios between pros and cons, Cydia automatically wins by a
large margin. From the tone of the reviews, you can probably tell that the feature
deprived Installer 4 falls far behind its predecessor (Installer 3), and thus, the App Store.
Cydia just has done so much better than Installer, carries more features than the App
Store, and does so much as an open source application. Cydia is the best Installer on
2.0 for now, and this guide will be updated to reflect that. Stay tuned, and here are the
current results below.

1. Cydia
2. App Store
3. Installer

Cydia Installer - Cydia Installer is a package manager and installer by Jay

Freeman, or saurik. Cydia is open sourced, has a source adder, is very
customizable, is really stable, and is the best of all Application Installers
(that includes Installer and App Store.) Cydia isnʼt buggy and contains a
large variety of applications and themes to download - including a huge selection of
Developer tools from Telesphoreo. Use it. Itʼs good.
utilities
Utilities are essential. They managed what we have and for this, I will be covering
Utilities and Tweaks.

AppFlow - AppFlow is a handy dandy Application launcher by Erica Sadun. Erica

Sadun is the developer of many exciting applications like Make It Mine, PDFViewer, and
things like Ericaʼs Utilities - a set of utilities allowing developers to do so much more with
their applications. App Flow launches applications in 3 different modes: Landscape,
Portrait, and Cover Flow. You can launch and badge (put the little number next to their
names) applications with AppFlow.

BossPrefs - While Poof and BossPrefs are by the same maker and both can hide
applications, BossPrefs is more full featured and does it all in one application.
BossPrefs hides applications, toggles services (Wifi, SSH, etc.), can be used as a
power manager (Reboot, Turn off, etc.) and even as an application launcher among
other things.

Dock - Dock is for those of you that donʼt want to use a separate application for
launching apps. It provides a subtle yellow line at the bottom of your screen at all times,
and when bringing your finger up, it shows a nice submenu of categories that can
launch apps. With Dock Preferences, you can move apps from category to category
and even make certain apps not even show up giving it a level of customization
AppFlow cannot take.

Five Icon Dock - This allows you to simply drag an icon to your dock and it magically
has room for a 5th icon. Drag it out, and it goes back to 4. Magic.

Make It Mine - Make It Mine allows you to change your Carrier Image and your banner.
Your carrier image is the thing that says iPod and the banner shows the time. This
application can make them say custom things. For example, my banner could be
iPhod, and my banner could say 103.3 FM.
OpenSSH - OpenSSH allows your computer to “talk” with your iPod, so you can see the
file system and manipulate it, adding things and putting applications and themes in.
This is a must download seeing as you need OpenSSH for many of the things you use
your iPod for.

QuickGold - If youʼve ever heard of QuickSilver, an application launcher on the mac, you
have heard of QuickGold. Simply tap the home button, a field pops up with a keyboard,
and it searches your device for contacts, web history, applications,
and more. This is my preferred launcher.

Stack - A really, really awesome launcher based on the Mac OS X

Leopard feature stacks.

Winterboard - Winterboard is a powerful, open sourced theme

manager and applier. It has a simple interface for applying themes
and using it is incredibly easy. You need this application.
games
As with most people, Iʼm a big fan of games, and if youʼre looking for emulators, you can
take a look at the next section for that. My favorite games and the best deals are below.

JAILBREAK

MacMan - This is a great Pac Man clone. Using the accelerometer (tilt controls), you
can steer this Mac themed Pac Man to eat up those pesky yellow dots and steer away
from the monsters.

APP STORE

Cube Runner - Cube Runner is a great, addicting, free game where you pilot a ship
through a field of cube mines. Tilting to steer is intuitive and a catchy techno beat plays
in the background (which can conveniently be disabled when it gets tedious.)

iCopter - The fun web game Helicopter has been ported to the iPod touch for only 99
cents. For almost endless and addictive fun, iCopter is the way to go. If you donʼt like it
how it is, the developer is pushing out frequent updates and this is cheaper than the
other helicopter type games: CaveCopter and iCave.

Tap Tap Revenge - A great deal of a game, Tap Tap Revenge is a Guitar Hero type
game of tapping circles as they come towards you to get a better score. Tapulous, the
makers of this game host weekly contest with all sorts of prizes: cases, money, songs,
etc. In addition, this game is free! Song and “tap” downloads are free and from right
inside the application. Everything in this game is wonderful - the graphics, the
gameplay, and songs. This is a must download.

Trism - This Tetris style game uses the accelerometer to match up 3+ triangles up of the
same color. This is my new favorite time waster and has incredible replay value due to
the fact that it has obstacles that can easily end your game like locks and bombs. Trism
is $4.99
emulators
You probably have some questions. Here are answers.

1. What is an emulator?
It duplicates the function of one thing (i.e. Game Boy, Playstation, Sega Genesis) and
allows it to be played on something else (i.e. Your iPod touch). Most of the emulators for
the iPod touch are made by zodttd, which you can find at http://zodttd.com.

2. What can I do with one?

You can play your favorite video games that you never got to play as a child. Go, run
child! Run!

3. Is it illegal?
Emulators themselves are not illegal. Various portions of emulators are illegal, and are
therefore not included in the original copy of the emulator. You must find these various
files yourselves. The illegal parts are "BIOS" and "ROMS," which are described in
greater detail below.

4. What is a BIOS file?

In simple terms, a BIOS file is a "Built-In Operating System," meaning that it tells the
emulator to run. The Emulator itself needs some instructions, and the BIOS will tell it
how to run. BIOS files are illegal, so do not distribute them on this forum. They are
illegal because they are an operating system. Think about if you copied Windows 95
install disks. Same thing.

5. What are ROMS?

A "ROM" is a copy of a given console game. These "ROMS" can run on an emulator,
and mostly are not legal. "ROMS" can be used to make copies of a game and easily
spread to piracy. It is illegal to have a "ROM" for 24 hours, contrary to popular belief.
However, some ROMS are legal. They are just crappy and are homemade.

NINTENDO SAYS: Can I Download a Nintendo ROM from the Internet if I Already
Own the Authentic Game?

There is a good deal of misinformation on the Internet regarding the backup/archival

copy exception. It is not a "second copy" rule and is often mistakenly cited for the
proposition that if you have one lawful copy of a copyrighted work, you are entitled to
have a second copy of the copyrighted work even if that second copy is an infringing
copy. The backup/archival copy exception is a very narrow limitation relating to a copy
being made by the rightful owner of an authentic game to ensure he or she has one in
the event of damage or destruction of the authentic. Therefore, whether you have an
authentic game or not, or whether you have possession of a Nintendo ROM for a limited
amount of time, i.e. 24 hours, it is illegal to download and play a Nintendo ROM from the
Internet.

6. What are the available emulators and what do they do?

• gpSPhone - Emulates Game Boy Advance (GBA)
• psx4iphone - Emulates Playstation (PSX)
• NES - Emulates the Nintendo Entertainment System (NES)
• gameboy4iphone - Emulates the Game Boy (GB)
• snes4iphone - Emulates the Super Nintendo Entertainment System (SNES)
• genesis4iphone - Emulates the Sega Genesis
• ScummVM - Emulates the Scumm platform
• quake4iphone - Emulates Quake
• Temper4iphone - TurboGrafx-16 Emulator
• OpenTTD - Transport Tycoon Deluxe
• gb4iphone - Game Boy/Game Boy Color (GB/GBC) Emulator
• vlc4iphone - VLC Player

7. What Emulators Run at Full Speed?

This question can give you many different answers, especially on which "ROM" you're
talking about. This is because some ROMS do not run well, and some do.

8. Why is my sound crackly and weird?

Emulators are like that. Youʼll have to deal with it.

9. Where can I get ROMS and BIOS?

Iʼm not telling you where, but Iʼll tell you where to put them and what theyʼre called.

gpSPhone
Place the BIOS in /Applications/gpSPhone.app
Make sure it is titled gba_bios.bin, and set permissions to 755 or 777.

Place ROMS in /private/var/mobile/Media/ROMs/GBA.

If the folder does not exist, create it, and stick the ROMS in there, setting permissions to
755.

gb4iphone
Place ROMS in /private/var/mobile/Media/ROMs/GAMEBOY/
If the folder does not exist, create it, and stick the ROMS in there, setting permissions to
755.

psx4iphone
Place the BIOS in /Applications/psx4iphone.app
Make sure it is titled scph1001.bin, and set permissions to 755 or 777.

Place ROMS in /Media/ROMs/PSX.

If the folder does not exist, create it, and stick the ROMS in there, setting permissions to
755.
snes4iphone
Place ROMS in /private/var/mobile/Media/ROMs/SNES.
If the folder does not exist, create it, and stick the ROMS in there, setting permissions to
755.

genesis4iphone
Place BIOS in /Applications/genesis4iphone.app
Make sure it is titled us_scd1_9210.bin, and set permissions to 755 or 777.

Place ROMS in /private/var/mobile/Media/ROMs/GENESIS/

If the folder does not exist, create it, and stick the ROMS in there, setting permissions to
755.

NES
Place ROMS in /private/var/mobile/Media/ROMs/NES.
If the folder does not exist, create it, and stick the ROMS in there, setting permissions to
755.

quake4iphone
Put the .pak files from the original game in /Applications/quake4iphone.app/ID1 and you
should be able to play the full version.

temper4iphone
Put syscards (syscard1.bin, syscard2.bin, syscard3.bin) in /private/var/mobile/Media/
ROMs/TEMPER/syscards/

For ROMs, put them in /private/var/mobile/Media/ROMs/TEMPER. Set the application

directory to 777, and the ROMs to 777. For ROMs ending in .pce, put them in /private/
var/mobile/Media/ROMs/TEMPER/images

zodttd beta testers

zodttd has a beta testers club that allows you to test some of his newest emulators. To
get in, you can donate, or send in a video of yourself playing one of his released
emulators to zodttd on his website, http://zodttd.com.

Then, you will get a repository to enter into Cydia to download your favorite zodttd
emulators!

UNDER NO CIRCUMSTANCES SHOULD YOU SHARE OR DOWNLOAD

SOMEBODY ELSEʼS ZODTTD EMULATORS. THIS IS NOT ACCEPTABLE.
multimedia
JAILBREAK

MxTube - MxTube is a YouTube video downloader. It can also now stream videos too,
so it is nearly a complete replacement of the YouTube application, plus it can download
things!

PocketTouch - PocketTouch is a gesture based music controller. What this means is

that you use a variety of swipes, taps, and shakes to control your music. Double tap to
pause, swipe to change tracks, and shake to shuffle. With PocketTouch, you never
have to take out your iPod, double tap the home button and search around for a button -
just tap, swipe, and shake!

WebTouch - WebTouch is a web based music controller. More of a toy than a useful
tool, you can install WebTouch and go to

APP STORE

Band - With Band, you can create your own music, with a variety of instruments
including Bass Guitar, Piano, Drum Machine, Drum Kit, Crowd, and much more. Then,
you can record and master your creation for listening anytime within Band. While Band
is a little bit pricy at $9.99, I feel that it is well worth it.
quick guide to the sdk
THIS SECTION COURTESY OF JAMIL_D

Now that youʼve read all about Applications, you may be wondering how to make them.
If youʼre wondering that question, youʼre not alone, but if you want to develop, you must
know a combination of C+ and Objective C, and have a decent knowledge of Terminal.
Please note that this does not describe how to develop applications, it only talks about
what the SDK is, how it is used, and how it can be implemented. It should also be noted
that the SDK is under a strict NDA, which you can read when you apply to the iPhone
Developer Program.

The iPhone SDK, or Software Development Kit, is an application that runs on your Mac
OSX machine. Contrary to what some believe, it does NOT show up on your iPod/
iPhone as an icon, but rather it allows you to create applications for your iPhone/iPod
touch. It is an official Apple Product, and does not require nor endorse jailbreaking. The
SDK Comes with five main tools, which will be discussed below:

Xcode
This tool allows you to create, edit, and manage code written in Objective-C (for more
information, go to http://developer.apple.com/). In the words of Apple Developer
Connection, Xcode is Apple's premiere development environment for Mac OS X. In
addition to being packaged on the DVD with every copy of Mac OS X, the latest Xcode
developer release is always available for free to ADC members and includes all the
tools you need to create, debug, and optimize your applications.

Dashcode
This application is excellent for creating Dashboard Applications, without, or limited
code. It is bundled within OS X 10.5 Leopard.

Interface Builder
This is where all the great things about the iPhone SDK are put together. Interface
Builder lets you create a UI (User Interface) without any code. Just drag and drop. In
addition to this, you can create connections between the code and Interface Builder.

Instruments
Instruments can monitor activity on your iPhone, OSX Environment, and track memory
leaks or hogs. It works with Jailbroken and Non-Jailbroken iPod touches.
ssh
What Is SSH?

SSH is a way of wirelessly transferring files to and from your jailbroken iPod touch. Your
computer sends the files to your router, which in turn sends the files to your iPod. Of
course, you'll need a wireless router to do this, though.

Why Should I Use This Thing?

I'm glad you asked. Many applications and modifications are not available in Installer or
Cydia, so you have to manually add them to your iPod.

How to do it

Download OpenSSH from Cydia.

Reboot.

Install an SFTP client on your computer. If youʼre on a PC, I recommend WinSCP. If

youʼre on a Mac, I recommend Cyberduck.

Go to Settings on your iPod touch and then tap Wi-Fi. Make sure youʼre connected to
the internet, and on the network that youʼre connected to (itʼll have a check mark on it),
tap the blue arrow. There, you will see a field that says IP Address. Write this down.
For reference, it should look something like 192.168.x.xxx.

In your SFTP client (WinSCP or Cyberduck), start a new connection. For the host
name, this will be your IP address. For username, put in root, and for password, use
alpine. This is the default configuration, which I will teach you how to change later in
the guide.

Also, make sure youʼre using Port 22 (in your SSH client) or using SFTP rather than
FTP.

It should then connect! Be responsible and donʼt delete files if you donʼt know what they
are. Seriously, itʼs bad.
How do I enter commands?

If your FTP client doesnʼt include a way to enter commands, you will have to use
Terminal.

On a mac, open Terminal.

Use either Spotlight or find it
in Applications/Utilities.
Then type in ssh
root@your.ip.address.here.
Wait a few seconds and
then you can enter
commands.

On a windows machine,
open WinSCP and connect to
your iPod. Then, press Ctrl+T and a window will popup where you can enter
commands.

Handy Terminal Commands

Find App Store applications

cd /var/mobile/Applications/
find ./ -name AppName

Set permissions

chmod -Rf PermissionNumberHere /Directory/Here

Remove Directory

rm -rf /Directory/Here

Respring

killall SpringBoard

or

setlanguage

Reboot

reboot
CHANGING YOUR PASSWORD

Login to your iPod via SSH and type in

su root

This will log you in as Administrator after you type in your password (alpine.)

passwd

Then type in your new password. If you want to change your password for mobile, type
this in:

passwd mobile

Youʼre good to go! Login with your new password to test it.

GOOD PLACES TO BOOKMARK ON YOUR iPOD

/Applications - Applications

/Library/Themes - Winterboard Themes

/System/Library/CoreServices/SpringBoard.app - SpringBoard.app

/var/mobile/Applications - App Store Applications

/var/mobile/Media/DCIM/100Apple - Saved Photos

/var/mobile/Media/DCIM/999Apple - Screenshots
theming
First off, before you start on the theming portion of this guide, read some tips on
theming.

- Don't copy other people's themes. The themes are theirs!

- Don't just take other people's background and say it's your theme!
- Vista themes are a "no-no." There are so many of them, nobody likes them anymore.
- Try something new. Flip things up. Innovative themes are always loved.
- Be Complete. Skin everything!
- Icons. Make a lot of icons. People can sometimes not like a theme because it lacks
lots of icons, and their home screen looks rather stock.
- Include a screenshot. We want to see what it looks like!

So, here are the dimensions of common images on the iPod touch.

- Icon Dimensions: 60 by 60 pixels

- Carrier Image Dimensions: 20 by <120 pixels
- Background Dimensions: 320 by 480 pixels
- Dock (1.1.3 and above): 320 by 91 pixels
- Mini Dock (1.1.1/1.1.2): 320 by 37 pixels
- Status Bar Dimensions: 320 by 20 pixels
- Slider Dimensions: 71 by 47 pixels
- Battery Dimensions: 264 by 129 pixels
- Volume fill Dimensions: 10 by 4 pixels
- Bottom bar Dimensions: 320 by 96 pixels
- Volume knob Dimensions: 25 by 25 pixels
- iPod bar Dimensions: 1 by 48 pixels

SEE THIS EMPTY SPACE? SEE THE LACK OF INFORMATION?

I need help with this section. If youʼre an expert on themes, email me at

ipodtouchguidewriter@gmail.com and we can work together.
winterboard
THIS SECTION COURTESY OF MANIC NIMROD

WHAT IS WINTERBOARD?

Winterboard is a theming application for the iPod/iPhone on 2.0. It allows you to change
many many aspects of the iPhones interface, such as the icons, wallpaper and well all
the images on the iPhone. A good thing for Winterboard is that you can use the old
summerboard themes as well, just drop then in the themes folder(how to below)

WHERE DO I GET IT?

You can get it from Cydia. There is no source you have to add, it should be there when
you open the application.

The location in Cydia is the System folder.

WHAT ARE THESE THINGS IN THE WINTERBOARD FOLDER?

-Black Navigation bars: These change the top and bottom bars to black of many apps.
-Saurik: THis is just a preview of the winterboard.html files. Its allows you to have
moving wallpapers.
-Transparent Dock/ Icon Labels: These remove the icon names from the apps on
springboard.
-User Wallpaper: This allows you to use your lock screen wallpaper as your
SpringBoard wallpaper.
-Server Lock Example: No idea.
-Solid Status Bar: No idea.

WHY SHOULD I USE THIS OVER CUSTOMIZE?

You should use Winterboard over customize because, itʼs much easier to use. You can
quickly pick a theme and close Winterboard and see it instantly. Customize has many
problems for many people, themes donʼt show, nothing changes after you apply one.
Winterboard does work, no problems, easy as pie.

WHERE CAN I GET NEW THEMES?

In Cydia, there are many themes for you to download. From Cydia, you can get full
themes, sliders, carriers, wallpapers, sounds, keyboards, and what ever else you can
change on the iPhone.
If you hit open the Themes(Summerboard) folder, you will see many Winterboard
themes in there. To see what theme you are downloading click on the "more
information" bit and you should see some screenshots. You can choose to download it.

HOW DO I INSTALL THEMES VIA SSH?

Open up your SSH client, Navigate to /Library/Themes. And there are the Winterboard
themes there. Simply drop the themes files in there, and open up Winterboard to see
them.

HOW DO I APPLY A THEME IN WINTERBOARD?

This is the easy part. Simply open Winterboard, tap on the one you just downloaded.
Then close Winterboard. It shall respring and take you back to the lock screen. Unlock,
and there we go.

Please note that if you are using a combination of themes

(i.e. Bluebird and MonoChrome) that you put whatever
you want most of on top of the other one. For example,
if you want icons from Bluebird, but the Artwork from
Monochrome (and not the icons), put Bluebird on top of
Monochrome because Monochromeʼs icons will be
overwrought by Bluebirdʼs icons.

To rearrange themes, simply hold down the 3 line box to

the right of a theme, as shown in red. Drag it upwards
above another theme.

Close Winterboard, and youʼre done!

HOW DO I “UNAPPLY” THEMES WITH WINTERBOARD?

Just tap a theme and it will become unchecked. Then, hit the home button, your device
shall respring, and that theme will be “unapplied.”
HOW DO I MAKE A THEME FOR WINTERBOARD?

Wallpaper.png=Wallpaper of your theme

StatusBar.png=The bar at the top of the iPod screen
Dock.png=The Bar at the bottom of the iPod screen.
SBDockBG=Dock
SBBadgeBG.png=The little red circle you see above some icons

You can use many programs for making themes, the most used are Photoshop and
GIMP.

CAN I CHANGE THE FONT WITH WINTERBOARD?

No, not at the moment. But you can change the font style on the SpringBoard! To do
so, download the package Winterboard Font Pack in Cydia from STE Packaging. I
made it and you apply whatever font you desire via Winterboard.

CAN I CHANGE THE LOCKSCREEN BACKGROUND?

Yes, simply include a LockScreen.png in the main directory (root) of your theme.

WHAT ELSE CAN IT DO?

Widgets

Winterboard allows you to have widgets on your springboard, so far there are 2
available.

The Weather Widget: See below for guide.

The Clock Widget: Guide coming soon.

Dynamic Wallpapers

Winterboard has the ability to be able to have wallpapers which change after a certain
amount of times.

Here is a great guide for this: http://www.ipodtouchfans.com/forums/...e+backgroun d

Video Wallpapers

Simply put a video with the right dimensions and name it Wallpaper.mp4 into a theme
file in /Library/Themes via SSH, and apply the theme.
widgets
Winterboard supports HTML theming. What this means is that you can use a webpage
for your Home Screen background. With this, you can make fading wallpapers and
other cool stuff. But the coolest part of all, is that you can use Javascript. This enables
widgets to be used, like the clock and weather widgets.

The clock widget is a handy, moving clock on the Home Screen. It actually works. The
weather widget is an updatable, customizable portion of your Home Screen with
updating weather.

Please note that if you want both clock and weather widgets, you will have to wait until I
finish writing that part. Sorry for the inconvenience.

the weather widget

COURTESY MANIC NIMROD

To install the weather widget you will need the following.

- Default Weather Widget

- OR Status Bar Weather Widget
- An SSH client
- OpenSSH
- Winterboard

PUTTING IT ON YOUR iPOD

Open up your SSH client and navigate to "/Library/Themes," and drop the
"WeatherWidget.theme" folder in there.

Now, you will need to change your location. To do this, you have to open up the
"configureMe.js" file. This script is found in "/Library/Themes/WeatherWidget.theme/
Private"

Double click to open it.

Now, there will be lots of text which tells you what to do, but that can be confusing.
So find the text that says: var locale = "(insert your living area here)" //e.g. 'Defiance,
Ohio'|'Moscow, Russia'|'Ledyard, AT'|'London, UK'

So if you live in London, you will type London, UK. Get what i mean?

WHICH WIDGET?

Number 5, OneLine is the default one which is set when you download the files from the
"What will i need bit". If you want the One Line widget, then all you need to do is the
whole of Step 1. And respring.

For all widget types, find the line that says: "var stylesheetWall =
'oneLine' //'originalBubble'|'myopia'|'iconOnly'|'split'|'oneL ine'|"

FOR NUMBER 1

Do Part 1. Change where is says "var stylesheetWall = 'oneLine'" to "var stylesheetWall

= 'iconOnly'"

FOR NUMBER 2

Do Part 1. Change where is says "var stylesheetWall

= 'oneLine'" to "var stylesheetWall = 'myopia'"

FOR NUMBER 3

Do Part 1. Change where is says "var stylesheetWall

= 'oneLine'" to "var stylesheetWall = 'originalBubble'"

FOR NUMBER 4

Do Part 1. Change where is says "var stylesheetWall

= 'oneLine'" to "var stylesheetWall = 'split'"

CHANGING THE TEMPERATURE TO FAHRENHEIT

To change the temperature to Fahrenheit, you will

have to open the configureMe.js
Find the line that says "var isCelsius = true //true|false"

Change the bit where is says "var isCelsius = true" to " var isCelsius = false"
Save and respring. To change it back to Celsius, just do the opposite.
WEATHER WIDGET IN THE STATUS BAR

Well there is a slight problem with this, as its not part of the status bar at all. Itʼs under it.
So if you are using a theme with a full colored bar then you will be unable to see it.

Simply download the WeatherWidgetStatusBar.theme from the download above and

follow the steps to customize it.

Save files and respring to see the changes.

CHANGING THE COLOR

This works with every type of widget.

To change the color to whatever you want you will need to navigate to "/Library/Themes/
WeatherWidget.theme/Private/Stylesheets" and choose which version of the widget you
are using. If you are using Icon Only, this does not apply to you.

Open up the one you are using, and you shall see many lines.

#WeatherContainer{
float:right;
margin-top:-22px;
margin-right:48px;
color:white;
padding:5px 10px 5px 10px;
}

Find that text, which should be the first chunk of it.

Now where it says "color:white" that means that the text color is white. Change where it
says "white" to any color you want. Black, blue, red. Whatever its up to you.

Save the file and respring.

CHANGING THE COLOR

In a styleʼs css file (located in Private/Stylesheets), there will be a line that says the
following.

background-color: rgba(0,0,0,0);

The first 0 represents red, the second green, the third blue, and the last transparency.
0.1 will mean almost completely transparent and 1 means opaque.
the clock widget
To install the clock widget you will need the
following.

-The Clock Widget Theme

- An SSH client
- OpenSSH
-Winterboard

PUTTING IT ON YOUR iPOD

Open up your SSH client and navigate to "/Library/

Themes," and drop the "Analog Bluebird
Clock.theme" folder in there.

Now, you will have to select your skin. Go to

Private/Cool Clock/coolclock.js in the theme folder.
Double click to open it. About half way through the
file there is a section that says this:

CoolClock.config = {
clockTracker: {},
tickDelay: 18000,
longTickDelay: 15000,
defaultRadius: 85,
renderRadius: 70,
defaultSkin: "swissRail",
skins: {

There are 3 default skins: swissRail, chunkySwiss, and chunkySwissOnBlack. To

switch skins, simply replace swissRail in the section above with one of the other ones.
Youʼll also notice the moreskins.js. To import a skin from moreskins.js, first open the
file. Then youʼll see the following skins: swissRail, chunkySwiss, chunkySwissOnBlack,
fancy, machine, classic, modern, simple, securephp, Tes2, Lev, Sand, Sun, Tor, Cold,
Babosa, Tumb, Stone, and Disc.

To get a theme into the coolclock.js file, select the theme you want from the theme title
to }, or if itʼs the last one, };. Then copy it and paste it in the coolclock.js in between two
other themes if it has }, or at the end of the themes if it ends in a };. If you donʼt
understand this, it is probably best if you just use the default themes. Below is an
example of what a single theme looks like.
Stone: {
outerBorder: { lineWidth:15, radius:80, color: "#339933",
alpha: 0.5 },
smallIndicator: { lineWidth: 2, startAt: 70, endAt: 90,
color: "#FF3300", alpha: 0.7 },
largeIndicator: { lineWidth: 15, startAt: 0, endAt: 29,
color: "#FF6600", alpha: 0.3 },
hourHand: { lineWidth: 4, startAt: 0, endAt: 65, color:
"black", alpha: 1 },
minuteHand: { lineWidth: 3, startAt: 0, endAt: 75, color:
"black", alpha: 1 },
secondHand: { lineWidth: 1, startAt: 0, endAt: 85, color:
"black", alpha: 0.8 },
secondDecoration: { lineWidth: 5, startAt: 50, radius: 90,
fillColor: "black", color: "black", alpha: 0.05 }
},

Apply the theme in Winterboard, respring, and your clock widget should appear as the
fourth icon in your dock.

MOVING THE CLOCK WIDGET

Since the clock widget is automatically set to be the fourth dock icon, this can be a
problem with those with five icon docks, or stack users. To do this, you must open
Wallpaper.html and edit the following:

margin-top:405px;
margin-left:252px;

margin-top refers to how many pixels the top of the clock is away from the top of your
screen out of 480 pixels. margin-left refers to how many pixels the left side of the clock
is away from the left side of your screen, out of 320 pixels. If you add 60 pixels to the
number of pixels it is away from the top, you get how many pixels it is from the bottom.
If you add 60 pixels to the number of pixels it is away from the left, you get how many
pixels it is away from the right side of the screen.

Edit the number of pixels to move the clock around the screen. Respring each time you
make a change for it to show. This is going to take a lot of trial and error, but after
awhile you will get it. If you did not understand this section, moving the clock is
probably not for you.
both widgets
Since WinterBoard only allows one WebKit
element to be present on the SpringBoard
at a time, it is impossible to have two
themes with html to be using the
SpringBoard. Thus, the clock and weather
widgets will not work when applied
together. Thankfully, a solution has been
made by combining the themes together.

To the left is an image of the theme I am

using with both clock and weather widgets.

Customize the files as noted in the previous

tutorials, and it should all work out fine.

You can download the combined files here.

MORE ABOUT THE WIDGETS

Credit to Zetetic Apparatchik for the Weather Widget over at MacThemes forum, who
created this great widget. The release thread is here.

Credit to fasmx and Simon Baird for the Clock Widget over at MacThemes forum, who
created this great widget. The release thread is here.
tweaks
The following section is just a bunch of random tweaks Iʼve taken the time to compile.

mobilefinder tweak
THIS SECTION COURTESY OF COLLATERAL

MobileFinder (1.99$ in the App Store) can be used to see your media partition and
transfer files to and from it, but it cannot see your system partition and therefore it is not
very useful for people who jailbreak..

But, if you make its automatic directory a symlink to root, which is where it will start, you
can access the system partition. You can do it for any part of the iPod for that matter.

For example:
(the X's are the number that stands for the directory that Mobile Finder is in)

To find the directory MobileFinder is in, you can use the handy Terminal command to
find App Store applications. Here it is again if you forgot.

cd /var/mobile/Applications/
find ./ -name Finder

TO MAKE A SYMLINK TO /

ssh root@*IP ADDRESS HERE*

alpine
ln -s / /private/var/mobile/Applications/XXXXXXXX-
XXXX-XXXXX-XXXX-XXXXXXXXXXXX/Documents

TO MAKE A SYMLINK TO /APPLICATIONS

ssh root@*IP ADDRESS HERE*

alpine
ln -s /Applications /private/var/mobile/Applications/
XXXXXXXX-XXXX-XXXXX-XXXX-XXXXXXXXXXXX/Documents
combining music & video
Unbeknownst to some people, the Music and Video applications on the iPod touch are
actually one application called MobileMusicPlayer. This is the same application that is
on the iPhone and if you want to save some space on your home screen, a simple
replacement of MobileMusicPlayerʼs Info.plist will “merge” Music and Video. To do this,
simply go to Cydia and install a package called MobileMusicPlayer Flip. Upon going
back to the SpringBoard, your Music and Video have merged!
tips + tricks
1. If you're scrolling through a long document/page in Safari - if you tap the bar at the
top of your screen containing the time and battery, Safari will automatically scroll up to
the top of the document/page and the show address bar.

2. Turn off WiFi and SSH (using BossPrefs) to save battery power when not in use.

3. Double tapping the home button in any application, or with the screen off will bring up
the music controls.

4. Make sure to completely close apps when you are done with them to save battery
power. This is accomplished by pressing and holding the home button for approximately
five seconds. This boosts battery life big time if you run lots of different apps all the time.

5. Holding down letters on the keyboard will pop up the accents/symbols associated
with those letters. Once it pops up, slide your finger over to the accent/symbol you like.

6. Whilst in Mail's inbox view, sliding your finger from left to right on a message the
'delete' button will appear. This also applies in the list view of the Videos application.

7. In Safari double tap to zoom in. You can also "pinch" (putting your thumb and index
finger on the screen and pinching in and out) to zoom in Safari and in Pictures.

8. You can charge your iPod Touch from any powered USB port. Such as a computer,
printer, media centre. The device does not have to have iTunes installed to provide
power to your iPod Touch.

9. Need a spare cleaning cloth for your touch, or an extra cloth to rest your iPod touch
on while at work or school? Just go to your local vision care store (or pharmacy) and get
an eyeglass/sunglass "cleaning cloth". Cheap and works great!

10. When watching a video, tap once to bring up the onscreen controls. When you are
done watching a video make sure you press done so your progress will be saved.

11. When typing a lot of text in Safari turn it to horizontal view. The keyboard will be
bigger and you can get a better grip of the Touch while typing with two thumbs.

12. When typing if you want to add something from the numbers keyboard just hold
down the numbers and slide your finger to the number or symbol you want, and release.
It will take you back to your letters keyboard. This way you donʼt have to tap numbers,
tap your number, then tap numbers again to go back. This also applies for using the
'shift' key to apply capital letters.
13. When in Safari, if you are presented with a link, hold your finger over the link, and a
bubble will appear showing the URL that the link is tied to.

14. In Safari since you can't open links in a new windows, you can open a new page,
tap the bookmarks icon, tap the history folder and direct yourself to the last page you
were just on and tap the link from there.

15. When listening to an audiobook, iTunes and your iPod create a new chapter list
unrelated to the subject of the book. It's accessible using the same control used for
viewing audio tracks (upper right of screen).

17. Make a spelling mistake? Press and hold the word you spelt wrong and a
magnifying glass will appear. Slide your finger back and forth to move the cursor.

18. When you're on a website that has a frame or an iframe with scroll bars in it, use two
fingers on that frame to scroll that window and back to a single finger to scroll the whole
page.

19. When typing, if you press the space bar twice after a word it will insert a period and
another space.

20. Press the power and home buttons and the screen will flash white, resulting in a
screenshot being taken and stored in Photos.

21. Pressing and holding an image in Safari will allow you to save it in Photos.

22. While watching a video on the Youtube or Videos app, pause the video and press
and hold the >>I button to play the video in slow-motion (forwards).

23. Upon going into Calculator, turn it sideways for a handy scientific calculator.

24. When you hold the .com button on the keyboard, it provides new units like .edu
and .org.

25. Websites without an icon will just be a screenshot for webclips, for websites like this
zoom into an area of the site you would like the webclip icon to look like... ex. zoom into
the website logo and that will be the webclip icon.

26. If you pull the headphones out while music is playing, music will pause.
troubleshooting
OH NO! Did something go wrong? Donʼt worry, it can be fixed quite easily. Go through
this whole guide and see if your problem is answered. If it isnʼt, a best bet would be to
restore - which will be detailed as DFU mode below.

COMMON PROBLEMS

I GET AN ERROR WHEN TRYING TO RESTORE TO MY CUSTOM FIRMWARE!

Well this is because you arenʼt in DFU mode, youʼre in Restore mode! Hereʼs how to
get into DFU Mode.

• Attach the iPod to the computer

• Hold Power button
• Slide onscreen slide to turn the iPod off
• Hold the power and home buttons together for 10 seconds
• Release power but keep holding home until the computer beeps as the iPod
is recognized.
• At no point will the display come on. Now your restore should work.

PWNAGE TOOL DOESNʼT RECOGNIZE MY 2.x FIRMWARE!

Try downloading the firmware again from http://felixbruns.de/iPod/firmware and

from Firefox. I am not a Firefox user, but Firefox will download the firmware
correctly and not mess it up like Safari does. Internet Explorer is also not the
greatest for this, so please use Firefox.

JAILBREAKME.COM ISNʼT WORKING!

Check your firmware version by going into Settings, then General, then About. If
itʼs 1.1.1, you can use jailbreakme.com. If it is anything else, like 1.1.2, 1.1.3,
1.1.4, 2.0, 2.0.1, 2.0.2, 2.1 - you must use another jailbreaking method.
Jailbreakme.com only works on 1.1.1.

iTUNES SAYS MY MUSIC IS ON MY iPOD, BUT IT DOESNʼT SHOW UP!

Go to Settings, then General, and at the bottom press Reset All Settings. Hit
Reset all settings (NOT THE ONE THAT SAYS CONTENT) but all settings. Your
iPod should reboot and all of your music should be back in your Music
application.

MY iPOD WONʼT TURN ON!

First, make sure itʼs charged. Plug it into your computer and leave it for an hour
or two. If it is still nonresponsive, see if it shows up in iTunes. If it does, restore
it. If it doesnʼt, it may be time for a new iPod.
THEREʼS A SPINNING WHEEL THAT WONʼT GO AWAY!

First, leave it for a few seconds. Chances are, it could be a long respring. If it
doesnʼt go away after about 5 minutes, try force powering off. Hold the power
and home buttons simultaneously and release them when the Apple logo pops
up. If it gets stuck on the apple logo for 5 minutes - you may have to SSH in and
delete the last thing you installed and delete the N45AP.plist file in /System/
CoreServices/SpringBoard.app.

UM... IʼM STUPID AND HID POOF AND NOW I CANʼT UNHIDE MY APPS. HELP!

First, if you have Cydia or Installer unhidden - install BossPrefs. BossPrefs has a
hiding icons feature too. If you already have BossPrefs hidden, install Dock or
AppFlow. Both are application launchers that can launch Poof or BossPrefs to
unhide applications. I highly recommend using Dock because it isnʼt an
application that you can hide - it is a bar that is always on the bottom of your
screen that can launch any application.

Second, if Cydia is hidden but Settings isnʼt, go to General and reset all settings.
If that doesnʼt work - enable then disable restrictions (if youʼre on 2.0) in the
General menu.

Third, if all of your icons are hidden, you will need to SSH into your iPod and
delete a file called N45AP.plist in /System/CoreServices/SpringBoard.app/. That
will work. To prevent this from happening, install a package in Cydia called Dock.

MY iPOD IS STUCK ON THE APPLE LOGO!

Well, it actually might not be. 2.x firmwares take a long time to boot up. Give it 5
minutes, walk away, and come back. It just works like that sometimes.

If that is not the case, SSH into your iPod and go to /var/mobile. Rename
Applications to Applications2 and reboot. When your iPod boots, name it back to
Applications and then Sync with iTunes.
WHY ARE SOME OF MY ICONS NOT CHANGING WHEN I APPLY A THEME?

Some icons wont change when you download a theme, why? Well, the creator
will not have all the apps/games that they are making icons for. So they are
unable to test if they work. Thus them spelling the name wrong, thus the icon not
changing. You get me so far? So what you will need to do is edit the file name.

Here are some commonly misspelt names.

Winterboard- should be named WinterBoard.png

AppStore - should be named App Store.png.

WHY ARE MY APP SKINS ARE NOT WORKING?

Winterboard is sometimes buggy and doesnʼt apply the skins for some
applications, Calculator being the most famous example. This may not be the
case though. Itʼs possible that your theme is below another theme, not allowing
its skin to apply. For how to fix this, see the Winterboard section.
cool stuff
VNC SERVERS

VNC servers allow you to see the screens of

other devices, so you could see the screen of
your computer from your iPod and then move
around the mouse and type stuff.

While this is incredibly useful, it is also great

for making fun of people and tricking them.

VEENCY

Veency is by saurik and allows you to control

your iPod via a computer. Install Veency via
Cydia and reboot. Then, set up a VNC
connection on your computer to your iPodʼs IP
Address, via a VNC client like Chicken of the
VNC or TightVNC.

A box should pop up on your iPod asking if you would like to confirm the connection.
Tap yes. On your computer you can now control your iPod. Itʼs quite laggy, but very
cool. Have fun!

VNC

There are several VNC applications in the App Store - Mocha VNC, Mocha VNC Lite
(Free), Jaadu Click, and Jaadu VNC. I personally use Jaadu VNC for its slickness and
how fast it is. The other two are serviceable but Jaadu VNC is a bit pricy at $25.

In any case, hereʼs how to set it up. On a Mac, go to System Preferences, and click
Sharing. Then enable Screen Sharing. In Jaadu VNC, it will automatically connect. In
the other two, you must find your computerʼs IP address and enter it in.

On a PC, download TightVNC and enable it. Put your IP address in on your iPod,
unless it is Jaadu VNC, which will automatically detect your computer.
contact me
Need more help?

Need to suggest something for the iPod touch Userʼs Manual?

You can contact me at ipodtouchguidewriter@gmail.com for suggestions, help, contact,

etc. If you want to help me with writing more and possibly making videos, that would be
wonderful and you can contact me there too.

No I would not like some free Natural Male Enhancement, nor do I want c14L15 f0R
Fr3E1!1! so your exciting spamalicious emails will be shipped off to a little place I call
the Spam Folder.

Thank you for managing to read this far in the guide, and I hope that Iʼve kept it rather
interesting for you as well.

donations
This guide took a lot of research, a lot of time, and a lot of patience to write. If you
would like to help out, I accept any amount of donations via PayPal.

To donate, send any amount of money to spoonforknife@gmail.com for donations.

Thanks a bundle! Every penny counts, so even if you have 3 cents, I will take that as
generosity. Thank you for reading this guide.
need something hosted?
Send an email to Ste at STE Packaging, at ste@smxy.org and you can get something
hosted on Installer or Cydia. He is very friendly and even in Community Sources,
meaning his source is pre-installed on Cydia and Installer, so you get great distribution.

contributers
The following iPod touch Fans forum users have contributed to this guide.

• Manic Nimrod

• Kiks52

• jamil_d

• Collateral

• spoonforknife
(C) copyright 2008 spoonforknife. All Rights Reserved.