Archive:IOS FAQ: Difference between revisions
Gamester17 (talk | contribs) No edit summary |
mNo edit summary |
||
(38 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
{{ | {{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]'''. | ||
''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 | <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) == | ||
{| 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 | ||
Line 18: | Line 15: | ||
| Question= Installing and updating Kodi for iOS | | Question= Installing and updating Kodi for iOS | ||
| Answer= | | Answer= | ||
:{{main|HOW-TO:Install Kodi for iOS}} | |||
'''Requirements:''' | |||
{{#lst:Supported hardware|iDevices}} | |||
}} | }} | ||
{{FAQ|1=SSH | {{FAQ|1=SSH | ||
| BGcolor= | | BGcolor= | ||
| Question= SSH | | Question= SSH | ||
| Answer= | | 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: | * To SSH into an iOS device open your SSH application and type in: | ||
:<pre>ssh [email protected]</pre> | :<pre>ssh [email protected]</pre> | ||
Line 40: | Line 38: | ||
* 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.}} | * 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= | {{FAQ|1=Current_build|2=Kodi_Version | ||
| BGcolor= | | BGcolor= | ||
| Question= How do I find out what version of Kodi am I running? | | Question= How do I find out what version of Kodi am I running? | ||
| Answer= | | Answer= | ||
Line 59: | Line 57: | ||
{{FAQ|1=Media | {{FAQ|1=Media | ||
| BGcolor= | | BGcolor= | ||
| Question= Accessing media | | Question= Accessing media | ||
| Answer= | | 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. | |||
* | |||
}} | }} | ||
Line 70: | Line 67: | ||
| Question= Add-ons and skins | | Question= Add-ons and skins | ||
| Answer= | | Answer= | ||
* Kodi for iOS is a full version of Kodi and will be able to use all non-platform specific [[ | * 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. | ||
}} | }} | ||
Line 84: | Line 74: | ||
| Question= Backing up Kodi's settings | | Question= Backing up Kodi's settings | ||
| Answer= | | 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/ </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). | :<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= | {{FAQ|1=TouchControls | ||
| BGcolor= | | BGcolor= | ||
| Question= Touch screen controls | | Question= Touch screen controls | ||
| Answer= | | Answer= | ||
Line 225: | Line 96: | ||
| Answer= | | Answer= | ||
* Direct '''touch screen''' input | * 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. | * 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 232: | Line 103: | ||
{{FAQ|1=iDevice_output | {{FAQ|1=iDevice_output | ||
| BGcolor= | | BGcolor= | ||
| Question= Resolutions iDevices can play and output | | Question= Resolutions iDevices can play and output | ||
| Answer= | | Answer= | ||
Line 238: | Line 109: | ||
* Retina and widescreen is fully supported on iPhone 4, 4S, 5, 5c, 5S and iPod touch 4, 5. | * Retina and widescreen is fully supported on iPhone 4, 4S, 5, 5c, 5S and iPod touch 4, 5. | ||
* Retina GUI is supported for iPad 3, 4, iPad Air, and iPad mini 2 (Retina) but video playback is still clamped to 720, pending some issues. | * Retina GUI is supported for iPad 3, 4, iPad Air, and iPad mini 2 (Retina) but video playback is still clamped to 720, pending some issues. | ||
* '''Native video out as of | * '''Native video out as of v12 (Frodo) is now supported for HDMI adapter, VGA adapter, and AirPlay mirroring (to ATV2/3 only for mirroring). See '''[[#iOS to TV]]'''. | ||
}} | }} | ||
Line 245: | Line 116: | ||
| Question= How to use video output to a TV | | Question= How to use video output to a TV | ||
| Answer= | | Answer= | ||
{{main| | {{main|Archive:Use_video_output_on_iOS}} | ||
{{#lst: | {{#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= | | BGcolor= | ||
| Question= iPad camera connector for USB and SD cards | | Question= iPad camera connector for USB and SD cards | ||
| Answer= | | Answer= | ||
* | * 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. | * 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. | * 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. | # 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. | # 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. | # 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. | # 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] | * 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 268: | Line 141: | ||
== 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? | 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 Kodi for | | Question= Getting more help with Kodi for iOS | ||
| Answer= | | Answer= | ||
* '''[http://forum.kodi.tv/forumdisplay.php?f=137 Kodi for iOS specific help forum]''' | * '''[http://forum.kodi.tv/forumdisplay.php?f=137 Kodi for iOS specific help forum]''' | ||
Line 279: | Line 151: | ||
}} | }} | ||
{{FAQ|1=Userdata|2=Logs|3=logs|4=debuglog|5= | {{FAQ|1=Userdata|2=Logs|3=logs|4=debuglog|5=kodi.log | ||
| BGcolor= | | BGcolor= | ||
| Question= Userdata folder and logs | | Question= Userdata folder and logs | ||
| Answer= | | Answer= | ||
:{{see also|HOW-TO: | :{{see also|HOW-TO:Submit_a_bug_report|Log file/Easy}} | ||
* [[Userdata | * [[Userdata]]: {{highlight|/var/mobile/Library/Preferences/Kodi/userdata/}} | ||
* [[ | * [[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 299: | Line 171: | ||
{{FAQ|1=Settings|2=repair_settings | {{FAQ|1=Settings|2=repair_settings | ||
| BGcolor= | | 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 Kodi. 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 | * Run the following SSH command on the iOS device: | ||
<pre>chown -R mobile:mobile /private/var/mobile/Library/Preferences/Kodi/</pre> | <pre>chown -R mobile:mobile /private/var/mobile/Library/Preferences/Kodi/</pre> | ||
}} | }} | ||
{{FAQ|1=SkinChange | {{FAQ|1=SkinChange | ||
| BGcolor= | | BGcolor= | ||
| Question= Stuck on a bad skin | | Question= Stuck on a bad skin | ||
| Answer= | | Answer= | ||
Line 332: | Line 197: | ||
{{FAQ|1=AC3 | {{FAQ|1=AC3 | ||
| BGcolor= | | BGcolor= | ||
| Question= AC3 files stutter or have static noise | | Question= AC3 files stutter or have static noise | ||
| Answer= | | Answer= | ||
Line 342: | Line 207: | ||
| 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 | * 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}} | ||
Line 350: | Line 215: | ||
** {{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/}} | ||
}} | }} | ||
{{FAQ|1=Thumbnails | {{FAQ|1=Thumbnails | ||
| BGcolor= | | 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= | ||
HOW-TO:Reduce disk space usage | |||
}} | }} | ||
Line 364: | Line 228: | ||
| Question= Audio issues and/or slow video playback | | Question= Audio issues and/or slow video playback | ||
| Answer= | | Answer= | ||
* 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. | ||
* 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 Kodi: 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= | | BGcolor= | ||
| Question= Performance: video buffering, stuttering, choppiness | | Question= Performance: video buffering, stuttering, choppiness | ||
| Answer= | | Answer= | ||
Line 383: | Line 245: | ||
* Disable playback sync completely, Kodi -> 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]]. | ||
** See also | ** 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, | * 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). | ||
* 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 Kodi -> Settings -> System -> Audio output -> Select "Optical/Coax", even if you are using HDMI (it will still work). | ||
Line 399: | Line 261: | ||
| Answer= | | Answer= | ||
;General | ;General | ||
* Check your | * Check your logs for clues. | ||
* Have you [[#repair_settings|tried to repair permissions on Kodi'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.kodi.tv/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 | * 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'. | * 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. | * 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 Kodi to crash. [http://forum.kodi.tv/showthread.php?tid=145280] | * Recent versions of Plex on ATV2 can cause Kodi to crash. [http://forum.kodi.tv/showthread.php?tid=145280] | ||
Line 412: | Line 274: | ||
* 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]]. | * 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. | |||
{{DISPLAYTITLE:iOS FAQ}} | {{DISPLAYTITLE:iOS FAQ}} | ||
[[Category: | [[Category:Apple]] | ||
Latest revision as of 20:23, 11 December 2020
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)
| ||||||||||
| ||||||||||
| ||||||||||
| ||||||||||
| ||||||||||
| ||||||||||
| ||||||||||
| ||||||||||
| ||||||||||
| ||||||||||
| ||||||||||
| ||||||||||
|
Troubleshooting
Have you tried switching it off then on again?
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
| ||||
|
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.