Archive:IOS FAQ: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 15: | Line 15: | ||
===Where can I get more help with XBMC on ATV2/iOS?=== | ===Where can I get more help with XBMC on ATV2/iOS?=== | ||
iOS-specific end-users [http://forum.xbmc.org/forumdisplay.php?f=137 forum] | :iOS-specific end-users [http://forum.xbmc.org/forumdisplay.php?f=137 forum] | ||
|- | |- | ||
| Line 21: | Line 21: | ||
===What platforms are supported today?=== | ===What platforms are supported today?=== | ||
Any version of iOS 4 and up that is jailbreakable. ATV2, iPad1, iPhone 3Gs and iPhone 3rd gen (not the 8GB model) and up are supported. | :Any version of iOS 4 and up that is jailbreakable. ATV2, iPad1, iPhone 3Gs and iPhone 3rd gen (not the 8GB model) and up are supported. | ||
|- | |- | ||
| Line 27: | Line 27: | ||
===What XBMC version is the iOS release?=== | ===What XBMC version is the iOS release?=== | ||
The current iOS version based on the 11.0 "Eden" version code. This is the same code that all of the other platform nightly versions are using. | :The current iOS version based on the 11.0 "Eden" version code. This is the same code that all of the other platform nightly versions are using. | ||
|- | |- | ||
| style="background:WhiteSmoke" | | | style="background:WhiteSmoke" | | ||
===Where are the | ===Where are the Userdata folder and logs?=== | ||
:''See [[HOW-TO Submit a Proper Bug Report|here]] for bug reporting details and [http://forum.xbmc.org/showthread.php?t=92480 here] and [[How-To:find and post XBMC.log for iOS|here]] for instructions on reporting an issue to the forums.'' | ::''See [[HOW-TO Submit a Proper Bug Report|here]] for bug reporting details and [http://forum.xbmc.org/showthread.php?t=92480 here] and [[How-To:find and post XBMC.log for iOS|here]] for instructions on reporting an issue to the forums.'' | ||
* | :*[[Userdata folder]]: <code>/private/var/mobile/Library/Preferences/XBMC/userdata/</code> | ||
*Debug log: <code>/private/var/mobile/Library/Preferences/xbmc.log</code> | :*[[Debug log]]: <code>/private/var/mobile/Library/Preferences/xbmc.log</code> | ||
*Syslog: <code>/var/log/syslog</code> | :*Syslog: <code>/var/log/syslog</code> | ||
*CrashReporter: <code>/var/logs/CrashReporter/*.plist</code> | :*CrashReporter: <code>/var/logs/CrashReporter/*.plist</code> | ||
|- | |- | ||
| Line 44: | Line 44: | ||
===What formats and resolutions will iOS devices play?=== | ===What formats and resolutions will iOS devices play?=== | ||
XBMC on iOS can playback all formats supported by XMBC. Only h.264 content is hardware accelerated (playback/decode up to 1080p video), so only HD content in h.264 will be smooth. The iPad2 is the only exception to this and will play ''some'' other HD codecs due to its faster CPU. | :XBMC on iOS can playback all formats supported by XMBC. Only h.264 content is hardware accelerated (playback/decode up to 1080p video), so only HD content in h.264 will be smooth. The iPad2 is the only exception to this and will play ''some'' other HD codecs due to its faster CPU. | ||
|- | |- | ||
| Line 50: | Line 50: | ||
===How can I backup my XBMC settings?=== | ===How can I backup my XBMC settings?=== | ||
The most common way is to copy or FTP this directory from the atv2 to another computer: /private/var/mobile/Library/Preferences/XBMC/userdata. Some recommend backing up the entire Preferences/XBMC directory. [http://forum.xbmc.org/showthread.php?t=92778] To restore, FTP the directory back to it's original location, then ssh to the atv2 and run the following command to reset ownership/permissions: | :The most common way is to copy or FTP this directory from the atv2 to another computer: /private/var/mobile/Library/Preferences/XBMC/userdata. Some recommend backing up the entire Preferences/XBMC directory. [http://forum.xbmc.org/showthread.php?t=92778] To restore, FTP the directory back to it's original location, then ssh to the atv2 and run the following command to reset ownership/permissions: | ||
:<pre>chown -R mobile:mobile /private/var/mobile/Library/Preferences/XBMC/userdata</pre> | ::<pre>chown -R mobile:mobile /private/var/mobile/Library/Preferences/XBMC/userdata</pre> | ||
|- | |- | ||
| Line 57: | Line 57: | ||
===Where can I find the version of XBMC that I'm running?=== | ===Where can I find the version of XBMC that I'm running?=== | ||
XBMC main menu > System > Lower submenu > System info. Note the build date. | :XBMC main menu > System > Lower submenu > System info. Note the build date. | ||
|} | |} | ||
| Line 67: | Line 67: | ||
===What are the Apple TV 2 specific requirements?=== | ===What are the Apple TV 2 specific requirements?=== | ||
A [http://forum.xbmc.org/showthread.php?t=99315 jailbroken] Apple TV 2 with one of the following software versions: | :A [http://forum.xbmc.org/showthread.php?t=99315 jailbroken] Apple TV 2 with one of the following software versions: | ||
* [http://forum.xbmc.org/showthread.php?t=105740 iOS 4.3 (Apple TV software 4.2)] | :* [http://forum.xbmc.org/showthread.php?t=105740 iOS 4.3 (Apple TV software 4.2)] | ||
* [http://www.iclarified.com/entry/index.php?enid=13581 iOS 4.2.1 (Apple TV software 4.1.1)] | :* [http://www.iclarified.com/entry/index.php?enid=13581 iOS 4.2.1 (Apple TV software 4.1.1)] | ||
* [http://www.iclarified.com/entry/index.php?enid=12380 iOS 4.1 (Apple TV software 4.0)]. | :* [http://www.iclarified.com/entry/index.php?enid=12380 iOS 4.1 (Apple TV software 4.0)]. | ||
Newer [http://en.wikipedia.org/wiki/IOS_version_history#Version_history:_Apple_TV_.28second_generation.29 versions] may also work but aren't officially supported. | :Newer [http://en.wikipedia.org/wiki/IOS_version_history#Version_history:_Apple_TV_.28second_generation.29 versions] may also work but aren't officially supported. | ||
|- | |- | ||
| Line 77: | Line 77: | ||
===What remotes work?=== | ===What remotes work?=== | ||
* The '''ATV2 remote''' works with XBMC and can be [[Keymap:Joystick.AppleRemote.xml|customized]] | :* The '''ATV2 remote''' works with XBMC and can be [[Keymap:Joystick.AppleRemote.xml|customized]] | ||
** General Apple remote functions can be found at [[Global Apple Remote]] | :** General Apple remote functions can be found at [[Global Apple Remote]] | ||
* '''Web interface''', including add-on interfaces | :* '''Web interface''', including add-on interfaces | ||
* Standard Android and iOS remote apps | :* Standard Android and iOS remote apps | ||
* '''Rowmote Pro''' (requires helper, see nitoTV) | :* '''Rowmote Pro''' (requires helper, see nitoTV) | ||
* '''Bluetooth''' keyboards can be used after BTstack is installed using either nitoTV or the command line. [http://forum.xbmc.org/showthread.php?t=92386] | :* '''Bluetooth''' keyboards can be used after BTstack is installed using either nitoTV or the command line. [http://forum.xbmc.org/showthread.php?t=92386] | ||
* '''Harmony''' Remotes have experimental support and you can teach the ATV2 to use most standard IR remotes via Settings > General > Remotes > Learn Remote. | :* '''Harmony''' Remotes have experimental support and you can teach the ATV2 to use most standard IR remotes via Settings > General > Remotes > Learn Remote. | ||
* The Apple iOS '''Remote app''' for iTunes/ATV | :* The Apple iOS '''Remote app''' for iTunes/ATV | ||
|- | |- | ||
| Line 90: | Line 90: | ||
===What happens to original Apple TV 2 software after the XBMC installation?=== | ===What happens to original Apple TV 2 software after the XBMC installation?=== | ||
XBMC is installed onto the Apple TV flashdrive, much like any iOS app, but you will still be able you use your Apple TV software as normal, XBMC will only be an extra option that you can launch from the Apple TV's original menu when you want to utilize the extra features and functions that are available in XBMC compared to the original Apple TV software. So XBMC will not replace the original Apple TV software, it instead complements the existing Apple TV software. | :XBMC is installed onto the Apple TV flashdrive, much like any iOS app, but you will still be able you use your Apple TV software as normal, XBMC will only be an extra option that you can launch from the Apple TV's original menu when you want to utilize the extra features and functions that are available in XBMC compared to the original Apple TV software. So XBMC will not replace the original Apple TV software, it instead complements the existing Apple TV software. | ||
|- | |- | ||
| Line 96: | Line 96: | ||
===What resolutions is the ATV2 capable of outputting?=== | ===What resolutions is the ATV2 capable of outputting?=== | ||
At present, though the ATV2 can decode 1080p video (using Apple's private VideoToolBox API for hardware-accelerated decoding), it is limited to 720p output. The 1080p video is decoded, then down-scaled in hardware to 720p. This is low on the priority list to "fix", as it may be a Frontrow limitation or a hardware limitation (ATV 2 has limited resources, i.e. 256MB RAM, etc). To see if you can really benefit with 1080p output, please consult this [http://hd.engadget.com/2006/12/09/1080p-charted-viewing-distance-to-screen-size/ chart] | :At present, though the ATV2 can decode 1080p video (using Apple's private VideoToolBox API for hardware-accelerated decoding), it is limited to 720p output. The 1080p video is decoded, then down-scaled in hardware to 720p. This is low on the priority list to "fix", as it may be a Frontrow limitation or a hardware limitation (ATV 2 has limited resources, i.e. 256MB RAM, etc). To see if you can really benefit with 1080p output, please consult this [http://hd.engadget.com/2006/12/09/1080p-charted-viewing-distance-to-screen-size/ chart] | ||
|- | |- | ||
| Line 102: | Line 102: | ||
===Can I hook up my external harddrive or other USB device to the ATV2?=== | ===Can I hook up my external harddrive or other USB device to the ATV2?=== | ||
Unfortunately, the ATV2 can not operate as a USB host, so hooking an external drive or any other USB device to it will not work. Only media physically on the ATV2 and media hosted on the network will be available. | :Unfortunately, the ATV2 can not operate as a USB host, so hooking an external drive or any other USB device to it will not work. Only media physically on the ATV2 and media hosted on the network will be available. | ||
|- | |- | ||
| Line 108: | Line 108: | ||
===How do I set the time zone on ATV2?=== | ===How do I set the time zone on ATV2?=== | ||
iOS 4.3 offers the ability to set the Time Zone via the Apple TV gui, under Settings > General > Time Zone. | :iOS 4.3 offers the ability to set the Time Zone via the Apple TV gui, under Settings > General > Time Zone. | ||
On previous iOS versions it has to be done via command line. [http://forum.xbmc.org/showthread.php?t=92492&highlight=timezone] | :On previous iOS versions it has to be done via command line. [http://forum.xbmc.org/showthread.php?t=92492&highlight=timezone] | ||
::<pre>cd /var/db/timezone ; rm localtime | |||
ln -s /usr/share/zoneinfo/[Country or Region]/[Zone Name] localtime (e.g. "ln -s /usr/share/zoneinfo/Canada/Eastern localtime") | ln -s /usr/share/zoneinfo/[Country or Region]/[Zone Name] localtime (e.g. "ln -s /usr/share/zoneinfo/Canada/Eastern localtime")</pre> | ||
|- | |- | ||
| Line 118: | Line 118: | ||
===How do I stop the ATV from checking for updates and crashing XBMC?=== | ===How do I stop the ATV from checking for updates and crashing XBMC?=== | ||
Install updatebegone via nitoTV or ssh (i.e. "apt-get install com.nito.updatebegone"). This has fixed the issue in many cases but if it doesn't, first make sure your packages are current ("apt-get update && apt-get upgrade" and reboot), and if the issue is still there, add these lines to your /etc/hosts file: [http://forum.xbmc.org/showpost.php?p=748981&postcount=1] | :Install updatebegone via nitoTV or ssh (i.e. "apt-get install com.nito.updatebegone"). This has fixed the issue in many cases but if it doesn't, first make sure your packages are current ("apt-get update && apt-get upgrade" and reboot), and if the issue is still there, add these lines to your /etc/hosts file: [http://forum.xbmc.org/showpost.php?p=748981&postcount=1] | ||
::<pre> echo "127.0.0.1 appldnld.apple.com" >> /etc/hosts | |||
echo "127.0.0.1 mesu.apple.com" >> /etc/hosts | echo "127.0.0.1 mesu.apple.com" >> /etc/hosts | ||
echo "127.0.0.1 appldnld.apple.com.edgesuite.net" >> /etc/hosts | echo "127.0.0.1 appldnld.apple.com.edgesuite.net" >> /etc/hosts</pre> | ||
|- | |- | ||
| Line 127: | Line 127: | ||
===Where can I find the version of iOS that I'm running?=== | ===Where can I find the version of iOS that I'm running?=== | ||
Apple TV main menu > Settings > General > About > click Select to toggle between Apple TV software version and iOS build version. Apple TV software is the application running on top of iOS similar to how FrontRow runs on MacOS. It's similar versions are easily confused with the [http://en.wikipedia.org/wiki/IOS_version_history#Version_history:_Apple_TV iOS versions]. More info on the Apple TV software versions is available [http://support.apple.com/kb/HT4448 here]. | :Apple TV main menu > Settings > General > About > click Select to toggle between Apple TV software version and iOS build version. Apple TV software is the application running on top of iOS similar to how FrontRow runs on MacOS. It's similar versions are easily confused with the [http://en.wikipedia.org/wiki/IOS_version_history#Version_history:_Apple_TV iOS versions]. More info on the Apple TV software versions is available [http://support.apple.com/kb/HT4448 here]. | ||
|} | |} | ||
| Line 137: | Line 137: | ||
===What remotes work?=== | ===What remotes work?=== | ||
* Direct '''touch screen''' input | :* Direct '''touch screen''' input | ||
* '''Web interface''', including add-on interfaces | :* '''Web interface''', including add-on interfaces | ||
* Standard Android and iOS remote Apps | :* Standard Android and iOS remote Apps | ||
* The Apple iOS '''Remote app''' for iTunes/ATV | :* The Apple iOS '''Remote app''' for iTunes/ATV | ||
|- | |- | ||
| style="background:WhiteSmoke" | | | style="background:WhiteSmoke" | | ||
===Touch screen controls=== | ===Touch screen controls=== | ||
*'''Context menu:''' Two finger single tap the menu item. | :*'''Context menu:''' Two finger single tap the menu item. | ||
*'''Slide out menus:''' Hold the menu item to bring it up, then swipe right to access the sub content. | :*'''Slide out menus:''' Hold the menu item to bring it up, then swipe right to access the sub content. | ||
|- | |- | ||
| Line 152: | Line 152: | ||
===What is a good touch screen skin for iPad?=== | ===What is a good touch screen skin for iPad?=== | ||
[http://forum.xbmc.org/showthread.php?t=107831 Touched], by Jezz X. It's pretty good on the smaller screen iPhone and iPod touch as well. | :[http://forum.xbmc.org/showthread.php?t=107831 Touched], by Jezz X. It's pretty good on the smaller screen iPhone and iPod touch as well. | ||
|} | |} | ||
| Line 162: | Line 162: | ||
===Why are settings or sources not stored and updates are failing?=== | ===Why are settings or sources not stored and updates are failing?=== | ||
This can happen when the setting xml files are manipulated outside XBMC. Connect to your iPad/ATV2 as root using an ssh client and repair file permissions. | :This can happen when the setting xml files are manipulated outside XBMC. Connect to your iPad/ATV2 as root using an ssh client and repair file permissions. | ||
Run the following command on the iPad/ATV2: | :Run the following command on the iPad/ATV2: | ||
:<pre>chown -R mobile:mobile /private/var/mobile/Library/Preferences/XBMC/userdata</pre> | ::<pre>chown -R mobile:mobile /private/var/mobile/Library/Preferences/XBMC/userdata</pre> | ||
|- | |- | ||
| Line 172: | Line 172: | ||
===I changed skins on the iPad or other touch device and now I can't navigate back to change them... help!=== | ===I changed skins on the iPad or other touch device and now I can't navigate back to change them... help!=== | ||
Delete <code>/private/var/mobile/Library/Preferences/XBMC/userdata/guisettings.xml</code> | :Delete <code>/private/var/mobile/Library/Preferences/XBMC/userdata/guisettings.xml</code> | ||
|- | |- | ||
| Line 178: | Line 178: | ||
===Why are there no navigational sounds in XBMC's menus?=== | ===Why are there no navigational sounds in XBMC's menus?=== | ||
This is a known issue and will be fixed with the new audio engine (developed behind the scenes..). | :This is a known issue and will be fixed with the new audio engine (developed behind the scenes..). | ||
|} | |} | ||
Revision as of 10:01, 13 September 2011
Template:XBMC faq toc Inline XBMC for iOS specific Frequently Asked Questions and Answers
How to install XBMC for iOS?
Install XBMC on Apple TV 2 (black)
Install XBMC on iPad, iPhone, iPod touch
General FAQ
Where can I get more help with XBMC on ATV2/iOS?
|
What platforms are supported today?
|
What XBMC version is the iOS release?
|
Where are the Userdata folder and logs?
|
What formats and resolutions will iOS devices play?
|
How can I backup my XBMC settings?
|
Where can I find the version of XBMC that I'm running?
|
Apple TV 2 (black)
What are the Apple TV 2 specific requirements?
|
What remotes work?
|
What happens to original Apple TV 2 software after the XBMC installation?
|
What resolutions is the ATV2 capable of outputting?
|
Can I hook up my external harddrive or other USB device to the ATV2?
|
How do I set the time zone on ATV2?
|
How do I stop the ATV from checking for updates and crashing XBMC?
echo "127.0.0.1 mesu.apple.com" >> /etc/hostsecho "127.0.0.1 appldnld.apple.com.edgesuite.net" >> /etc/hosts |
Where can I find the version of iOS that I'm running?
|
Touch screen iOS devices
What remotes work?
|
Touch screen controls
|
What is a good touch screen skin for iPad?
|
Basic troubleshooting
Why are settings or sources not stored and updates are failing?
|
|
|