Archive:IOS FAQ: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>Jd2157
mNo edit summary
 
(400 intermediate revisions by 19 users not shown)
Line 1: Line 1:
{{XBMC faq toc Inline}}
{{notice|v14.2 "Helix" will be the last version of Kodi to run on the '''Apple TV 2'''. For more information read the announcement '''[http://kodi.tv/farewell-to-future-appletv2-development/ here]'''.  
XBMC for iOS specific Frequently Asked Questions and Answers. ''Don't forget to check out the '''[http://forum.xbmc.org/forumdisplay.php?f=137 iOS Specific Support forum].'''''
''Other iOS devices (iPhone, iPad, etc) will still be supported.''}}


==General FAQ (all devices)==
{| cellborder="0" cellpadding="5" cellspacing="0"
|-
|


{{anchor|Install}}
===How do I install XBMC for iOS?===
*'''[[Install XBMC on ATV2|Install XBMC on Apple TV 2 (black)]]'''   (see [[#What are the Apple TV 2 specific requirements?|requirements]])


*'''[[Install XBMC on iPhone/iPad|Install XBMC on iPad, iPhone, iPod touch]]'''   (see [[#What platforms are supported today?|requirements]])
<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__
| style="background:WhiteSmoke" |
{{-}}
{{anchor|SSH}}
== General FAQ (all devices) ==
===What is SSH?===
*[[w:SSH|SSH]] is a secure shell to access and install software on your ATV2. For ssh command line 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.


|-
{| cellborder="0" cellpadding="5" cellspacing="0"
|
{{FAQ|1=Install|2=Update|3=Installing
 
| BGcolor=
{{anchor|Version}}
| Question= Installing and updating Kodi for iOS
 
| Answer=
===What XBMC version is the iOS release?===
:{{main|HOW-TO:Install Kodi for iOS}}
*The current XBMC for iOS version is based on the 11.0 "Eden" version code. This is the same code that all of the other platform nightly versions are using ([https://github.com/xbmc/xbmc/commits changelog]). These are in-development test builds that contain many new features, but are not yet completely stable. A stable version of XBMC for iOS will come with the final release of XBMC v11 (Eden).
 
|-
| style="background:WhiteSmoke" |
 
{{anchor|Formats}}
===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 iPad 2 and iPhone 4S are the only exceptions to this and will play ''some'' other HD codecs due to the faster CPU inside.
 
|-
|
 
{{anchor|Media}}
 
===How should I setup and access my media for XBMC?===
*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.
 
*This [http://www.youtube.com/watch?v=Z4iEl3BqhUI tutorial] describes how to share using SMB on Mac OS X 10.6 and below. This is a [http://forum.xbmc.org/showthread.php?t=63123 tutorial] for SMB sharing on Windows 7. If you're using Mac OS X 10.7 "Lion", there are several [http://forum.xbmc.org/showthread.php?t=106659 filesharing options] but you'll likely want to use AFP because SMB won't work without installing Samba.  [[Network Filesystem (NFS)|NFS sharing]] is available for all platforms but it's more complex than the other options. Most NAS devices will use SMB sharing.
 
:'''''Note:''' Better how-to guides on network sharing will be coming to the wiki soon. Feel free to add any links here to good guides you find.''
 
|-
| style="background:WhiteSmoke" |
 
{{anchor|Skins}}
===What add-ons/skins can I use?===
*XBMC for iOS is a full version of XBMC and will be able to use all non-platform specific add-ons and should use all skins. More CPU demanding skins like AEON MQ 3 might not run smoothly, but most skins should be fine.
 
*Because XBMC is using pre-v11 (Eden) code, only add-ons and skins that have been tested and work will show up in the [[Add-on manager]]. If a specific add-on or skin you want to use doesn't show up then look for a newer in-development version on the forums: [http://forum.xbmc.org/forumdisplay.php?f=67 for Skins], [http://forum.xbmc.org/forumdisplay.php?f=27 for Add-ons].
 
|-
|
 
{{anchor|FileTransfer|Addons|How do I transfer files like add-on/skin zips over?|Is there an application with a GUI I can use to transfer files?}}
===How do I transfer files like add-on/skin zips over?===
*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.
 
|-
| style="background:WhiteSmoke" |
 
{{anchor|Library}}
===I have several XBMC devices, how do I centralize my XBMC library?===
*Check out the tutorials [http://lifehacker.com/5634515/how-to-synchronize-your-xbmc-media-center-across-every-room-in-the-house here] and [http://lime-technology.com/forum/index.php?topic=11473.msg109149#msg109149 here]
 
|-
|
 
{{anchor|Backup}}
===How can I backup my XBMC settings?===
*The most common way is to copy this directory (via [[#How do I transfer files like add-on/skin zips over?|SFTP]]) 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:
chown -R mobile:mobile /private/var/mobile/Library/Preferences/XBMC/userdata
 
|}
 
==Apple TV 2 (black)==
{| cellborder="0" cellpadding="5" cellspacing="0" width="100%"
|-
|
 
{{anchor|Requirements}}
===What are the Apple TV 2 specific requirements?===
:A [[forum:99315|jailbroken]] Apple TV 2 with one of the following software versions:
:* [[forum:105740|iOS 4.3 (Apple TV software 4.2.x)]]
:* [http://www.iclarified.com/entry/index.php?enid=13581 iOS 4.2.1 (Apple TV software 4.1.x)]
:* [http://www.iclarified.com/entry/index.php?enid=12380 iOS 4.1 (Apple TV software 4.0)].
:Newer [[w:IOS version history#Version history: Apple TV (second generation)|versions]] may also work but aren't officially supported.
 
|-
| style="background:WhiteSmoke" |
 
{{anchor|Jailbreaking}}
 
===I need help jailbreaking===
*See the [http://forum.xbmc.org/showthread.php?t=99315 ATV2 jailbreak FAQ]. If you need additional help go to http://forum.firecore.com/ , http://forum.tomcool.org/ , or http://modmyi.com/forums/ . Do not ask for jailbreaking help on the forums or on the wiki.
 
|-
|
 
{{anchor|Remotes}}
===What remotes work?===
* The '''ATV2 remote''' works with XBMC and can be customized. See: [[Joystick.AppleRemote.xml for ATV2|Joystick.AppleRemote.xml for ATV2]]
**'''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
**Key repeat (such as holding down directional buttons to navigate) does not work right now on the Apple Remote. This is a known issue.
<!--** General Apple remote functions can be found at [[Global Apple Remote]] (not fully updated for ATV2)-->
* 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
* Standard Android and iOS remote apps
* '''Rowmote Pro''' (requires helper, see nitoTV)
* '''Bluetooth''' keyboards can be used after BTstack is installed using either nitoTV or the command line. See [http://forum.xbmc.org/showthread.php?t=92386 this post] for more info.
* '''Harmony''' Remotes have experimental support and you can teach the ATV2 to use most standard IR remotes via 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


|-
'''Requirements:'''
| style="background:WhiteSmoke" |
{{#lst:Supported hardware|iDevices}}
}}


{{anchor|ATV2Software}}
{{FAQ|1=SSH
| BGcolor=
| Question= SSH
| Answer=
* 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:
:<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 Kodi itself, you will need to replace "mobile" with "root".
* The default password (for "mobile" or "root") will be ''alpine''
}}


===What happens to original Apple TV 2 software after the XBMC installation?===
{{FAQ|1=Release_version|2=Version
*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.
| BGcolor=  
| Question= Is Kodi for iOS different from normal Kodi?  
| Answer=
* 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=Kodi_Version
|
| BGcolor=
| Question= How do I find out what version of Kodi am I running?
| Answer=
* Kodi -> Main menu -> System -> Lower submenu -> System info. '''Note the build date.'''
}}


{{anchor|Output}}
{{FAQ|1=Formats
===What resolutions is the ATV2 capable of outputting?===
| BGcolor=  
*The ATV2 can playback 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]
| Question= Formats and resolutions iOS devices can playback
| Answer=
* 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).
}}


|-
{{FAQ|1=Media
| style="background:WhiteSmoke" |
| BGcolor=
| Question= Accessing media
| Answer=
* 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.
}}


{{anchor|USB}}
{{FAQ|1=Skins
===Can I hook up my external harddrive or other USB device to the ATV2?===
| BGcolor=  
*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.
| Question= Add-ons and skins
| Answer=
* 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=Backup
|
| BGcolor=
| Question= Backing up Kodi's settings
| Answer=
* 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:
:<code> /private/var/mobile/Library/Preferences/Kodi/ </code> for all of your Kodi data, add-ons, skins, etc, or just <br />
:<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).
}}


{{anchor|Timezone}}
{{FAQ|1=TouchControls
===How do I set the time zone on ATV2?===
| BGcolor=
*iOS 4.3 offers the ability to set the Time Zone via the Apple TV gui, under Settings > General > Time Zone.
| Question= Touch screen controls
| Answer=
* '''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.
}}


*On previous iOS versions it has to be done [http://forum.xbmc.org/showthread.php?t=92492&highlight=timezone via command line]:
{{FAQ|1=iRemotes|2=iDevice_remotes
cd /var/db/timezone ; rm localtime
| BGcolor=
ln -s /usr/share/zoneinfo/[Country or Region]/[Zone Name] localtime (e.g. "ln -s /usr/share/zoneinfo/Canada/Eastern localtime")
| Question= Remotes for iDevices
 
| Answer=
|-
| style="background:WhiteSmoke" |
 
{{anchor|Updates}}
===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 by pasting them into the command prompt on the ATV2 and reboot after that: [http://forum.xbmc.org/showpost.php?p=748981&postcount=1]
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 appldnld.apple.com.edgesuite.net" >> /etc/hosts
echo "" >> /etc/hosts
 
|-
|
 
{{anchor|iOS_Version}}
 
===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#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].
 
|-
| style="background:WhiteSmoke" |
 
{{anchor|direct_boot|boot}}
 
===Can the ATV2 directly boot into XBMC?===
*Yes but there's currently no way back to the ATV2 menu without disabling direct booting. SSH into the ATV2 and:
:*To enable direct booting: <pre>apt-get install org.tomcool.xbmc-booter</pre>
:*To disable direct booting: <pre>apt-get remove org.tomcool.xbmc-booter</pre>
 
|}
 
==iPad, iPhone, and iPod touch==
{| cellborder="0" cellpadding="5" cellspacing="0" width="100%"
|-
|
 
{{anchor|iDevices}}
===What iDevices are supported today?===
*Any version of iOS 4.x that is jailbreakable. iPad1, iPhone 3Gs, iPod touch 3rd gen (not the 8GB model), and up are supported. iOS 5 support is experimental.
 
|-
| style="background:WhiteSmoke" |
 
{{anchor|iRemotes}}
 
===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
* 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).
}}


|-
{{FAQ|1=iDevice_output
|  
| BGcolor=
| Question= Resolutions iDevices can play and output
| Answer=
* iDevices can playback [[#Formats|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]]'''.
}}


{{anchor|TouchControls}}
{{FAQ|1=iOS_to_TV
| BGcolor=
| Question= How to use video output to a TV
| Answer=
{{main|Archive:Use_video_output_on_iOS}}
{{#lst:Archive:Use_video_output_on_iOS|FAQ}}
}}


===Touch screen controls===
{{FAQ|1= iPad_camera_kit|2=iPad_USB
*'''Context menu:''' Two finger single tap the menu item.
| BGcolor=  
*'''Go Back:''' Two finger swipe left.
| Question= iPad camera connector for USB and SD cards
*'''Zoom into/out of Image:''' Pinch.
| Answer=
*'''Slide out menus:''' Hold the menu item to bring it up, then swipe right to access the sub content.  
* 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]
}}


|}
|}


==Troubleshooting==
== 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?
|  
{{FAQ|1=Forum|2=IRC
| BGcolor=
| Question= Getting more help with Kodi for iOS
| Answer=
* '''[http://forum.kodi.tv/forumdisplay.php?f=137 Kodi for iOS specific help forum]'''
* '''[irc://irc.freenode.org/kodi #kodi]''' [[w:IRC|IRC]] chat channel on irc.freenode.org.
}}


{{anchor|Forum}}
{{FAQ|1=Userdata|2=Logs|3=logs|4=debuglog|5=kodi.log
===Where can I get more help with XBMC for ATV2/iOS?===
| BGcolor=
* '''[http://forum.xbmc.org/forumdisplay.php?f=137 XBMC for iOS specific help forum]''' or the '''[irc://irc.freenode.org/xbmc-ios #xbmc-ios]''' [[w:IRC|IRC]] chat channel on irc.freenode.org
| Question= Userdata folder and logs
| Answer=
:{{see also|HOW-TO:Submit_a_bug_report|Log file/Easy}}


|-
* [[Userdata]]: {{highlight|/var/mobile/Library/Preferences/Kodi/userdata/}}
| style="background:WhiteSmoke" |
* [[Log_file]]: {{highlight|/var/mobile/Library/Preferences/kodi.log}}
* Syslog: {{highlight|/var/log/syslog}}
* CrashReporter: {{highlight|/var/mobile/Library/Logs/CrashReporter/*.plist}}
}}


{{anchor|XBMC_Version}}
{{FAQ|1=install_errors
| BGcolor=
| Question= Errors while installing
| Answer=
* Check out '''[[forum:128748|this guide]]''' for help with SSH/install errors.
}}


===Where can I find the version of XBMC that I'm running?===
{{FAQ|1=Settings|2=repair_settings
*XBMC main menu > System > Lower submenu > System info. Note the build date.
| BGcolor=  
| Question= Repair settings
| Answer=
* 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:
|


{{anchor|Userdata|logs|debuglog|xbmc.log}}
<pre>chown -R mobile:mobile /private/var/mobile/Library/Preferences/Kodi/</pre>
}}


===Where are the Userdata folder and logs?===
{{FAQ|1=SkinChange
:''See '''[[How-to:Submit a proper bug report]]''' for bug reporting details, '''[http://forum.xbmc.org/showthread.php?t=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.''
| BGcolor=  
| Question= Stuck on a bad skin
| Answer=
* 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>
}}


*[[Userdata folder]]: <code>/private/var/mobile/Library/Preferences/XBMC/userdata/</code>
{{FAQ|1=NoSound
*[[Debug log]]: <code>/private/var/mobile/Library/Preferences/XBMC.log</code>
| BGcolor=
*Syslog: <code>/var/log/syslog</code>
| Question= No sound with DTS or AC3
*CrashReporter: <code>/var/logs/CrashReporter/*.plist</code>
| Answer=
* 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
| style="background:WhiteSmoke" |
| BGcolor=
| Question= AC3 files stutter or have static noise
| Answer=
* 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".
}}


{{anchor|Settings|repair_settings}}
{{FAQ|1=Disk_space
| BGcolor=
| Question=Not enough space/memory
| 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) 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:
{{note|you can clear out the files in these folders, but don't delete the folders themselves}}
** {{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/Other}}
** {{highlight|/private/var/cache/apt/archives/}}
}}


===Why are settings or sources not stored and updates are failing?===
{{FAQ|1=Thumbnails
*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.
| BGcolor=  
| Question= Thumbnails taking up too much space or are causing long loading times
| Answer=
HOW-TO:Reduce disk space usage
}}


*Run the following command on the iPad/ATV2:
{{FAQ|1= Audio
| BGcolor=
| Question= Audio issues and/or slow video playback
| Answer=
* 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.
}}


chown -R mobile:mobile /private/var/mobile/Library/Preferences/XBMC/userdata
{{FAQ|1=Buffering|2=Performance
| BGcolor=
| Question= Performance: video buffering, stuttering, choppiness
| Answer=
;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 [[forumpost s:959135|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 <!-- 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).
* 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.
}}


|-
{{FAQ|1=Crashing|2=Crash|3=Fixes
|  
| BGcolor=
| Question= Other crash reasons/fixes
| Answer=
;General
* Check your logs for clues.
* 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.kodi.tv/showpost.php?p=883003&postcount=86 out of memory].
* 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), 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.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
;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.
* 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 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 Kodi, so use Kodi's built in AirPlay server instead. See [[#AirPlay|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.


{{anchor|Reset}}
===How can i reset the AppleTV2 without unplugging?===
:Hold "menu" and "down" buttons for 5 sec.


|-
{{DISPLAYTITLE:iOS FAQ}}
| style="background:WhiteSmoke" |
 
{{anchor|NavSounds}}
===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..).
 
|-
|
 
{{anchor|SkinChange}}
===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>
 
|-
| style="background:WhiteSmoke" |
 
{{anchor|NoSound}}
===I have enabled DTS or AC3 but don't have any sound?===
*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].
 
|-
|
 
{{anchor|AC3}}
===Some of my AC3 files stutter or have static noise===
*AC3 Audio can stutter and pause video. Generating thumbnails may be the cause, go to XBMC > Settings > Video > File and deselect 'generate thumbnails'. Audio output could also be the culprit, go to Apple TV > Settings > Audio & Video > Audio Output and set it to "16 bit".
 
|-
| style="background:WhiteSmoke" |
 
{{anchor|Buffering}}
===My videos are stuttering and buffering a lot when streaming from an SMB source===
*Try using a different protocol, i.e. UPnP or FTP, and avoid using Wi-Fi if possible.
 
|-
|
 
{{anchor|Upgrading}}
===Why is the dpkg command hanging/freezing when I'm upgrading XBMC?===
*This issue should be resolved in the latest nightlies. Stopping the hung command with CTRL+C should fix the problem. If not, there is a [http://forum.xbmc.org/showpost.php?p=867847&postcount=46 workaround].
 
|-
| style="background:WhiteSmoke" |
 
{{anchor|Crashing}}
 
===My ATV2 is crashing, am I out of space/memory or running the wrong version, how can I fix it?===
*Do you have [http://forum.firecore.com/topic/4224 Firecore Media Player] installed? Try removing it and testing again.
*Have you [[#Why are settings or sources not stored and updates are failing?|verified proper ownership of your settings]]?
*Is a software update crashing XBMC? Try [[#How do I stop the ATV from checking for updates and crashing XBMC?|blocking them]].
*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].
*Have you run out of space on your ATV2? Check with "df -k". If any /dev/disk* filesystems are at 100%, use "du -h /" to see what's taking up space.
* Does your xbmc.log have any SQL errors? Remove your databases and reboot: "rm -f /private/var/mobile/Library/Preferences/XBMC/userdata/Database/*db".
*Are you running the latest nightly? The latest nightly will have the most recent bug fixes. It's worth upgrading to the latest in case the problem's already been fixed.
|}


[[Category:FAQ]]
[[Category:Apple]]
[[Category:iOS|*]]

Latest revision as of 20:23, 11 December 2020

Emblem-important-yellow.png NOTICE:
v14.2 "Helix" will be the last version of Kodi to run on the Apple TV 2. For more information read the announcement here.

Other iOS devices (iPhone, iPad, etc) will still be supported.


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


General FAQ (all devices)

Installing and updating Kodi for iOS
Link
Main page: HOW-TO:Install Kodi for iOS

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 v21 Omega. 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
Main page: Archive:Use_video_output_on_iOS

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).
Note for iOS8 and later: Apple broke some things when it comes to hardware adapters like HDMI/DVI/VGA/Component adapters.
1. The screen is not filled 100% but has a border around it. There is no solution to this as of now and all tvout capable apps are suffering from the same issue.
2. When changing the resolution of the external screen nothing happens. The screen will always stay in its highest resolution. All tvout capable apps are suffering from the same issue.

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
See also: HOW-TO:Submit_a_bug_report and Log file/Easy
  • 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.
Retrieved from "https://kodi.wiki/index.php?title=Archive:IOS_FAQ&oldid=223247"