Archive:IOS FAQ: Difference between revisions
Jump to navigation
Jump to search
m (Bot: Automated text replacement (- XBMC + {{name}} )) |
m (Robot: Substituting template: Name) |
||
Line 13: | Line 13: | ||
{{FAQ|1=Install|2=Update|3=Installing | {{FAQ|1=Install|2=Update|3=Installing | ||
| BGcolor= | | BGcolor= | ||
| Question= Installing and updating | | Question= Installing and updating XBMC for iOS | ||
| Answer= | | Answer= | ||
* '''[[HOW-TO:Install | * '''[[HOW-TO:Install XBMC on Apple TV 2|Install XBMC on Apple TV 2 (black)]]''' (see [[#ATV2_requirements|requirements]]) | ||
* '''[[HOW-TO:Install | * '''[[HOW-TO:Install XBMC on iPad/iPhone/iPod touch|Install XBMC on iPad, iPhone, iPod touch]]''' (see [[#iDevice_requirements|requirements]]) | ||
}} | }} | ||
Line 24: | Line 24: | ||
| Question= SSH | | Question= SSH | ||
| Answer= | | Answer= | ||
* [[SSH|Secure Shell (SSH)]] is used to send remote commands to the ATV2. You will need this for many | * [[SSH|Secure Shell (SSH)]] is used to send remote commands to the ATV2. You will need this for many XBMC related tasks detailed on this page. For SSH access you can use [http://www.chiark.greenend.org.uk/~sgtatham/putty/ putty] or [http://www.bitvise.com/tunnelier.html Tunnelier] on Windows, Terminal.app in Mac OS X, or any standard terminal/shell in Linux. | ||
* To SSH into an iOS device open your SSH application and type in: | * To SSH into an iOS device open your SSH application and type in: | ||
:<pre>ssh [email protected]</pre> | :<pre>ssh [email protected]</pre> | ||
* For most things you can and should use "mobile" as the user, as shown above. For some tasks, such as upgrading | * For most things you can and should use "mobile" as the user, as shown above. For some tasks, such as upgrading XBMC itself, you will need to replace "mobile" with "root". | ||
* The default password (for "mobile" or "root") will be ''alpine'' | * The default password (for "mobile" or "root") will be ''alpine'' | ||
}} | }} | ||
Line 33: | Line 33: | ||
{{FAQ|1=Release_version|2=Version | {{FAQ|1=Release_version|2=Version | ||
| BGcolor= | | BGcolor= | ||
| Question= Is | | Question= Is XBMC for iOS different from normal XBMC? | ||
| Answer= | | Answer= | ||
* The current stable version of | * The current stable version of XBMC for iOS is {{Current version}}. This is the same code that all of the other platforms (Linux, Mac, Windows) are using.}} | ||
{{FAQ|1=Current_build|2=XBMC_Version | {{FAQ|1=Current_build|2=XBMC_Version | ||
| BGcolor= WhiteSmoke | | BGcolor= WhiteSmoke | ||
| Question= How do I find out what version of | | Question= How do I find out what version of XBMC am I running? | ||
| Answer= | | Answer= | ||
* | * XBMC main menu > System > Lower submenu > System info. '''Note the build date.''' | ||
}} | }} | ||
Line 48: | Line 48: | ||
| Question= Formats and resolutions iOS devices can playback | | Question= Formats and resolutions iOS devices can playback | ||
| Answer= | | Answer= | ||
* | * XBMC on iOS can playback all formats supported by XMBC in standard definition. | ||
* H.264 (up to High Profile) encoded videos that are not interlaced are supported for high definition (720P and up) using hardware video decoding. | * H.264 (up to High Profile) encoded videos that are not interlaced are supported for high definition (720P and up) using hardware video decoding. | ||
** The iPad 2 and iPhone 4S ''(and possibly the [[ATV3]] once jailbroken)'' are the only exceptions to this and will play ''some'' other HD codecs due to the more powerful CPU inside using software video decoding. | ** The iPad 2 and iPhone 4S ''(and possibly the [[ATV3]] once jailbroken)'' are the only exceptions to this and will play ''some'' other HD codecs due to the more powerful CPU inside using software video decoding. | ||
Line 67: | Line 67: | ||
| Question= Add-ons and skins | | Question= Add-ons and skins | ||
| Answer= | | Answer= | ||
* | * XBMC for iOS is a full version of XBMC and will be able to use all non-platform specific [[add-ons]] and [[skins]]. More feature rich (CPU demanding) skins like AEON MQ 3 might not run smoothly, but most skins should be fine. | ||
}} | }} | ||
Line 82: | Line 82: | ||
| Answer= | | Answer= | ||
* The most common way is to copy the [[userdata folder]] (via [[#FileTransfer|SFTP]]) (not to be confused with FTP) from the iOS device to another computer: | * The most common way is to copy the [[userdata folder]] (via [[#FileTransfer|SFTP]]) (not to be confused with FTP) from the iOS device to another computer: | ||
:<code> /private/var/mobile/Library/Preferences/XBMC/ </code> for all of your | :<code> /private/var/mobile/Library/Preferences/XBMC/ </code> for all of your XBMC data, add-ons, skins, etc, or just <br /> | ||
:<code> /private/var/mobile/Library/Preferences/XBMC/userdata/ </code> for just the settings files themselves (which takes up less space, but means you would have to re-download add-ons, etc). ([[Forum:92778]]). | :<code> /private/var/mobile/Library/Preferences/XBMC/userdata/ </code> for just the settings files themselves (which takes up less space, but means you would have to re-download add-ons, etc). ([[Forum:92778]]). | ||
* To restore, SFTP the directory back to its original location, then [[#SSH|SSH]] to the ATV2 and run the following command to reset ownership/permissions: | * To restore, SFTP the directory back to its original location, then [[#SSH|SSH]] to the ATV2 and run the following command to reset ownership/permissions: | ||
<pre>chown -R mobile:mobile /private/var/mobile/Library/Preferences/XBMC/</pre> | <pre>chown -R mobile:mobile /private/var/mobile/Library/Preferences/XBMC/</pre> | ||
* A new add-on has been created for easily backing up and restoring | * A new add-on has been created for easily backing up and restoring XBMC settings on any platform: [[Add-on:XBMC Backup]] | ||
}} | }} | ||
Line 124: | Line 124: | ||
| Question= Remotes for ATV2 | | Question= Remotes for ATV2 | ||
| Answer= | | Answer= | ||
* The '''ATV2 remote''' works with | * The '''ATV2 remote''' works with XBMC and can be customized. See: [[Joystick.AppleRemote.xml for ATV2]] for a custom setting that uses up/down for longer FF/RW jumping. | ||
** '''How do I bring up the context menu?''' - Press and hold MENU | ** '''How do I bring up the context menu?''' - Press and hold MENU | ||
** '''How do I bring up the OSD during playback?''' - Press and hold SELECT | ** '''How do I bring up the OSD during playback?''' - Press and hold SELECT | ||
** '''Changing the volume''' - Up and down while in full screen playback. | ** '''Changing the volume''' - Up and down while in full screen playback. | ||
* The ATV2 can also learn remotes in its native settings. | * The ATV2 can also learn remotes in its native settings. XBMC will respond to these learned remotes. See [http://support.apple.com/kb/HT3296 here] for instructions. | ||
* '''[[Web interface]]''', including add-on interfaces | * '''[[Web interface]]''', including add-on interfaces | ||
* | * XBMC '''[[:Category:Smartphone and tablet remotes|smartphone and tablet remote apps]]'''. | ||
* '''Bluetooth''' keyboards can be used since ATV software v5.2 or with earlier versions using BTstack. See [[forum:92386|this forum post]] for more info. | * '''Bluetooth''' keyboards can be used since ATV software v5.2 or with earlier versions using BTstack. See [[forum:92386|this forum post]] for more info. | ||
* '''Harmony''' Remotes have experimental support and you can teach the ATV2 to use most standard IR remotes via {{highlight|Settings -> General -> Remotes -> Learn Remote}}. You can get additional functions by following [http://forum.xbmc.org/showthread.php?p=738485#post738485 these instructions]. | * '''Harmony''' Remotes have experimental support and you can teach the ATV2 to use most standard IR remotes via {{highlight|Settings -> General -> Remotes -> Learn Remote}}. You can get additional functions by following [http://forum.xbmc.org/showthread.php?p=738485#post738485 these instructions]. | ||
Line 154: | Line 154: | ||
| Question= Sleep/Shutdown | | Question= Sleep/Shutdown | ||
| Answer= | | Answer= | ||
* | * XBMC will disable any sleep timer (if set) in ATV iOS since the sleep timer will cause XBMC to crash. When XBMC quits it will turn the sleep timer back on to whatever it was set at before. | ||
* The Apple TV 2 does not have a real "sleep" or shutdown function. Even under the native Apple software, the unit is always powered on, and only fakes sleeping. There is no way to sleep or shutdown the Apple TV 2 without physically pulling the power. | * The Apple TV 2 does not have a real "sleep" or shutdown function. Even under the native Apple software, the unit is always powered on, and only fakes sleeping. There is no way to sleep or shutdown the Apple TV 2 without physically pulling the power. | ||
* Given that the ATV2 uses only a few watts of power, the cost of running the unit 24/7 for a whole year is only a few dollars. Leaving it on does not damage the unit. | * Given that the ATV2 uses only a few watts of power, the cost of running the unit 24/7 for a whole year is only a few dollars. Leaving it on does not damage the unit. | ||
Line 168: | Line 168: | ||
{{FAQ|1=ATV2Software | {{FAQ|1=ATV2Software | ||
| BGcolor= WhiteSmoke | | BGcolor= WhiteSmoke | ||
| Question= Native ATV2 software after | | Question= Native ATV2 software after XBMC installation | ||
| Answer= | | Answer= | ||
* | * XBMC is installed onto the Apple TV internal 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 177: | Line 177: | ||
| Question= Software updates from Apple will crash XBMC | | Question= Software updates from Apple will crash XBMC | ||
| Answer= | | Answer= | ||
* When you install | * When you install XBMC it will install a dependancy with it that will block the updates to Apple's iOS software so nothing else is needed. | ||
}} | }} | ||
Line 216: | Line 216: | ||
* Direct '''touch screen''' input | * Direct '''touch screen''' input | ||
* '''[[Web interface]]''', including add-on interfaces | * '''[[Web interface]]''', including add-on interfaces | ||
* | * XBMC '''[[:Category:Smartphone and tablet remotes|smartphone and tablet remote apps]]'''. | ||
* Bluetooth keyboards can be used for navigation and playback, in addition to text entry. | * Bluetooth keyboards can be used for navigation and playback, in addition to text entry. | ||
* Headphone remote control of Apple headphones or on bluetooth headphones can control play/pause and next/previous item (playlist or auto play next). | * Headphone remote control of Apple headphones or on bluetooth headphones can control play/pause and next/previous item (playlist or auto play next). | ||
Line 228: | Line 228: | ||
* Retina and widescreen is fully supported on iPhone 4, 4S, 5, 5c, 5S and iPod touch 4, 5. | * Retina and widescreen is fully supported on iPhone 4, 4S, 5, 5c, 5S and iPod touch 4, 5. | ||
* Retina GUI is supported for iPad 3, 4, iPad Air, and iPad mini 2 (Retina) but video playback is still clamped to 720, pending some issues. | * Retina GUI is supported for iPad 3, 4, iPad Air, and iPad mini 2 (Retina) but video playback is still clamped to 720, pending some issues. | ||
* '''Native video out as of | * '''Native video out as of XBMC v12 (Frodo) is now supported for HDMI adapter, VGA adapter, and AirPlay mirroring (to ATV2/3 only for mirroring). See '''[[#iOS to TV]]'''. | ||
}} | }} | ||
Line 242: | Line 242: | ||
| Question= iPad camera connector for USB and SD cards | | Question= iPad camera connector for USB and SD cards | ||
| Answer= | | Answer= | ||
* | * XBMC for iOS can read videos and files via the iPad Camera Connector Kit though the SD card reader or the USB port adapter (drives must be self powered or hub powered). Files should show up under {{highlight|/var/mnt/mount1/}}. For troubleshooting tips when using the CCK, see [[forum:123816|this forum thread]]. | ||
}} | }} | ||
Line 253: | Line 253: | ||
{{FAQ|1=Forum|2=IRC | {{FAQ|1=Forum|2=IRC | ||
| BGcolor= | | BGcolor= | ||
| Question= Getting more help with | | Question= Getting more help with XBMC for ATV2/iOS | ||
| Answer= | | Answer= | ||
* '''[http://forum.xbmc.org/forumdisplay.php?f=137 | * '''[http://forum.xbmc.org/forumdisplay.php?f=137 XBMC for iOS specific help forum]''' | ||
* '''[irc://irc.freenode.org/xbmc-osx #xbmc]''' or '''[irc://irc.freenode.org/xbmc-ios #xbmc-ios]''' [[w:IRC|IRC]] chat channel on irc.freenode.org. You might want to try the general channel first, even if your issue is iOS specific, simply because that channel is more active. | * '''[irc://irc.freenode.org/xbmc-osx #xbmc]''' or '''[irc://irc.freenode.org/xbmc-ios #xbmc-ios]''' [[w:IRC|IRC]] chat channel on irc.freenode.org. You might want to try the general channel first, even if your issue is iOS specific, simply because that channel is more active. | ||
}} | }} | ||
Line 307: | Line 307: | ||
| Question= No sound with DTS or AC3 | | Question= No sound with DTS or AC3 | ||
| Answer= | | Answer= | ||
* It's probably not the | * It's probably not the XBMC software on your ATV2, but has to do with your receiver. Try [http://forum.xbmc.org/showpost.php?p=712719&postcount=90 this solution]. | ||
}} | }} | ||
Line 314: | Line 314: | ||
| Question= AC3 files stutter or have static noise | | Question= AC3 files stutter or have static noise | ||
| Answer= | | Answer= | ||
* | * XBMC v12 Frodo currently has a bug that prevents it from using AC3 without "passthrough" enabled. Meaning you can't use AC3 unless your TV or sound receiver directly supports it, for the time being. | ||
* AC3 Audio can stutter and pause video. | * AC3 Audio can stutter and pause video. | ||
* Audio output could also be the culprit, go to Apple TV > Settings > Audio & Video > Audio Output and set it to "16 bit". | * Audio output could also be the culprit, go to Apple TV > Settings > Audio & Video > Audio Output and set it to "16 bit". | ||
Line 325: | Line 325: | ||
* Have you run out of space on your ATV2? Check with (via [[#SSH|SSH]]) the <code>df -k</code> command. If any /dev/disk* filesystems are at 100%, use <code>du -h /</code> to see what's taking up space. or to show which files are, for example, bigger then 9 Mb do <code>find / -size +9000b</code> | * Have you run out of space on your ATV2? Check with (via [[#SSH|SSH]]) the <code>df -k</code> command. If any /dev/disk* filesystems are at 100%, use <code>du -h /</code> to see what's taking up space. or to show which files are, for example, bigger then 9 Mb do <code>find / -size +9000b</code> | ||
* First places to check are: | * First places to check are: | ||
** {{highlight|/private/var/mobile/Library/Preferences/XBMC/addons/packages}} <- ''As of | ** {{highlight|/private/var/mobile/Library/Preferences/XBMC/addons/packages}} <- ''As of XBMC v12, this folder should be limited to 200 MB by default, and shouldn't need to be manually cleaned out.'' | ||
** {{highlight|/private/var/mobile/Library/Caches/AppleTV/Video/LocalAndRental}} | ** {{highlight|/private/var/mobile/Library/Caches/AppleTV/Video/LocalAndRental}} | ||
** {{highlight|/private/var/mobile/Library/Caches/AppleTV/Video/Other}} | ** {{highlight|/private/var/mobile/Library/Caches/AppleTV/Video/Other}} | ||
Line 336: | Line 336: | ||
| Question= Thumbnails taking up too much space or are causing long loading times | | Question= Thumbnails taking up too much space or are causing long loading times | ||
| Answer= | | Answer= | ||
{{See|HOW-TO:Reduce | {{See|HOW-TO:Reduce XBMC disk space}} | ||
}} | }} | ||
Line 359: | Line 359: | ||
* Switch to a different network protocol (especially if you are using SMB), i.e. NFS, FTP, WebDAV, etc. | * Switch to a different network protocol (especially if you are using SMB), i.e. NFS, FTP, WebDAV, etc. | ||
* Try sharing the media on another device to rule out a device-specific (or network) issue. | * Try sharing the media on another device to rule out a device-specific (or network) issue. | ||
* Turn off thumbnail generation (does not affect thumbnails from a library scan), | * Turn off thumbnail generation (does not affect thumbnails from a library scan), XBMC -> Settings -> Video -> File lists -> and deselect 'Extract thumbnails and video information'. | ||
* Disable playback sync completely, | * Disable playback sync completely, XBMC -> Settings -> Video -> Playback -> turn off "Sync playback to display" | ||
* If you are having buffering issues using a Time Capsule on WiFi, try [[forumpost s:959135|this]]. | * If you are having buffering issues using a Time Capsule on WiFi, try [[forumpost s:959135|this]]. | ||
* Try switching on [[HOW-TO:Enable_dirty_regions|dirty regions]] to speed-up the GUI using advancedsettings.xml '''GUI only. Won't help for video playback.''' | * Try switching on [[HOW-TO:Enable_dirty_regions|dirty regions]] to speed-up the GUI using advancedsettings.xml '''GUI only. Won't help for video playback.''' | ||
Line 369: | Line 369: | ||
* Use a wired network connection (if possible, even if just for testing to rule out wireless network issues). | * Use a wired network connection (if possible, even if just for testing to rule out wireless network issues). | ||
* Delete cache files in the following dir: /private/var/mobile/Library/Caches/AppleTV/Video/LocalAndRental (leave .plist files) | * Delete cache files in the following dir: /private/var/mobile/Library/Caches/AppleTV/Video/LocalAndRental (leave .plist files) | ||
* Configure Audio Output in | * Configure Audio Output in XBMC -> Settings -> System -> Audio output -> Select "Optical/Coax", even if you are using HDMI (it will still work). | ||
* Set to 16-bit audio, Apple TV > Settings > Audio & Video > Audio Output and set it to "16 bit". | * Set to 16-bit audio, Apple TV > Settings > Audio & Video > Audio Output and set it to "16 bit". | ||
* Try using an ATV iOS version before 4.4.4 to minimize system resource consumption. | * Try using an ATV iOS version before 4.4.4 to minimize system resource consumption. | ||
Line 386: | Line 386: | ||
* Are you using a feature rich skin? Check to see if you're running [http://forum.xbmc.org/showpost.php?p=883003&postcount=86 out of memory]. | * Are you using a feature rich skin? Check to see if you're running [http://forum.xbmc.org/showpost.php?p=883003&postcount=86 out of memory]. | ||
* Does your xbmc.log have any SQL errors ("database disk image is malformed")? Remove your databases and reboot: (via [[#SSH|SSH]]) <code>rm -f /private/var/mobile/Library/Preferences/XBMC/userdata/Database/*db</code> . {{highlight|color=orange|'''Warning:''' This will reset your video and music libraries}}. | * Does your xbmc.log have any SQL errors ("database disk image is malformed")? Remove your databases and reboot: (via [[#SSH|SSH]]) <code>rm -f /private/var/mobile/Library/Preferences/XBMC/userdata/Database/*db</code> . {{highlight|color=orange|'''Warning:''' This will reset your video and music libraries}}. | ||
* Try turning off thumbnail generation (does not affect thumbnails from a library scan), | * Try turning off thumbnail generation (does not affect thumbnails from a library scan), XBMC > Settings > Video > File and deselect 'generate thumbnails'. | ||
* Are you using AFP file sharing? If you're seeing LIBAFPCLIENT errors in your logs you may want to switch to a different protocol. AFP is generally stable but [http://forum.xbmc.org/showthread.php?t=109723&page=21 development] is orphaned at the moment. | * Are you using AFP file sharing? If you're seeing LIBAFPCLIENT errors in your logs you may want to switch to a different protocol. AFP is generally stable but [http://forum.xbmc.org/showthread.php?t=109723&page=21 development] is orphaned at the moment. | ||
* If your Windows 7 SMB share stops streaming, try [[forumpost s:959354|this]] fix | * If your Windows 7 SMB share stops streaming, try [[forumpost s:959354|this]] fix | ||
;ATV2 | ;ATV2 | ||
* Do you have Firecore Media Player installed? Try removing it and testing again. | * Do you have Firecore Media Player installed? Try removing it and testing again. | ||
* Recent versions of Plex on ATV2 can cause | * Recent versions of Plex on ATV2 can cause XBMC to crash. [http://forum.xbmc.org/showthread.php?tid=145280] | ||
* Is an Apple software update crashing XBMC? Try [[#Apple_updates|blocking them]]. | * Is an Apple software update crashing XBMC? Try [[#Apple_updates|blocking them]]. | ||
* Be sure to disable the native ATV2 AirPlay server in the ATV2's settings. Using the native AirPlay server will crash XBMC, so use XBMC's built in AirPlay server instead. See [[#AirPlay|here]]. | * Be sure to disable the native ATV2 AirPlay server in the ATV2's settings. Using the native AirPlay server will crash XBMC, so use XBMC's built in AirPlay server instead. See [[#AirPlay|here]]. | ||
;iDevice | ;iDevice | ||
* Unrestricted Premium and Display Out can cause | * Unrestricted Premium and Display Out can cause XBMC to crash. Other video-out jailbreak tweaks, or tweaks that tap into hardware decoding, might also cause issues. | ||
* iOS 7 on iDevices currently crash when using DVD menus in XBMC. | * iOS 7 on iDevices currently crash when using DVD menus in XBMC. | ||
}} | }} |
Revision as of 20:21, 5 June 2014
iOS | iOS FAQ |
Frequently Asked Questions for iOS, including iDevices and the Apple TV 2 (black). Template:ATV3
General FAQ (all devices)
- See also: XBMC all platforms FAQ for FAQs that apply to all versions of XBMC.
The following applies to all supported iOS devices, including: Apple TV 2, iPad, iPhone, and iPod touch.
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
|
Apple TV 2 (black)
- This is the FAQ for the Apple TV 2 (black). For the original Apple TV 1 (silver) see: Apple TV 1 FAQ
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
|
iPad, iPhone, and iPod touch
| ||||
| ||||
| ||||
| ||||
| ||||
|
Troubleshooting
See also: Troubleshooting
Have you tried switching it off then on again?
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
|