2011-08-26, 19:11
Welcome to the Installation / FAQ / Workarounds thread. This thread aims to provide you with information for XBMC on iOS that is commonly requested, or is particularly important to this platform.
IMPORTANT!!: This thread is *NOT* for troubleshooting. The aim of this thread is to be informative. It is not for discussion of problems with installation or any other issues. The thread will be left open for constructive suggestions such as suggested FAQs to add to the list (ideally with solutions and/or links please). Again; please do not use this thread for troubleshooting!
Installation | FAQ | Workarounds/Guides
----------------------------------------------
Installation
IMPORTANT!!: This thread is *NOT* for troubleshooting. The aim of this thread is to be informative. It is not for discussion of problems with installation or any other issues. The thread will be left open for constructive suggestions such as suggested FAQs to add to the list (ideally with solutions and/or links please). Again; please do not use this thread for troubleshooting!
Installation | FAQ | Workarounds/Guides
----------------------------------------------
Installation
Jailbreaking
This is not a jailbreak forum, and discussion on this topic here is not permitted. All jailbreak posts on this forum will be moved/deleted, and repeat offenders will be warned and banned if it continues. However, jailbreaking is an essential step that must be performed before you install XBMC. There is a Jailbreak FAQ which is updated regularly that should answer most questions on the subject.
For ALL BUILDS you will be testing it. Proper bug reports, in the relevant thread (not this one!), are appreciated and help improve XBMC. However, do understand that [b]you use this version at your own risk. Please do not whine and moan if it is not working properly![/b]
Installing the XBMC Cydia repo version
current version: 10.0-9, released 23-June-2011
XBMC for iOS is a work-in-progress. As such there is no truely stable, or bug-free version of the software available on this OS. The repo version is the last packaged version for installation via Cydia/NitoTV. It's issues are well documented. Please note that the latest repo version is a selected nightly build so there are likely to be compatibility issues with skins and addons intended for use with Dharma versions of XBMC.
There are a couple of ways to install the repo version, the methods for these are better explained elsewhere. Please follow the relevant link for more information:
If you are installing onto an AppleTV2 you can
- Install via NitoTV [Guide on iPhoneBlogr.com], or
- Install via SSH [Guide on XBMC wiki]
Installing the XBMC nightly build
The nightly build of XBMC is, as the name implies, updated nightly! It is made up from the very latest code in the XBMC project. This code has not been tested. As such, it should be expected that the software will be buggy, and may even suffer from damage to core functionality.
A list of nightly builds (including the most recent) can be found here: [ATV2] [iPad/iPhone/iPod touch]
The most recent build is at the top of the list
As this version is constantly progressing a comprehensive list of issues is difficult to track. You can find a list of what issues are known in this version here.
installation and upgrade:
Note on iOS 4.3: (yes, this applies again)
- DO NOT UPDATE.
- iOS 4.3 update - This will crash XBMC, unless you block hosts: http://forum.xbmc.org/showthread.php?tid=106747 and/or install updatebegone from NitoTV.
INSTRUCTIONS for ATV2 and iOS devices
Automated nightly builds are now being provided by XBMC.org. Instuctions for installation can be found on the wiki via the following links:
ATV2 installation guide
iPad/iPhone/iPod touch installation guide
Full Commitlog/Changelog:
https://github.com/xbmc/xbmc/commits
Downgrading to a previous version
If you wish to downgrade to a previous version, then SSH into your iOS device and type:
- apt-get remove org.xbmc.xbmc-atv2
- wget <URL_of_deb_file>
- dpkg -i <name_of_deb_file>
- rm <name_of_deb_file>
Be sure to exchange the bits in blue for the relevant information
The previous repo versions can be found here: [ATV2] [iPad/iPhone/iPod touch]
The previous nightlies can be found here: [ATV2] [iPad/iPhone/iPod touch]
Checking which version you are using
If you want to know what version you are currently using you can find the version and build date under System info. Where this is located may vary depending on what skin you are using. In the default skin (Confluence) you can find this by scrolling to "SYSTEM" on the main menu, and selecting "System info" from the sub-menu that appears.
A note on backing up your settings
You may wish to back up your settings, add-ons, and library entries. This may be useful if you need to remove XBMC from your device, or re-jailbreak it.
To back up your userdata, simply make a copy of your userdata folder onto another device.
The location of your userdata folder is:
/User/Library/Preferences/XBMC/userdata
Access this folder via SSH, or through a sFTP client such as Filezilla or Cyberduck (see FAQ for more info)
To restore, transfer the directory back to it's original location, and overwrite what is already there.
link to old FAQ/info/issues thread: http://forum.xbmc.org/showthread.php?tid=91581