1. You will need to have a jailbroke iPhone or iPod Touch in order to SSH into your iPhone or iPod Touch. For more information on Jailbreaking, please see our F.A.Q. Page.

2. When you jailbreak your iPhone/iPod Touch, the Cydia application will be added to your SpringBoard with the rest of your applications. You will want to go into Cydia and search for the OpenSSH application. If it is not already installed, you will need to install it.

3. Then you will need some type of SSH client installed on your computer. WinSCP is great for PCs. Macs come with openssh but if you’d like some alternatives check here.

4. To sign into the iPhone, the Host Name is the iPhone’s IP address which you can find by going into your Settings application on your iPhone (or iPod Touch) and then into the Wi-fi option, click on the little arrow next to the Wi-Fi you are connected to and find the IP address. The username is root and password is alpine (no capitals). Don’t worry about the Private key file, you don’t need to put anything there.

5. On an iPhone 3GS, you will need to change the File Protocol to SCP. The default is most likely SFTP. Just select the arrow next to the option and select SCP.

6. Hit login.

Helpful Hints:
- The first time you connect it takes longer than usual, about 30 full seconds.
- Your iPhone must stay turned on, so disable autolock
- Your iPhone and computer must be on the same network, ssh connects via wifi on the iPhone.

Note: I also updated our OpenSSH page making it relevant for both 2.x firmware and 1.1.4 and below firmware.

If a theme is not available through Cydia, you will have to add it manually yourself. You will need to have a jailbroke iPhone or iPod Touch in order to change the theme on your iPhone or iPod Touch. For more information on Jailbreaking, please see our F.A.Q. Page.

When you jailbreak your iPhone/iPod Touch, the Cydia application will be added to your SpringBoard with the rest of your applications. You will want to go into Cydia and search for the OpenSSH application. If it is not already installed, you will need to install it.

You will then need to install WinSCP on your PC. Macs come with openssh but if you’d like some alternatives check here. To connect to WinSCP you will need to go into your Settings application on your iPhone and then into the Wi-fi option, click on the little arrow next to the Wi-Fi you are connected to and get the ip address. Now open WinSCP on your computer….the Host Name is your ip address (with the periods) the user name is root and the password is alpine. Don’t worry about the Private key file, you don’t need to put anything there. Hit login.

Once WinSCP opens, you will see all the files on your iPhone/iPod Touch and the file structure. Themes are located in the Library/Themes folder. Once you are in that folder you will see all the themes that are on your iPhone. This is where you will want to add your new themes.

If you are creating a theme – Create a folder somewhere on your computer that is the title of the theme you would like to add (ex…Chalkwork) then inside of the Chalkwork folder create another folder called Icons (with a capital “I”). Inside the Icons folder put all of the icon images that you would like to have. They must be named the same as the Title of the app, starting with a capital (Ex…Calendar.png, WinterBoard.png, AppStore.pgn, Stocks.png….). You can also add a Dock and Wallpaper to the Chalkwork folder, they also need to be capitalized (do not put them in the Icons folder…just in the main Chalkwork folder). Once you have a folder of the theme with a folder of icons inside it you just drag the whole folder, Chalkwork, into the Library/Themes folder on your iPhone or iPod Touch via WinSCP and hit Copy. Once it is done transferring you can go on your iPhone into WinterBoard and select the theme you just added. Note: your iPhone has to be on for the file to transfer!

If you are downloading a theme that is in a zip file – you will have to open the zip file and then create a folder on your computer that is the same name as the theme you are trying to download. Then copy the Icons folder from the zip file into the folder you created on your computer. This unzips the file so that you can add it to WinterBoard through WinSCP. You can also copy the wallpaper and dock out of the zip file into the file you created if you would like them too. If you are looking for some themes to download, check out our Downloadable Themes page.

If you have any further questions, you can email help@appleiphoneschool.com
If you would like to add information about this process please use the comments!! Thanks!