Archive:IOS FAQ: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
m (Robot: Changing Category:XBMC Manual to Category:Manual)
m (Text replacement - "{{Helix updated}}" to "")
(46 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{XBMC FAQ}}
{{atv2 farewell}}
{{mininav|[[iOS]]|page=iOS FAQ}}
 
'''F'''requently '''A'''sked '''Q'''uestions for iOS, including [[w:iDevices|iDevices]] and the [[Apple TV 2 (black)]].
 
 
<section begin="intro" />'''F'''requently '''A'''sked '''Q'''uestions for iOS, including [[w:iDevices|iDevices]] and [[w:Apple TV|Apple TV]].<section end="intro" />


__TOC__
__TOC__
{{-}}
{{-}}
== General FAQ (all devices) ==
== General FAQ (all devices) ==
:{{big|''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.
{| cellborder="0" cellpadding="5" cellspacing="0"
{| cellborder="0" cellpadding="5" cellspacing="0"
{{FAQ|1=Install|2=Update|3=Installing
{{FAQ|1=Install|2=Update|3=Installing
| BGcolor=
| BGcolor=
| Question= Installing and updating XBMC for iOS
| Question= Installing and updating Kodi for iOS
| Answer=
| Answer=
* '''[[HOW-TO:Install XBMC on Apple TV 2|Install XBMC on Apple TV 2 (black)]]''' &nbsp; (see [[#ATV2_requirements|requirements]])
:{{main|HOW-TO:Install Kodi for iOS}}


* '''[[HOW-TO:Install XBMC on iPad/iPhone/iPod touch|Install XBMC on iPad, iPhone, iPod touch]]''' &nbsp; (see [[#iDevice_requirements|requirements]])
'''Requirements:'''
{{#lst:Supported hardware|iDevices}}
}}
}}


{{FAQ|1=SSH
{{FAQ|1=SSH
| BGcolor= WhiteSmoke
| BGcolor=  
| 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 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.
* Secure Shell (SSH) is used to send remote commands to iOS devices. You might need this for some Kodi 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 XBMC itself, you will need to replace "mobile" with "root".
* For most things you can and should use "mobile" as the user, as shown above. For some tasks, such as upgrading Kodi 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 32: Line 33:
{{FAQ|1=Release_version|2=Version
{{FAQ|1=Release_version|2=Version
| BGcolor=  
| BGcolor=  
| Question= Is XBMC for iOS different from normal XBMC?  
| Question= Is Kodi for iOS different from normal Kodi?  
| Answer=
| Answer=
* 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.}}
* The current stable version of Kodi 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=Kodi_Version
| BGcolor= WhiteSmoke
| BGcolor=  
| Question= How do I find out what version of XBMC am I running?
| Question= How do I find out what version of Kodi am I running?
| Answer=
| Answer=
* XBMC main menu > System > Lower submenu > System info. '''Note the build date.'''
* Kodi -> Main menu -> System -> Lower submenu -> System info. '''Note the build date.'''
}}
}}


Line 47: 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.
* Kodi on iOS can playback most formats supported by Kodi 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 later) and iPhone 4S (and later) are the only exceptions to this and will play ''some'' other HD codecs due to the more powerful CPU inside using software video decoding.
* Videos with 16 reference frames will not playback correctly (using 16 ref frames is out of spec for most codec standards anyways)
* Videos with 16 reference frames will not playback correctly (using 16 ref frames is out of spec for most codec standards anyways)
* Videos at 60Hz may not playback correctly for reasons not yet known (possible hardware limitation).
* Videos at 60FPS may not playback correctly for reasons not yet known (possible hardware limitation).
}}
}}


{{FAQ|1=Media
{{FAQ|1=Media
| BGcolor= WhiteSmoke
| BGcolor=  
| Question= Accessing media
| Question= Accessing media
| Answer=
| Answer=
:{{See also|Adding videos to the library|File sharing}}
* Most users just connect to media that's being shared from a computer, HTPC, or NAS device on your local network. iPad and other iDevices can store files locally, and the iPad specifically can also use the Apple Camera Kit to use USB drive and SD cards.
* You'll want to connect to media that's being shared from a computer, HTPC, or NAS device on your local network, especially with the ATV2 since it only has 8 GB of space. iPad and other iDevices can store files locally, and the iPad specifically can also use the Apple Camera Kit to use USB drive and SD cards. Guides for these will be arriving shortly, until then try searching [http://forum.xbmc.org/forumdisplay.php?f=137 the forums] or Youtube.
}}
}}


Line 66: Line 66:
| 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.
* Kodi for iOS is a full version of Kodi and will be able to use all non-platform specific [[Add-ons]] and [[Skins]]. For iPad users, a "Re-Touched" skin is included in Kodi that makes the device easier to use. See '''[[Skins]]''' for more info about switching to other skins.
}}
 
{{FAQ|1=FileTransfer|2=Addons|3=Add-ons|4=SFTP
| BGcolor= WhiteSmoke
| Question= Transferring files like add-ons, skins, and others over
| Answer=
* To manually install a skin/add-on/repo "by zip", see '''[[HOW-TO:Install an Add-on from a zip file on ATV2|this guide]]'''. The guide will also give you the basic gist of how to transfer files over using SSH/SFTP.
}}
}}


{{FAQ|1=Backup
{{FAQ|1=Backup
| BGcolor=  
| BGcolor=  
| Question= Backing up XBMC's settings
| Question= Backing up Kodi's settings
| 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:
* Most users will just want to use the backup add-on from within Kodi. See '''[[Backup]]''' for more general backup information, including the add-on.
:<code> /private/var/mobile/Library/Preferences/XBMC/ </code> for all of your XBMC data, add-ons, skins, etc, or just <br />
* Users can also manually copy the [[Userdata]] (via iFile or other file manager app from Cydia) from the iOS device to another computer:
:<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/Kodi/ </code> for all of your Kodi data, add-ons, skins, etc, or just <br />
* 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:
:<code> /private/var/mobile/Library/Preferences/Kodi/userdata/ </code> for just the settings files themselves (which takes up less space, but means you would have to re-download add-ons, etc).
<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 XBMC settings on any platform: [[Add-on:XBMC Backup]]
}}
}}


{{FAQ|1=USB_access
{{FAQ|1=TouchControls
| BGcolor= WhiteSmoke
| Question= Use USB to transfer files to/from ATV2/iDevices
| Answer=
* By installing afc2add you can have full file access of the ATV2 or an iDevice when it's plugged into a computer via USB. Once installed you can access the files by using an application such as [http://code.google.com/p/iphonebrowser/downloads/list iPhoneBrowser] or [http://www.macroplant.com/iexplorer/ iExplorer] (formally iPhone Explorer).
** For ATV2: To install afc2add you can either do it through the NitoTV menu or [[#SSH|SSH]] into the ATV2 and type in <code>apt-get install us.scw.afctwoadd</code>
** For iDevices: search for "afc2add" in Cydia.
* You can use this to transfer [[#logs|logs]] out of the ATV2/iDevice, place add-on zips, restore backups (remember to [[#repair_settings|repair permissions]]), or even store a video files on the internal memory.
}}
 
|}
 
== 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]]'''''
{| cellborder="0" cellpadding="5" cellspacing="0" width="100%"
 
{{FAQ|1=ATV2_requirements|2=Requirements
| BGcolor=
| Question= Apple TV 2 specific requirements
| Answer=
{{#lst:Supported hardware|ATV2}}
}}
 
{{FAQ|1=Jailbreaking
| BGcolor=WhiteSmoke
| Question= Jailbreaking
| Answer=
* See '''[[forum:99315|ATV2 jailbreak FAQ]]''' {{editor note|<-- Needs updating and replaced with a wiki page.}}
* If you need additional help go to http://forum.firecore.com or http://modmyi.com/forums/ . Do not ask for jailbreaking help on the forums or on the wiki.
}}
 
{{FAQ|1=ATV3
| BGcolor=
| Question=Apple TV 3
| Answer=
* As the Apple TV 3 (ATV3) is not jailbroken, and is unlikely to be jailbroken soon, XBMC cannot be installed on it.
}}
 
{{FAQ|1=Remotes|2=ATV2_remotes
| BGcolor= WhiteSmoke
| Question= Remotes for ATV2
| Answer=
* 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 OSD during playback?''' - Press and hold SELECT
** '''Changing the volume''' - Up and down while in full screen playback.
* 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
* 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.
* '''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].
* The Apple iOS '''Remote app''' for iTunes/ATV
}}
 
{{FAQ|1=ATV2_output|2=Output
| BGcolor=
| Question= Resolutions ATV2 can play and output
| Answer=
* The ATV2 can playback [[#Formats|most videos]] saved as high as 1080p, but will only output a 720p signal to your TV. 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]
}}
 
{{FAQ|1=USB
| BGcolor= WhiteSmoke
| Question= USB hard drives and devices
| Answer=
* The Apple TV 2 can not operate as a USB host, so hooking an external drive or any other USB device to it will not work. To [[#Media|access media]] it must be located on the local network, ATV2's limited internal memory, and/or streaming from the internet.
}}
 
{{FAQ|1= Sleep|2=Shutdown
| BGcolor=
| Question= Sleep/Shutdown
| 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.
* 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.
}}
 
{{FAQ|1=Timezone
| BGcolor= WhiteSmoke
| Question= Setting time zones on ATV2
| Answer=
* iOS 4.3 and higher, offers the ability to set the Time Zone via the Apple TV GUI, under {{highlight|Settings -> General -> Time Zone}}.
}}
 
{{FAQ|1=ATV2Software
| BGcolor=
| BGcolor=
| Question= Native ATV2 software after XBMC installation
| 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.
}}
{{FAQ|1=Updates|2=Apple_updates
| BGcolor= WhiteSmoke
| Question= Software updates from Apple will crash XBMC
| Answer=
* 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. 
}}
{{FAQ|1=ATV2_version|2=iOS_Version
| BGcolor=
| Question= Finding the ATV2 software version
| Answer=
* From the Apple TV main menu go to {{highlight|Settings -> General -> About}} and 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 [[w:IOS version history#iOS 4.x: Initial OS release on Apple TV|iOS versions]]. More info on the Apple TV software versions is available [http://support.apple.com/kb/HT4448 here].
}}
|}
== iPad, iPhone, and iPod touch ==
{| cellborder="0" cellpadding="5" cellspacing="0" width="100%"
{{FAQ|1=iDevice_requirements|2=iDevices
| BGcolor=
| Question= iDevice requirements
| Answer=
{{#lst:Supported hardware|iDevices}}
}}
{{FAQ|1=TouchControls
| BGcolor=WhiteSmoke
| Question= Touch screen controls
| Question= Touch screen controls
| Answer=
| Answer=
Line 221: Line 95:
| Answer=
| Answer=
* 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]]'''.
* Kodi 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 102:


{{FAQ|1=iDevice_output
{{FAQ|1=iDevice_output
| BGcolor=WhiteSmoke
| BGcolor=
| Question= Resolutions iDevices can play and output
| Question= Resolutions iDevices can play and output
| Answer=
| Answer=
Line 234: Line 108:
* 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 XBMC v12 (Frodo) is now supported for HDMI adapter, VGA adapter, and AirPlay mirroring (to ATV2/3 only for mirroring). See '''[[#iOS to TV]]'''.
* '''Native video out as of v12 (Frodo) is now supported for HDMI adapter, VGA adapter, and AirPlay mirroring (to ATV2/3 only for mirroring). See '''[[#iOS to TV]]'''.
}}
}}


Line 241: Line 115:
| Question= How to use video output to a TV
| Question= How to use video output to a TV
| Answer=
| Answer=
{{main|HOW-TO:Use video output on iOS}}
{{main|Archive:Use_video_output_on_iOS}}
{{#lst:HOW-TO:Use video output on iOS|FAQ}}
{{#lst:Archive:Use_video_output_on_iOS|FAQ}}
}}
}}


{{FAQ|1= iPad_camera_kit|2=iPad_USB
{{FAQ|1= iPad_camera_kit|2=iPad_USB
| BGcolor= WhiteSmoke
| BGcolor=  
| 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]].
* Kodi 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/}}.  
* As of iOS 8.1.x, it seems that mounting only Apple HFS(+) formatted SD cards is supported.
* There are limited reports of success mounting FAT32 or exFAT formatted SD cards, even those less than 4 GB in size. Previous versions of iOS (7.x) appear to have supported more file systems.
* As of iOS 8.1.4, a known good workflow to use an HFS+ formatted SD card as a video source is:
# Double-press the Home button to launch the App Switcher and swipe up to close Photos and Kodi, if open already.
# Insert the Camera Connection Kit with SD card installed.
# Wait several seconds until the message appears: "Cannot Use Device - USB Storage: The connected device is not supported." This may not appear if using a powered USB hub and separate card reader.
# Launch the Photos app. It may appear unresponsive and even terminate and re-launch automatically. It should take less than 30 seconds in total for the activity to subside.
# Launch Kodi.
# If the screen is black for 5-10 seconds after launching Kodi, then double-press the Home button twice, launch the App Switcher, swipe up to close Kodi, and then re-launch Kodi.
# Once in Kodi, add a Video source with the path ''/var/mnt/mount1'' to view videos stored on the SD card.
* For troubleshooting tips when using the CCK, refer to the forum ([[forum:201978|try this thread]], [[forum:207598|this one]], or [[forum:123816|this one]]) or [http://www.reddit.com/r/jailbreak/comments/2k7cfe/cckmounting_drives_on_ios_8 this reddit page]
}}
}}


Line 255: Line 140:


== Troubleshooting ==
== Troubleshooting ==
{{see also|Troubleshooting}}
{| cellborder="0" cellpadding="5" cellspacing="0" width="100%"
{| cellborder="0" cellpadding="5" cellspacing="0" width="100%"
Have you tried switching it off then on again?
Have you tried switching it off then on again?
{{FAQ|1=Forum|2=IRC
{{FAQ|1=Forum|2=IRC
| BGcolor=
| BGcolor=
| Question= Getting more help with XBMC for ATV2/iOS
| Question= Getting more help with Kodi for iOS
| Answer=
| Answer=
* '''[http://forum.xbmc.org/forumdisplay.php?f=137 XBMC for iOS specific help forum]'''
* '''[http://forum.kodi.tv/forumdisplay.php?f=137 Kodi 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/kodi #kodi]''' [[w:IRC|IRC]] chat channel on irc.freenode.org.
}}
}}


{{FAQ|1=Userdata|2=Logs|3=logs|4=debuglog|5=xbmc.log
{{FAQ|1=Userdata|2=Logs|3=logs|4=debuglog|5=kodi.log
| BGcolor=WhiteSmoke
| BGcolor=
| Question= Userdata folder and logs
| Question= Userdata folder and logs
| Answer=
| Answer=
:''See '''[[How-to:Submit a proper bug report]]''' for bug reporting details, '''[[forum:92480|here]]''' for instructions on reporting an issue to the forums, and  '''[[How-to:find and post XBMC.log for iOS]]''' for how to extract the debug and other logs.''
:{{see also|HOW-TO:Submit_a_bug_report|Log file/Easy}}


* [[Userdata folder]]: {{highlight|/var/mobile/Library/Preferences/XBMC/userdata/}}
* [[Userdata]]: {{highlight|/var/mobile/Library/Preferences/Kodi/userdata/}}
* [[Debug log]]: {{highlight|/var/mobile/Library/Preferences/XBMC.log}}
* [[Log_file]]: {{highlight|/var/mobile/Library/Preferences/kodi.log}}
* Syslog: {{highlight|/var/log/syslog}}
* Syslog: {{highlight|/var/log/syslog}}
* CrashReporter: {{highlight|/var/mobile/Library/Logs/CrashReporter/*.plist}}
* CrashReporter: {{highlight|/var/mobile/Library/Logs/CrashReporter/*.plist}}
Line 286: Line 170:


{{FAQ|1=Settings|2=repair_settings
{{FAQ|1=Settings|2=repair_settings
| BGcolor= WhiteSmoke
| BGcolor=  
| Question= Repair settings
| Question= Repair settings
| Answer=
| Answer=
* 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.
* Settings or sources not stored and updates are failing? This can happen when the setting xml files are manipulated outside Kodi. Connect to your iPad/ATV2 as root using an ssh client and repair file permissions.


* Run the following [[#SSH|SSH]] command on the iPad/ATV2:
* Run the following SSH command on the iOS device:
 
<pre>chown -R mobile:mobile /private/var/mobile/Library/Preferences/XBMC/</pre>
}}


{{FAQ|1=Reset
<pre>chown -R mobile:mobile /private/var/mobile/Library/Preferences/Kodi/</pre>
| BGcolor=
| Question= Reset ATV2 without unplugging
| Answer=
* Hold "menu" and "down" buttons for 5 sec.
}}
}}


{{FAQ|1=SkinChange
{{FAQ|1=SkinChange
| BGcolor= WhiteSmoke
| BGcolor=  
| Question= Stuck on a bad skin
| Question= Stuck on a bad skin
| Answer=
| Answer=
* If you changed skins and now can't navigate back to change it back, delete <code>/private/var/mobile/Library/Preferences/XBMC/userdata/guisettings.xml</code>
* If you changed skins and now can't navigate back to change it back, delete the guisettings.xml file:
<code>rm /private/var/mobile/Library/Preferences/Kodi/userdata/guisettings.xml</code>
}}
}}


Line 314: Line 192:
| Question= No sound with DTS or AC3
| Question= No sound with DTS or AC3
| Answer=
| Answer=
* 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].
* It's probably not the Kodi software on your ATV2, but has to do with your receiver. Try [http://forum.kodi.tv/showpost.php?p=712719&postcount=90 this solution].
}}
}}


{{FAQ|1=AC3
{{FAQ|1=AC3
| BGcolor= WhiteSmoke
| BGcolor=  
| 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 (without using passthrough) 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 329: Line 206:
| BGcolor=
| BGcolor=
| Question=Not enough space/memory
| Question=Not enough space/memory
| Answer=
| Answer= <!-- Please keep some of the troubleshooting ATV2 stuff for a while. We might even spit it off onto a legacy ATV2 page. -->
* 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) 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:
{{note|you can clear out the files in these folders, but don't delete the folders themselves}}
{{note|you can clear out the files in these folders, but don't delete the folders themselves}}
** {{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/Preferences/Kodi/addons/packages}} <- ''As of 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}}
** {{highlight|/private/var/cache/apt/archives/}}
** {{highlight|/private/var/cache/apt/archives/}}
* See also [[#Thumbnails]] for saving space with smaller thumbs or moving them to a network location.
}}
}}


{{FAQ|1=Thumbnails
{{FAQ|1=Thumbnails
| BGcolor= WhiteSmoke
| BGcolor=  
| 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 XBMC disk space}}
HOW-TO:Reduce disk space usage
}}
}}


Line 351: Line 227:
| Question= Audio issues and/or slow video playback
| Question= Audio issues and/or slow video playback
| Answer=  
| Answer=  
{{See also|Settings/System#Audio output}}
* Make sure that your audio settings are correct. Wrong audio settings will have severely negative effects on video playback.
* Make sure that your audio settings are correct. Wrong audio settings will have severely negative effects on video playback.
:* Check to see if your speaker setup is really correct
:* Check to see if your speaker setup is really correct
:* If passthrough: make sure you '''only''' enable the audio codecs your receiver supports.
:* If passthrough: make sure you '''only''' enable the audio codecs your receiver supports.
:* Select the correct audio output device for analog and passthrough.
:* Select the correct audio output device for analog and passthrough.
{{#lst:Frodo issues|Mac audio}}
* Not actually an issue with Kodi: Apple does not provide support for HD-audio passthrough in their audio API, CoreAudio.
* Not actually an issue with XBMC: Apple does not provide support for HD-audio passthrough in their audio API, CoreAudio.
}}
}}


{{FAQ|1=Buffering|2=Performance
{{FAQ|1=Buffering|2=Performance
| BGcolor= WhiteSmoke
| BGcolor=  
| Question= Performance: video buffering, stuttering, choppiness  
| Question= Performance: video buffering, stuttering, choppiness  
| Answer=
| Answer=
Line 367: Line 241:
* 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), XBMC -> Settings -> Video -> File lists -> and deselect 'Extract thumbnails and video information'.
* Turn off thumbnail generation (does not affect thumbnails from a library scan), Kodi -> Settings -> Video -> File lists -> and deselect 'Extract thumbnails and video information'.
* Disable playback sync completely, XBMC -> Settings -> Video -> Playback -> turn off "Sync playback to display"
* Disable playback sync completely, Kodi -> 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.'''
** See also Thumbnails for speeding up the GUI when it's loading large/lots of thumbnails.
** See also [[#Thumbnails]] for speeding up the GUI when it's loading large/lots of thumbnails.
* Make sure the video isn't interlaced.
* Make sure the video isn't interlaced.
* If the video is in HD, make sure it is using the h.264 codec (up to High Profile. Hi10P will not work, [http://mediainfo.sourceforge.net mediainfo] can help).
* If the video is in HD, make sure it is using the h.264 codec (up to High Profile. Hi10P will not work, MediaInfo can help).
;ATV2
;ATV2 <!-- Please keep some of the troubleshooting ATV2 stuff for a while. We might even spit it off onto a legacy ATV2 page. -->
* 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)
* Configure Audio Output in Kodi -> Settings -> System -> Audio output -> Select "Optical/Coax", even if you are using HDMI (it will still work).
* 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.
* Reboot to clear out the ATV2's RAM. Sometimes other "apps" like Netflix don't always release RAM when they are done.
* Reboot to clear out the ATV2's RAM. Sometimes other "apps" like Netflix don't always release RAM when they are done.
;iDevice
* iDevices that use an A7 chip (64-bit) won't currently use hardware video decoding. Software video decoding should be enough to play back most videos, but will drain the battery faster.
}}
}}


Line 390: Line 260:
| Answer=
| Answer=
;General
;General
* Check your [[#Logs|logs]] for clues.
* Check your logs for clues.
* Have you [[#repair_settings|tried to repair permissions on XBMC's settings]]?
* Have you [[#repair_settings|tried to repair permissions on Kodi's settings]]?
* 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.kodi.tv/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 kodi.log have any SQL errors ("database disk image is malformed")? Remove your databases and reboot: (via SSH) <code>rm -f /private/var/mobile/Library/Preferences/Kodi/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), XBMC > Settings > Video > File and deselect 'generate thumbnails'.
* Try turning off thumbnail generation (does not affect thumbnails from a library scan), Kodi > 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.kodi.tv/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 <!-- Please keep some of the troubleshooting ATV2 stuff for a while. We might even spit it off onto a legacy ATV2 page. -->
* 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 XBMC to crash. [http://forum.xbmc.org/showthread.php?tid=145280]
* Recent versions of Plex on ATV2 can cause Kodi to crash. [http://forum.kodi.tv/showthread.php?tid=145280]
* Is an Apple software update crashing XBMC? Try [[#Apple_updates|blocking them]].
* Is an Apple software update crashing Kodi? 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 Kodi, so use Kodi's built in AirPlay server instead. See [[#AirPlay|here]].
;iDevice
* 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.
}}
}}
|}
=== v16 missing from Cydia ===
: Due do a server issue, the Team Kodi Cydia repo is having problems. Jailbroken iOS users can still manually install Kodi v16. See '''[[HOW-TO:Install Kodi for iOS]]''' for more info.


|}
{{frodo updated}}
{{DISPLAYTITLE:iOS FAQ}}
{{DISPLAYTITLE:iOS FAQ}}


[[Category:Manual]]
[[Category:Apple]]
[[Category:FAQ|IOS]]
[[Category:IOS|*]]
[[Category:Troubleshooting]]

Revision as of 07:20, 14 November 2020

Template:Atv2 farewell


Frequently Asked Questions for iOS, including iDevices and Apple TV.


General FAQ (all devices)

Installing and updating Kodi for iOS

Link

Requirements:

SSH

Link
  • Secure Shell (SSH) is used to send remote commands to iOS devices. You might need this for some Kodi related tasks detailed on this page. For SSH access you can use putty or 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:
ssh [email protected]
  • For most things you can and should use "mobile" as the user, as shown above. For some tasks, such as upgrading Kodi itself, you will need to replace "mobile" with "root".
  • The default password (for "mobile" or "root") will be alpine

Is Kodi for iOS different from normal Kodi?

Link
  • The current stable version of Kodi for iOS is Kodi v20.5 Nexus. This is the same code that all of the other platforms (Linux, Mac, Windows) are using.

How do I find out what version of Kodi am I running?

Link
  • Kodi -> Main menu -> System -> Lower submenu -> System info. Note the build date.

Formats and resolutions iOS devices can playback

Link
  • Kodi on iOS can playback most formats supported by Kodi 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.
    • The iPad 2 (and later) and iPhone 4S (and later) are the only exceptions to this and will play some other HD codecs due to the more powerful CPU inside using software video decoding.
  • Videos with 16 reference frames will not playback correctly (using 16 ref frames is out of spec for most codec standards anyways)
  • Videos at 60FPS may not playback correctly for reasons not yet known (possible hardware limitation).

Accessing media

Link
  • Most users just connect to media that's being shared from a computer, HTPC, or NAS device on your local network. iPad and other iDevices can store files locally, and the iPad specifically can also use the Apple Camera Kit to use USB drive and SD cards.

Add-ons and skins

Link
  • Kodi for iOS is a full version of Kodi and will be able to use all non-platform specific Add-ons and Skins. For iPad users, a "Re-Touched" skin is included in Kodi that makes the device easier to use. See Skins for more info about switching to other skins.

Backing up Kodi's settings

Link
  • Most users will just want to use the backup add-on from within Kodi. See Backup for more general backup information, including the add-on.
  • Users can also manually copy the Userdata (via iFile or other file manager app from Cydia) from the iOS device to another computer:
/private/var/mobile/Library/Preferences/Kodi/ for all of your Kodi data, add-ons, skins, etc, or just
/private/var/mobile/Library/Preferences/Kodi/userdata/ for just the settings files themselves (which takes up less space, but means you would have to re-download add-ons, etc).

Touch screen controls

Link
  • Context menu: Single-finger long tap or two-finger single tap the menu item.
  • Go Back: Two finger swipe left.
  • Zoom into/out of Image: Pinch.
  • Slide out menus: Hold the menu item to bring it up, then swipe right to access the sub content.
  • iDevices can use the multitasking player control bar and lockscreen controls for music.

Remotes for iDevices

Link
  • Direct touch screen input
  • Web interface, including add-on interfaces
  • Kodi smartphone and tablet remote apps.
  • 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).

Resolutions iDevices can play and output

Link
  • iDevices can playback most videos as high as 1080p.
  • 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.
  • Native video out as of v12 (Frodo) is now supported for HDMI adapter, VGA adapter, and AirPlay mirroring (to ATV2/3 only for mirroring). See #iOS to TV.

How to use video output to a TV

Link

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). Currently limited to 720P outout:

HDMI/VGA adapter (A4 processor or higher) AirPlay mirroring (requires A5 processor or higher)

1. Before opening XBMC, first plug in the video out adapter and connect it to the display

1. Before opening XBMC enable global AirPlay mirroring

On iOS 6: Double-tapping the home button, swiping from left to right to bring up the volume control and AirPlay icon, and selecting your Apple TV from the options.

On iOS 7/8: Bring up the Control Center by swiping from the bottom of the screen to the top, and then selecting AirPlay, and then select Apple TV from the options.

2. Go to Settings -> Appearance -> Skin and change the skin to something like Confluence (not required, but makes operating XBMC on a TV easier).
3. Go to Settings -> System -> Video output and change it to "Display #2"
4. Now you can use the iDevice screen for directional navigation by swiping. Tap to select things, two finger tap to go back.

Note: AirPlay mirroring only works from an iDevice with an A5 or higher SoC (iPhone 4S, iPad 2/3), and will only stream to the native AirPlay feature of Apple TV 2 and 3 (in other words, it won't work with XBMC's AirPlay server as a target).

iPad camera connector for USB and SD cards

Link
  • Kodi 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 /var/mnt/mount1/.
  • As of iOS 8.1.x, it seems that mounting only Apple HFS(+) formatted SD cards is supported.
  • There are limited reports of success mounting FAT32 or exFAT formatted SD cards, even those less than 4 GB in size. Previous versions of iOS (7.x) appear to have supported more file systems.
  • As of iOS 8.1.4, a known good workflow to use an HFS+ formatted SD card as a video source is:
  1. Double-press the Home button to launch the App Switcher and swipe up to close Photos and Kodi, if open already.
  2. Insert the Camera Connection Kit with SD card installed.
  3. Wait several seconds until the message appears: "Cannot Use Device - USB Storage: The connected device is not supported." This may not appear if using a powered USB hub and separate card reader.
  4. Launch the Photos app. It may appear unresponsive and even terminate and re-launch automatically. It should take less than 30 seconds in total for the activity to subside.
  5. Launch Kodi.
  6. If the screen is black for 5-10 seconds after launching Kodi, then double-press the Home button twice, launch the App Switcher, swipe up to close Kodi, and then re-launch Kodi.
  7. Once in Kodi, add a Video source with the path /var/mnt/mount1 to view videos stored on the SD card.

Troubleshooting

Have you tried switching it off then on again?

Getting more help with Kodi for iOS

Link

Userdata folder and logs

Link
  • Userdata: /var/mobile/Library/Preferences/Kodi/userdata/
  • Log_file: /var/mobile/Library/Preferences/kodi.log
  • Syslog: /var/log/syslog
  • CrashReporter: /var/mobile/Library/Logs/CrashReporter/*.plist

Errors while installing

Link
  • Check out this guide for help with SSH/install errors.

Repair settings

Link
  • Settings or sources not stored and updates are failing? This can happen when the setting xml files are manipulated outside Kodi. Connect to your iPad/ATV2 as root using an ssh client and repair file permissions.
  • Run the following SSH command on the iOS device:
chown -R mobile:mobile /private/var/mobile/Library/Preferences/Kodi/

Stuck on a bad skin

Link
  • If you changed skins and now can't navigate back to change it back, delete the guisettings.xml file:

rm /private/var/mobile/Library/Preferences/Kodi/userdata/guisettings.xml

No sound with DTS or AC3

Link
  • It's probably not the Kodi software on your ATV2, but has to do with your receiver. Try this solution.

AC3 files stutter or have static noise

Link
  • AC3 Audio (without using passthrough) 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".

Not enough space/memory

Link
  • Have you run out of space on your ATV2? Check with (via SSH) the df -k command. If any /dev/disk* filesystems are at 100%, use du -h / to see what's taking up space. or to show which files are, for example, bigger then 9 Mb do find / -size +9000b
  • First places to check are:

Note: you can clear out the files in these folders, but don't delete the folders themselves

    • /private/var/mobile/Library/Preferences/Kodi/addons/packages <- As of v12, this folder should be limited to 200 MB by default, and shouldn't need to be manually cleaned out.
    • /private/var/mobile/Library/Caches/AppleTV/Video/LocalAndRental
    • /private/var/mobile/Library/Caches/AppleTV/Video/Other
    • /private/var/cache/apt/archives/

Thumbnails taking up too much space or are causing long loading times

Link

HOW-TO:Reduce disk space usage

Audio issues and/or slow video playback

Link
  • Make sure that your audio settings are correct. Wrong audio settings will have severely negative effects on video playback.
  • Check to see if your speaker setup is really correct
  • If passthrough: make sure you only enable the audio codecs your receiver supports.
  • Select the correct audio output device for analog and passthrough.
  • Not actually an issue with Kodi: Apple does not provide support for HD-audio passthrough in their audio API, CoreAudio.

Performance: video buffering, stuttering, choppiness

Link
General
  • 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.
  • Turn off thumbnail generation (does not affect thumbnails from a library scan), Kodi -> Settings -> Video -> File lists -> and deselect 'Extract thumbnails and video information'.
  • Disable playback sync completely, Kodi -> Settings -> Video -> Playback -> turn off "Sync playback to display"
  • If you are having buffering issues using a Time Capsule on WiFi, try this.
    • See also Thumbnails for speeding up the GUI when it's loading large/lots of thumbnails.
  • Make sure the video isn't interlaced.
  • If the video is in HD, make sure it is using the h.264 codec (up to High Profile. Hi10P will not work, MediaInfo can help).
ATV2
  • Use a wired network connection (if possible, even if just for testing to rule out wireless network issues).
  • Configure Audio Output in Kodi -> 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".
  • Try using an ATV iOS version before 4.4.4 to minimize system resource consumption.
  • Reboot to clear out the ATV2's RAM. Sometimes other "apps" like Netflix don't always release RAM when they are done.

Other crash reasons/fixes

Link
General
  • Check your logs for clues.
  • Have you tried to repair permissions on Kodi's settings?
  • Are you using a feature rich skin? Check to see if you're running out of memory.
  • Does your kodi.log have any SQL errors ("database disk image is malformed")? Remove your databases and reboot: (via SSH) rm -f /private/var/mobile/Library/Preferences/Kodi/userdata/Database/*db . Warning: This will reset your video and music libraries.
  • Try turning off thumbnail generation (does not affect thumbnails from a library scan), Kodi > 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 development is orphaned at the moment.
  • If your Windows 7 SMB share stops streaming, try this fix
ATV2
  • Do you have Firecore Media Player installed? Try removing it and testing again.
  • Recent versions of Plex on ATV2 can cause Kodi to crash. [1]
  • Is an Apple software update crashing Kodi? Try blocking them.
  • Be sure to disable the native ATV2 AirPlay server in the ATV2's settings. Using the native AirPlay server will crash Kodi, so use Kodi's built in AirPlay server instead. See here.

v16 missing from Cydia

Due do a server issue, the Team Kodi Cydia repo is having problems. Jailbroken iOS users can still manually install Kodi v16. See HOW-TO:Install Kodi for iOS for more info.