HOW-TO:Install XBMC on iPad/iPhone/iPod touch

iOS: FAQ ★ ATV (black) ★ Installing XBMC for ATV2 ★ Installing XBMC for iDevice ★ Install 3rd party add-ons ★ XBMC.log

The current stable release of XBMC for iOS is v12 Frodo.

Requirements

• To install XBMC for iOS you must have a jailbroken iDevice running iOS 4.0 through 6.1.
• For hardware: iPad (1,2,3,4), iPad Mini, iPhone (3GS*, 4, 4S, 5) iPod touch (3-16GB*, 3-32GB*, 4, 5). *iPhone 3GS/iPod touch 3 might work still, but iPhone 4/iPod touch 4 and higher is recommended.
• If you have any issues, be sure to read the iOS FAQ!

Contents 1 Installing from Cydia 2 Updating 3 Development builds 3.1 Nightly builds 3.2 Monthly builds 3.3 Installing from the iOS GUI 4 Uninstalling 4.1 Uninstalling just XBMC 4.2 Removing settings

1 Installing from Cydia

• 

  Step 1: Tap the Cydia icon on your homescreen.

• 

  Step 2-iPhone: Manage - > Sources -> Edit -> Add
  Step 2-iPad: Sources -> Edit -> Add
  Step 3: Type in  http://mirrors.xbmc.org/apt/ios/ 

• 

  Step 4: Tap on the teamXBMC source.

• 

  Step 5: Tap on the XBMC-iOS icon.

• 

  Step 6: Tap install, then confirm.

• 

  Step 7: Let it install, then exit Cydia. You should now have a new XBMC icon on your screen.

And you're done! You should now be running XBMC v12 Frodo for iOS. See here to verify your XBMC version.

2 Updating

Updates for stable releases of XBMC are handled by Cydia and will show up in the "Changes" section when available.

3 Development builds

3.1 Nightly builds

Nightly builds are unstable test builds that have the latest bug fixes and feature additions. They are not fully tested, so anticipate issues and be sure to backup your userdata folder.

Installing from the command line

Change history: trac timeline or commit history

NOTE: You MUST install the stable version before you can install a nightly build. You only need to install the stable version once and you don't need to uninstall previous versions to upgrade (or downgrade) XBMC.

1. Open http://mirrors.xbmc.org/nightlies/darwin/ios/ in a web browser and copy the url of the most recent file in that listing.

   EXAMPLE: http://mirrors.xbmc.org/nightlies/darwin/ios/xbmc-20111202-6729214-master-ios.deb

2. Open up your terminal/ssh application and enter the following commands:

   ssh root@YOUR.iDEVICE.IP.ADDRESS

   EXAMPLE: ssh root@192.168.1.5

3. You will be asked for a password: default password is alpine
4. Continue to enter the following commands:

   rm -f *xbmc*.deb

   curl -O -L URL-FROM-STEP-1-HERE

   EXAMPLE: curl -O -L http://mirrors.xbmc.org/nightlies/darwin/ios/xbmc-20111202-6729214-master-ios.deb

   dpkg -i *xbmc*.deb

   rm *xbmc*.deb

And you're done! You should now have the latest nightly build of XBMC for iOS. See here to verify your XBMC version.

3.2 Monthly builds

To install a semi-stable monthly build, follow the nightly build instructions above, but replace the url in step 1 with http://mirrors.xbmc.org/snapshots/darwin/ios/

3.3 Installing from the iOS GUI

Opening a downloaded deb file (from Safari, for example) using iFile from Cydia, will also allow for installation.

4 Uninstalling

4.1 Uninstalling just XBMC

• 

  Step 1: Tap the Cydia icon on your homescreen.

• 

  Step 2: Tap Manage from the bottom of the Cydia menu and then tap Packages

• 

  Step 3: Find and tap XBMC-iOS in the list of installed packages.

• 

  Step 4: Tap on Modify in the top right and then choose Remove from the pop up menu.
  Step 5: Let XBMC uninstall and then press Return to Cydia.

You're all done. XBMC will now be uninstalled from your iDevice. If you want you can also uninstall XBMC-IconPack using the same method.

4.2 Removing settings

XBMC will uninstall from your iDevice but will leave certain things (databases and everything in your userdata folder) behind to make it easier if you wanted to reinstall. To delete those:

From the terminal, run

rm -Rf /private/var/mobile/Library/Preferences/XBMC/

Or

From iFile

Delete /private/var/mobile/Library/Preferences/XBMC/