Archive:IOS FAQ: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
mNo edit summary
 
(353 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.''}}
 
 
 
<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__
{{-}}
== General FAQ (all devices) ==


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


*'''[[Install XBMC on iPhone/iPad|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, what is it?
| Question= SSH
| Answer=
| Answer=
*[[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.
* 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''
}}
}}


{{FAQ|1=Version
{{FAQ|1=Release_version|2=Version
| BGcolor=
| BGcolor=  
| Question= XBMC for iOS version
| 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=
| Answer=
*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 11.0 "Eden" ([http://trac.xbmc.org/roadmap roadmap]).
* Kodi -> Main menu -> System -> Lower submenu -> System info. '''Note the build date.'''
}}
}}


{{FAQ|1=Formats
{{FAQ|1=Formats
| BGcolor=WhiteSmoke
| BGcolor=  
| Question= Formats and resolutions iOS devices can play
| Question= Formats and resolutions iOS devices can playback
| Answer=
| Answer=
*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.
* 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
{{FAQ|1=Media
| BGcolor=
| BGcolor=  
| Question= Accessing media
| Question= Accessing media
| Answer=
| Answer=
*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.
* 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.
 
*This [http://www.youtube.com/watch?v=Z4iEl3BqhUI tutorial] describes how to share using SMB on '''Mac OS 10.6''' (Snow Leopard) 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 10.7''' (Lion), there are several [http://forum.xbmc.org/showthread.php?t=106659 filesharing options] but you'll likely want to use AFP (unless you run into [http://forum.xbmc.org/showthread.php?t=109723&page=21 stability issues]) because SMB won't work without installing Samba.  WebDAV and FTP are the next best choices.  [[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 someday. Feel free to add any links here to good guides you find.''
}}
}}


{{FAQ|1=Skins
{{FAQ|1=Skins
| BGcolor=WhiteSmoke
| BGcolor=  
| 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 should use all skins. More 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.
 
*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].
}}
 
{{FAQ|1=FileTransfer|2=Addons|3=Add-ons
| BGcolor=
| Question= Transfer 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=Library
| BGcolor=WhiteSmoke
| Question= Sync the XBMC library between multiple installs
| Answer=
*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]
}}
}}


{{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 this directory (via [[#FileTransfer|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:
* 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.
<pre>chown -R mobile:mobile /private/var/mobile/Library/Preferences/XBMC/userdata</pre>
* 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).
}}
}}


|}
{{FAQ|1=TouchControls
 
==Apple TV 2 (black)==
{| cellborder="0" cellpadding="5" cellspacing="0" width="100%"
 
{{FAQ|1=Requirements|2=ATV2_requirements
| BGcolor=
| BGcolor=
| Question= Apple TV 2 specific requirements
| Question= Touch screen controls
| Answer=
| Answer=
:A [[forum:99315|jailbroken]] Apple TV 2 with one of the following software versions:
* '''Context menu:''' Single-finger long tap or two-finger single tap the menu item.
:* [[forum:105740|iOS 4.3 (Apple TV software 4.2.x)]]
* '''Go Back:''' Two finger swipe left.
:* [http://www.iclarified.com/entry/index.php?enid=13581 iOS 4.2.1 (Apple TV software 4.1.x)]
* '''Zoom into/out of Image:''' Pinch.
:* [http://www.iclarified.com/entry/index.php?enid=12380 iOS 4.1 (Apple TV software 4.0)].
* '''Slide out menus:''' Hold the menu item to bring it up, then swipe right to access the sub content.  
:Newer [[w:IOS version history#Version history: Apple TV (second generation)|versions]] may also work but aren't officially supported.
* iDevices can use the multitasking player control bar and lockscreen controls for music.
}}
}}


{{FAQ|1=Jailbreaking
{{FAQ|1=iRemotes|2=iDevice_remotes
| BGcolor=WhiteSmoke
| Question= Jailbreaking
| Answer=
*See the [[forum: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.
}}
 
{{FAQ|1=Remotes
| BGcolor=
| BGcolor=
| Question= Remotes for ATV2
| Question= Remotes for iDevices
| Answer=
| Answer=
* The '''ATV2 remote''' works with XBMC and can be customized. See: [[Joystick.AppleRemote.xml for ATV2|Joystick.AppleRemote.xml for ATV2]]
* Direct '''touch screen''' input
**'''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
* '''Web interface''', including add-on interfaces
* Standard Android and iOS remote apps
* Kodi smartphone and tablet remote apps.
* '''Rowmote Pro''' (requires helper, see nitoTV)
* Bluetooth keyboards can be used for navigation and playback, in addition to text entry.
* '''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.
* Headphone remote control of Apple headphones or on bluetooth headphones can control play/pause and next/previous item (playlist or auto play next).
* '''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
}}
}}


{{FAQ|1=ATV2Software
{{FAQ|1=iDevice_output
| BGcolor=WhiteSmoke
| Question= Native Apple TV 2 software after the 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=Output
| BGcolor=
| Question= Resolutions ATV2 can play and output
| Answer=
*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]
}}
 
{{FAQ|1=USB
| BGcolor=WhiteSmoke
| Question= USB hard drives and devices
| Answer=
*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.
}}
 
{{FAQ|1=Timezone
| BGcolor=
| BGcolor=
| Question= Setting time zones on ATV2
| Question= Resolutions iDevices can play and output
| Answer=
*iOS 4.3 offers the ability to set the Time Zone via the Apple TV gui, under Settings > General > Time Zone.
 
*On previous iOS versions it has to be done [http://forum.xbmc.org/showthread.php?t=92492&highlight=timezone via command line]:
cd /var/db/timezone ; rm localtime
ln -s /usr/share/zoneinfo/[Country or Region]/[Zone Name] localtime (e.g. "ln -s /usr/share/zoneinfo/Canada/Eastern localtime")
}}
 
{{FAQ|1=Updates|2=Apple_updates
| BGcolor=WhiteSmoke
| Question= Software updates from Apple will crash XBMC
| Answer=
| Answer=
*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]
* iDevices can playback [[#Formats|most videos]] as high as 1080p.
echo "127.0.0.1 appldnld.apple.com" >> /etc/hosts
* Retina and widescreen is fully supported on iPhone 4, 4S, 5, 5c, 5S and iPod touch 4, 5.
echo "127.0.0.1 mesu.apple.com" >> /etc/hosts
* 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.
echo "127.0.0.1 appldnld.apple.com.edgesuite.net" >> /etc/hosts
* '''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]]'''.
echo "" >> /etc/hosts
}}
}}


{{FAQ|1=iOS_Version
{{FAQ|1=iOS_to_TV
| BGcolor=
| BGcolor=
| Question= What iOS version is on my ATV2?
| Question= How to use video output to a TV
| Answer=
| Answer=
*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 [[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].
{{main|Archive:Use_video_output_on_iOS}}
{{#lst:Archive:Use_video_output_on_iOS|FAQ}}
}}
}}


{{FAQ|1=direct_boot|2=boot
{{FAQ|1= iPad_camera_kit|2=iPad_USB
| BGcolor=WhiteSmoke
| BGcolor=  
| Question= Directly booting into XBMC
| Question= iPad camera connector for USB and SD cards
| Answer=
| Answer=
*The ATV2 can be set up to directly boot into XBMC, bypassing the native ATV2 menu, but this will disable the ATV2 native menu completely. SSH into the ATV2 and:
* 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/}}.
:*To enable direct booting: <pre>apt-get install org.tomcool.xbmc-booter</pre>
* As of iOS 8.1.x, it seems that mounting only Apple HFS(+) formatted SD cards is supported.
:*To disable direct booting: <pre>apt-get remove org.tomcool.xbmc-booter</pre>
* 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]
}}
}}


|}
|}


==iPad, iPhone, and iPod touch==
== 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=iDevices|2=iDevice_requirements
{{FAQ|1=Forum|2=IRC
| BGcolor=
| BGcolor=
| Question= iDevice requirements
| Question= Getting more help with Kodi for iOS
| Answer=
| Answer=
*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.
* '''[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.
}}
}}


{{FAQ|1=iRemotes
{{FAQ|1=Userdata|2=Logs|3=logs|4=debuglog|5=kodi.log
| BGcolor=WhiteSmoke
| BGcolor=
| Question= Remotes for iDevices
| Question= Userdata folder and logs
| Answer=
| Answer=
* Direct '''touch screen''' input
:{{see also|HOW-TO:Submit_a_bug_report|Log file/Easy}}
* '''Web interface''', including add-on interfaces
* Standard Android and iOS remote Apps
}}


{{FAQ|1=TouchControls
* [[Userdata]]: {{highlight|/var/mobile/Library/Preferences/Kodi/userdata/}}
| BGcolor=
* [[Log_file]]: {{highlight|/var/mobile/Library/Preferences/kodi.log}}
| Question= Touch screen controls
* Syslog: {{highlight|/var/log/syslog}}
| Answer=
* CrashReporter: {{highlight|/var/mobile/Library/Logs/CrashReporter/*.plist}}
*'''Context menu:''' 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.  
}}
}}


|}
{{FAQ|1=install_errors
 
==Troubleshooting==
{| cellborder="0" cellpadding="5" cellspacing="0" width="100%"
 
{{FAQ|1=Forum
| BGcolor=
| BGcolor=
| Question= Getting more help with XBMC for ATV2/iOS
| Question= Errors while installing
| Answer=
| Answer=
* '''[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
* Check out '''[[forum:128748|this guide]]''' for help with SSH/install errors.
}}
}}


{{FAQ|1=XBMC_Version
{{FAQ|1=Settings|2=repair_settings
| BGcolor=WhiteSmoke
| BGcolor=  
| Question= What version of XBMC am I running?
| Question= Repair settings
| Answer=
| Answer=
*XBMC main menu > System > Lower submenu > System info. Note the build date.
* 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.
}}


{{FAQ|1=Userdata|2=Logs|3=logs|4=debuglog|5=xbmc.log
* Run the following SSH command on the iOS device:
| BGcolor=
| Question= Userdata folder and logs
| Answer=
:''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.''


*[[Userdata folder]]: <code>/private/var/mobile/Library/Preferences/XBMC/userdata/</code>
<pre>chown -R mobile:mobile /private/var/mobile/Library/Preferences/Kodi/</pre>
*[[Debug log]]: <code>/private/var/mobile/Library/Preferences/XBMC.log</code>
*Syslog: <code>/var/log/syslog</code>
*CrashReporter: <code>/var/logs/CrashReporter/*.plist</code>
}}
}}


{{FAQ|1=Settings|2=repair_settings
{{FAQ|1=SkinChange
| BGcolor=WhiteSmoke
| BGcolor=  
| Question= Settings or sources not stored and updates are failing
| Question= Stuck on a bad skin
| Answer=
| Answer=
*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.
* 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>
*Run the following command on the iPad/ATV2:
 
<pre>chown -R mobile:mobile /private/var/mobile/Library/Preferences/XBMC/userdata</pre>
}}
}}


{{FAQ|1=Reset
{{FAQ|1=NoSound
| BGcolor=
| BGcolor=
| Question= Reset the AppleTV2 without unplugging
| Question= No sound with DTS or AC3
| Answer=
| Answer=
*Hold "menu" and "down" buttons for 5 sec.  
* 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=NavSounds
{{FAQ|1=AC3
| BGcolor=WhiteSmoke
| BGcolor=  
| Question= No navigational sounds in XBMC's menus
| Question= AC3 files stutter or have static noise
| Answer=
| Answer=
*This is a known issue and will be fixed with the new audio engine (developed behind the scenes..).
* 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".
}}
}}


{{FAQ|1=SkinChange
{{FAQ|1=Disk_space
| BGcolor=
| BGcolor=
| Question= Stuck on a bad iPad/iDevice skin
| 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. -->
* If you changed skins on the iPad or other touch device and now can't navigate back to change them, delete <code>/private/var/mobile/Library/Preferences/XBMC/userdata/guisettings.xml</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:
{{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/}}
}}
}}


{{FAQ|1=NoSound
{{FAQ|1=Thumbnails
| BGcolor=WhiteSmoke
| BGcolor=  
| Question= No sound with DTS or AC3
| Question= Thumbnails taking up too much space or are causing long loading times
| 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].
HOW-TO:Reduce disk space usage
}}
}}


{{FAQ|1=AC3
{{FAQ|1= Audio
| BGcolor=
| BGcolor=  
| Question= AC3 files stutter or have static noise
| Question= Audio issues and/or slow video playback
| Answer=
| Answer=  
*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".
* 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.
}}
}}


{{FAQ|1=Buffering
{{FAQ|1=Buffering|2=Performance
| BGcolor=WhiteSmoke
| BGcolor=  
| Question= Constant video buffering
| Question= Performance: video buffering, stuttering, choppiness
| Answer=
| Answer=
*Try using a different protocol (especially if you are using SMB), i.e. UPnP or FTP, and avoid using Wi-Fi if possible.
;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=Upgrading
{{FAQ|1=Crashing|2=Crash|3=Fixes
| BGcolor=
| BGcolor=
| Question=Why is the dpkg command hanging/freezing when I'm upgrading XBMC?
| Question= Other crash reasons/fixes
| Answer=
| Answer=
*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].
;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.


{{FAQ|1=Crashing|2=Crash
| BGcolor=WhiteSmoke
| Question= Other ATV2 crash reasons/fixes
| Answer=
* Check your [[#Logs|logs]] for clues.
* Do you have [http://forum.firecore.com/topic/4224 Firecore Media Player] installed? Try removing it and testing again.
* Have you [[#repair_settings|verified proper ownership of your settings]]?
* Is an Apple software update crashing XBMC? Try [[#Apple_updates|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 [[HOW-TO:Install_XBMC_on_Apple_TV_2#Nightly|latest nightly]]? It'll have the most recent bug fixes.
}}


|}
{{DISPLAYTITLE:iOS FAQ}}


[[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"