Official Kodi Wiki - User contributions [en]

Log file/Advanced

2018-05-23T16:42:19Z

Tinwarble: /* Location */

{{mininav| [[Troubleshooting]] | [[HOW-TO:Submit a bug report]] | [[Log file]] }}

:{{bigger|''Not sure what to do, but someone just asked you for a "log file", "debug log", "kodi.log", or "xbmc.log"? '''[[Log file/Easy|Click here]].'''''}}

<section being="intro" />At some point during your foray into {{kodi}}, you will likely come up against a problem that isn't made 100% clear from errors in the GUI. This is where the log file comes into play. {{kodi}} writes all sorts of useful stuff to its log, which is why it should be included with every bug/problem report. Don't be afraid of its contents! Often a quick glance through the log will turn up a simple typo or missing file which you can easily fix on your own.<section end="intro" />

= Enable debugging = 
If someone asks for a debug log then debugging needs to be enabled. There are three ways to do this:

# Select the enable debug options in the '''[[#GUI settings|GUI settings]]'''
# Use an '''[[#advancedsettings.xml|advancedsettings.xml]]''' file
# Toggle debug logging with a '''[[#Keyboard or remote shortcut|keyboard or remote shortcut]]'''

== GUI settings ==
Most users only need to enable debug logging in the GUI.

In {{highlight|bordered=yes|[[Settings/System#Logging|Settings -> System -> Logging]]}} toggle the '''''Enable debug logging''''' setting.

{{#lst:Settings/System|debugging}}

== Turn on debugging using a file (advancedsettings.xml) ==
{{anchor|advancedsettings.xml}}
You can manually enable debug logging directly using an [[advancedsettings.xml]] file. This is especially useful if {{kodi}} is crashing during start-up and you are unable to turn debugging on via the GUI. The advancedsettings.xml file is simply a plain text document that is saved in the [[userdata folder]] and read when {{kodi}} first starts up. You can use the following examples to enable debug logging:

{{note|Be sure to format this as a '''plain text''' document, and make sure it is titled <code>advancedsettings.xml</code> and make sure the extension is ''just'' <code>.xml</code> and not something like ".xml.txt" or ".xml.doc". }}

=== advancedsettings.xml for normal debugging ===
If you want '''basic debug logging''' then use this. This the same as enabling logging in the GUI without enabling component-specific logging. Start with this one first if you are not sure which mode to use:

<syntaxhighlight lang="xml">
<advancedsettings>
<loglevel>2</loglevel> 
</advancedsettings>
</syntaxhighlight>

=== advancedsettings.xml for input devices ===
''Useful as you cannot enable debug logging in the GUI if your input devices don't work.''

If you only want debug logging with verbose components for '''input devices''' (JSON-RPC, CEC, HTTP, for remotes, smart phone remotes, web remotes, etc) then use this:
<syntaxhighlight lang="xml">
<advancedsettings>
<loglevel>2</loglevel> 
<debug>
<extralogging>true</extralogging>
<setextraloglevel>64,1024, 16384</setextraloglevel>
<showloginfo>true</showloginfo> 
</debug>
</advancedsettings>
</syntaxhighlight>

=== advancedsettings.xml for everything ===
If you want debug logging with '''all verbose components''' enabled use this.

{{note|Normally, you don't want to use this one unless specifically asked for it, as it will create a very hard-to-read debug log.}}

<syntaxhighlight lang="xml">
<advancedsettings>
<loglevel>2</loglevel> 
<debug>
<extralogging>true</extralogging>
<setextraloglevel>32,64,128,256,512,1024,2048,4096,8192,16384,32768,65536</setextraloglevel>
<showloginfo>true</showloginfo>
</debug>
</advancedsettings>
</syntaxhighlight>

=== Technical notes ===
{{collapse top}}
Everything except the <code><loglevel></code> tag is actually taken from guisettings.xml, but they can be used in the advancedsettings.xml file as a way to manually enable them.

As one can see from the previous sections, individual component logging is set using the <code><setextraloglevel></code> tag. A complete list of the components and their setting value follows:

{| class="prettytable"
! Component !! setting value
|-
| LOGSAMBA || 32
|-
| LOGCURL || 64
|-
| LOGFFMPEG || 128
|-
| LOGDBUS || 512
|-
| LOGJSONRPC || 1024
|-
| LOGAUDIO || 2048
|-
| LOGAIRTUNES || 4096
|-
| LOGUPNP || 8192
|-
| LOGCEC || 16384
|-
| LOGVIDEO || 32768
|-
| LOGWEBSERVER || 65536
|}
{{collapse bottom}}

== Password warning ==
{{Log file password warning}}

== Keyboard or remote shortcut ==
By plugging in a keyboard, debug mode can be toggled by pressing {{keypress|shift|ctrl|D}}

Other keys, or buttons on remotes, can be used to toggle debug mode. Just use the [[action ID]] <code>toggledebug</code> along with a custom '''[[keymap]]'''.

== Component-specific logging ==

For more extensive logging, several system components can be selected to put in more detailed debug messages in Kodi's log file. Multiple components can be selected for extending the debugging of the Kodi application.

[[File:Component-logging-selection.jpg|500px|Component logging selection window|right]]

First, you need to enable this feature via toggling

{{highlight|bordered=yes|[[Settings/System#Logging|Settings -> System -> Logging -> Enable component-specific logging]]}}.

Then specifiy which components you want logged into the Kodi log file.

{{highlight|bordered=yes|[[Settings/System#Logging|Settings -> System -> Logging -> - Specify component-specific logging...]]}}.

One or more components can be selected for further investigating the debugging on your Kodi device, subject to your Kodi hardware capabilities.

* The SMB library
* The libcURL library (HTTP(S), DAV)
* The FFmpeg libraries
* The Audio component
* The Video component
* D-Bus calls
* JSON-RPC requests
* The Webserver component
* The Airtunes library
* The UPnP components
* The libCEC library
* The Database component
* Audio/video timing information

= So what do I do with this thing? =

Whatever you do, please '''DO NOT''' paste it directly into IRC, a forum post or ticket on the bug tracker. This not only clutters said text, but the log is nearly impossible to read like this. If your log file is too big for the following methods, please restart {{kodi}} to start a clean log file file, recreate the problem in as few steps as possible, then stop {{kodi}} and try again. If it is still too large, try disabling features such as "scan library on startup", which spam's a lot of info to the log (unless of course this is where the problem is).

:{{note|{{big|'''Always include the whole debug log.''' Don't assume which portions of the log are relevant or not. }} }}

:{{note|Make sure you have enabled "debug logging". The normal log file, without debugging enabled, is almost always useless when it comes to troubleshooting!}}

=== In the forums and IRC ===
Use a pastesite such as http://pastebin.com , or http://paste.ubuntu.com on when posting on the forums. Simply visit one of these sites, paste or upload your log and hit submit. After a few seconds you'll have a nice short URL to paste in your post. Be sure to select an appropriate time to keep your paste around when submitting!

=== On the bug tracker ===
Just upload the log to your ticket as an attachment. '''DO NOT''' archive (zip,rar,tar,etc) it in anyway! Trac will let us view it right on the site without downloading.

=== Watch it locally, perhaps spotting errors you can fix or report ===
Using 'tail -f {location}' you can watch the log from a cmd/console (better with 2 displays), or better, via ssh (won't distract the gui).

= Log files =
* '''kodi.log''' or '''xbmc.log''' - This is the log file of most recent (or currently running) {{kodi}} session.
* '''kodi.old.log''' or '''xbmc.old.log''' - This is the log file from the last Kodi session. If {{kodi}} crashes AND you have restarted it before viewing the log, this is the one you want.

=== Location ===
''kodi.log'' {{small|(or ''xbmc.log'')}} and ''kodi.old.log'' {{small|(or ''xbmc.old.log'')}} are located here, depending on your platform:
{|class="prettytable"
! style="background: lightgrey; width: 150px" | '''Operative system'''
! style="background: lightgrey; width: 800px" | '''File/Folder Paths'''
|-
| colspan=2 | ''Directories and files named <code>'''kodi''' were called '''xbmc'''in versions before v14.''
|-
|'''Android''' || {{note|The first folder might be different on various devices:}}
*''<data/sdcard/Android>''/data/org.xbmc.kodi/cache/temp/kodi.log

*/sdcard/Android/data/org.xbmc.kodi/files/.kodi/temp/kodi.log

*/storage/emulated/0/Android/data/org.xbmc.kodi/files/.kodi/temp/kodi.log
|-
|'''iOS/ATV2''' || /private/var/mobile/Library/Preferences/kodi.log
|-
|'''Linux''' || $HOME/.kodi/temp/kodi.log
|-
|'''Raspberry Pi''' || /storage/.kodi/temp/kodi.log
|-
|'''macOS''' || /Users/''<username>''/Library/Logs/kodi.log
|-
|'''Windows desktop''' || %APPDATA%\Kodi\kodi.log
|-
|'''Windows store (UWP)''' || %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\kodi.log
|-
| '''[[Special protocol]]''' || special://logpath (this can be used by scripts)
|}

See '''[[Log file/File manager access]]''' for how to copy the debug log file using the [[File manager]].

= Easy ways to get and post the log file =
=== Debug log add-on ===
{{main|Log file/Easy}}
You can use the '''[[Add-on:Kodi Log Uploader|Kodi Logfile Uploader]]''' to make the process of getting your debug log easier.

=== Automatic pastebin log in Linux via command line ===
You can generate a debug.log [http://en.wikipedia.org/wiki/Pastebin Pastebin] link automatically quickly to post anywhere that requires a debug.log.
<br />
:'''''See also:''''' [[SSH|Accessing Kodi via SSH]] e.g. Putty

:{{note|Don't forget to [[#Enable debugging|enable debugging]]}}
<pre>sudo apt-get install pastebinit -y

cat $HOME/.kodi/temp/kodi.log | pastebinit</pre>
''(or cat $HOME/.Kodi/temp/kodi.log | pastebinit)''

Submit the link you get in any forums discussion where you post about '''any''' problem.

= Technical details about log files =
{{Editor note|This section might be outdated now that {{kodi}} has component-level logging. Some of it should still be true, but just keep in mind that this section hasn't been totally cleaned up for v13 and v14 yet.}}

=== Layout ===
Each event is logged to one line of the {{kodi}} log file which is formatted as follows...
<pre>[TIMESTAMP] T:[THREADID] M:[FREEMEM] [LEVEL]: [MESSAGE]</pre>
* '''TIMESTAMP''' - The wall time at which the event occurred.
* '''THREADID''' - The thread identification number of the thread in which the event occurred.
* '''FREEMEM''' - The amount of memory (in bytes) free at the time of the event.
* '''LEVEL''' - The severity of the event.
* '''MESSAGE''' - A brief description and/or important information about the event.

=== Log levels ===
There are two different types levels when talking about the {{kodi}} log. The first is the severity of event that has occurred. The second controls which severity levels are actually printed out to the log.

;Severity levels
In order from least to most severe...
* '''DEBUG''' - In depth information about the status of {{kodi}}. This information can pretty much only be deciphered by a developer or long time {{kodi}} power user.
* '''INFO''' - Something has happened. It's not a problem, we just thought you might want to know. Fairly excessive output that most people won't care about.
* '''NOTICE''' - Similar to INFO but the average Joe might want to know about these events. This level and above are logged by default.
* '''WARNING''' - Something potentially bad has happened. If {{kodi}} did something you didn't expect, this is probably why. Watch for errors to follow.
* '''ERROR''' - This event is bad. Something has failed. You likely noticed problems with the application be it skin artifacts, failure of playback a crash, etc.
* '''FATAL''' - We're screwed. {{kodi}} is about to crash.

;Log file control levels
In order from least to most information provided...
* '''None''' - No logging will occur. ''kodi.log'' will likely be created but should remain empty.
* '''Normal''' - The default loglevel. Events with a severity of NOTICE or greater will be logged.
* '''Debug''' - All events are logged. This level (or higher) is all that you should bother someone else with.
* '''Debug w/ Visuals''' - Same printed log as ''Debug'', but free memory and CPU usage are rendered on the screen as well.
* '''SMB Debug''' - Same as ''Debug w/ Visuals'' with the addition of ridiculous amounts of Samba debugging info. Use this only if asked.


= See also =
* [[HOW-TO:Submit a bug report]]
* [[Bug tracker]]
* [[Troubleshooting]]

{{Updated|17}}

[[Category:Development]]
[[Category:Trac]]
[[Category:Manual]]
[[Category:Troubleshooting]]
[[Category:Advanced topics]]

Log file/Advanced

2018-05-23T16:41:22Z

Tinwarble: /* Location */

{{mininav| [[Troubleshooting]] | [[HOW-TO:Submit a bug report]] | [[Log file]] }}

:{{bigger|''Not sure what to do, but someone just asked you for a "log file", "debug log", "kodi.log", or "xbmc.log"? '''[[Log file/Easy|Click here]].'''''}}

<section being="intro" />At some point during your foray into {{kodi}}, you will likely come up against a problem that isn't made 100% clear from errors in the GUI. This is where the log file comes into play. {{kodi}} writes all sorts of useful stuff to its log, which is why it should be included with every bug/problem report. Don't be afraid of its contents! Often a quick glance through the log will turn up a simple typo or missing file which you can easily fix on your own.<section end="intro" />

= Enable debugging = 
If someone asks for a debug log then debugging needs to be enabled. There are three ways to do this:

# Select the enable debug options in the '''[[#GUI settings|GUI settings]]'''
# Use an '''[[#advancedsettings.xml|advancedsettings.xml]]''' file
# Toggle debug logging with a '''[[#Keyboard or remote shortcut|keyboard or remote shortcut]]'''

== GUI settings ==
Most users only need to enable debug logging in the GUI.

In {{highlight|bordered=yes|[[Settings/System#Logging|Settings -> System -> Logging]]}} toggle the '''''Enable debug logging''''' setting.

{{#lst:Settings/System|debugging}}

== Turn on debugging using a file (advancedsettings.xml) ==
{{anchor|advancedsettings.xml}}
You can manually enable debug logging directly using an [[advancedsettings.xml]] file. This is especially useful if {{kodi}} is crashing during start-up and you are unable to turn debugging on via the GUI. The advancedsettings.xml file is simply a plain text document that is saved in the [[userdata folder]] and read when {{kodi}} first starts up. You can use the following examples to enable debug logging:

{{note|Be sure to format this as a '''plain text''' document, and make sure it is titled <code>advancedsettings.xml</code> and make sure the extension is ''just'' <code>.xml</code> and not something like ".xml.txt" or ".xml.doc". }}

=== advancedsettings.xml for normal debugging ===
If you want '''basic debug logging''' then use this. This the same as enabling logging in the GUI without enabling component-specific logging. Start with this one first if you are not sure which mode to use:

<syntaxhighlight lang="xml">
<advancedsettings>
<loglevel>2</loglevel> 
</advancedsettings>
</syntaxhighlight>

=== advancedsettings.xml for input devices ===
''Useful as you cannot enable debug logging in the GUI if your input devices don't work.''

If you only want debug logging with verbose components for '''input devices''' (JSON-RPC, CEC, HTTP, for remotes, smart phone remotes, web remotes, etc) then use this:
<syntaxhighlight lang="xml">
<advancedsettings>
<loglevel>2</loglevel> 
<debug>
<extralogging>true</extralogging>
<setextraloglevel>64,1024, 16384</setextraloglevel>
<showloginfo>true</showloginfo> 
</debug>
</advancedsettings>
</syntaxhighlight>

=== advancedsettings.xml for everything ===
If you want debug logging with '''all verbose components''' enabled use this.

{{note|Normally, you don't want to use this one unless specifically asked for it, as it will create a very hard-to-read debug log.}}

<syntaxhighlight lang="xml">
<advancedsettings>
<loglevel>2</loglevel> 
<debug>
<extralogging>true</extralogging>
<setextraloglevel>32,64,128,256,512,1024,2048,4096,8192,16384,32768,65536</setextraloglevel>
<showloginfo>true</showloginfo>
</debug>
</advancedsettings>
</syntaxhighlight>

=== Technical notes ===
{{collapse top}}
Everything except the <code><loglevel></code> tag is actually taken from guisettings.xml, but they can be used in the advancedsettings.xml file as a way to manually enable them.

As one can see from the previous sections, individual component logging is set using the <code><setextraloglevel></code> tag. A complete list of the components and their setting value follows:

{| class="prettytable"
! Component !! setting value
|-
| LOGSAMBA || 32
|-
| LOGCURL || 64
|-
| LOGFFMPEG || 128
|-
| LOGDBUS || 512
|-
| LOGJSONRPC || 1024
|-
| LOGAUDIO || 2048
|-
| LOGAIRTUNES || 4096
|-
| LOGUPNP || 8192
|-
| LOGCEC || 16384
|-
| LOGVIDEO || 32768
|-
| LOGWEBSERVER || 65536
|}
{{collapse bottom}}

== Password warning ==
{{Log file password warning}}

== Keyboard or remote shortcut ==
By plugging in a keyboard, debug mode can be toggled by pressing {{keypress|shift|ctrl|D}}

Other keys, or buttons on remotes, can be used to toggle debug mode. Just use the [[action ID]] <code>toggledebug</code> along with a custom '''[[keymap]]'''.

== Component-specific logging ==

For more extensive logging, several system components can be selected to put in more detailed debug messages in Kodi's log file. Multiple components can be selected for extending the debugging of the Kodi application.

[[File:Component-logging-selection.jpg|500px|Component logging selection window|right]]

First, you need to enable this feature via toggling

{{highlight|bordered=yes|[[Settings/System#Logging|Settings -> System -> Logging -> Enable component-specific logging]]}}.

Then specifiy which components you want logged into the Kodi log file.

{{highlight|bordered=yes|[[Settings/System#Logging|Settings -> System -> Logging -> - Specify component-specific logging...]]}}.

One or more components can be selected for further investigating the debugging on your Kodi device, subject to your Kodi hardware capabilities.

* The SMB library
* The libcURL library (HTTP(S), DAV)
* The FFmpeg libraries
* The Audio component
* The Video component
* D-Bus calls
* JSON-RPC requests
* The Webserver component
* The Airtunes library
* The UPnP components
* The libCEC library
* The Database component
* Audio/video timing information

= So what do I do with this thing? =

Whatever you do, please '''DO NOT''' paste it directly into IRC, a forum post or ticket on the bug tracker. This not only clutters said text, but the log is nearly impossible to read like this. If your log file is too big for the following methods, please restart {{kodi}} to start a clean log file file, recreate the problem in as few steps as possible, then stop {{kodi}} and try again. If it is still too large, try disabling features such as "scan library on startup", which spam's a lot of info to the log (unless of course this is where the problem is).

:{{note|{{big|'''Always include the whole debug log.''' Don't assume which portions of the log are relevant or not. }} }}

:{{note|Make sure you have enabled "debug logging". The normal log file, without debugging enabled, is almost always useless when it comes to troubleshooting!}}

=== In the forums and IRC ===
Use a pastesite such as http://pastebin.com , or http://paste.ubuntu.com on when posting on the forums. Simply visit one of these sites, paste or upload your log and hit submit. After a few seconds you'll have a nice short URL to paste in your post. Be sure to select an appropriate time to keep your paste around when submitting!

=== On the bug tracker ===
Just upload the log to your ticket as an attachment. '''DO NOT''' archive (zip,rar,tar,etc) it in anyway! Trac will let us view it right on the site without downloading.

=== Watch it locally, perhaps spotting errors you can fix or report ===
Using 'tail -f {location}' you can watch the log from a cmd/console (better with 2 displays), or better, via ssh (won't distract the gui).

= Log files =
* '''kodi.log''' or '''xbmc.log''' - This is the log file of most recent (or currently running) {{kodi}} session.
* '''kodi.old.log''' or '''xbmc.old.log''' - This is the log file from the last Kodi session. If {{kodi}} crashes AND you have restarted it before viewing the log, this is the one you want.

=== Location ===
''kodi.log'' {{small|(or ''xbmc.log'')}} and ''kodi.old.log'' {{small|(or ''xbmc.old.log'')}} are located here, depending on your platform:
{|class="prettytable"
! style="background: lightgrey; width: 150px" | '''Operative system'''
! style="background: lightgrey; width: 800px" | '''File/Folder Paths'''
|-
| colspan=2 | ''Directories and files named <code>'''kodi''' were called <code>'''xbmc'''in versions before v14.''
|-
|'''Android''' || {{note|The first folder might be different on various devices:}}
*''<data/sdcard/Android>''/data/org.xbmc.kodi/cache/temp/kodi.log

*/sdcard/Android/data/org.xbmc.kodi/files/.kodi/temp/kodi.log

*/storage/emulated/0/Android/data/org.xbmc.kodi/files/.kodi/temp/kodi.log
|-
|'''iOS/ATV2''' || /private/var/mobile/Library/Preferences/kodi.log
|-
|'''Linux''' || $HOME/.kodi/temp/kodi.log
|-
|'''Raspberry Pi''' || /storage/.kodi/temp/kodi.log
|-
|'''macOS''' || /Users/''<username>''/Library/Logs/kodi.log
|-
|'''Windows desktop''' || %APPDATA%\Kodi\kodi.log
|-
|'''Windows store (UWP)''' || %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\kodi.log
|-
| '''[[Special protocol]]''' || special://logpath (this can be used by scripts)
|}

See '''[[Log file/File manager access]]''' for how to copy the debug log file using the [[File manager]].

= Easy ways to get and post the log file =
=== Debug log add-on ===
{{main|Log file/Easy}}
You can use the '''[[Add-on:Kodi Log Uploader|Kodi Logfile Uploader]]''' to make the process of getting your debug log easier.

=== Automatic pastebin log in Linux via command line ===
You can generate a debug.log [http://en.wikipedia.org/wiki/Pastebin Pastebin] link automatically quickly to post anywhere that requires a debug.log.
<br />
:'''''See also:''''' [[SSH|Accessing Kodi via SSH]] e.g. Putty

:{{note|Don't forget to [[#Enable debugging|enable debugging]]}}
<pre>sudo apt-get install pastebinit -y

cat $HOME/.kodi/temp/kodi.log | pastebinit</pre>
''(or cat $HOME/.Kodi/temp/kodi.log | pastebinit)''

Submit the link you get in any forums discussion where you post about '''any''' problem.

= Technical details about log files =
{{Editor note|This section might be outdated now that {{kodi}} has component-level logging. Some of it should still be true, but just keep in mind that this section hasn't been totally cleaned up for v13 and v14 yet.}}

=== Layout ===
Each event is logged to one line of the {{kodi}} log file which is formatted as follows...
<pre>[TIMESTAMP] T:[THREADID] M:[FREEMEM] [LEVEL]: [MESSAGE]</pre>
* '''TIMESTAMP''' - The wall time at which the event occurred.
* '''THREADID''' - The thread identification number of the thread in which the event occurred.
* '''FREEMEM''' - The amount of memory (in bytes) free at the time of the event.
* '''LEVEL''' - The severity of the event.
* '''MESSAGE''' - A brief description and/or important information about the event.

=== Log levels ===
There are two different types levels when talking about the {{kodi}} log. The first is the severity of event that has occurred. The second controls which severity levels are actually printed out to the log.

;Severity levels
In order from least to most severe...
* '''DEBUG''' - In depth information about the status of {{kodi}}. This information can pretty much only be deciphered by a developer or long time {{kodi}} power user.
* '''INFO''' - Something has happened. It's not a problem, we just thought you might want to know. Fairly excessive output that most people won't care about.
* '''NOTICE''' - Similar to INFO but the average Joe might want to know about these events. This level and above are logged by default.
* '''WARNING''' - Something potentially bad has happened. If {{kodi}} did something you didn't expect, this is probably why. Watch for errors to follow.
* '''ERROR''' - This event is bad. Something has failed. You likely noticed problems with the application be it skin artifacts, failure of playback a crash, etc.
* '''FATAL''' - We're screwed. {{kodi}} is about to crash.

;Log file control levels
In order from least to most information provided...
* '''None''' - No logging will occur. ''kodi.log'' will likely be created but should remain empty.
* '''Normal''' - The default loglevel. Events with a severity of NOTICE or greater will be logged.
* '''Debug''' - All events are logged. This level (or higher) is all that you should bother someone else with.
* '''Debug w/ Visuals''' - Same printed log as ''Debug'', but free memory and CPU usage are rendered on the screen as well.
* '''SMB Debug''' - Same as ''Debug w/ Visuals'' with the addition of ridiculous amounts of Samba debugging info. Use this only if asked.


= See also =
* [[HOW-TO:Submit a bug report]]
* [[Bug tracker]]
* [[Troubleshooting]]

{{Updated|17}}

[[Category:Development]]
[[Category:Trac]]
[[Category:Manual]]
[[Category:Troubleshooting]]
[[Category:Advanced topics]]

Log file/Advanced

2018-05-23T16:40:21Z

Tinwarble: /* Location */

{{mininav| [[Troubleshooting]] | [[HOW-TO:Submit a bug report]] | [[Log file]] }}

:{{bigger|''Not sure what to do, but someone just asked you for a "log file", "debug log", "kodi.log", or "xbmc.log"? '''[[Log file/Easy|Click here]].'''''}}

<section being="intro" />At some point during your foray into {{kodi}}, you will likely come up against a problem that isn't made 100% clear from errors in the GUI. This is where the log file comes into play. {{kodi}} writes all sorts of useful stuff to its log, which is why it should be included with every bug/problem report. Don't be afraid of its contents! Often a quick glance through the log will turn up a simple typo or missing file which you can easily fix on your own.<section end="intro" />

= Enable debugging = 
If someone asks for a debug log then debugging needs to be enabled. There are three ways to do this:

# Select the enable debug options in the '''[[#GUI settings|GUI settings]]'''
# Use an '''[[#advancedsettings.xml|advancedsettings.xml]]''' file
# Toggle debug logging with a '''[[#Keyboard or remote shortcut|keyboard or remote shortcut]]'''

== GUI settings ==
Most users only need to enable debug logging in the GUI.

In {{highlight|bordered=yes|[[Settings/System#Logging|Settings -> System -> Logging]]}} toggle the '''''Enable debug logging''''' setting.

{{#lst:Settings/System|debugging}}

== Turn on debugging using a file (advancedsettings.xml) ==
{{anchor|advancedsettings.xml}}
You can manually enable debug logging directly using an [[advancedsettings.xml]] file. This is especially useful if {{kodi}} is crashing during start-up and you are unable to turn debugging on via the GUI. The advancedsettings.xml file is simply a plain text document that is saved in the [[userdata folder]] and read when {{kodi}} first starts up. You can use the following examples to enable debug logging:

{{note|Be sure to format this as a '''plain text''' document, and make sure it is titled <code>advancedsettings.xml</code> and make sure the extension is ''just'' <code>.xml</code> and not something like ".xml.txt" or ".xml.doc". }}

=== advancedsettings.xml for normal debugging ===
If you want '''basic debug logging''' then use this. This the same as enabling logging in the GUI without enabling component-specific logging. Start with this one first if you are not sure which mode to use:

<syntaxhighlight lang="xml">
<advancedsettings>
<loglevel>2</loglevel> 
</advancedsettings>
</syntaxhighlight>

=== advancedsettings.xml for input devices ===
''Useful as you cannot enable debug logging in the GUI if your input devices don't work.''

If you only want debug logging with verbose components for '''input devices''' (JSON-RPC, CEC, HTTP, for remotes, smart phone remotes, web remotes, etc) then use this:
<syntaxhighlight lang="xml">
<advancedsettings>
<loglevel>2</loglevel> 
<debug>
<extralogging>true</extralogging>
<setextraloglevel>64,1024, 16384</setextraloglevel>
<showloginfo>true</showloginfo> 
</debug>
</advancedsettings>
</syntaxhighlight>

=== advancedsettings.xml for everything ===
If you want debug logging with '''all verbose components''' enabled use this.

{{note|Normally, you don't want to use this one unless specifically asked for it, as it will create a very hard-to-read debug log.}}

<syntaxhighlight lang="xml">
<advancedsettings>
<loglevel>2</loglevel> 
<debug>
<extralogging>true</extralogging>
<setextraloglevel>32,64,128,256,512,1024,2048,4096,8192,16384,32768,65536</setextraloglevel>
<showloginfo>true</showloginfo>
</debug>
</advancedsettings>
</syntaxhighlight>

=== Technical notes ===
{{collapse top}}
Everything except the <code><loglevel></code> tag is actually taken from guisettings.xml, but they can be used in the advancedsettings.xml file as a way to manually enable them.

As one can see from the previous sections, individual component logging is set using the <code><setextraloglevel></code> tag. A complete list of the components and their setting value follows:

{| class="prettytable"
! Component !! setting value
|-
| LOGSAMBA || 32
|-
| LOGCURL || 64
|-
| LOGFFMPEG || 128
|-
| LOGDBUS || 512
|-
| LOGJSONRPC || 1024
|-
| LOGAUDIO || 2048
|-
| LOGAIRTUNES || 4096
|-
| LOGUPNP || 8192
|-
| LOGCEC || 16384
|-
| LOGVIDEO || 32768
|-
| LOGWEBSERVER || 65536
|}
{{collapse bottom}}

== Password warning ==
{{Log file password warning}}

== Keyboard or remote shortcut ==
By plugging in a keyboard, debug mode can be toggled by pressing {{keypress|shift|ctrl|D}}

Other keys, or buttons on remotes, can be used to toggle debug mode. Just use the [[action ID]] <code>toggledebug</code> along with a custom '''[[keymap]]'''.

== Component-specific logging ==

For more extensive logging, several system components can be selected to put in more detailed debug messages in Kodi's log file. Multiple components can be selected for extending the debugging of the Kodi application.

[[File:Component-logging-selection.jpg|500px|Component logging selection window|right]]

First, you need to enable this feature via toggling

{{highlight|bordered=yes|[[Settings/System#Logging|Settings -> System -> Logging -> Enable component-specific logging]]}}.

Then specifiy which components you want logged into the Kodi log file.

{{highlight|bordered=yes|[[Settings/System#Logging|Settings -> System -> Logging -> - Specify component-specific logging...]]}}.

One or more components can be selected for further investigating the debugging on your Kodi device, subject to your Kodi hardware capabilities.

* The SMB library
* The libcURL library (HTTP(S), DAV)
* The FFmpeg libraries
* The Audio component
* The Video component
* D-Bus calls
* JSON-RPC requests
* The Webserver component
* The Airtunes library
* The UPnP components
* The libCEC library
* The Database component
* Audio/video timing information

= So what do I do with this thing? =

Whatever you do, please '''DO NOT''' paste it directly into IRC, a forum post or ticket on the bug tracker. This not only clutters said text, but the log is nearly impossible to read like this. If your log file is too big for the following methods, please restart {{kodi}} to start a clean log file file, recreate the problem in as few steps as possible, then stop {{kodi}} and try again. If it is still too large, try disabling features such as "scan library on startup", which spam's a lot of info to the log (unless of course this is where the problem is).

:{{note|{{big|'''Always include the whole debug log.''' Don't assume which portions of the log are relevant or not. }} }}

:{{note|Make sure you have enabled "debug logging". The normal log file, without debugging enabled, is almost always useless when it comes to troubleshooting!}}

=== In the forums and IRC ===
Use a pastesite such as http://pastebin.com , or http://paste.ubuntu.com on when posting on the forums. Simply visit one of these sites, paste or upload your log and hit submit. After a few seconds you'll have a nice short URL to paste in your post. Be sure to select an appropriate time to keep your paste around when submitting!

=== On the bug tracker ===
Just upload the log to your ticket as an attachment. '''DO NOT''' archive (zip,rar,tar,etc) it in anyway! Trac will let us view it right on the site without downloading.

=== Watch it locally, perhaps spotting errors you can fix or report ===
Using 'tail -f {location}' you can watch the log from a cmd/console (better with 2 displays), or better, via ssh (won't distract the gui).

= Log files =
* '''kodi.log''' or '''xbmc.log''' - This is the log file of most recent (or currently running) {{kodi}} session.
* '''kodi.old.log''' or '''xbmc.old.log''' - This is the log file from the last Kodi session. If {{kodi}} crashes AND you have restarted it before viewing the log, this is the one you want.

=== Location ===
''kodi.log'' {{small|(or ''xbmc.log'')}} and ''kodi.old.log'' {{small|(or ''xbmc.old.log'')}} are located here, depending on your platform:
{|class="prettytable"
! style="background: lightgrey; width: 150px" | '''Operative system'''
! style="background: lightgrey; width: 800px" | '''File/Folder Paths'''
|-
| colspan=2 | ''Directories and files named <code>'''kodi''' were called <code>'''xbmc'''in versions before v14.''
|-
|'''Android''' || {{note|The first folder might be different on various devices:}}
*''<data/sdcard/Android>''/data/org.xbmc.kodi/cache/temp/kodi.log

*/sdcard/Android/data/org.xbmc.kodi/files/.kodi/temp/kodi.log

*/storage/emulated/0/Android/data/org.xbmc.kodi/files/.kodi/temp/kodi.log
|-
|'''iOS/ATV2''' || /private/var/mobile/Library/Preferences/kodi.log
|-
|'''Linux''' || $HOME/.kodi/temp/kodi.log
|-
|'''Raspberry Pi''' || /storage/.kodi/temp/kodi.log
|-
|'''macOS''' || /Users/''<username>''/Library/Logs/kodi.log
|-
|'''Windows desktop''' || %APPDATA%\Kodi\kodi.log
|-
|'''Windows store (UWP)''' || <code>%LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\kodi.log</code>
|-
| '''[[Special protocol]]''' || <code>special://logpath (this can be used by scripts)</code>
|}

See '''[[Log file/File manager access]]''' for how to copy the debug log file using the [[File manager]].

= Easy ways to get and post the log file =
=== Debug log add-on ===
{{main|Log file/Easy}}
You can use the '''[[Add-on:Kodi Log Uploader|Kodi Logfile Uploader]]''' to make the process of getting your debug log easier.

=== Automatic pastebin log in Linux via command line ===
You can generate a debug.log [http://en.wikipedia.org/wiki/Pastebin Pastebin] link automatically quickly to post anywhere that requires a debug.log.
<br />
:'''''See also:''''' [[SSH|Accessing Kodi via SSH]] e.g. Putty

:{{note|Don't forget to [[#Enable debugging|enable debugging]]}}
<pre>sudo apt-get install pastebinit -y

cat $HOME/.kodi/temp/kodi.log | pastebinit</pre>
''(or cat $HOME/.Kodi/temp/kodi.log | pastebinit)''

Submit the link you get in any forums discussion where you post about '''any''' problem.

= Technical details about log files =
{{Editor note|This section might be outdated now that {{kodi}} has component-level logging. Some of it should still be true, but just keep in mind that this section hasn't been totally cleaned up for v13 and v14 yet.}}

=== Layout ===
Each event is logged to one line of the {{kodi}} log file which is formatted as follows...
<pre>[TIMESTAMP] T:[THREADID] M:[FREEMEM] [LEVEL]: [MESSAGE]</pre>
* '''TIMESTAMP''' - The wall time at which the event occurred.
* '''THREADID''' - The thread identification number of the thread in which the event occurred.
* '''FREEMEM''' - The amount of memory (in bytes) free at the time of the event.
* '''LEVEL''' - The severity of the event.
* '''MESSAGE''' - A brief description and/or important information about the event.

=== Log levels ===
There are two different types levels when talking about the {{kodi}} log. The first is the severity of event that has occurred. The second controls which severity levels are actually printed out to the log.

;Severity levels
In order from least to most severe...
* '''DEBUG''' - In depth information about the status of {{kodi}}. This information can pretty much only be deciphered by a developer or long time {{kodi}} power user.
* '''INFO''' - Something has happened. It's not a problem, we just thought you might want to know. Fairly excessive output that most people won't care about.
* '''NOTICE''' - Similar to INFO but the average Joe might want to know about these events. This level and above are logged by default.
* '''WARNING''' - Something potentially bad has happened. If {{kodi}} did something you didn't expect, this is probably why. Watch for errors to follow.
* '''ERROR''' - This event is bad. Something has failed. You likely noticed problems with the application be it skin artifacts, failure of playback a crash, etc.
* '''FATAL''' - We're screwed. {{kodi}} is about to crash.

;Log file control levels
In order from least to most information provided...
* '''None''' - No logging will occur. ''kodi.log'' will likely be created but should remain empty.
* '''Normal''' - The default loglevel. Events with a severity of NOTICE or greater will be logged.
* '''Debug''' - All events are logged. This level (or higher) is all that you should bother someone else with.
* '''Debug w/ Visuals''' - Same printed log as ''Debug'', but free memory and CPU usage are rendered on the screen as well.
* '''SMB Debug''' - Same as ''Debug w/ Visuals'' with the addition of ridiculous amounts of Samba debugging info. Use this only if asked.


= See also =
* [[HOW-TO:Submit a bug report]]
* [[Bug tracker]]
* [[Troubleshooting]]

{{Updated|17}}

[[Category:Development]]
[[Category:Trac]]
[[Category:Manual]]
[[Category:Troubleshooting]]
[[Category:Advanced topics]]

HOW-TO:Install Kodi for Windows

2017-11-07T01:42:33Z

Tinwarble: /* Userdata */

{{mininav| [[Windows]] }}
[[File:Windows_10_Logo_svg.png|300px|right]]
[[File:windows-8-logo.png|150px|right]]
[[File:Windows_7_logo.png|150px|right]]

__TOC__

== Installing Kodi ==

The installation of Kodi for Windows is performed in the same manner as most other windows applications.

The Download page is located here... [http://kodi.tv/download/849 http://kodi.tv/download/]

A number of download options are available, each detailed as follows:

=== Release or Stable ===
The Release version is the most current and stable version of Kodi available for Windows. If you are a general user wanting hassle free installation and operation, the Release version is the one for you.

=== Nightly ===
Kodi is in a constant state of upgrade and improvement. The Nightly version is the forward progression of the Release version. The nightly does not include new features. It's purpose is to fix bugs that have been discovered in the official Release version of Kodi.

The nightly is available for download and installation. If you have been affected by a bug that is fixed in the nightly version, then it is safe to use a nightly version.

=== Development Builds ===
These development builds, often called “pre-release” builds, are what will eventually lead to the final product of the next version. '''THESE BUILDS COULD BE UNSTABLE''' and are for users that do not fear bugs or possibly crashes and data loss. They are mainly used for development to help us in testing for the upcoming releases. If you want a stable HTPC then please install the stable build instead. '''Always backup before using a development build.'''

== Which Install Method ==
There are a number of methods available to install Kodi. Choose an installation method you understand and are comfortable with.

=== Installer ===
This is the most commonly used method and is similar to installing any other MS Windows software.

# On the download page, click '''Installer (32BIT)'''
# You will be offered the standard '''Run''', '''Save''', '''Cancel''' options.
# Once downloaded, installation will commence automatically if the '''Run''' option was selected, or you will need to double click the downloaded file if the '''Save''' option was selected. Once installation commences, simply follow the steps as shown on screen. For most users the offered default settings are sufficient, if not, change them accordingly if you are sure you have to.

The following video guide may help you with this install process.

{{#widget:YouTube|id=pfV9Z691n40}}

{{divbox|green||'''Note:''' Please note that Kodi v15 is shown in the video. v17 will show a different menu system}}

=== Windows Store ===
Kodi may be downloaded from the Windows Store as an App. It is still the same Kodi version as the “Installer” version. There are no changes or limitations using this version. The store version brings a few benefits, such as automatic updating.

Selecting this option will take you to the Kodi page at the MS Windows Store. Click the large Kodi icon to commence the install process.

To read more about the introduction of the Windows Store version click here... [https://kodi.tv/article/kodi-goes-windows-store Windows Store Blog]

=== Chocolatey ===
If you have Chocolatey installed, you may run the command line installer. For instructions, visit the Kodi Package page at [https://chocolatey.org/packages/kodi Chocolately].

=== Portable Mode ===
If you have a requirement to run a different version of Kodi, or run a basic install for the purpose of fault finding and testing, without removing your current installation, Kodi has the ability to run in portable mode. This is a Windows only feature. It gives the user the flexibility to install multiples of the same version or multiple different versions. Follow these steps to install additional Kodi setups on the same computer.

* Download required version of Kodi
* During the installation process of Kodi you will be prompted with where the destination folder should go, this needs to be changed, either to a removable USB device or another folder or hard drive on your computer. If you install Kodi to your computer you'll have to put the Kodi folder in a place where standard users have write permission (e.g. ''not'' under Program Files) or run the shortcut as admin (even though you're logged in with an admin account). Otherwise you'll get the error message "ERROR: Unable to create application. Exiting."
* '''Once the Install has finished do not run Kodi''' until the remainder of these steps have been completed.
* Navigate to where you just installed Kodi which is planned to be your portable install
* Create a shortcut to kodi.exe. Usually by right clicking on the kodi.exe file and selecting ''Send to desktop (create shortcut)''
* Right click on the newly created shortcut and select ''Properties''. There will be a box called ''Target:'', add the switch ''-p'' after kodi.exe i.e. P:\Kodi\kodi.exe -p and save the change
* Start Kodi. This will then use the Kodi folder itself as the Home folder, which means scripts, plugins, skins and userdata will be located in the 'portable_data' folder within the Kodi folder.
* You will, however, have to be careful when upgrading to make sure that the [[userdata]] folder you use is not overwritten.

== Upgrading Kodi ==
The dedicated team of Kodi volunteers are always working to improve and enhance your Kodi experience. At various times throughout the year, new stable versions of Kodi are released.

Upgrading is a simple task. Following the “How To Install” guide above will allow you to upgrade Kodi to the latest version. Be aware of the following though

* It is not necessary to uninstall the previous version. If you are happy with your current setup, installing “over the top” is ok.
* Make a backup of your '''%appdata%\Kodi''' directory. Do not upgrade without backing up first. {{See|Backup}}
* Ensure your hardware meets the minimum requirements before upgrading. {{See|Hardware_requirement}}
* If you have a favourite add-on or skin, ensure they have also been upgraded to work in the new version of Kodi. If the upgrade is a decimal upgrade (eg v17 to v17.1) then all skins and add-ons should still be compatible.
*It is currently possible to upgrade from v14 to v17 in one jump

{{#widget:YouTube|id=V0eLSeuN0Gs}}
{{divbox|green||'''Note:''' Please note that Kodi v15 is shown in the video. v17 will show a different menu system}}

=== Upgrading XBMC ===
{{See| Migration_from_XBMC_to_Kodi}}

If you are one of the few people still using a version of XBMC, you must follow the instructions in the above mentioned guide to upgrade to the latest stable release. Be aware of the following

* Ensure your hardware meets the minimum requirements before upgrading. {{See|Hardware_requirement}}
* If you have a favourite add-on or skin, ensure they have also been upgraded to work in the new version of Kodi.

== Older Kodi Versions ==
Looking for an older version of Kodi? They can be found here...
[http://mirrors.kodi.tv/releases/win32/old/ http://mirrors.kodi.tv/releases/win32/old/]

== Uninstalling Kodi ==
Kodi is installed in two locations. Which parts of Kodi you uninstall depends on the reason for your requirement. The two locations are as follows:

=== Program ===
This is the install location for the core program of Kodi. There should be no user interaction with this folder, same as any other program installed in the ''Program files'' folder of your computer.

The Kodi program is installed by default here...
C:\Program Files (x86)\Kodi

To uninstall the data from here, you should run Windows Add or Remove Programs. You will also have the option to remove the ''\Kodi\userdata'' folder.

=== Userdata ===
The userdata folder is the location where all subsequent changes are made, like creating libraries, new skins or add-ons etc. This is a different ''Kodi'' folder to where the Kodi program is installed. All modifications to Kodi are saved in the ''Userdata'' folder.

Be aware that when using the term '''Userdata''' we are referencing the '''Kodi''' folder located in the '''\Roaming\''' folder. By co-incidence there is a ''userdata'' subfolder located within the Kodi folder.

You would use this procedure in the following circumstances..
*You are performing a '''Fresh Install''' of Kodi.
*You removed the Kodi program from your system, but failed to tick the option to remove ''\Kodi\Userdata''
*You removed the Kodi program from your system, but the Windows Uninstaller failed to remove the ''\Kodi\Userdata'' folder
*You are creating a backup

The location of the '''\Roaming\Kodi\''' folder depends on the installation method used:

If you downloaded Kodi from this site and manually ran the installer, you will find the ''Kodi'' folder in here...
C:\Users\Your User Name\AppData\Roaming\

If you downloaded Kodi from the Microsoft Store, you will find the ''Kodi'' folder in here...
C:\Users\Your User Name\AppData\Local\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\

Data in these locations must be manually removed. Options to remove are as follows...
* If you want to retain the userdata folder for backup purposes, simply rename the ''Kodi'' folder to something like ''Kodi-Old''.
* If you have no requirement to keep the Userdata folder, then simply Delete the folder and all its subfolders and files

Once renamed or deleted, Kodi will re-create the Userdata folders on next start of the program.

=== Complete Uninstall ===
To completely uninstall Kodi, leaving no remnants behind, you must remove the data from both locations- Program and Userdata.

== What Next? ==
[[File:Quick-start-0.png|400px|right]]

After the installation you can immediately start using Kodi. To start Kodi, find it under the Windows '''Start''' button in a '''Program Group''' called '''Kodi'''. You can also use the desktop icon if you enabled this option during setup.

When starting Kodi for the first time, this screen is displayed.

Now that Kodi is installed and running you will want to add your media to the Library.
{{See|Quick_start_guide}}

{{top}}

{{updated|17}}

[[Category:Manual]]
[[Category:Installation|Windows]]
[[Category:Windows]]
[[Category:How-to]]

Archive:Android FAQ

2017-05-08T15:28:20Z

Tinwarble: /* Installing/getting Kodi for Android */

{{Kodi FAQ}}
{{mininav|[[Android]] }}
<section begin="intro" />'''F'''requently '''A'''sked '''Q'''uestions for Android.<section end="intro" />
__TOC__
{{-}}

== General FAQ ==
:{{big|''See also: '''[[Kodi all platforms FAQ]]''' for FAQs that apply to all versions of Kodi.''}}

=== Will this really do 1080p and all that stuff the desktop can do? ===
:* Yes! This is a full port of Kodi! It is not a thin client or lite version!
:* The reason Android port is to get Kodi working on Android set-top-boxes. Phones and tablets are also supported, but are not the main focus.

=== Requirements ===
{{anchor|1=Requirements}}
:{{see also|Android hardware}}
:{{#lst:Supported hardware|Android}}

=== There are three versions of Kodi for Android. Which one do I use? ===
{{anchor|1=CPU}}
:The vast majority of users will want to use the [http://mirrors.kodi.tv/releases/android/arm/ "ARMV7A (32bit}" version] or the [http://mirrors.kodi.tv/releases/android/arm64-v8a/ "ARMV8A (64bit) version]. Users who have an Android device with an Intel or AMD CPU will want to use the [{{Download link|Android x86}} "x86" version].

=== Installing/getting Kodi for Android ===
{{anchor|1=Installing}}
{{Main|HOW-TO:Install Kodi for Android}}
:* {{current version}} can be found here:
:** '''[http://mirrors.kodi.tv/releases/android/arm/ ARMV7A (32bit)]''' (most users, regardless of your devices SoC, want this):
:** '''[http://mirrors.kodi.tv/releases/android/arm64-v8a/ ARMV8A (64bit)]''' (requires the Soc & Android version to be 64bit)
:** '''[http://mirrors.kodi.tv/releases/android/x86/ x86]''' (for devices with Intel SoCs)
:* For nightlies, alphas, betas and experimental builds, see the links on '''[[Development builds]]'''

=== Is Kodi for Android different from normal Kodi? ===
{{anchor|1=Version}}
: The current version of Kodi for Android is based on {{current version}}, and is based on the same code as Kodi for all the other supported platforms.

{{anchor|1=Current_build}}
=== How do I find out what version of Kodi am I running? ===
: Kodi main menu > System > Lower submenu > System info. '''Note the version and build date.'''

=== Video and audio formats Kodi for Android can playback ===
{{anchor|1=Formats}}
:* Kodi for Android supports all the same formats that other platforms do (such as desktop OS).
:* Due to the weak processing power of most ARM processors, for smooth playback most Android hardware will require proper hardware decoding. (See [[#Requirements]] below)

=== Accessing media ===
{{anchor|1=Media}}
{{See also|Adding videos to the library|File sharing}}
:* You can connect to media that's being shared from a computer, HTPC, or NAS device on your local network.
:* You can access media on the internal memory, SD cards or from USB ports (hard drives, USB stick drives, directly or via hubs, etc).

=== Add-ons and skins ===
{{anchor|1=Add-ons|2=Skins}}
:* Kodi for Android is a full version of Kodi and will be able to use all non-platform specific [[add-ons]] and [[skins]].
:* If you are using a touch screen device and the build you are using did not include it, you can manually instal [[Add-on:Touched]] for better touch screen support.

=== Remote controls ===
{{anchor|1=Remotes}}
:* Some Android set-top-boxes come with a remote and an IR port which Kodi can use.
:* Any '''[[Keyboard]]''' such as wired, wireless, bluetooth (if supported in your Android ROM). This includes "keymotes" such as a Rii, [[Boxee remote]], most "air mouse" keyboard remotes, and others that appear as a normal USB keyboard to the system.
:* '''[[Web interface]]s''', including add-on interfaces.
:* Kodi '''[[:Category:Smartphone and tablet remotes|smartphone and tablet remote apps]]'''.
:* Other IR remotes can be used with IR receivers such as the '''[[Flirc]]'''.
:* Some Android devices support '''[[CEC]]'''

=== Launching Android apps from within Kodi ===
{{anchor|1=Apps}}
:{{main|HOW-TO:Launch Android apps}}
:{{#lst:HOW-TO:Launch Android apps|intro}}

=== Automatically start Kodi ===
{{anchor|1=Startup}}
: You can automatically start Kodi when your Android device boots up using an application such as [https://play.google.com/store/apps/details?id=imoblife.startupmanager Startup Manager (free)]

== Performance tips ==
{{Main|Android#Tips and tricks}}

=== Performance: video buffering, stuttering, choppiness ===
{{anchor|1=Buffering|2=Performance}}
:{{#lst:Android|FAQ Performance notes}}

== Troubleshooting ==
{{see also|Troubleshooting}}

=== Getting more help with Kodi for Android ===
{{anchor|1=Forum|2=IRC}}
:* '''[http://forum.kodi.tv/forumdisplay.php?fid=164 Kodi for Android specific help forum]'''
:* '''[irc://irc.freenode.org/kodi #kodi]''' [[w:IRC|IRC]] chat channel on irc.freenode.org.

=== Where is the Userdata folder ===
{{anchor|1=Userdata}}
:The userdata folder is located on external storage/sdcard at the following locations (depending on your device):
:;[[userdata folder]]
:* <code>{{userdata|Android}}</code>

=== Where is the Kodi log ===
{{anchor|1=Kodi log}}
:The Kodi log is located inside the temp folder, i.e.
:;[[debug log]]
:* /sdcard/Android/data/org.xbmc.kodi/files/.kodi/temp/kodi.log

=== How can I obtain a Minidump ===
{{anchor|1=minidump}}
:The Kodi minidumps are located inside the temp folder, i.e.
:* /sdcard/Android/data/org.xbmc.kodi/files/.kodi/temp/*.dmp

=== How can I obtain a Crash Log (logcat) ===
{{anchor|1=logcat}}
:A crash log (also called logcat) is mandatory to be able todebug hard crashes on Android
:* Download the '''[https://play.google.com/store/apps/details?id=org.l6n.sendlog SendLog app]''' from the Google Play store. It allows you to send your system log to an email address. Email it to yourself and show us where the error happened. '''(requires root)'''
:* Alternatively, you can use your computer. Plug your device, download and unzip the [http://d.android.com/sdk/index.html Android SDK] and run ddms.bat in the tools folder. There you have it under ''LogCat''.
:* The logfile is kept on a phone for a while, so you don't need to reproduce a crash in order to get the log.
:* Be sure to have hidden folders set to be shown in your file explorer.

=== How to hide the Android navigation bar ===
{{anchor|1=navbar}}
:* As of v13, Kodi supports Android 4.4 (Kitkat)'s immersive mode, allowing for fullscreen automatically.
:* '''To remove the navbar:'''
:** You can use "[http://ppareit.github.com/HideBar/ HideBar]" (Has a free version, and is open source if you wish to compile yourself)
:** The app "[https://play.google.com/store/apps/details?id=de.tsorn.FullScreen Full!Screen]" is free and should also work.
:** A custom Android distribution can be installed to correctly handle the navbar. [http://replicant.us/ Replicant], [http://www.cyanogenmod.org/ CyanogenMod] and some others offer an “extended desktop” mode which hides the navigation bar and, optionally, the status bar too. Also check for firmware on sites such as http://freaktab.com for more firmware options.

=== Audio sync/delay issues ===
{{anchor|1=audio_sync}}
:Is some or all of your audio out of sync with the video? Try these tips:
:* Check for firmware updates for your specific Android device.
:* If you have a delay that is consistent regardless of the file, you can manually adjust the delay:
:*# Open any video that has audio playing.
:*# Bring up the '''[[Video playback#On screen display (OSD)|on-screen-display]]''' and select the [[Video playback#OSD audio and subtitle settings|audio options]].
:*# Select '''[[Video playback#OSD audio and subtitle settings|Audio offset]]''' and then adjust the audio until the delay is corrected.
:*# Back in the OSD audio settings, scroll down and select '''Set as default for all videos'''.
:* {{editor note|Sometimes things can be corrected by just not using audio passthrough, but either some people don't want to do that at all, or they don't know exactly what that is. We probably need a guide about audio sync in general (not just Android), and add that to our general '''[[audio]]''' help pages.}}

{{anchor|no_video}}
=== Amlogic playback issues (zoomed in, 1/4 screen, no video, etc) ===
* As of v15 and later, Kodi will no longer ask to fix incorrect video decoding permissions on Amlogic-based devices that have incorrectly configured firmware. This might cause an issue in some situations, and if this happens to you, first try to manually disable '''amcodec''' and only use '''mediacodec''' and '''libstagefright''' under {{highlight|bordered=yes| [[Settings/Videos#Acceleration|Settings -> Videos -> Acceleration]] }}. If videos still won't play correctly then the device might a firmware/OS update for things to work properly.

* In some cases video playback is fine, but incorrectly sized so that it only takes up a small portion of the screen. This again is most likely a firmware issue, but a temp workaround would be to go into Android's system settings (not Kodi's settings) and change the GUI resolution to 720 and/or disable "auto select". Video will still render at 1080, and only the GUI is limited to 720.

* There may also be situations were Kodi isn't correctly detecting the box's ability to use the "amcodec", and thus prematurely disabling it. Our devs are currently looking into this situation, and if true, will attempt to fix it.

:;Why was this changed?
::Kodi doesn't try to manually fix the permissions anymore. Doing so was a hack that the devs didn't feel comfortable with, and vendors need to fix this on the firmware level, not the application level. Some hardware vendors are still unwilling to set the necessary permissions because of a misconception on "security", which ironically requires granting apps root-level access, which is far less secure.

::However, the mediacodec "path" to decoding doesn't require the permissions changes, and mediacodec support has improved both in Kodi and in most firmware (even in some of the flawed ones). So now when amcodec fails it falls back on mediacodec, which normally works. In that sense it is "fixed". Eventually mediacodec will be the single standard, and there won't be a need for amcodec, but the option is still there for some special situations.

=== Videos play, but are not always smooth ===
{{anchor|1=rough_playback}}
:There are a number of reasons why this can happen, so it's hard to give general advice for such a description, but here are some things that you can try:
:* Some Android hardware has bugs using the "MediaCodec" hardware decoding method, but plays video fine using "libstagefright". Try turning off "MediaCodec" and leaving "libstageright" on in: {{highlight|bordered=yes|[[Settings/Videos#Acceleration|Settings -> Videos -> Acceleration]]}}. Users of [[Android hardware|AMLogic hardware]] can ignore this, as those devices use a third "AmCodec" hardware decoding method.
:* Hardware video decoding might not be enabled at all on your device. Most Android boxes will require hardware video decoding for smooth HD video playback. Check settings under {{highlight|bordered=yes|[[Settings/Videos#Acceleration|Settings -> Videos -> Acceleration]]}}
:* Most Android boxes don't support hardware video decoding of some codecs, such as VC-1, Hi10P, and HEVC(H.265). Consult the compatibility list on '''[[Android hardware]]'''.
:* Rule out network performance by loading a small test video directly to the internal memory of your Android device.
:* Some AVI files with H.264 encoded video have problems if you play them with hardware decoding - some SoCs play them smoothly (like Mediatek 8129, 8173), while others don't (like Broadcom BCM28145, Qualcomm Snapdragon 617, 652, Samsung Exynos 8890). If your SoC is powerful enough, try disabling hardware decoding.

=== Downloading Kodi results in a .txt or .zip file instead of a .apk file ===
:* Some web browsers will rename .apk files for some reason. To fix this you simply need to rename the file back to .apk and it should then work to install Kodi. To rename files you can use a file manager/explorer program.

=== Video playback stops when another app is in focus ===
* This is expected behavior for newer Google APIs and how Kodi v16 works. In addition to making sure that the new video decoding APIs are working correctly, this also has the side effect of making sure Kodi doesn't prevent other apps from using video, such as Netflix, even if Kodi is still open.

* To prevent this from happening when a video is paused, make sure that Kodi's screensaver is either off or using a screensaver other than "Dim" or "Black". That will prevent the Android screensaver/daydream from becoming active.

=== Low volume or strange volume behavior ===
* To support TVs that have Android built-in, and to prevent the "double volume bar" of previous releases, Kodi v16 no longer changes both '''Kodi volume''' and '''system volume''' at the same time. Instead, these are now controlled seperately.

* Most users will likely wish to leave Kodi volume at full and then control system volume, which is what most remote controls use by default for their volume buttons.

* If volume is low then you might need to turn up the internal "Kodi volume". If you are using a skin that doesn't show the volume bar, then you can change the volume by playing a video and opening the on-screen-display and selecting the audio settings. Alternatively, you can also hook up a USB keyboard to turn the volume up using the {{keypress|+}} or {{keypress|1==}} keys.

=== Crashing when opened ===
: A few things to try it this happens:
* Go into Android's settings and into "Apps". Then select Kodi and select '''"Clear cache"'''. {{small|''Do '''{{color|red|not}}''' select "Clear data".''}}

* If you are using MySQL then see '''[[MySQL/Upgrading]]'''.

* Make sure your Android device has at least 500 MB of free space (a rough estimate).

* Re-install without uninstalling. This should keep your settings.

* As a last resort, uninstalling and re-installing can be done, but doing so will reset all settings.

* If you need more help, please leave a message on '''http://forum.kodi.tv'''.

=== GUI no longer rendered at 4K ===
: Kodi v15 would render everything in 4K for the Nvidia Shield TV, but used a method that won't work correctly on other 4K boxes, as the GUI is handled by the CPU and not a hardware decoder.

: This has been changed for Kodi v16. On supported hardware, such as some official Android TV devices, 4K video will always output at 4K. Only the user interface will render at 1080, so that less powerful CPUs aren't bogged down. In other words, the video lists and buttons are not as "sharp", but video will still be fine. In the future there ''might'' be an option to render everything at 4K, for devices that are powerful enough.

=== Missing "brightness" and "contrast" options ===
: If in Kodi v15 you had brightness and contrast [[video playback]] options, but they are missing in v16, then you can re-enable them by going to {{highlight|bordered=yes|Settings -> Videos -> Acceleration -> }} and disable only '''"Mediacodec (surface)"'''. Video will still be hardware decoded, but this will disable 4K output support for 4K Android hardware.

{{Updated|16}}

[[Category:Manual]]
[[Category:FAQ|Android]]
[[Category:Android|*]]
[[Category:Troubleshooting]]

Archive:Android FAQ

2017-05-08T15:22:10Z

Tinwarble: /* There are two versions of Kodi for Android. Which one do I use? */

{{Kodi FAQ}}
{{mininav|[[Android]] }}
<section begin="intro" />'''F'''requently '''A'''sked '''Q'''uestions for Android.<section end="intro" />
__TOC__
{{-}}

== General FAQ ==
:{{big|''See also: '''[[Kodi all platforms FAQ]]''' for FAQs that apply to all versions of Kodi.''}}

=== Will this really do 1080p and all that stuff the desktop can do? ===
:* Yes! This is a full port of Kodi! It is not a thin client or lite version!
:* The reason Android port is to get Kodi working on Android set-top-boxes. Phones and tablets are also supported, but are not the main focus.

=== Requirements ===
{{anchor|1=Requirements}}
:{{see also|Android hardware}}
:{{#lst:Supported hardware|Android}}

=== There are three versions of Kodi for Android. Which one do I use? ===
{{anchor|1=CPU}}
:The vast majority of users will want to use the [http://mirrors.kodi.tv/releases/android/arm/ "ARMV7A (32bit}" version] or the [http://mirrors.kodi.tv/releases/android/arm64-v8a/ "ARMV8A (64bit) version]. Users who have an Android device with an Intel or AMD CPU will want to use the [{{Download link|Android x86}} "x86" version].

=== Installing/getting Kodi for Android ===
{{anchor|1=Installing}}
{{Main|HOW-TO:Install Kodi for Android}}
:* {{current version}} can be found here:
:** '''ARM''' (most users want this): http://mirrors.kodi.tv/releases/android/arm/
:** '''x86''': {{Download link|Android x86}}
:* For nightlies, alphas, betas and experimental builds, see the links on '''[[Development builds]]'''

=== Is Kodi for Android different from normal Kodi? ===
{{anchor|1=Version}}
: The current version of Kodi for Android is based on {{current version}}, and is based on the same code as Kodi for all the other supported platforms.

{{anchor|1=Current_build}}
=== How do I find out what version of Kodi am I running? ===
: Kodi main menu > System > Lower submenu > System info. '''Note the version and build date.'''

=== Video and audio formats Kodi for Android can playback ===
{{anchor|1=Formats}}
:* Kodi for Android supports all the same formats that other platforms do (such as desktop OS).
:* Due to the weak processing power of most ARM processors, for smooth playback most Android hardware will require proper hardware decoding. (See [[#Requirements]] below)

=== Accessing media ===
{{anchor|1=Media}}
{{See also|Adding videos to the library|File sharing}}
:* You can connect to media that's being shared from a computer, HTPC, or NAS device on your local network.
:* You can access media on the internal memory, SD cards or from USB ports (hard drives, USB stick drives, directly or via hubs, etc).

=== Add-ons and skins ===
{{anchor|1=Add-ons|2=Skins}}
:* Kodi for Android is a full version of Kodi and will be able to use all non-platform specific [[add-ons]] and [[skins]].
:* If you are using a touch screen device and the build you are using did not include it, you can manually instal [[Add-on:Touched]] for better touch screen support.

=== Remote controls ===
{{anchor|1=Remotes}}
:* Some Android set-top-boxes come with a remote and an IR port which Kodi can use.
:* Any '''[[Keyboard]]''' such as wired, wireless, bluetooth (if supported in your Android ROM). This includes "keymotes" such as a Rii, [[Boxee remote]], most "air mouse" keyboard remotes, and others that appear as a normal USB keyboard to the system.
:* '''[[Web interface]]s''', including add-on interfaces.
:* Kodi '''[[:Category:Smartphone and tablet remotes|smartphone and tablet remote apps]]'''.
:* Other IR remotes can be used with IR receivers such as the '''[[Flirc]]'''.
:* Some Android devices support '''[[CEC]]'''

=== Launching Android apps from within Kodi ===
{{anchor|1=Apps}}
:{{main|HOW-TO:Launch Android apps}}
:{{#lst:HOW-TO:Launch Android apps|intro}}

=== Automatically start Kodi ===
{{anchor|1=Startup}}
: You can automatically start Kodi when your Android device boots up using an application such as [https://play.google.com/store/apps/details?id=imoblife.startupmanager Startup Manager (free)]

== Performance tips ==
{{Main|Android#Tips and tricks}}

=== Performance: video buffering, stuttering, choppiness ===
{{anchor|1=Buffering|2=Performance}}
:{{#lst:Android|FAQ Performance notes}}

== Troubleshooting ==
{{see also|Troubleshooting}}

=== Getting more help with Kodi for Android ===
{{anchor|1=Forum|2=IRC}}
:* '''[http://forum.kodi.tv/forumdisplay.php?fid=164 Kodi for Android specific help forum]'''
:* '''[irc://irc.freenode.org/kodi #kodi]''' [[w:IRC|IRC]] chat channel on irc.freenode.org.

=== Where is the Userdata folder ===
{{anchor|1=Userdata}}
:The userdata folder is located on external storage/sdcard at the following locations (depending on your device):
:;[[userdata folder]]
:* <code>{{userdata|Android}}</code>

=== Where is the Kodi log ===
{{anchor|1=Kodi log}}
:The Kodi log is located inside the temp folder, i.e.
:;[[debug log]]
:* /sdcard/Android/data/org.xbmc.kodi/files/.kodi/temp/kodi.log

=== How can I obtain a Minidump ===
{{anchor|1=minidump}}
:The Kodi minidumps are located inside the temp folder, i.e.
:* /sdcard/Android/data/org.xbmc.kodi/files/.kodi/temp/*.dmp

=== How can I obtain a Crash Log (logcat) ===
{{anchor|1=logcat}}
:A crash log (also called logcat) is mandatory to be able todebug hard crashes on Android
:* Download the '''[https://play.google.com/store/apps/details?id=org.l6n.sendlog SendLog app]''' from the Google Play store. It allows you to send your system log to an email address. Email it to yourself and show us where the error happened. '''(requires root)'''
:* Alternatively, you can use your computer. Plug your device, download and unzip the [http://d.android.com/sdk/index.html Android SDK] and run ddms.bat in the tools folder. There you have it under ''LogCat''.
:* The logfile is kept on a phone for a while, so you don't need to reproduce a crash in order to get the log.
:* Be sure to have hidden folders set to be shown in your file explorer.

=== How to hide the Android navigation bar ===
{{anchor|1=navbar}}
:* As of v13, Kodi supports Android 4.4 (Kitkat)'s immersive mode, allowing for fullscreen automatically.
:* '''To remove the navbar:'''
:** You can use "[http://ppareit.github.com/HideBar/ HideBar]" (Has a free version, and is open source if you wish to compile yourself)
:** The app "[https://play.google.com/store/apps/details?id=de.tsorn.FullScreen Full!Screen]" is free and should also work.
:** A custom Android distribution can be installed to correctly handle the navbar. [http://replicant.us/ Replicant], [http://www.cyanogenmod.org/ CyanogenMod] and some others offer an “extended desktop” mode which hides the navigation bar and, optionally, the status bar too. Also check for firmware on sites such as http://freaktab.com for more firmware options.

=== Audio sync/delay issues ===
{{anchor|1=audio_sync}}
:Is some or all of your audio out of sync with the video? Try these tips:
:* Check for firmware updates for your specific Android device.
:* If you have a delay that is consistent regardless of the file, you can manually adjust the delay:
:*# Open any video that has audio playing.
:*# Bring up the '''[[Video playback#On screen display (OSD)|on-screen-display]]''' and select the [[Video playback#OSD audio and subtitle settings|audio options]].
:*# Select '''[[Video playback#OSD audio and subtitle settings|Audio offset]]''' and then adjust the audio until the delay is corrected.
:*# Back in the OSD audio settings, scroll down and select '''Set as default for all videos'''.
:* {{editor note|Sometimes things can be corrected by just not using audio passthrough, but either some people don't want to do that at all, or they don't know exactly what that is. We probably need a guide about audio sync in general (not just Android), and add that to our general '''[[audio]]''' help pages.}}

{{anchor|no_video}}
=== Amlogic playback issues (zoomed in, 1/4 screen, no video, etc) ===
* As of v15 and later, Kodi will no longer ask to fix incorrect video decoding permissions on Amlogic-based devices that have incorrectly configured firmware. This might cause an issue in some situations, and if this happens to you, first try to manually disable '''amcodec''' and only use '''mediacodec''' and '''libstagefright''' under {{highlight|bordered=yes| [[Settings/Videos#Acceleration|Settings -> Videos -> Acceleration]] }}. If videos still won't play correctly then the device might a firmware/OS update for things to work properly.

* In some cases video playback is fine, but incorrectly sized so that it only takes up a small portion of the screen. This again is most likely a firmware issue, but a temp workaround would be to go into Android's system settings (not Kodi's settings) and change the GUI resolution to 720 and/or disable "auto select". Video will still render at 1080, and only the GUI is limited to 720.

* There may also be situations were Kodi isn't correctly detecting the box's ability to use the "amcodec", and thus prematurely disabling it. Our devs are currently looking into this situation, and if true, will attempt to fix it.

:;Why was this changed?
::Kodi doesn't try to manually fix the permissions anymore. Doing so was a hack that the devs didn't feel comfortable with, and vendors need to fix this on the firmware level, not the application level. Some hardware vendors are still unwilling to set the necessary permissions because of a misconception on "security", which ironically requires granting apps root-level access, which is far less secure.

::However, the mediacodec "path" to decoding doesn't require the permissions changes, and mediacodec support has improved both in Kodi and in most firmware (even in some of the flawed ones). So now when amcodec fails it falls back on mediacodec, which normally works. In that sense it is "fixed". Eventually mediacodec will be the single standard, and there won't be a need for amcodec, but the option is still there for some special situations.

=== Videos play, but are not always smooth ===
{{anchor|1=rough_playback}}
:There are a number of reasons why this can happen, so it's hard to give general advice for such a description, but here are some things that you can try:
:* Some Android hardware has bugs using the "MediaCodec" hardware decoding method, but plays video fine using "libstagefright". Try turning off "MediaCodec" and leaving "libstageright" on in: {{highlight|bordered=yes|[[Settings/Videos#Acceleration|Settings -> Videos -> Acceleration]]}}. Users of [[Android hardware|AMLogic hardware]] can ignore this, as those devices use a third "AmCodec" hardware decoding method.
:* Hardware video decoding might not be enabled at all on your device. Most Android boxes will require hardware video decoding for smooth HD video playback. Check settings under {{highlight|bordered=yes|[[Settings/Videos#Acceleration|Settings -> Videos -> Acceleration]]}}
:* Most Android boxes don't support hardware video decoding of some codecs, such as VC-1, Hi10P, and HEVC(H.265). Consult the compatibility list on '''[[Android hardware]]'''.
:* Rule out network performance by loading a small test video directly to the internal memory of your Android device.
:* Some AVI files with H.264 encoded video have problems if you play them with hardware decoding - some SoCs play them smoothly (like Mediatek 8129, 8173), while others don't (like Broadcom BCM28145, Qualcomm Snapdragon 617, 652, Samsung Exynos 8890). If your SoC is powerful enough, try disabling hardware decoding.

=== Downloading Kodi results in a .txt or .zip file instead of a .apk file ===
:* Some web browsers will rename .apk files for some reason. To fix this you simply need to rename the file back to .apk and it should then work to install Kodi. To rename files you can use a file manager/explorer program.

=== Video playback stops when another app is in focus ===
* This is expected behavior for newer Google APIs and how Kodi v16 works. In addition to making sure that the new video decoding APIs are working correctly, this also has the side effect of making sure Kodi doesn't prevent other apps from using video, such as Netflix, even if Kodi is still open.

* To prevent this from happening when a video is paused, make sure that Kodi's screensaver is either off or using a screensaver other than "Dim" or "Black". That will prevent the Android screensaver/daydream from becoming active.

=== Low volume or strange volume behavior ===
* To support TVs that have Android built-in, and to prevent the "double volume bar" of previous releases, Kodi v16 no longer changes both '''Kodi volume''' and '''system volume''' at the same time. Instead, these are now controlled seperately.

* Most users will likely wish to leave Kodi volume at full and then control system volume, which is what most remote controls use by default for their volume buttons.

* If volume is low then you might need to turn up the internal "Kodi volume". If you are using a skin that doesn't show the volume bar, then you can change the volume by playing a video and opening the on-screen-display and selecting the audio settings. Alternatively, you can also hook up a USB keyboard to turn the volume up using the {{keypress|+}} or {{keypress|1==}} keys.

=== Crashing when opened ===
: A few things to try it this happens:
* Go into Android's settings and into "Apps". Then select Kodi and select '''"Clear cache"'''. {{small|''Do '''{{color|red|not}}''' select "Clear data".''}}

* If you are using MySQL then see '''[[MySQL/Upgrading]]'''.

* Make sure your Android device has at least 500 MB of free space (a rough estimate).

* Re-install without uninstalling. This should keep your settings.

* As a last resort, uninstalling and re-installing can be done, but doing so will reset all settings.

* If you need more help, please leave a message on '''http://forum.kodi.tv'''.

=== GUI no longer rendered at 4K ===
: Kodi v15 would render everything in 4K for the Nvidia Shield TV, but used a method that won't work correctly on other 4K boxes, as the GUI is handled by the CPU and not a hardware decoder.

: This has been changed for Kodi v16. On supported hardware, such as some official Android TV devices, 4K video will always output at 4K. Only the user interface will render at 1080, so that less powerful CPUs aren't bogged down. In other words, the video lists and buttons are not as "sharp", but video will still be fine. In the future there ''might'' be an option to render everything at 4K, for devices that are powerful enough.

=== Missing "brightness" and "contrast" options ===
: If in Kodi v15 you had brightness and contrast [[video playback]] options, but they are missing in v16, then you can re-enable them by going to {{highlight|bordered=yes|Settings -> Videos -> Acceleration -> }} and disable only '''"Mediacodec (surface)"'''. Video will still be hardware decoded, but this will disable 4K output support for 4K Android hardware.

{{Updated|16}}

[[Category:Manual]]
[[Category:FAQ|Android]]
[[Category:Android|*]]
[[Category:Troubleshooting]]

Archive:Android FAQ

2017-05-08T15:17:39Z

Tinwarble: /* Installing/getting Kodi for Android */

{{Kodi FAQ}}
{{mininav|[[Android]] }}
<section begin="intro" />'''F'''requently '''A'''sked '''Q'''uestions for Android.<section end="intro" />
__TOC__
{{-}}

== General FAQ ==
:{{big|''See also: '''[[Kodi all platforms FAQ]]''' for FAQs that apply to all versions of Kodi.''}}

=== Will this really do 1080p and all that stuff the desktop can do? ===
:* Yes! This is a full port of Kodi! It is not a thin client or lite version!
:* The reason Android port is to get Kodi working on Android set-top-boxes. Phones and tablets are also supported, but are not the main focus.

=== Requirements ===
{{anchor|1=Requirements}}
:{{see also|Android hardware}}
:{{#lst:Supported hardware|Android}}

=== There are two versions of Kodi for Android. Which one do I use? ===
{{anchor|1=CPU}}
:The vast majority of users will want to use the [{{download link|Android ARM}} "ARM" version]. Users who have an Android device with an Intel or AMD CPU will want to use the [{{Download link|Android x86}} "x86" version].

=== Installing/getting Kodi for Android ===
{{anchor|1=Installing}}
{{Main|HOW-TO:Install Kodi for Android}}
:* {{current version}} can be found here:
:** '''ARM''' (most users want this): http://mirrors.kodi.tv/releases/android/arm/
:** '''x86''': {{Download link|Android x86}}
:* For nightlies, alphas, betas and experimental builds, see the links on '''[[Development builds]]'''

=== Is Kodi for Android different from normal Kodi? ===
{{anchor|1=Version}}
: The current version of Kodi for Android is based on {{current version}}, and is based on the same code as Kodi for all the other supported platforms.

{{anchor|1=Current_build}}
=== How do I find out what version of Kodi am I running? ===
: Kodi main menu > System > Lower submenu > System info. '''Note the version and build date.'''

=== Video and audio formats Kodi for Android can playback ===
{{anchor|1=Formats}}
:* Kodi for Android supports all the same formats that other platforms do (such as desktop OS).
:* Due to the weak processing power of most ARM processors, for smooth playback most Android hardware will require proper hardware decoding. (See [[#Requirements]] below)

=== Accessing media ===
{{anchor|1=Media}}
{{See also|Adding videos to the library|File sharing}}
:* You can connect to media that's being shared from a computer, HTPC, or NAS device on your local network.
:* You can access media on the internal memory, SD cards or from USB ports (hard drives, USB stick drives, directly or via hubs, etc).

=== Add-ons and skins ===
{{anchor|1=Add-ons|2=Skins}}
:* Kodi for Android is a full version of Kodi and will be able to use all non-platform specific [[add-ons]] and [[skins]].
:* If you are using a touch screen device and the build you are using did not include it, you can manually instal [[Add-on:Touched]] for better touch screen support.

=== Remote controls ===
{{anchor|1=Remotes}}
:* Some Android set-top-boxes come with a remote and an IR port which Kodi can use.
:* Any '''[[Keyboard]]''' such as wired, wireless, bluetooth (if supported in your Android ROM). This includes "keymotes" such as a Rii, [[Boxee remote]], most "air mouse" keyboard remotes, and others that appear as a normal USB keyboard to the system.
:* '''[[Web interface]]s''', including add-on interfaces.
:* Kodi '''[[:Category:Smartphone and tablet remotes|smartphone and tablet remote apps]]'''.
:* Other IR remotes can be used with IR receivers such as the '''[[Flirc]]'''.
:* Some Android devices support '''[[CEC]]'''

=== Launching Android apps from within Kodi ===
{{anchor|1=Apps}}
:{{main|HOW-TO:Launch Android apps}}
:{{#lst:HOW-TO:Launch Android apps|intro}}

=== Automatically start Kodi ===
{{anchor|1=Startup}}
: You can automatically start Kodi when your Android device boots up using an application such as [https://play.google.com/store/apps/details?id=imoblife.startupmanager Startup Manager (free)]

== Performance tips ==
{{Main|Android#Tips and tricks}}

=== Performance: video buffering, stuttering, choppiness ===
{{anchor|1=Buffering|2=Performance}}
:{{#lst:Android|FAQ Performance notes}}

== Troubleshooting ==
{{see also|Troubleshooting}}

=== Getting more help with Kodi for Android ===
{{anchor|1=Forum|2=IRC}}
:* '''[http://forum.kodi.tv/forumdisplay.php?fid=164 Kodi for Android specific help forum]'''
:* '''[irc://irc.freenode.org/kodi #kodi]''' [[w:IRC|IRC]] chat channel on irc.freenode.org.

=== Where is the Userdata folder ===
{{anchor|1=Userdata}}
:The userdata folder is located on external storage/sdcard at the following locations (depending on your device):
:;[[userdata folder]]
:* <code>{{userdata|Android}}</code>

=== Where is the Kodi log ===
{{anchor|1=Kodi log}}
:The Kodi log is located inside the temp folder, i.e.
:;[[debug log]]
:* /sdcard/Android/data/org.xbmc.kodi/files/.kodi/temp/kodi.log

=== How can I obtain a Minidump ===
{{anchor|1=minidump}}
:The Kodi minidumps are located inside the temp folder, i.e.
:* /sdcard/Android/data/org.xbmc.kodi/files/.kodi/temp/*.dmp

=== How can I obtain a Crash Log (logcat) ===
{{anchor|1=logcat}}
:A crash log (also called logcat) is mandatory to be able todebug hard crashes on Android
:* Download the '''[https://play.google.com/store/apps/details?id=org.l6n.sendlog SendLog app]''' from the Google Play store. It allows you to send your system log to an email address. Email it to yourself and show us where the error happened. '''(requires root)'''
:* Alternatively, you can use your computer. Plug your device, download and unzip the [http://d.android.com/sdk/index.html Android SDK] and run ddms.bat in the tools folder. There you have it under ''LogCat''.
:* The logfile is kept on a phone for a while, so you don't need to reproduce a crash in order to get the log.
:* Be sure to have hidden folders set to be shown in your file explorer.

=== How to hide the Android navigation bar ===
{{anchor|1=navbar}}
:* As of v13, Kodi supports Android 4.4 (Kitkat)'s immersive mode, allowing for fullscreen automatically.
:* '''To remove the navbar:'''
:** You can use "[http://ppareit.github.com/HideBar/ HideBar]" (Has a free version, and is open source if you wish to compile yourself)
:** The app "[https://play.google.com/store/apps/details?id=de.tsorn.FullScreen Full!Screen]" is free and should also work.
:** A custom Android distribution can be installed to correctly handle the navbar. [http://replicant.us/ Replicant], [http://www.cyanogenmod.org/ CyanogenMod] and some others offer an “extended desktop” mode which hides the navigation bar and, optionally, the status bar too. Also check for firmware on sites such as http://freaktab.com for more firmware options.

=== Audio sync/delay issues ===
{{anchor|1=audio_sync}}
:Is some or all of your audio out of sync with the video? Try these tips:
:* Check for firmware updates for your specific Android device.
:* If you have a delay that is consistent regardless of the file, you can manually adjust the delay:
:*# Open any video that has audio playing.
:*# Bring up the '''[[Video playback#On screen display (OSD)|on-screen-display]]''' and select the [[Video playback#OSD audio and subtitle settings|audio options]].
:*# Select '''[[Video playback#OSD audio and subtitle settings|Audio offset]]''' and then adjust the audio until the delay is corrected.
:*# Back in the OSD audio settings, scroll down and select '''Set as default for all videos'''.
:* {{editor note|Sometimes things can be corrected by just not using audio passthrough, but either some people don't want to do that at all, or they don't know exactly what that is. We probably need a guide about audio sync in general (not just Android), and add that to our general '''[[audio]]''' help pages.}}

{{anchor|no_video}}
=== Amlogic playback issues (zoomed in, 1/4 screen, no video, etc) ===
* As of v15 and later, Kodi will no longer ask to fix incorrect video decoding permissions on Amlogic-based devices that have incorrectly configured firmware. This might cause an issue in some situations, and if this happens to you, first try to manually disable '''amcodec''' and only use '''mediacodec''' and '''libstagefright''' under {{highlight|bordered=yes| [[Settings/Videos#Acceleration|Settings -> Videos -> Acceleration]] }}. If videos still won't play correctly then the device might a firmware/OS update for things to work properly.

* In some cases video playback is fine, but incorrectly sized so that it only takes up a small portion of the screen. This again is most likely a firmware issue, but a temp workaround would be to go into Android's system settings (not Kodi's settings) and change the GUI resolution to 720 and/or disable "auto select". Video will still render at 1080, and only the GUI is limited to 720.

* There may also be situations were Kodi isn't correctly detecting the box's ability to use the "amcodec", and thus prematurely disabling it. Our devs are currently looking into this situation, and if true, will attempt to fix it.

:;Why was this changed?
::Kodi doesn't try to manually fix the permissions anymore. Doing so was a hack that the devs didn't feel comfortable with, and vendors need to fix this on the firmware level, not the application level. Some hardware vendors are still unwilling to set the necessary permissions because of a misconception on "security", which ironically requires granting apps root-level access, which is far less secure.

::However, the mediacodec "path" to decoding doesn't require the permissions changes, and mediacodec support has improved both in Kodi and in most firmware (even in some of the flawed ones). So now when amcodec fails it falls back on mediacodec, which normally works. In that sense it is "fixed". Eventually mediacodec will be the single standard, and there won't be a need for amcodec, but the option is still there for some special situations.

=== Videos play, but are not always smooth ===
{{anchor|1=rough_playback}}
:There are a number of reasons why this can happen, so it's hard to give general advice for such a description, but here are some things that you can try:
:* Some Android hardware has bugs using the "MediaCodec" hardware decoding method, but plays video fine using "libstagefright". Try turning off "MediaCodec" and leaving "libstageright" on in: {{highlight|bordered=yes|[[Settings/Videos#Acceleration|Settings -> Videos -> Acceleration]]}}. Users of [[Android hardware|AMLogic hardware]] can ignore this, as those devices use a third "AmCodec" hardware decoding method.
:* Hardware video decoding might not be enabled at all on your device. Most Android boxes will require hardware video decoding for smooth HD video playback. Check settings under {{highlight|bordered=yes|[[Settings/Videos#Acceleration|Settings -> Videos -> Acceleration]]}}
:* Most Android boxes don't support hardware video decoding of some codecs, such as VC-1, Hi10P, and HEVC(H.265). Consult the compatibility list on '''[[Android hardware]]'''.
:* Rule out network performance by loading a small test video directly to the internal memory of your Android device.
:* Some AVI files with H.264 encoded video have problems if you play them with hardware decoding - some SoCs play them smoothly (like Mediatek 8129, 8173), while others don't (like Broadcom BCM28145, Qualcomm Snapdragon 617, 652, Samsung Exynos 8890). If your SoC is powerful enough, try disabling hardware decoding.

=== Downloading Kodi results in a .txt or .zip file instead of a .apk file ===
:* Some web browsers will rename .apk files for some reason. To fix this you simply need to rename the file back to .apk and it should then work to install Kodi. To rename files you can use a file manager/explorer program.

=== Video playback stops when another app is in focus ===
* This is expected behavior for newer Google APIs and how Kodi v16 works. In addition to making sure that the new video decoding APIs are working correctly, this also has the side effect of making sure Kodi doesn't prevent other apps from using video, such as Netflix, even if Kodi is still open.

* To prevent this from happening when a video is paused, make sure that Kodi's screensaver is either off or using a screensaver other than "Dim" or "Black". That will prevent the Android screensaver/daydream from becoming active.

=== Low volume or strange volume behavior ===
* To support TVs that have Android built-in, and to prevent the "double volume bar" of previous releases, Kodi v16 no longer changes both '''Kodi volume''' and '''system volume''' at the same time. Instead, these are now controlled seperately.

* Most users will likely wish to leave Kodi volume at full and then control system volume, which is what most remote controls use by default for their volume buttons.

* If volume is low then you might need to turn up the internal "Kodi volume". If you are using a skin that doesn't show the volume bar, then you can change the volume by playing a video and opening the on-screen-display and selecting the audio settings. Alternatively, you can also hook up a USB keyboard to turn the volume up using the {{keypress|+}} or {{keypress|1==}} keys.

=== Crashing when opened ===
: A few things to try it this happens:
* Go into Android's settings and into "Apps". Then select Kodi and select '''"Clear cache"'''. {{small|''Do '''{{color|red|not}}''' select "Clear data".''}}

* If you are using MySQL then see '''[[MySQL/Upgrading]]'''.

* Make sure your Android device has at least 500 MB of free space (a rough estimate).

* Re-install without uninstalling. This should keep your settings.

* As a last resort, uninstalling and re-installing can be done, but doing so will reset all settings.

* If you need more help, please leave a message on '''http://forum.kodi.tv'''.

=== GUI no longer rendered at 4K ===
: Kodi v15 would render everything in 4K for the Nvidia Shield TV, but used a method that won't work correctly on other 4K boxes, as the GUI is handled by the CPU and not a hardware decoder.

: This has been changed for Kodi v16. On supported hardware, such as some official Android TV devices, 4K video will always output at 4K. Only the user interface will render at 1080, so that less powerful CPUs aren't bogged down. In other words, the video lists and buttons are not as "sharp", but video will still be fine. In the future there ''might'' be an option to render everything at 4K, for devices that are powerful enough.

=== Missing "brightness" and "contrast" options ===
: If in Kodi v15 you had brightness and contrast [[video playback]] options, but they are missing in v16, then you can re-enable them by going to {{highlight|bordered=yes|Settings -> Videos -> Acceleration -> }} and disable only '''"Mediacodec (surface)"'''. Video will still be hardware decoded, but this will disable 4K output support for 4K Android hardware.

{{Updated|16}}

[[Category:Manual]]
[[Category:FAQ|Android]]
[[Category:Android|*]]
[[Category:Troubleshooting]]

Quick start guide

2017-05-01T17:56:50Z

Tinwarble:

{{mininav|[[General topics]]|[[First time user]]}}
Congratulations, new user, in your choice of [[w:media center|media center]] software: [[Kodi|{{Kodi}}]]!

<section begin="intro" />This guide is designed to get you up and running with {{Kodi}} in the shortest time possible, and was written with the most typical use cases in mind.<section end="intro" />
For more in depth information please refer to the [[Main Page|{{Kodi}} online wiki manual]]

The {{Kodi}} interface is designed with the '[[w:Home cinema|Home Theater]]' in mind. This means it is best viewed on a large-screen TV while you sit on your couch [[10-foot user interface|10-feet away from that TV]], rather than on a small monitor while you sit at your desk.
Because everything is designed with the home theater experience in mind, the best way to interact with {{Kodi}} is with a remote control, rather than a computer mouse. If it helps, think of {{Kodi}} as the ultimate DVD-player/set-top-box.

== Installing {{Kodi}} ==
{{main|Installing}}
{{#lst:Installing|intro}}

If you haven't already done so, download {{Kodi}} from '''http://kodi.tv/download/''' or see the installation guides here:
{{#lst:Installing|OS}}
See the '''[[Installing]]''' page for additional guides.

== Adding files ==
{{See also|File sharing|Media sources}}
While you can just use {{Kodi}} with plain file views, adding/scanning files to the library will add rich features such as cover art, summaries, thumbnails, trailers, and more.

To just quickly add files see [[Adding videos to the library/Adding media sources]].
=== Adding videos to the library ===
{{main|Adding videos to the library|Video library}}
{{#lst:Video library/Adding media sources|adding video}}

=== Adding music to the library ===
:''See also: '''[[Adding music to the library]]''' and '''[[Music library]]'''''
In order to be able to include information on your music collection in the library, {{Kodi}} needs your music to be tagged. When your collection is scanned, {{Kodi}} stores all the tagging information (artist, album, year, genre, etc) in the database which allows you to efficiently search and manage your music collection.
Today most media applications and players (e.g. iTunes / iPod) organize music by this ID tag information.

{{note|Your audio files ''must'' have a valid ID tag for them to work properly in the {{Kodi}} music library.}}
{{#lst:Adding music to the library|First Time Music Setup}}

=== Adding pictures ===
Adding sources for your [[pictures]] follows the same method as adding other media sources. From the Home Page navigate to Pictures, select Add Source and browse to the location of your picture files.

== Using a remote control ==
{{main|Remote controls}}
{{#lst:Remote controls|intro}}

== {{Kodi}} add-ons ==
{{Main|Add-ons|Add-on manager}}
{{#lst:Add-ons|intro}}

{{#lst:Add-on manager|HOW-TO install}}

== Changing the look and feel of {{Kodi}} ==
{{Kodi}} is unlike many contemporary media and gaming centers, in that it can be easily customized to look completely different using ''[[skins]]'' while still remaining equally as useable and providing access to all your videos, music, and more.

To get new skins, go to: {{highlight|Settings → Interface settings → Skin → Skin - Estuary|bordered=yes}}

You will be provided a list of currently installed skins and an option to "Get More..." where you can download additional skins.

'''<big>To change skins, see: [[HOW-TO:Change_skins|How To: Change Skins]]</big>'''

<gallery caption="The same home screen using different skins" widths=200px heights=113px>
File:Estuary_home_movies.png| Estuary - default skin, Kodi 17 & above
File:Confluence_ss.png|Confluence - default skin, Kodi 16 & below
File:Aeon Nox - glass home.jpg|Aeon Nox
File:Immersive.jpg|Immersive
File:Titan.jpg|Titan
File:Welo.jpg|Welo
File:Transparency.jpg|Transparency
</gallery>

== Important note about the Context Menu ==
{{main|Context menu}}
As you read this wiki and experiment on your own, you will quickly learn about the value of the '''''[[context menu]]'''''.

To use it, while highlighting an item, press the {{keypress|'''C'''}} key on the keyboard. If you are using a mouse, you can right click while hovering over an item. With remote controls, this is normally the {{button|guide}} button.

== Alternative guides ==
{{main|Video management#Alternative guides}}
{{#lst:Video management|Alternative guides}}

{{Krypton updated}}

==See also==
* [[First time user]]

[[Category:Manual]]
[[Category:Guides]]
[[Category:Quick Start Guide]]
[[Category:First time user]]

HOW-TO:Change skins

2017-04-27T18:19:18Z

Tinwarble:

{{mininav|[[Extras]]|[[Add-ons]]|[[Skins]]|page={{FULLPAGENAME}} }}
<section begin="intro"/>Many of us have been tempted by the allure of Kodi's beauty. There are some excellent skin designers out there who have gone to great lengths to create and share beautiful ways of viewing and navigating our media collections. As default, Kodi comes with the excellent skin Estuary, but there are plenty more to choose from.<section end="intro"/>

== Installing a new skin==
<gallery widths=500px heights=313px>
File:Estuary_home_blank.png|'''Step 1:''' Start from the Home screen
File:Estuary_home_settings_icon.png|'''Step 2:''' Navigate to the top of the menu and select '''System Settings''' (the gear) icon.
File:Interface_settings.png|'''Step 3:''' Select '''Interface settings'''.
File:Interface_settings_skin.png|'''Step 4:''' In the Interface setttings, select '''Skin''', then '''Skin''' under '''Look and feel'''.
File:Skin_get_more.png|'''Step 5:''' By default, there are only 2 skins installed, '''Estuary'''(the default skin) and '''Estouchy'''. To install another skin, select '''Get more...'''
File:Skin_get_more_browse.png|'''Step 6:''' In the new window, select the skin you want to install from the list.
File:Skin_get_more_downloading.png|'''Step 7:''' After you have select the skin it will begin downloading.
File:Skin_get_more_installing.png|'''Step 8:''' Once downloaded, the skin and any dependencies it requires will install.
File:Skin_get_more_switch_skin.png|'''Step 9:''' Once installed, Kodi will ask you if you want to start using that skin. If you do the select '''Yes'''
File:Skin_get_more_new_skin.png|'''Step 10:''' Enjoy your new skin!!!
</gallery>

== Installing a skin from a zip file. ==
Although there are many skins already available to you from Kodi Add-on repository, there are even more that you may want to try out, including modified skins of the ones available. Some of those skins can be found in the [http://forum.kodi.tv/forumdisplay.php?fid=67 Skin Support] section of the Kodi forum as well as Work in Progress skins which can be found in the [http://forum.kodi.tv/forumdisplay.php?fid=67 Skinning/WIP Skins] sub-section of the Kodi forum.

To install these skins you will need to install them from a zip file. See [[Add-on_manager#How_to_install_from_a_ZIP_file|How to install from a ZIP file]] for how to install.

:''Note: Estuary was designed to be fully featured. Sometimes as a new user, it can be daunting enough to get used to the program for starters without changing things. It is highly recommended that you stick to Estuary until you’re sure of how things work. Should you ever encounter issues with another skin, such as the feeling that something is missing, consider reverting to Estuary to see if it was simply an issue with that skin.'

{{krypton updated}}

[[Category:How-to]]
[[Category:Skins|*]]
[[Category:Manual]]
[[Category:Add-ons]]

Add-on:Estuary/Settings

2017-04-26T15:16:30Z

Tinwarble:

Skin settings for the default Kodi skin (for v17 (Krypton and above), Estuary.

==Accessing The System Settings Menu==
<gallery widths=400px heights=222px>
File:Estuary home settings icon.png|To access the System Settings menu, where you can access individual settings, select the System Settings icon (gear) at the top of the Menu on the Home screen.
</gallery>

==Accessing Skin Settings==

The System Settings menu is where you can access and change specific Kodi settings, access System information and Kodi's built in File Manager. To access Estuary's settings, select '''System → Skin Settings'''.

==General Skin Settings==
[[File:Estuary_skin_settings_general.png|400px|right]]
===Use slide animations===
:Changes the animation used when navigating screens. If enable, the items on the screen will slide in & out. If disable, item on screen will fade in & out.

===Enable auto scrolling for plot & review===
:When enabled, plots & reviews that do not fit within the defined area will auto scroll on the screen so that the entire plot/review can be read. When disabled, only the first part of the plot or review that fits within the defined area will be shown.

===Touch mode===
:For touch screens. If enabled, this will allow for better control using touch screen devices and will also add additional control buttons. If not using a touch screen this should remain disabled (default).

===Show weather info in top bar===
:When enabled, this will show the weather information on the top on every menu screen. This requires a Weather Service Information provider add-on to be installed.

===Show media flags===
:When enabled, will show media flags where applicable.

==Main Menu Items Settings==
[[File:Estuary_skin_settings_items.png|400px|right]]
[[File:Estuary_install_library_node_editor.png|400px|right]]

This menu item allows for enabling or disabling menu items that are shown on the Home screen. The items on this screen which can be enabled or disabled are:

'''Movies ♦ TV shows ♦ Music ♦ Music videos ♦ TV ♦ Radio ♦ Add-ons ♦ Pictures ♦ Videos ♦ Favorites ♦ Weather'''

You can also use '''Edit categories''' for '''Movies''', '''TV shows''' & '''Music'''. This will allow you to edit categories for each of these items such as '''Genre''', '''Title''', '''Year''', '''etc.''', add new '''Rules''', add new '''Nodes''' or add new '''Parent nodes'''.

When you select '''Edit categories''' you will be asked to install the '''Library node editor'''. This is required if you wish to preform any of the actions above.

<big>See: '''[[Add-on:Library Node Editor|Library Node Editor]]'''</big>

==Artwork Settings==
[[File:Estuary_skin_settings_artwork.png|400px|right]]

===Show Media Fanart As Background===
:When enabled, the select medias fanart will be displayed in the background of all menu screens. When disabled, only the default background will be displayed.

===Choose Background Pattern===
:Allows for cycling though different default backgrounds.

===Choose Skin Fanart Pack===
:Allows you to use or download a new set of background fanart packs. When installed and used, the art from the select pack will be used as the default background for menu items on the Home screen. This does not override '''Show media fanart as background''' and the media fanart will still display when hovered over.

===Choose Weather Fanart Pack===
:Allows you to use or download a new set of fanart packs to be used with weather.

===Select Genre Fanart Pack===
:Allows you to use or download a new set of fanart packs to be used with Genres.

{{note|In order to use or download '''Fanart Packs''' you must install the '''Image Resource Select Add-on'''. If you choose any of the '''Pack''' options above you will be asked if you want to download and install it at that time.}}

<big>See: '''[[Add-on:Image_Resource_Select_Addon|Image Resource Select Add-on]]'''</big>

[[Category:Settings]]

Quick start guide

2017-04-22T17:40:58Z

Tinwarble: /* Adding music to the library */

{{mininav|[[General topics]]|[[First time user]]}}
Congratulations, new user, in your choice of [[w:media center|media center]] software: [[Kodi|{{Kodi}}]]!

<section begin="intro" />This guide is designed to get you up and running with {{Kodi}} in the shortest time possible, and was written with the most typical use cases in mind.<section end="intro" />
For more in depth information please refer to the [[Main Page|{{Kodi}} online wiki manual]]

The {{Kodi}} interface is designed with the '[[w:Home cinema|Home Theater]]' in mind. This means it is best viewed on a large-screen TV while you sit on your couch [[10-foot user interface|10-feet away from that TV]], rather than on a small monitor while you sit at your desk.
Because everything is designed with the home theater experience in mind, the best way to interact with {{Kodi}} is with a remote control, rather than a computer mouse. If it helps, think of {{Kodi}} as the ultimate DVD-player/set-top-box.

== Installing {{Kodi}} ==
{{main|Installing}}
{{#lst:Installing|intro}}

If you haven't already done so, download {{Kodi}} from '''http://kodi.tv/download/''' or see the installation guides here:
{{#lst:Installing|OS}}
See the '''[[Installing]]''' page for additional guides.

== Adding files ==
{{See also|File sharing|Media sources}}
While you can just use {{Kodi}} with plain file views, adding/scanning files to the library will add rich features such as cover art, summaries, thumbnails, trailers, and more.

To just quickly add files see [[Adding videos to the library/Adding media sources]].
=== Adding videos to the library ===
{{main|Adding videos to the library|Video library}}
{{#lst:Video library/Adding media sources|adding video}}

=== Adding music to the library ===
:''See also: '''[[Adding music to the library]]''' and '''[[Music library]]'''''
In order to be able to include information on your music collection in the library, {{Kodi}} needs your music to be tagged. When your collection is scanned, {{Kodi}} stores all the tagging information (artist, album, year, genre, etc) in the database which allows you to efficiently search and manage your music collection.
Today most media applications and players (e.g. iTunes / iPod) organize music by this ID tag information.

{{note|Your audio files ''must'' have a valid ID tag for them to work properly in the {{Kodi}} music library.}}
{{#lst:Adding music to the library|First Time Music Setup}}

=== Adding pictures ===
Adding sources for your [[pictures]] follows the same method as adding other media sources. From the Home Page navigate to Pictures, select Add Source and browse to the location of your picture files.

== Using a remote control ==
{{main|Remote controls}}
{{#lst:Remote controls|intro}}

== {{Kodi}} add-ons ==
{{Main|Add-ons|Add-on manager}}
{{#lst:Add-ons|intro}}

{{#lst:Add-on manager|HOW-TO install}}

== Changing the look and feel of {{Kodi}} ==
{{Kodi}} is unlike many contemporary media and gaming centers, in that it can be easily customized to look completely different using ''[[skins]]'' while still remaining equally as useable and providing access to all your videos, music, and more.

To get new skins, go to: {{highlight|Settings → Interface settings → Skin → Skin - Estuary|bordered=yes}}

You will be provided a list of currently installed skins and an option to "Get More..." where you can download additional skins.

'''<big>To change skins, see: [[HOW-TO:Change_skins|How To: Change Skins]]</big>'''

<gallery caption="The same home screen using different skins" widths=200px heights=113px>
File:Estuary_home_movies.png| Estuary - default skin, Kodi 17 & above
File:Confluence_ss.png|Confluence - default skin, Kodi 16 & below
File:Aeon Nox - glass home.jpg|Aeon Nox
File:Immersive.jpg|Immersive
File:Titan.jpg|Titan
File:Welo.jpg|Welo
File:Transparency.jpg|Transparency
</gallery>

== Important note about the Context Menu ==
{{main|Context menu}}
As you read this wiki and experiment on your own, you will quickly learn about the value of the '''''[[context menu]]'''''.

To use it, while highlighting an item, press the {{keypress|'''C'''}} key on the keyboard. If you are using a mouse, you can right click while hovering over an item. With remote controls, this is normally the {{button|guide}} button.

== Alternative guides ==
{{main|Video management#Alternative guides}}
{{#lst:Video management|Alternative guides}}

{{Helix updated}}

==See also==
* [[First time user]]

[[Category:Manual]]
[[Category:Guides]]
[[Category:Quick Start Guide]]
[[Category:First time user]]

Quick start guide

2017-04-22T17:25:53Z

Tinwarble: /* Adding music to the library */

{{mininav|[[General topics]]|[[First time user]]}}
Congratulations, new user, in your choice of [[w:media center|media center]] software: [[Kodi|{{Kodi}}]]!

<section begin="intro" />This guide is designed to get you up and running with {{Kodi}} in the shortest time possible, and was written with the most typical use cases in mind.<section end="intro" />
For more in depth information please refer to the [[Main Page|{{Kodi}} online wiki manual]]

The {{Kodi}} interface is designed with the '[[w:Home cinema|Home Theater]]' in mind. This means it is best viewed on a large-screen TV while you sit on your couch [[10-foot user interface|10-feet away from that TV]], rather than on a small monitor while you sit at your desk.
Because everything is designed with the home theater experience in mind, the best way to interact with {{Kodi}} is with a remote control, rather than a computer mouse. If it helps, think of {{Kodi}} as the ultimate DVD-player/set-top-box.

== Installing {{Kodi}} ==
{{main|Installing}}
{{#lst:Installing|intro}}

If you haven't already done so, download {{Kodi}} from '''http://kodi.tv/download/''' or see the installation guides here:
{{#lst:Installing|OS}}
See the '''[[Installing]]''' page for additional guides.

== Adding files ==
{{See also|File sharing|Media sources}}
While you can just use {{Kodi}} with plain file views, adding/scanning files to the library will add rich features such as cover art, summaries, thumbnails, trailers, and more.

To just quickly add files see [[Adding videos to the library/Adding media sources]].
=== Adding videos to the library ===
{{main|Adding videos to the library|Video library}}
{{#lst:Video library/Adding media sources|adding video}}

=== Adding music to the library ===
:''See main page: '''[[Adding music to the library]]''' and '''[[Music library]]'''''
In order to be able to include information on your music collection in the library, {{Kodi}} needs your music to be tagged. When your collection is scanned, {{Kodi}} stores all the tagging information (artist, album, year, genre, etc) in the database which allows you to efficiently search and manage your music collection.
Today most media applications and players (e.g. iTunes / iPod) organize music by this ID tag information.

{{note|Your audio files ''must'' have a valid ID tag for them to work properly in the {{Kodi}} music library.}}

{{#lst:Adding music to the library|First Time Music Setup}}

=== Adding pictures ===
Adding sources for your [[pictures]] follows the same method as adding other media sources. From the Home Page navigate to Pictures, select Add Source and browse to the location of your picture files.

== Using a remote control ==
{{main|Remote controls}}
{{#lst:Remote controls|intro}}

== {{Kodi}} add-ons ==
{{Main|Add-ons|Add-on manager}}
{{#lst:Add-ons|intro}}

{{#lst:Add-on manager|HOW-TO install}}

== Changing the look and feel of {{Kodi}} ==
{{Kodi}} is unlike many contemporary media and gaming centers, in that it can be easily customized to look completely different using ''[[skins]]'' while still remaining equally as useable and providing access to all your videos, music, and more.

To get new skins, go to: {{highlight|Settings → Interface settings → Skin → Skin - Estuary|bordered=yes}}

You will be provided a list of currently installed skins and an option to "Get More..." where you can download additional skins.

'''<big>To change skins, see: [[HOW-TO:Change_skins|How To: Change Skins]]</big>'''

<gallery caption="The same home screen using different skins" widths=200px heights=113px>
File:Estuary_home_movies.png| Estuary - default skin, Kodi 17 & above
File:Confluence_ss.png|Confluence - default skin, Kodi 16 & below
File:Aeon Nox - glass home.jpg|Aeon Nox
File:Immersive.jpg|Immersive
File:Titan.jpg|Titan
File:Welo.jpg|Welo
File:Transparency.jpg|Transparency
</gallery>

== Important note about the Context Menu ==
{{main|Context menu}}
As you read this wiki and experiment on your own, you will quickly learn about the value of the '''''[[context menu]]'''''.

To use it, while highlighting an item, press the {{keypress|'''C'''}} key on the keyboard. If you are using a mouse, you can right click while hovering over an item. With remote controls, this is normally the {{button|guide}} button.

== Alternative guides ==
{{main|Video management#Alternative guides}}
{{#lst:Video management|Alternative guides}}

{{Helix updated}}

==See also==
* [[First time user]]

[[Category:Manual]]
[[Category:Guides]]
[[Category:Quick Start Guide]]
[[Category:First time user]]

Adding music to the library

2017-04-22T17:23:44Z

Tinwarble: /* First Time Music Library Setup */

{{mininav|[[Music library]]}}
{{cleanup}}
<section begin="intro"/>Kodi adds music to the library by [[Adding music to the library#Scanning Your Music Into the Music Library|scanning]] music files to extract identifying information from tags in the files. In order to be able to include information on your music collection in the '''[[music library]]''', Kodi needs your music to be tagged. When your collection is scanned, Kodi stores all the tagging information (artist, album, year, genre, etc) in the database which allows you to efficiently search and manage your music collection.<section end="intro"/>

Your audio files '''MUST''' have a valid ID tag for them to work properly in the Kodi music library. There are third party applications available for download from the internet that allow you to add and manage ID tags in your music files.

== See also audio streams ==
{{see also|Internet_video_and_audio_streams}}

== First Time Music Library Setup ==
<section begin="First Time Music Setup" />
<gallery widths=500px heights=313px>
File:Estuary_home_music.png|'''Step 1:''' On the Home menu select '''Music''' from the menu itmes, then select '''Enter files section'''
File:Estuary_music_file_browser.png|'''Step 2:''' In the '''Music File Browser''' select '''Add music'''.
File:Estuary_add_music_source.png|'''Step 3:''' In the '''Add music source''' window select '''Browse'''. You can also manually add your source by selecting the box with '''<None>''' then typing in your path. If you chose to do it this way skip to '''Step 5'''
File:Estuary_music_browse_source.png|'''Step 4:''' In the '''Browse for new share''' window, navigate to where your music is stored, select the folder and then select '''OK'''.
File:Estuary_music_name_source.png|'''Step 5:''' You will now be taken back to the '''Add music source''' window where under '''Enter a name for this media source''' you can name your media source. If you don't enter a name then, by default, Kodi will use the folder name as the name for your source. You can then select '''OK'''.
File:Estuary_music_scan_source.png|'''Step 6:''' You will now be asked if you wish to add your media source to the library. If you do, then select '''Yes''', if you do not, then select '''No'''. By selecting '''No''' you will only have the option of accessing your media though the '''Music file browser'''.
File:Estuary_music_scanning_library.png|'''Step 7:''' If you selected '''Yes''' Kodi will begin scanning your source to the library.
File:Estuary_home_music_library.png|'''Step 8:''' Once your library is scanned you will be able to see & access '''Recently added albums, Random albums, Random Artist & Unplayed albums''' on the Home menu.
File:Estuary_music_albums.png|You will also be able to view your entire music library by selecting '''Music''' from the Home menu, then selecting the appropriate category. Or from the Home menu, navigate to '''Categories''' at the top of the '''Music''' menu item and then selecting the category you wish to view. '''Example: Category''' → '''Albums'''.
File:Estuary_music_artist.png|'''Example: Category''' → '''Artist'''.
</gallery>
<section end="First Time Music Setup" />

== Adding Additional Music Sources ==
<gallery widths=500px heights=313px>
File:Estuary_home_music_files.png|To add additional sources to your library, from the Home menu select '''Music'''. Then navigate to the to the top of the page and under '''Categories''' select '''Files'''. Then follow the directions from '''Step 2''' in [[Estuary:Adding_music_to_the_library#First_Time_Music_Library_Setup|First Time Music Library Setup]]
</gallery>

== Sources for Music ==
{{main|Media sources}}
Kodi gives you the ability to listen to music from a variety of sources, click here for more information and examples of [[Types of Media Sources|Types of Media Sources (link)]].<br />
Some examples of sources that allow you to easily access all your digital music collection:
* '''On your computer or a [[NAS (Network Attached Storage)]] device/system, which supports [[SMB]] file sharing'''
* '''Stored directly on the hard drive'''
* '''On CDs/DVDs'''
* '''Streamed from the Internet'''
For information on how to configure remote file shares, please click [[Configuring PC Shares|here (link)]]

== Ripping CDs ==
{{main|Ripping CDs}}
{{#lst:Ripping CDs|intro}}

== MusicBrainz integration ==
{{main|MusicBrainz metadata}}
{{#lst:MusicBrainz metadata|intro}}

== Applications to edit music Tags ==
Your audio files '''MUST''' have correct audio tags to use the Music Library mode. Without tags you're limited to the file view in Kodi. There are several tools out there that will allow you to manipulate music ID tags.

* [[Supplemental tools/Linux#Music tools]]
* [[Supplemental tools/Mac OS X#Music tools]]
* [[Supplemental tools/Windows#Music tools]]

== Technical Explanation: File tags ==
''Skip this section if you're not interested a technical explanation of this subject. You don't need this information to use what is explained in the previous section.''

For many categories, such as genres and artists, Kodi supports multiple values in the one field. By default it uses the character sequence " / " to divide the entry into multiple values. This divider may be changed via [[advancedsettings.xml]].

=== Artist Tags - Resolving Compilations and Multiple Artists ===
Kodi reads the ''Album Artist'' tag in ID3, Ogg, APE and MP4 tags and uses it if available to assign an artist to the album (independently of the track's artist information). This is the "Album Artist" tag (in ID3 this is represented by the "TPE2" tag; in vorbiscomment (ogg) files "ALBUMARTIST", "ALBUM ARTIST" and "ENSEMBLE" are all supported). Multiple artists for either a track or album artist can be specified in "Artist1 / Artist2 / Artist3" format.

If no ''Album Artist'' tag exists, Kodi will use the first (primary) artist from the tracks as the ''Album Artist''. Essentially we do a string comparison of all the track artists, and assign the common artists as the ''Album artist''. This is generally the TPE1 tag in ID3.

As many users don't yet use the ''Album Artist'' tag, Kodi has an additional filter system for identifying compilation albums, where each track normally has a different artist. As Kodi scans a folder, it does the following:

# Identifies albums based on ''Album'' name alone in the folder and groups the songs that have the same ''Album'' name together as an album.
# Runs through each album's assigned songs. If there is 2 or more tracks with the same ''Track'' number, the group of songs must come from 2 or more albums, so the ''Album'' name is ruled out as a possible compilation.
# If any of the songs assigned to the ''Album'' name have an ''Album Artist'' tag, then Kodi assumes the user knows what they're doing, and this album is also ruled out from being a compilation.
# If two or more songs assigned to the ''Album'' name then have different primary artists, then the ''Album'' name is considered to be a group of songs from a compilation, and the ''Various Artists''" tag is assigned as the album artist.
# Otherwise, if all the songs have the same primary artist but don't have the same full artist list (eg a song or two has an additional artist) then the album is assigned the primary artist as it's ''Album Artist'', and we assume the additional artists are guest artists.

=== Ratings in ID3 tags ===
Ratings in ID3 tags are read via the POPM field, and (if this doesn't exist) in a custom (TXXX) field named "RATING". For the RATING field, we accept 1-5 as valid ratings. For the POPM field things are more complicated, as there is no established standard in place. We currently most closely respect what Mediamonkey does, and also have some support for what Windows Media Player 11 does. The POPM tag takes a value from 0..255, with 0 meaning no rating, 1 the worst, and 255 the best. We currently map these as follows:

{| class="prettytable"
|-
|
'''POPM value'''
|
'''Star rating'''
|-
|
0
|
|-
|
1
|
'''*''' This is a special case for Windows Media Player
|-
|
2-8
|
|-
|
9-49
|
'''*'''
|-
|
50-113
|
'''**'''
|-
|
114-167
|
'''***'''
|-
|
168-218
|
'''****'''
|-
|
219-255
|
'''*****'''
|}

== Embedded Album Art ==
Kodi supports embedded album art in files with ID3 tags, WMA tags and MP4 tags only. It does not support embedded album art in APE, Ogg or FLAC tags currently. To have album art for these formats, see the [[Thumbnails]] portion of the manual.

== Album art and thumbnails ==
{{See also|Thumbnails}}
{|
| valign="top" |
There are a number of ways to get thumbnails to display in Music.<br />
Album art can by obtained via [http://www.allmusic.com Allmusic.com] and described in the [[My Music Navigation and Control#The Context Menu|The Context Menu]] section. Music tags can also contain art for that specific song, as can be seen in [[Preparing your Music]].<br />
If you want a custom thumb, you can add a .jpg file to your music directory. The .tbn file can be either a .JPG or a .PNG file (with transparency) that you simply rename the extension from .jpg/.png to .tbn.<br />
The size of the picture can be anything from 64x64 to 256x256 in pixel-size (you may want to use a larger pixel-size if you use Kodi in 720p/1080i HDTV resolution to get a sharper image).<br />

'''Examples:'''<br />
In this example audiofilename.mp3 will use audiofilename.tbn as thumbnail:
Music\path\'''audiofilename.mp3'''
Music\path\'''audiofilename.tbn'''
|
[[File:mymusic.jpg|right|500px]]
|}
The same goes for playlists, [[Cue sheets]], SHOUTcast, and [[HOW-TO: Play Internet Streams|internet-stream files]], eg:
Music\path\'''audioplaylistname.m3u'''
Music\path\'''audioplaylistname.tbn'''
Music\path\'''cuelistname.cue'''
Music\path\'''cuelistname.tbn'''
Music\path\'''shoutcastlinkname.pls'''
Music\path\'''shoutcastlinkname.tbn'''
Music\path\'''audiostreamname.strm'''
Music\path\'''audiostreamname.tbn'''

If you store each of your music-albums or artists in a separate subfolder to keep things organized, you can also make the folder have a custom thumbnail image. To do this you need to rename your .jpg thumbnail as folder.jpg and place it in the folder (the size of the picture can be anything from 64x64 to 256x256 in pixel size).<br />

'''Example:'''<br />
Music\path\album\'''folder.jpg'''

Now your album/artist folder will have a lovely custom thumbnail-image.

You can via [[advancedsettings.xml]] change the default filename of the image that Kodi uses for music folders. See the [[advancedsettings.xml#<musicthumbs>|<musicthumbs>]] tag. for more information.

== NFO files ==
{{main|NFO files}}
{{#lst:NFO files|intro}}

== Cue sheets ==
{{main|Cue sheets}}
{{#lst:Cue sheets|intro}}

{{Krypton updated}}

[[Category:Manual]]
[[Category:Music library]]

Adding music to the library

2017-04-22T17:09:35Z

Tinwarble:

{{mininav|[[Music library]]}}
{{cleanup}}
<section begin="intro"/>Kodi adds music to the library by [[Adding music to the library#Scanning Your Music Into the Music Library|scanning]] music files to extract identifying information from tags in the files. In order to be able to include information on your music collection in the '''[[music library]]''', Kodi needs your music to be tagged. When your collection is scanned, Kodi stores all the tagging information (artist, album, year, genre, etc) in the database which allows you to efficiently search and manage your music collection.<section end="intro"/>

Your audio files '''MUST''' have a valid ID tag for them to work properly in the Kodi music library. There are third party applications available for download from the internet that allow you to add and manage ID tags in your music files.

== See also audio streams ==
{{see also|Internet_video_and_audio_streams}}

== First Time Music Library Setup ==
<gallery widths=500px heights=313px>
File:Estuary_home_music.png|'''Step 1:''' On the Home menu select '''Music''' from the menu itmes, then select '''Enter files section'''
File:Estuary_music_file_browser.png|'''Step 2:''' In the '''Music File Browser''' select '''Add music'''.
File:Estuary_add_music_source.png|'''Step 3:''' In the '''Add music source''' window select '''Browse'''. You can also manually add your source by selecting the box with '''<None>''' then typing in your path. If you chose to do it this way skip to '''Step 5'''
File:Estuary_music_browse_source.png|'''Step 4:''' In the '''Browse for new share''' window, navigate to where your music is stored, select the folder and then select '''OK'''.
File:Estuary_music_name_source.png|'''Step 5:''' You will now be taken back to the '''Add music source''' window where under '''Enter a name for this media source''' you can name your media source. If you don't enter a name then, by default, Kodi will use the folder name as the name for your source. You can then select '''OK'''.
File:Estuary_music_scan_source.png|'''Step 6:''' You will now be asked if you wish to add your media source to the library. If you do, then select '''Yes''', if you do not, then select '''No'''. By selecting '''No''' you will only have the option of accessing your media though the '''Music file browser'''.
File:Estuary_music_scanning_library.png|'''Step 7:''' If you selected '''Yes''' Kodi will begin scanning your source to the library.
File:Estuary_home_music_library.png|'''Step 8:''' Once your library is scanned you will be able to see & access '''Recently added albums, Random albums, Random Artist & Unplayed albums''' on the Home menu.
File:Estuary_music_albums.png|You will also be able to view your entire music library by selecting '''Music''' from the Home menu, then selecting the appropriate category. Or from the Home menu, navigate to '''Categories''' at the top of the '''Music''' menu item and then selecting the category you wish to view. '''Example: Category''' → '''Albums'''.
File:Estuary_music_artist.png|'''Example: Category''' → '''Artist'''.
</gallery>

== Adding Additional Music Sources ==
<gallery widths=500px heights=313px>
File:Estuary_home_music_files.png|To add additional sources to your library, from the Home menu select '''Music'''. Then navigate to the to the top of the page and under '''Categories''' select '''Files'''. Then follow the directions from '''Step 2''' in [[Estuary:Adding_music_to_the_library#First_Time_Music_Library_Setup|First Time Music Library Setup]]
</gallery>

== Sources for Music ==
{{main|Media sources}}
Kodi gives you the ability to listen to music from a variety of sources, click here for more information and examples of [[Types of Media Sources|Types of Media Sources (link)]].<br />
Some examples of sources that allow you to easily access all your digital music collection:
* '''On your computer or a [[NAS (Network Attached Storage)]] device/system, which supports [[SMB]] file sharing'''
* '''Stored directly on the hard drive'''
* '''On CDs/DVDs'''
* '''Streamed from the Internet'''
For information on how to configure remote file shares, please click [[Configuring PC Shares|here (link)]]

== Ripping CDs ==
{{main|Ripping CDs}}
{{#lst:Ripping CDs|intro}}

== MusicBrainz integration ==
{{main|MusicBrainz metadata}}
{{#lst:MusicBrainz metadata|intro}}

== Applications to edit music Tags ==
Your audio files '''MUST''' have correct audio tags to use the Music Library mode. Without tags you're limited to the file view in Kodi. There are several tools out there that will allow you to manipulate music ID tags.

* [[Supplemental tools/Linux#Music tools]]
* [[Supplemental tools/Mac OS X#Music tools]]
* [[Supplemental tools/Windows#Music tools]]

== Technical Explanation: File tags ==
''Skip this section if you're not interested a technical explanation of this subject. You don't need this information to use what is explained in the previous section.''

For many categories, such as genres and artists, Kodi supports multiple values in the one field. By default it uses the character sequence " / " to divide the entry into multiple values. This divider may be changed via [[advancedsettings.xml]].

=== Artist Tags - Resolving Compilations and Multiple Artists ===
Kodi reads the ''Album Artist'' tag in ID3, Ogg, APE and MP4 tags and uses it if available to assign an artist to the album (independently of the track's artist information). This is the "Album Artist" tag (in ID3 this is represented by the "TPE2" tag; in vorbiscomment (ogg) files "ALBUMARTIST", "ALBUM ARTIST" and "ENSEMBLE" are all supported). Multiple artists for either a track or album artist can be specified in "Artist1 / Artist2 / Artist3" format.

If no ''Album Artist'' tag exists, Kodi will use the first (primary) artist from the tracks as the ''Album Artist''. Essentially we do a string comparison of all the track artists, and assign the common artists as the ''Album artist''. This is generally the TPE1 tag in ID3.

As many users don't yet use the ''Album Artist'' tag, Kodi has an additional filter system for identifying compilation albums, where each track normally has a different artist. As Kodi scans a folder, it does the following:

# Identifies albums based on ''Album'' name alone in the folder and groups the songs that have the same ''Album'' name together as an album.
# Runs through each album's assigned songs. If there is 2 or more tracks with the same ''Track'' number, the group of songs must come from 2 or more albums, so the ''Album'' name is ruled out as a possible compilation.
# If any of the songs assigned to the ''Album'' name have an ''Album Artist'' tag, then Kodi assumes the user knows what they're doing, and this album is also ruled out from being a compilation.
# If two or more songs assigned to the ''Album'' name then have different primary artists, then the ''Album'' name is considered to be a group of songs from a compilation, and the ''Various Artists''" tag is assigned as the album artist.
# Otherwise, if all the songs have the same primary artist but don't have the same full artist list (eg a song or two has an additional artist) then the album is assigned the primary artist as it's ''Album Artist'', and we assume the additional artists are guest artists.

=== Ratings in ID3 tags ===
Ratings in ID3 tags are read via the POPM field, and (if this doesn't exist) in a custom (TXXX) field named "RATING". For the RATING field, we accept 1-5 as valid ratings. For the POPM field things are more complicated, as there is no established standard in place. We currently most closely respect what Mediamonkey does, and also have some support for what Windows Media Player 11 does. The POPM tag takes a value from 0..255, with 0 meaning no rating, 1 the worst, and 255 the best. We currently map these as follows:

{| class="prettytable"
|-
|
'''POPM value'''
|
'''Star rating'''
|-
|
0
|
|-
|
1
|
'''*''' This is a special case for Windows Media Player
|-
|
2-8
|
|-
|
9-49
|
'''*'''
|-
|
50-113
|
'''**'''
|-
|
114-167
|
'''***'''
|-
|
168-218
|
'''****'''
|-
|
219-255
|
'''*****'''
|}

== Embedded Album Art ==
Kodi supports embedded album art in files with ID3 tags, WMA tags and MP4 tags only. It does not support embedded album art in APE, Ogg or FLAC tags currently. To have album art for these formats, see the [[Thumbnails]] portion of the manual.

== Album art and thumbnails ==
{{See also|Thumbnails}}
{|
| valign="top" |
There are a number of ways to get thumbnails to display in Music.<br />
Album art can by obtained via [http://www.allmusic.com Allmusic.com] and described in the [[My Music Navigation and Control#The Context Menu|The Context Menu]] section. Music tags can also contain art for that specific song, as can be seen in [[Preparing your Music]].<br />
If you want a custom thumb, you can add a .jpg file to your music directory. The .tbn file can be either a .JPG or a .PNG file (with transparency) that you simply rename the extension from .jpg/.png to .tbn.<br />
The size of the picture can be anything from 64x64 to 256x256 in pixel-size (you may want to use a larger pixel-size if you use Kodi in 720p/1080i HDTV resolution to get a sharper image).<br />

'''Examples:'''<br />
In this example audiofilename.mp3 will use audiofilename.tbn as thumbnail:
Music\path\'''audiofilename.mp3'''
Music\path\'''audiofilename.tbn'''
|
[[File:mymusic.jpg|right|500px]]
|}
The same goes for playlists, [[Cue sheets]], SHOUTcast, and [[HOW-TO: Play Internet Streams|internet-stream files]], eg:
Music\path\'''audioplaylistname.m3u'''
Music\path\'''audioplaylistname.tbn'''
Music\path\'''cuelistname.cue'''
Music\path\'''cuelistname.tbn'''
Music\path\'''shoutcastlinkname.pls'''
Music\path\'''shoutcastlinkname.tbn'''
Music\path\'''audiostreamname.strm'''
Music\path\'''audiostreamname.tbn'''

If you store each of your music-albums or artists in a separate subfolder to keep things organized, you can also make the folder have a custom thumbnail image. To do this you need to rename your .jpg thumbnail as folder.jpg and place it in the folder (the size of the picture can be anything from 64x64 to 256x256 in pixel size).<br />

'''Example:'''<br />
Music\path\album\'''folder.jpg'''

Now your album/artist folder will have a lovely custom thumbnail-image.

You can via [[advancedsettings.xml]] change the default filename of the image that Kodi uses for music folders. See the [[advancedsettings.xml#<musicthumbs>|<musicthumbs>]] tag. for more information.

== NFO files ==
{{main|NFO files}}
{{#lst:NFO files|intro}}

== Cue sheets ==
{{main|Cue sheets}}
{{#lst:Cue sheets|intro}}

{{Krypton updated}}

[[Category:Manual]]
[[Category:Music library]]

File:Estuary home music files.png

2017-04-22T16:45:01Z

Tinwarble:

File:Estuary music artist.png

2017-04-22T15:41:26Z

Tinwarble:

File:Estuary music albums.png

2017-04-22T15:36:47Z

Tinwarble:

File:Estuary home music library.png

2017-04-22T15:30:52Z

Tinwarble:

File:Estuary music scanning library.png

2017-04-22T15:26:18Z

Tinwarble:

File:Estuary music name source.png

2017-04-22T15:17:30Z

Tinwarble:

File:Estuary music browse source.png

2017-04-22T15:14:37Z

Tinwarble:

File:Estuary add music source.png

2017-04-22T14:49:48Z

Tinwarble:

File:Estuary music file browser.png

2017-04-22T14:44:18Z

Tinwarble:

File:Estuary home music.png

2017-04-22T14:36:54Z

Tinwarble:

HOW-TO:Change skins

2017-04-21T16:05:04Z

Tinwarble: /* Installing a new skin */

{{mininav|[[Extras]]|[[Add-ons]]|[[Skins]]|page={{FULLPAGENAME}} }}
<section begin="intro"/>Many of us have been tempted by the allure of Kodi's beauty. There are some excellent skin designers out there who have gone to great lengths to create and share beautiful ways of viewing and navigating our media collections. As default, Kodi comes with the excellent skin Estuary, but there are plenty more to choose from.<section end="intro"/>

== Installing a new skin==
<gallery widths=500px heights=313px>
File:Estuary_home_blank.png|'''Step 1:''' Start from the Home screen
File:Estuary_home_settings_icon.png|'''Step 2:''' Navigate to the top of the menu and select '''System Settings''' (the gear) icon.
File:Interface_settings.png|'''Step 3:''' Select '''Interface settings'''.
File:Interface_settings_skin.png|'''Step 4:''' In the Interface setttings, select '''Skin''', then '''Skin''' under '''Look and feel'''.
File:Skin_get_more.png|'''Step 5:''' By default, there are only 2 skins installed, '''Estuary'''(the default skin) and '''Estouchy'''. To install another skin, select '''Get more...'''
File:Skin_get_more_browse.png|'''Step 6:''' In the new window, select the skin you want to install from the list.
File:Skin_get_more_downloading.png|'''Step 7:''' After you have select the skin it will begin downloading.
File:Skin_get_more_installing.png|'''Step 8:''' Once downloaded, the skin and any dependencies it requires will install.
File:Skin_get_more_switch_skin.png|'''Step 9:''' Once installed, Kodi will ask you if you want to start using that skin. If you do the select '''Yes'''
File:Skin_get_more_new_skin.png|'''Step 10:''' Enjoy your new skin!!!
</gallery>

== Installing a skin from a zip file. ==
Although there are many skins already available to you from Kodi Add-on repository, there are even more that you may want to try out, including modified skins of the ones available. Some of those skins can be found in the [http://forum.kodi.tv/forumdisplay.php?fid=67 Skin Support] section of the Kodi forum as well as Work in Progress skins which can be found in the [http://forum.kodi.tv/forumdisplay.php?fid=67 Skinning/WIP Skins] sub-section of the Kodi forum.

To install these skins you will need to install them from a zip file. See [[Add-on_manager#How_to_install_from_a_ZIP_file|How to install from a ZIP file]] for how to install.

:''Note: Estuary was designed to be fully featured. Sometimes as a new user, it can be daunting enough to get used to the program for starters without changing things. It is highly recommended that you stick to Estuary until you’re sure of how things work. Should you ever encounter issues with another skin, such as the feeling that something is missing, consider reverting to Estuary to see if it was simply an issue with that skin.'

{{helix updated}}

[[Category:How-to]]
[[Category:Skins|*]]
[[Category:Manual]]
[[Category:Add-ons]]

Settings/Player/Videos

2017-04-20T18:43:43Z

Tinwarble: /* Processing */

[[File:Player_videos1.JPG|600px|right]] [[File:Player_videos2.JPG|600px|right]]

__TOC__

=== Actions ===

{| class="wikitable"
|-
! Setting !! Description
|-
| Play next video automatically || When selected this enables automatic playback of the next file in the list
|-
| Skip steps || Defines the amount of time each press of the Skip button will skip forward or backwards. A (-) will define backwards and no (-) will define forward. You can set multiple times so each press will skip more time in the video. So if, for example you use '''10 sec, 30 sec, 60 sec''' when press the Skip button once it will skip 10 seconds foward, double pressing the Skip button will skip 30 seconds and triple pressing the Skip button will skip 60 seconds.
|-
| Skip delay || Defines how much time it takes before the skip step occurs. The range is '''none''' (which will cause the skip step to happen immediately) & '''250 - 3000ms''' (milliseconds).
|}

=== Playback===

{| class="wikitable"
|-
! Setting !! Description
|-
| Adjust display refresh rate || Defines when the refresh rate adjustments should take place.
Activate to automatically set the refresh rate which is best matched with the video that is playing (default off). This potentially allows for perfectly smooth video reproduction, as video material can be recorded in a variety of frame rates (23.976fps, 24fps, 25fps, 29.97fps, 30 fps, etc.) which need to be properly matched by the refresh rate of the display, in order to be displayed smoothly.
|-
| Sync playback to display || This setting enables syncing the video to the refresh rate of the monitor.
|-
| Minimise black bars || Allow video player to try to fit video to screen by ignoring aspect ratio by a certain amount.
|-
| Display 4:3 videos as || Determines the zoom level that 4:3 videos are shown on widescreen displays.
|}

=== Processing ===

{| class="wikitable"
|-
! Setting !! Description
|-
| Render Method || Controls the method used by the player to process and display the video, (which is called rendering).
|-
| Enable HQ scalers for scaling above || ?
|-
| Allow hardware acceleration || Enables hardware decoding of video files e.g. VDPAU, Mediacodec.
|}

=== Stereoscopic 3D ===

{| class="wikitable"
|-
! Setting !! Description
|-
| Playback mode of stereoscopic videos || ?
|-
| Disable stereoscopic mode when playback is stopped || ?
|}

=== Teletext ===

{| class="wikitable"
|-
! Setting !! Description
|-
| Activate Teletext || Enables Teletext when watching a live TV stream.
|-
| Scale Teletext to 4:3 || When selected scales Teletext to 4:3 ratio.
|}

Settings/Player/Videos

2017-04-20T18:42:57Z

Tinwarble: /* Actions */

[[File:Player_videos1.JPG|600px|right]] [[File:Player_videos2.JPG|600px|right]]

__TOC__

=== Actions ===

{| class="wikitable"
|-
! Setting !! Description
|-
| Play next video automatically || When selected this enables automatic playback of the next file in the list
|-
| Skip steps || Defines the amount of time each press of the Skip button will skip forward or backwards. A (-) will define backwards and no (-) will define forward. You can set multiple times so each press will skip more time in the video. So if, for example you use '''10 sec, 30 sec, 60 sec''' when press the Skip button once it will skip 10 seconds foward, double pressing the Skip button will skip 30 seconds and triple pressing the Skip button will skip 60 seconds.
|-
| Skip delay || Defines how much time it takes before the skip step occurs. The range is '''none''' (which will cause the skip step to happen immediately) & '''250 - 3000ms''' (milliseconds).
|}

=== Playback===

{| class="wikitable"
|-
! Setting !! Description
|-
| Adjust display refresh rate || Defines when the refresh rate adjustments should take place.
Activate to automatically set the refresh rate which is best matched with the video that is playing (default off). This potentially allows for perfectly smooth video reproduction, as video material can be recorded in a variety of frame rates (23.976fps, 24fps, 25fps, 29.97fps, 30 fps, etc.) which need to be properly matched by the refresh rate of the display, in order to be displayed smoothly.
|-
| Sync playback to display || This setting enables syncing the video to the refresh rate of the monitor.
|-
| Minimise black bars || Allow video player to try to fit video to screen by ignoring aspect ratio by a certain amount.
|-
| Display 4:3 videos as || Determines the zoom level that 4:3 videos are shown on widescreen displays.
|}

=== Processing ===

{| class="wikitable"
|-
! Setting !! Description
|-
| Render Method || Controls the method used by the player to process and display the video, (which is called rendering).
|-
| Enable HQ scalers for scaling above || ?
|-
| Allow hardware acceleration || Enables hardware decoding of video files e.g. VDPAU
|}

=== Stereoscopic 3D ===

{| class="wikitable"
|-
! Setting !! Description
|-
| Playback mode of stereoscopic videos || ?
|-
| Disable stereoscopic mode when playback is stopped || ?
|}

=== Teletext ===

{| class="wikitable"
|-
! Setting !! Description
|-
| Activate Teletext || Enables Teletext when watching a live TV stream.
|-
| Scale Teletext to 4:3 || When selected scales Teletext to 4:3 ratio.
|}

Add-on:Aeon Nox

2017-04-20T10:13:23Z

Tinwarble:

{{forum link2|See the [[forumtopic:142|Aeon Nox sub-forum]] for more information.}}
{{Addon
|Name=Aeon Nox
|provider-name=BigNoid
|ID=skin.aeon.nox.5
|latest-version=5.9.9
|extension point=xbmc.gui.skin
|provides=
|Summary=Aeon Nox 5: Redux
|Description=Redux: Komplett neu designed für ein modernes Aussehen und das klassische Aeon-Feeling beizubehalten.
|Platform=all
|Language=
|License=CC BY-NC-SA 4.0
|Forum=http://forum.kodi.tv/showthread.php?tid=183504
|Website=https://github.com/BigNoid/Aeon-Nox
|Source=https://github.com/BigNoid/Aeon-Nox
|Email=big.noid@kodi.tv
|broken=
|icon url=http://mirrors.kodi.tv/addons/krypton/skin.aeon.nox.5/resources/icon.png}}

{{Skin features
| custom home items = {{yes}}
| custom submenu items = {{yes}}
| Media flags = {{yes}}
| TV show logo = {{yes}}
| TV logo downloader = {{yes}}
| Artwork downloader = {{yes}}
| Clear Art = {{yes}}
| cdArt = {{yes}}
| Extra fanart (Movies) = {{yes}}
| Extra fanart (TV shows) = {{yes}}
| Extra fanart (Music) = {{yes}}
| Season fanart = {{yes}}
| Weather fanart = {{yes}}
| Live TV = {{yes}}
| Next Aired = {{yes}}
| TvTunes = {{yes}}
| Advanced Launcher = {{yes}}
| Watchlist = {{yes}}
| MovieSets = {{yes}}
| Metadata Actors = {{yes}}
| Random And Last Items = {{yes}}
| Touch = {{no}}
}}

{{Compat
| Works with Atlantis = {{no}}
| Works with Babylon = {{no}}
| Works with Camelot = {{no}}
| Works with Dharma = {{no}}
| Works with Eden = {{no}}
| Works with Frodo = {{no}}
| Works with Gotham = {{yes}}
| Works with Helix = {{yes}}
| Works with Isengard = {{yes}}
| Works with Jarvis = {{yes}}
| Works with Krypton = {{yes}}
}}

== Screenshots ==
<section begin="screenshots"/>
<gallery caption="Screenshots" widths=200px heights=113px>
File:nox1.jpg
File:nox2.jpg
File:nox3.jpg
File:nox4.jpg
File:nox5.jpg
File:nox6.jpg
File:nox7.jpg
File:nox8.jpg
</gallery>
<section end="screenshots"/>

== Video demos ==
=== Kodi 15.x - Aeon Nox 5: Redux ===

{{youtube|rBz4QCM9NIs}}

=== XBMC 13 ===
{{youtube|nOY5fq8V15c}}

[[Category:Add-ons with license tag]]
[[Category:Add-ons with source tag]]
[[Category:Add-ons with website tag]]
[[Category:All add-ons]]
[[Category:Skin - Artwork downloader]]
[[Category:Skin - Clear Art]]
[[Category:Skin - Metadata Actors]]
[[Category:Skin - Next Aired]]
[[Category:Skin - PVR]]
[[Category:Skin - Skin Widgets]]
[[Category:Skin - TV show logo]]
[[Category:Skin - TvTunes]]
[[Category:Skin - cdArt]]
[[Category:Skin - custom home items]]
[[Category:Skin - extra fanart]]
[[Category:Skins]]
[[Category:Krypton add-on repository]]
[[Category:Isengard add-on repository]]
[[Category:Gotham add-on repository]]
[[Category:Helix add-on repository]]
[[Category:Jarvis add-on repository]]

Add-on:Estuary

2017-04-20T10:10:53Z

Tinwarble:

bots}}
{{Add-on
| Name = Estuary
| provider-name = phil65
| ID = skin.estuary
| latest-version = 1.9.12
| extension point = Kodi.gui.skin
| type = skin
| Platform = all
|Language=
|License=GNU General Public License version 2
|Forum=http://forum.kodi.tv/forumdisplay.php?fid=260
|Website=
|Source=https://github.com/phil65/skin.estuary
|Email=
|broken=
| Summary = Estuary skin by phil65. (Kodi's >v17 default skin)
| Description =
{{forum link2|See the [[forumtopic:260|Estuary sub-forum]] for more information.}}Estuary is the default skin for Kodi 17 and above.}}
__TOC__
== Skin features compatibility ==
{{See also|Skin features compatibility list}}
{{Skin features
| skin = [[Add-on:Estuary|Estuary]]
| custom home items = {{partial}}
| custom submenu items = {{partial}}
| Media flags = {{yes}}
| TV show logo = {{no}}
| TV logo downloader = {{no}}
| Artwork downloader = {{no}}
| Clear Art = {{no}}
| cdArt = {{no}}
| Extra fanart = {{no}}
| Season fanart = {{yes}}
| Weather fanart = {{yes}}
| Live TV = {{yes}}
| Next Aired = {{yes}}
| TvTunes = {{yes}}
| Skin Widgets = {{yes}}
| Advanced Launcher = {{no}}
| Watchlist = {{no}}
| MovieSets = {{yes}}
| Metadata Actors = {{no}}
| Cinema Experience = {{no}}
| Intro movie = {{no}}
| Touch = {{yes}}
| PVR = {{yes}}
}}
{{Compat
| Works with Atlantis = {{no}}
| Works with Babylon = {{no}}
| Works with Camelot = {{no}}
| Works with Dharma = {{no}}
| Works with Eden = {{no}}
| Works with Frodo = {{no}}
| Works with Gotham = {{no}}
| Works with Helix = {{no}}
| Works with Isengard = {{no}}
| Works with Jarvis = {{no}}
| Works with Krypton = {{yes}}
| Works with Leia = {{yes}}
}}
== Settings ==
:See: '''[[Add-on:Estuary/Settings|Estuary Skin Settings]]'''

== Media flags ==
{{see also|Media flags#Media source}}

== Screenshots ==

<gallery widths=250px heights=150px perrow=3 caption= "Estuary Screenshots">
File:Estuary-home.jpg
File:Estuary-movies-list.jpg
File:Estuary-tvshow-banner.jpg
File:Estuary-music-artists.jpg
File:Estuary-livetv.jpg
File:Estuary-Addons.jpg
File:Estuary-weather.jpg
</gallery>

[[Category:Add-ons with license tag]]
[[Category:Add-ons with source tag]]
[[Category:All add-ons]]
[[Category:Skins]]

Add-on:Estuary

2017-04-20T10:09:33Z

Tinwarble:

bots}}
{{Add-on
| Name = Estuary
| provider-name = phil65
| ID = skin.estuary
| latest-version = 1.9.12
| extension point = Kodi.gui.skin
| type = skin
| Platform = all
|Language=
|License=GNU General Public License version 2
|Forum=http://forum.kodi.tv/forumdisplay.php?fid=260
|Website=
|Source=https://github.com/phil65/skin.estuary
|Email=
|broken=
| Summary = Estuary skin by phil65. (Kodi's >v17 default skin)
| Description =
{{forum link2|See the [[forumtopic:260|Estuary sub-forum]] for more information.}}Estuary is the default skin for Kodi 17 and above.}}
__TOC__
== Skin features compatibility ==
{{See also|Skin features compatibility list}}
{{Skin features
| skin = [[Add-on:Estuary|Estuary]]
| custom home items = {{partial}}
| custom submenu items = {{partial}}
| Media flags = {{yes}}
| TV show logo = {{no}}
| TV logo downloader = {{no}}
| Artwork downloader = {{no}}
| Clear Art = {{no}}
| cdArt = {{no}}
| Extra fanart = {{no}}
| Season fanart = {{yes}}
| Weather fanart = {{yes}}
| Live TV = {{yes}}
| Next Aired = {{yes}}
| TvTunes = {{yes}}
| Skin Widgets = {{yes}}
| Advanced Launcher = {{no}}
| Watchlist = {{no}}
| MovieSets = {{yes}}
| Metadata Actors = {{no}}
| Cinema Experience = {{no}}
| Intro movie = {{no}}
| Touch = {{?}}
| PVR = {{yes}}
}}
{{Compat
| Works with Atlantis = {{no}}
| Works with Babylon = {{no}}
| Works with Camelot = {{no}}
| Works with Dharma = {{no}}
| Works with Eden = {{no}}
| Works with Frodo = {{no}}
| Works with Gotham = {{no}}
| Works with Helix = {{no}}
| Works with Isengard = {{no}}
| Works with Jarvis = {{no}}
| Works with Krypton = {{yes}}
| Works with Leia = {{yes}}
}}
== Settings ==
:See: '''[[Add-on:Estuary/Settings|Estuary Skin Settings]]'''

== Media flags ==
{{see also|Media flags#Media source}}

== Screenshots ==

<gallery widths=250px heights=150px perrow=3 caption= "Estuary Screenshots">
File:Estuary-home.jpg
File:Estuary-movies-list.jpg
File:Estuary-tvshow-banner.jpg
File:Estuary-music-artists.jpg
File:Estuary-livetv.jpg
File:Estuary-Addons.jpg
File:Estuary-weather.jpg
</gallery>

[[Category:Add-ons with license tag]]
[[Category:Add-ons with source tag]]
[[Category:All add-ons]]
[[Category:Skins]]

Add-on:Confluence

2017-04-20T09:14:37Z

Tinwarble:

{{Add-on
| Name = Confluence
| provider-name = Jezz_X, Team Kodi
| ID = skin.confluence
| latest-version = 2.1.0
| extension point = Kodi.gui.skin
| type = skin
| Platform = all
|Language=
|License=GNU General Public License version 2
|Forum=http://forum.kodi.tv/forumdisplay.php?fid=125
|Website=
|Source=https://github.com/xbmc/skin.confluence
|Email=
|broken=
| Summary = Confluence skin by Jezz_X. (Kodi's <v17 default skin)
| Description =
{{forum link2|See the [[forumtopic:125|Confluence sub-forum]] for more information.}}Confluence is the default skin for Kodi 9.11 - 16.x. It is a combination of concepts from many popular skins, and attempts to embrace and integrate their good ideas into a skin that should be easy for first time Kodi users to understand and use.
}}

== Skin features compatibility ==
{{See also|Skin features compatibility list}}
Confluence skin is among other features compatible these features:
* [[Add-on:Favourites_script|Custom home items via Favourites script]]
* [[Add-on:Global_Search|Global Search]]
* [[PVR|Live TV/PVR]]


{{Skin features
| skin = [[Add-on:Confluence|Confluence]]
| custom home items = {{partial}}
| custom submenu items = {{partial}}
| Media flags = {{yes}}
| TV show logo = {{no}}
| TV logo downloader = {{no}}
| Artwork downloader = {{no}}
| Clear Art = {{no}}
| cdArt = {{no}}
| Extra fanart = {{no}}
| Season fanart = {{yes}}
| Weather fanart = {{yes}}
| Live TV = {{yes}}
| Next Aired = {{yes}}
| TvTunes = {{yes}}
| Skin Widgets = {{yes}}
| Advanced Launcher = {{no}}
| Watchlist = {{no}}
| MovieSets = {{yes}}
| Metadata Actors = {{no}}
| Cinema Experience = {{no}}
| Intro movie = {{no}}
| Touch = {{?}}
| PVR = {{yes}}
}}

== Settings ==
{{main|Add-on:Confluence/Settings}}
Confluence specific settings are accessible from the main menu by going to {{highlight|bordered=yes|[[Settings/Appearance#Skin|Settings -> Appearance -> Skin -> Settings]]}}.

== Media flags ==
{{see also|Media flags#Media source}}
Media can be flagged with following media source flags for [[Confluence]] (Kodi's default skin):
<section begin="flags" />
* '''DVD''', if the filename contains DVD.
* '''Bluray''', if the filename contains BLURAY, BRRIP, BD25, or BD50.
* '''HDDVD''', if the filename contains HDDVD.
* '''TV''', if the filename contains HDTV, PDTV, or DSR.
* '''VHS''', if the filename contains VHS.
<br />
{{see also|3D#Video_filenames_flags}}
<section end="flags" />


== Mods ==
: ''See http://forum.kodi.tv/forumdisplay.php?fid=125 for even more Confluence mods.''
*[[HOW-TO:Add Time Remaining to Confluence]]
*[[HOW-TO:Add volume value in Confluence]]
*[[HOW-TO:Change time and date in Confluence]]
*[[HOW-TO:Change the episode thumbnail in Confluence]]
*[[HOW-TO:Remove media flags in Confluence]]
*[[HOW-TO:Remove ratings in Confluence]]
*[[HOW-TO:Remove the logo in Confluence]]
*[[HOW-TO:Simplify the seekbar in Confluence]]

== Video demos ==
{{youtube|NcogPuSo-DU}}

== Notes ==

{{Compat
| Works with Atlantis = {{no}}
| Works with Babylon = {{no}}
| Works with Camelot = {{yes}}
| Works with Dharma = {{yes}}
| Works with Eden = {{yes}}
| Works with Frodo = {{yes}}
| Works with Gotham = {{yes}}
| Works with Helix = {{yes}}
| Works with Isengard = {{yes}}
| Works with Jarvis = {{yes}}
| Works with Krypton = {{yes}}
}}

<references/>

[[Category:Add-ons with license tag]]
[[Category:Add-ons with source tag]]
[[Category:All add-ons]]
[[Category:Built-in add-ons]]
[[Category:Skins]]
[[Category:Krypton add-on repository]]

Add-on:Estuary/Settings

2017-04-19T18:53:44Z

Tinwarble: /* Accessing The System Settings Menu */

Add-on:Estuary/Settings

2017-04-19T18:50:24Z

Tinwarble:

Skin settings for the default Kodi skin (for v17 (Krypton and above), Estuary.

==Accessing The System Settings Menu==
<gallery widths=400px heights=222px>
File:Estuary home settings icon.png|To access the System Settings menu where you can access individual settings, select the System icon (gear) at the top of the Menu on the Home screen.
</gallery>

==Accessing Skin Settings==

The System Settings menu is where you can access and change specific Kodi settings, access System information and Kodi's built in File Manager. To access Estuary's settings, select '''System → Skin Settings'''.

==General Skin Settings==
[[File:Estuary_skin_settings_general.png|400px|right]]
===Use slide animations===
:Changes the animation used when navigating screens. If enable, the items on the screen will slide in & out. If disable, item on screen will fade in & out.

===Enable auto scrolling for plot & review===
:When enabled, plots & reviews that do not fit within the defined area will auto scroll on the screen so that the entire plot/review can be read. When disabled, only the first part of the plot or review that fits within the defined area will be shown.

===Touch mode===
:For touch screens. If enabled, this will allow for better control using touch screen devices and will also add additional control buttons. If not using a touch screen this should remain disabled (default).

===Show weather info in top bar===
:When enabled, this will show the weather information on the top on every menu screen. This requires a Weather Service Information provider add-on to be installed.

===Show media flags===
:When enabled, will show media flags where applicable.

==Main Menu Items Settings==
[[File:Estuary_skin_settings_items.png|400px|right]]
[[File:Estuary_install_library_node_editor.png|400px|right]]

This menu item allows for enabling or disabling menu items that are shown on the Home screen. The items on this screen which can be enabled or disabled are:

'''Movies ♦ TV shows ♦ Music ♦ Music videos ♦ TV ♦ Radio ♦ Add-ons ♦ Pictures ♦ Videos ♦ Favorites ♦ Weather'''

You can also use '''Edit categories''' for '''Movies''', '''TV shows''' & '''Music'''. This will allow you to edit categories for each of these items such as '''Genre''', '''Title''', '''Year''', '''etc.''', add new '''Rules''', add new '''Nodes''' or add new '''Parent nodes'''.

When you select '''Edit categories''' you will be asked to install the '''Library node editor'''. This is required if you wish to preform any of the actions above.

<big>See: '''[[Add-on:Library Node Editor|Library Node Editor]]'''</big>

==Artwork Settings==
[[File:Estuary_skin_settings_artwork.png|400px|right]]

===Show Media Fanart As Background===
:When enabled, the select medias fanart will be displayed in the background of all menu screens. When disabled, only the default background will be displayed.

===Choose Background Pattern===
:Allows for cycling though different default backgrounds.

===Choose Skin Fanart Pack===
:Allows you to use or download a new set of background fanart packs. When installed and used, the art from the select pack will be used as the default background for menu items on the Home screen. This does not override '''Show media fanart as background''' and the media fanart will still display when hovered over.

===Choose Weather Fanart Pack===
:Allows you to use or download a new set of fanart packs to be used with weather.

===Select Genre Fanart Pack===
:Allows you to use or download a new set of fanart packs to be used with Genres.

{{note|In order to use or download '''Fanart Packs''' you must install the '''Image Resource Select Add-on'''. If you choose any of the '''Pack''' options above you will be asked if you want to download and install it at that time.}}

<big>See: '''[[Add-on:Image_Resource_Select_Addon|Image Resource Select Add-on]]'''</big>

[[Category:Skins]]
[[Category:Settings]]

Add-on:Estuary/Settings

2017-04-19T18:49:24Z

Tinwarble:

Skin settings for the default Kodi skin (for v17 (Krypton and above), Estuary.

==Accessing The System Settings Menu==
<gallery widths=400px heights=222px>
File:Estuary home settings icon.png|To access the System Settings menu where you can access individual settings, select the System icon (gear) at the top of the Menu on the Home screen.
</gallery>

==Accessing Skin Settings==

The System Settings menu is where you can access and change specific Kodi settings, access System information and Kodi's built in File Manager. To access Estuary's settings, select '''System → Skin Settings'''.

==General Skin Settings==
[[File:Estuary_skin_settings_general.png|400px|right]]
===Use slide animations===
:Changes the animation used when navigating screens. If enable, the items on the screen will slide in & out. If disable, item on screen will fade in & out.

===Enable auto scrolling for plot & review===
:When enabled, plots & reviews that do not fit within the defined area will auto scroll on the screen so that the entire plot/review can be read. When disabled, only the first part of the plot or review that fits within the defined area will be shown.

===Touch mode===
:For touch screens. If enabled, this will allow for better control using touch screen devices and will also add additional control buttons. If not using a touch screen this should remain disabled (default).

===Show weather info in top bar===
:When enabled, this will show the weather information on the top on every menu screen. This requires a Weather Service Information provider add-on to be installed.

===Show media flags===
:When enabled, will show media flags where applicable.

==Main Menu Items Settings==
[[File:Estuary_skin_settings_items.png|400px|right]]
[[File:Estuary_install_library_node_editor.png|400px|right]]

This menu item allows for enabling or disabling menu items that are shown on the Home screen. The items on this screen which can be enabled or disabled are:

'''Movies ♦ TV shows ♦ Music ♦ Music videos ♦ TV ♦ Radio ♦ Add-ons ♦ Pictures ♦ Videos ♦ Favorites ♦ Weather'''

You can also use '''Edit categories''' for '''Movies''', '''TV shows''' & '''Music'''. This will allow you to edit categories for each of these items such as '''Genre''', '''Title''', '''Year''', '''etc.''', add new '''Rules''', add new '''Nodes''' or add new '''Parent nodes'''.

When you select '''Edit categories''' you will be asked to install the '''Library node editor'''. This is required if you wish to preform any of the actions above.

<big>See: '''[[Add-on:Library Node Editor|Library Node Editor]]'''</big>

==Artwork Settings==
[[File:Estuary_skin_settings_artwork.png|400px|right]]

===Show Media Fanart As Background===
:When enabled, the select medias fanart will be displayed in the background of all menu screens. When disabled, only the default background will be displayed.

===Choose Background Pattern===
:Allows for cycling though different default backgrounds.

===Choose Skin Fanart Pack===
:Allows you to use or download a new set of background fanart packs. When installed and used, the art from the select pack will be used as the default background for menu items on the Home screen. This does not override '''Show media fanart as background''' and the media fanart will still display when hovered over.

===Choose Weather Fanart Pack===
:Allows you to use or download a new set of fanart packs to be used with weather.

===Select Genre Fanart Pack===
:Allows you to use or download a new set of fanart packs to be used with Genres.

{{note|In order to use or download '''Fanart Packs''' you must install the '''Image Resource Select Add-on'''. If you choose any of the '''Pack''' options above you will be asked if you want to download and install it at that time.}}

<big>See: '''[[Add-on:Image_Resource_Select_Addon|Image Resource Select Add-on]]'''</big>

[[Category:Settings]]

Add-on:Estuary/Settings

2017-04-19T18:21:47Z

Tinwarble: /* Accessing Skin Settings */

Skin settings for the default Kodi skin (for v17 (Krypton and above), Estuary.

==Accessing The System Settings Menu==
<gallery widths=400px heights=222px>
File:Estuary home settings icon.png|To access the System Settings menu where you can access individual settings, select the System icon (gear) at the top of the Menu on the Home screen.
</gallery>

==Accessing Skin Settings==

The System Settings menu is where you can access and change specific Kodi settings, access System information and Kodi's built in File Manager. To access Estuary's settings, select '''System → Skin Settings'''.

==General Skin Settings==
[[File:Estuary_skin_settings_general.png|400px|right]]
===Use slide animations===
:Changes the animation used when navigating screens. If enable, the items on the screen will slide in & out. If disable, item on screen will fade in & out.

===Enable auto scrolling for plot & review===
:When enabled, plots & reviews that do not fit within the defined area will auto scroll on the screen so that the entire plot/review can be read. When disabled, only the first part of the plot or review that fits within the defined area will be shown.

===Touch mode===
:For touch screens. If enabled, this will allow for better control using touch screen devices and will also add additional control buttons. If not using a touch screen this should remain disabled (default).

===Show weather info in top bar===
:When enabled, this will show the weather information on the top on every menu screen. This requires a Weather Service Information provider add-on to be installed.

===Show media flags===
:When enabled, will show media flags where applicable.

==Main Menu Items Settings==
[[File:Estuary_skin_settings_items.png|400px|right]]
[[File:Estuary_install_library_node_editor.png|400px|right]]

This menu item allows for enabling or disabling menu items that are shown on the Home screen. The items on this screen which can be enabled or disabled are:

'''Movies ♦ TV shows ♦ Music ♦ Music videos ♦ TV ♦ Radio ♦ Add-ons ♦ Pictures ♦ Videos ♦ Favorites ♦ Weather'''

You can also use '''Edit categories''' for '''Movies''', '''TV shows''' & '''Music'''. This will allow you to edit categories for each of these items such as '''Genre''', '''Title''', '''Year''', '''etc.''', add new '''Rules''', add new '''Nodes''' or add new '''Parent nodes'''.

When you select '''Edit categories''' you will be asked to install the '''Library node editor'''. This is required if you wish to preform any of the actions above.

<big>See: '''[[Add-on:Library Node Editor|Library Node Editor]]'''</big>

==Artwork Settings==
[[File:Estuary_skin_settings_artwork.png|400px|right]]

===Show Media Fanart As Background===
:When enabled, the select medias fanart will be displayed in the background of all menu screens. When disabled, only the default background will be displayed.

===Choose Background Pattern===
:Allows for cycling though different default backgrounds.

===Choose Skin Fanart Pack===
:Allows you to use or download a new set of background fanart packs. When installed and used, the art from the select pack will be used as the default background for menu items on the Home screen. This does not override '''Show media fanart as background''' and the media fanart will still display when hovered over.

===Choose Weather Fanart Pack===
:Allows you to use or download a new set of fanart packs to be used with weather.

===Select Genre Fanart Pack===
:Allows you to use or download a new set of fanart packs to be used with Genres.

{{note|In order to use or download '''Fanart Packs''' you must install the '''Image Resource Select Add-on'''. If you choose any of the '''Pack''' options above you will be asked if you want to download and install it at that time.}}

<big>See: '''[[Add-on:Image_Resource_Select_Addon|Image Resource Select Add-on]]'''</big>

Add-on:Estuary/Settings

2017-04-19T18:21:17Z

Tinwarble: /* Accessing The System Menu */

Skin settings for the default Kodi skin (for v17 (Krypton and above), Estuary.

==Accessing The System Settings Menu==
<gallery widths=400px heights=222px>
File:Estuary home settings icon.png|To access the System Settings menu where you can access individual settings, select the System icon (gear) at the top of the Menu on the Home screen.
</gallery>

==Accessing Skin Settings==

The System menu is where you can access and change specific Kodi settings, access System information and Kodi's built in File Manager. To access Estuary's settings, select '''System → Skin Settings'''.

==General Skin Settings==
[[File:Estuary_skin_settings_general.png|400px|right]]
===Use slide animations===
:Changes the animation used when navigating screens. If enable, the items on the screen will slide in & out. If disable, item on screen will fade in & out.

===Enable auto scrolling for plot & review===
:When enabled, plots & reviews that do not fit within the defined area will auto scroll on the screen so that the entire plot/review can be read. When disabled, only the first part of the plot or review that fits within the defined area will be shown.

===Touch mode===
:For touch screens. If enabled, this will allow for better control using touch screen devices and will also add additional control buttons. If not using a touch screen this should remain disabled (default).

===Show weather info in top bar===
:When enabled, this will show the weather information on the top on every menu screen. This requires a Weather Service Information provider add-on to be installed.

===Show media flags===
:When enabled, will show media flags where applicable.

==Main Menu Items Settings==
[[File:Estuary_skin_settings_items.png|400px|right]]
[[File:Estuary_install_library_node_editor.png|400px|right]]

This menu item allows for enabling or disabling menu items that are shown on the Home screen. The items on this screen which can be enabled or disabled are:

'''Movies ♦ TV shows ♦ Music ♦ Music videos ♦ TV ♦ Radio ♦ Add-ons ♦ Pictures ♦ Videos ♦ Favorites ♦ Weather'''

You can also use '''Edit categories''' for '''Movies''', '''TV shows''' & '''Music'''. This will allow you to edit categories for each of these items such as '''Genre''', '''Title''', '''Year''', '''etc.''', add new '''Rules''', add new '''Nodes''' or add new '''Parent nodes'''.

When you select '''Edit categories''' you will be asked to install the '''Library node editor'''. This is required if you wish to preform any of the actions above.

<big>See: '''[[Add-on:Library Node Editor|Library Node Editor]]'''</big>

==Artwork Settings==
[[File:Estuary_skin_settings_artwork.png|400px|right]]

===Show Media Fanart As Background===
:When enabled, the select medias fanart will be displayed in the background of all menu screens. When disabled, only the default background will be displayed.

===Choose Background Pattern===
:Allows for cycling though different default backgrounds.

===Choose Skin Fanart Pack===
:Allows you to use or download a new set of background fanart packs. When installed and used, the art from the select pack will be used as the default background for menu items on the Home screen. This does not override '''Show media fanart as background''' and the media fanart will still display when hovered over.

===Choose Weather Fanart Pack===
:Allows you to use or download a new set of fanart packs to be used with weather.

===Select Genre Fanart Pack===
:Allows you to use or download a new set of fanart packs to be used with Genres.

{{note|In order to use or download '''Fanart Packs''' you must install the '''Image Resource Select Add-on'''. If you choose any of the '''Pack''' options above you will be asked if you want to download and install it at that time.}}

<big>See: '''[[Add-on:Image_Resource_Select_Addon|Image Resource Select Add-on]]'''</big>

Skin settings

2017-04-19T18:12:52Z

Tinwarble: Redirected page to Add-on:Estuary/Settings

#REDIRECT [[Add-on:Estuary/Settings]]

Add-on:Estuary

2017-04-19T18:05:40Z

Tinwarble: /* Settings */

bots}}
{{Add-on
| Name = Estuary
| provider-name = phil65
| ID = skin.estuary
| latest-version = 1.9.12
| extension point = Kodi.gui.skin
| type = skin
| Platform = all
|Language=
|License=GNU General Public License version 2
|Forum=http://forum.kodi.tv/forumdisplay.php?fid=260
|Website=
|Source=https://github.com/phil65/skin.estuary
|Email=
|broken=
| Summary = Estuary skin by phil65. (Kodi's >v17 default skin)
| Description =
{{forum link2|See the [[forumtopic:260|Estuary sub-forum]] for more information.}}Estuary is the default skin for Kodi 17 and above.}}
__TOC__
== Skin features compatibility ==
{{See also|Skin features compatibility list}}
{{Skin features
| skin = [[Add-on:Estuary|Estuary]]
| custom home items = {{partial}}
| custom submenu items = {{partial}}
| Media flags = {{yes}}
| TV show logo = {{no}}
| TV logo downloader = {{no}}
| Artwork downloader = {{no}}
| Clear Art = {{no}}
| cdArt = {{no}}
| Extra fanart = {{no}}
| Season fanart = {{yes}}
| Weather fanart = {{yes}}
| Live TV = {{yes}}
| Next Aired = {{yes}}
| TvTunes = {{yes}}
| Skin Widgets = {{yes}}
| Advanced Launcher = {{no}}
| Watchlist = {{no}}
| MovieSets = {{yes}}
| Metadata Actors = {{no}}
| Cinema Experience = {{no}}
| Intro movie = {{no}}
| Touch = {{?}}
| PVR = {{yes}}
}}
{{Compat
| Works with Atlantis = {{no}}
| Works with Babylon = {{no}}
| Works with Camelot = {{no}}
| Works with Dharma = {{no}}
| Works with Eden = {{no}}
| Works with Frodo = {{no}}
| Works with Gotham = {{no}}
| Works with Helix = {{no}}
| Works with Isengard = {{no}}
| Works with Jarvis = {{no}}
| Works with Krypton = {{yes}}
}}
== Settings ==
:See: '''[[Add-on:Estuary/Settings|Estuary Skin Settings]]'''

== Media flags ==
{{see also|Media flags#Media source}}

== Screenshots ==

<gallery widths=250px heights=150px perrow=3 caption= "Estuary Screenshots">
File:Estuary-home.jpg
File:Estuary-movies-list.jpg
File:Estuary-tvshow-banner.jpg
File:Estuary-music-artists.jpg
File:Estuary-livetv.jpg
File:Estuary-Addons.jpg
File:Estuary-weather.jpg
</gallery>

[[Category:Add-ons with license tag]]
[[Category:Add-ons with source tag]]
[[Category:All add-ons]]
[[Category:Skins]]

Add-on:Estuary

2017-04-19T18:05:08Z

Tinwarble: /* Settings */

bots}}
{{Add-on
| Name = Estuary
| provider-name = phil65
| ID = skin.estuary
| latest-version = 1.9.12
| extension point = Kodi.gui.skin
| type = skin
| Platform = all
|Language=
|License=GNU General Public License version 2
|Forum=http://forum.kodi.tv/forumdisplay.php?fid=260
|Website=
|Source=https://github.com/phil65/skin.estuary
|Email=
|broken=
| Summary = Estuary skin by phil65. (Kodi's >v17 default skin)
| Description =
{{forum link2|See the [[forumtopic:260|Estuary sub-forum]] for more information.}}Estuary is the default skin for Kodi 17 and above.}}
__TOC__
== Skin features compatibility ==
{{See also|Skin features compatibility list}}
{{Skin features
| skin = [[Add-on:Estuary|Estuary]]
| custom home items = {{partial}}
| custom submenu items = {{partial}}
| Media flags = {{yes}}
| TV show logo = {{no}}
| TV logo downloader = {{no}}
| Artwork downloader = {{no}}
| Clear Art = {{no}}
| cdArt = {{no}}
| Extra fanart = {{no}}
| Season fanart = {{yes}}
| Weather fanart = {{yes}}
| Live TV = {{yes}}
| Next Aired = {{yes}}
| TvTunes = {{yes}}
| Skin Widgets = {{yes}}
| Advanced Launcher = {{no}}
| Watchlist = {{no}}
| MovieSets = {{yes}}
| Metadata Actors = {{no}}
| Cinema Experience = {{no}}
| Intro movie = {{no}}
| Touch = {{?}}
| PVR = {{yes}}
}}
{{Compat
| Works with Atlantis = {{no}}
| Works with Babylon = {{no}}
| Works with Camelot = {{no}}
| Works with Dharma = {{no}}
| Works with Eden = {{no}}
| Works with Frodo = {{no}}
| Works with Gotham = {{no}}
| Works with Helix = {{no}}
| Works with Isengard = {{no}}
| Works with Jarvis = {{no}}
| Works with Krypton = {{yes}}
}}
== Settings ==
See: [[Add-on:Estuary/Settings|Estuary Skin Settings]]

== Media flags ==
{{see also|Media flags#Media source}}

== Screenshots ==

<gallery widths=250px heights=150px perrow=3 caption= "Estuary Screenshots">
File:Estuary-home.jpg
File:Estuary-movies-list.jpg
File:Estuary-tvshow-banner.jpg
File:Estuary-music-artists.jpg
File:Estuary-livetv.jpg
File:Estuary-Addons.jpg
File:Estuary-weather.jpg
</gallery>

[[Category:Add-ons with license tag]]
[[Category:Add-ons with source tag]]
[[Category:All add-ons]]
[[Category:Skins]]

Add-on:Estuary/Settings

2017-04-19T18:02:45Z

Tinwarble: Created page with "Skin settings for the default Kodi skin (for v17 (Krypton and above), Estuary. ==Accessing The System Menu== <gallery widths=400px heights=222px> File:Estuary home settings ..."

Skin settings for the default Kodi skin (for v17 (Krypton and above), Estuary.

==Accessing The System Menu==
<gallery widths=400px heights=222px>
File:Estuary home settings icon.png|To access the System menu where you can access individual settings, select the System icon (gear) at the top of the Menu on the Home screen.
</gallery>

==Accessing Skin Settings==

The System menu is where you can access and change specific Kodi settings, access System information and Kodi's built in File Manager. To access Estuary's settings, select '''System → Skin Settings'''.

==General Skin Settings==
[[File:Estuary_skin_settings_general.png|400px|right]]
===Use slide animations===
:Changes the animation used when navigating screens. If enable, the items on the screen will slide in & out. If disable, item on screen will fade in & out.

===Enable auto scrolling for plot & review===
:When enabled, plots & reviews that do not fit within the defined area will auto scroll on the screen so that the entire plot/review can be read. When disabled, only the first part of the plot or review that fits within the defined area will be shown.

===Touch mode===
:For touch screens. If enabled, this will allow for better control using touch screen devices and will also add additional control buttons. If not using a touch screen this should remain disabled (default).

===Show weather info in top bar===
:When enabled, this will show the weather information on the top on every menu screen. This requires a Weather Service Information provider add-on to be installed.

===Show media flags===
:When enabled, will show media flags where applicable.

==Main Menu Items Settings==
[[File:Estuary_skin_settings_items.png|400px|right]]
[[File:Estuary_install_library_node_editor.png|400px|right]]

This menu item allows for enabling or disabling menu items that are shown on the Home screen. The items on this screen which can be enabled or disabled are:

'''Movies ♦ TV shows ♦ Music ♦ Music videos ♦ TV ♦ Radio ♦ Add-ons ♦ Pictures ♦ Videos ♦ Favorites ♦ Weather'''

You can also use '''Edit categories''' for '''Movies''', '''TV shows''' & '''Music'''. This will allow you to edit categories for each of these items such as '''Genre''', '''Title''', '''Year''', '''etc.''', add new '''Rules''', add new '''Nodes''' or add new '''Parent nodes'''.

When you select '''Edit categories''' you will be asked to install the '''Library node editor'''. This is required if you wish to preform any of the actions above.

<big>See: '''[[Add-on:Library Node Editor|Library Node Editor]]'''</big>

==Artwork Settings==
[[File:Estuary_skin_settings_artwork.png|400px|right]]

===Show Media Fanart As Background===
:When enabled, the select medias fanart will be displayed in the background of all menu screens. When disabled, only the default background will be displayed.

===Choose Background Pattern===
:Allows for cycling though different default backgrounds.

===Choose Skin Fanart Pack===
:Allows you to use or download a new set of background fanart packs. When installed and used, the art from the select pack will be used as the default background for menu items on the Home screen. This does not override '''Show media fanart as background''' and the media fanart will still display when hovered over.

===Choose Weather Fanart Pack===
:Allows you to use or download a new set of fanart packs to be used with weather.

===Select Genre Fanart Pack===
:Allows you to use or download a new set of fanart packs to be used with Genres.

{{note|In order to use or download '''Fanart Packs''' you must install the '''Image Resource Select Add-on'''. If you choose any of the '''Pack''' options above you will be asked if you want to download and install it at that time.}}

<big>See: '''[[Add-on:Image_Resource_Select_Addon|Image Resource Select Add-on]]'''</big>

File:Estuary install library node editor.png

2017-04-19T17:20:35Z

Tinwarble:

File:Estuary skin settings general.png

2017-04-19T16:16:55Z

Tinwarble: Tinwarble uploaded a new version of "File:Estuary skin settings general.png"

File:Estuary skin settings general.png

2017-04-19T16:15:12Z

Tinwarble:

Add-on:Estuary

2017-04-19T13:25:42Z

Tinwarble:

bots}}
{{Add-on
| Name = Estuary
| provider-name = phil65
| ID = skin.estuary
| latest-version = 1.9.12
| extension point = Kodi.gui.skin
| type = skin
| Platform = all
|Language=
|License=GNU General Public License version 2
|Forum=http://forum.kodi.tv/forumdisplay.php?fid=260
|Website=
|Source=https://github.com/phil65/skin.estuary
|Email=
|broken=
| Summary = Estuary skin by phil65. (Kodi's >v17 default skin)
| Description =
{{forum link2|See the [[forumtopic:260|Estuary sub-forum]] for more information.}}Estuary is the default skin for Kodi 17 and above.}}
__TOC__
== Skin features compatibility ==
{{See also|Skin features compatibility list}}
{{Skin features
| skin = [[Add-on:Estuary|Estuary]]
| custom home items = {{partial}}
| custom submenu items = {{partial}}
| Media flags = {{yes}}
| TV show logo = {{no}}
| TV logo downloader = {{no}}
| Artwork downloader = {{no}}
| Clear Art = {{no}}
| cdArt = {{no}}
| Extra fanart = {{no}}
| Season fanart = {{yes}}
| Weather fanart = {{yes}}
| Live TV = {{yes}}
| Next Aired = {{yes}}
| TvTunes = {{yes}}
| Skin Widgets = {{yes}}
| Advanced Launcher = {{no}}
| Watchlist = {{no}}
| MovieSets = {{yes}}
| Metadata Actors = {{no}}
| Cinema Experience = {{no}}
| Intro movie = {{no}}
| Touch = {{?}}
| PVR = {{yes}}
}}
{{Compat
| Works with Atlantis = {{no}}
| Works with Babylon = {{no}}
| Works with Camelot = {{no}}
| Works with Dharma = {{no}}
| Works with Eden = {{no}}
| Works with Frodo = {{no}}
| Works with Gotham = {{no}}
| Works with Helix = {{no}}
| Works with Isengard = {{no}}
| Works with Jarvis = {{no}}
| Works with Krypton = {{yes}}
}}
== Settings ==
{{See also|Settings}}

== Media flags ==
{{see also|Media flags#Media source}}

== Screenshots ==

<gallery widths=250px heights=150px perrow=3 caption= "Estuary Screenshots">
File:Estuary-home.jpg
File:Estuary-movies-list.jpg
File:Estuary-tvshow-banner.jpg
File:Estuary-music-artists.jpg
File:Estuary-livetv.jpg
File:Estuary-Addons.jpg
File:Estuary-weather.jpg
</gallery>

[[Category:Add-ons with license tag]]
[[Category:Add-ons with source tag]]
[[Category:All add-ons]]
[[Category:Skins]]

HOW-TO:Change skins

2017-04-19T06:19:51Z

Tinwarble: /* Installing a new skin */

{{mininav|[[Extras]]|[[Add-ons]]|[[Skins]]|page={{FULLPAGENAME}} }}
<section begin="intro"/>Many of us have been tempted by the allure of Kodi's beauty. There are some excellent skin designers out there who have gone to great lengths to create and share beautiful ways of viewing and navigating our media collections. As default, Kodi comes with the excellent skin Estuary, but there are plenty more to choose from.<section end="intro"/>

== Installing a new skin==
<gallery widths=500px heights=313px>
File:Estuary_home_blank.png|'''Step 1:''' Start from the Home screen
File:Estuary_home_settings_icon.png|'''Step 2:''' Navigate to the top of the menu and select '''System''' (the gear) icon.
File:Interface_settings.png|'''Step 3:''' Select '''Interface settings'''.
File:Interface_settings_skin.png|'''Step 4:''' In the Interface setttings, select '''Skin''', then '''Skin''' under '''Look and feel'''.
File:Skin_get_more.png|'''Step 5:''' By default, there are only 2 skins installed, '''Estuary'''(the default skin) and '''Estouchy'''. To install another skin, select '''Get more...'''
File:Skin_get_more_browse.png|'''Step 6:''' In the new window, select the skin you want to install from the list.
File:Skin_get_more_downloading.png|'''Step 7:''' After you have select the skin it will begin downloading.
File:Skin_get_more_installing.png|'''Step 8:''' Once downloaded, the skin and any dependencies it requires will install.
File:Skin_get_more_switch_skin.png|'''Step 9:''' Once installed, Kodi will ask you if you want to start using that skin. If you do the select '''Yes'''
File:Skin_get_more_new_skin.png|'''Step 10:''' Enjoy your new skin!!!
</gallery>

== Installing a skin from a zip file. ==
Although there are many skins already available to you from Kodi Add-on repository, there are even more that you may want to try out, including modified skins of the ones available. Some of those skins can be found in the [http://forum.kodi.tv/forumdisplay.php?fid=67 Skin Support] section of the Kodi forum as well as Work in Progress skins which can be found in the [http://forum.kodi.tv/forumdisplay.php?fid=67 Skinning/WIP Skins] sub-section of the Kodi forum.

To install these skins you will need to install them from a zip file. See [[Add-on_manager#How_to_install_from_a_ZIP_file|How to install from a ZIP file]] for how to install.

:''Note: Estuary was designed to be fully featured. Sometimes as a new user, it can be daunting enough to get used to the program for starters without changing things. It is highly recommended that you stick to Estuary until you’re sure of how things work. Should you ever encounter issues with another skin, such as the feeling that something is missing, consider reverting to Estuary to see if it was simply an issue with that skin.'

{{helix updated}}

[[Category:How-to]]
[[Category:Skins|*]]
[[Category:Manual]]
[[Category:Add-ons]]

HOW-TO:Change skins

2017-04-19T06:19:07Z

Tinwarble: /* Installing a new skin */

{{mininav|[[Extras]]|[[Add-ons]]|[[Skins]]|page={{FULLPAGENAME}} }}
<section begin="intro"/>Many of us have been tempted by the allure of Kodi's beauty. There are some excellent skin designers out there who have gone to great lengths to create and share beautiful ways of viewing and navigating our media collections. As default, Kodi comes with the excellent skin Estuary, but there are plenty more to choose from.<section end="intro"/>

== Installing a new skin==
<gallery widths=500px heights=313px>
File:Estuary_home_blank.png|'''Step 1:''' Start from the Home screen
File:Estuary_home_settings_icon.png|'''Step 2:''' Navigate to the top of the menu and select '''System''' (the gear icon).
File:Interface_settings.png|'''Step 3:''' Select '''Interface settings'''.
File:Interface_settings_skin.png|'''Step 4:''' In the Interface setttings, select '''Skin''', then '''Skin''' under '''Look and feel'''.
File:Skin_get_more.png|'''Step 5:''' By default, there are only 2 skins installed, '''Estuary'''(the default skin) and '''Estouchy'''. To install another skin, select '''Get more...'''
File:Skin_get_more_browse.png|'''Step 6:''' In the new window, select the skin you want to install from the list.
File:Skin_get_more_downloading.png|'''Step 7:''' After you have select the skin it will begin downloading.
File:Skin_get_more_installing.png|'''Step 8:''' Once downloaded, the skin and any dependencies it requires will install.
File:Skin_get_more_switch_skin.png|'''Step 9:''' Once installed, Kodi will ask you if you want to start using that skin. If you do the select '''Yes'''
File:Skin_get_more_new_skin.png|'''Step 10:''' Enjoy your new skin!!!
</gallery>

== Installing a skin from a zip file. ==
Although there are many skins already available to you from Kodi Add-on repository, there are even more that you may want to try out, including modified skins of the ones available. Some of those skins can be found in the [http://forum.kodi.tv/forumdisplay.php?fid=67 Skin Support] section of the Kodi forum as well as Work in Progress skins which can be found in the [http://forum.kodi.tv/forumdisplay.php?fid=67 Skinning/WIP Skins] sub-section of the Kodi forum.

To install these skins you will need to install them from a zip file. See [[Add-on_manager#How_to_install_from_a_ZIP_file|How to install from a ZIP file]] for how to install.

:''Note: Estuary was designed to be fully featured. Sometimes as a new user, it can be daunting enough to get used to the program for starters without changing things. It is highly recommended that you stick to Estuary until you’re sure of how things work. Should you ever encounter issues with another skin, such as the feeling that something is missing, consider reverting to Estuary to see if it was simply an issue with that skin.'

{{helix updated}}

[[Category:How-to]]
[[Category:Skins|*]]
[[Category:Manual]]
[[Category:Add-ons]]

Add-on:Confluence/Settings

2017-04-19T05:57:52Z

Tinwarble:

{{mininav|[[General topics]]|[[Settings]] {{l2|[[Skins]] }} |[[Settings/Appearance|Appearance]] {{l2|[[Add-on:Confluence|Confluence]]}} }}
Skin settings for the default Kodi skin (for v16 (Jarvis) and below), Confluence. The following settings are accessible from the main menu by going to {{highlight|bordered=yes|[[Settings/Appearance#Skin|Settings -> Appearance -> Skin]]}}.

== General settings ==
[[File:Conf Skin General 1.png|500px|right]]
=== Miscellaneous options ===
;Enable auto scrolling for plot & review
:Enables automatic page scrolling in information dialogs.
;Show "Paused" in picture slide show
:Selects whether or not to show the word "Paused" in the corner when you've paused a picture slide show.
;Play trailers in a window
:If movie trailers are available/enabled, this option will play them in a window rather than full screen. This applies only to the [[Video library#Media information screen|Media information screen]].
;Hide flagging read from video filenames
:[[Media flags#Media source|Media flags]] for videos based on additions to the filename. See '''[[Add-on:Confluence#Media flags]]''' for more info.
;Hide Background Fanart
:Disables [[fanart]] being displayed in the background for TV shows and movies.

=== TV shows ===
;Play TV theme songs in video library ([[Add-on:TvTunes|TvTunes add-on]])
:This option will only show up if the TvTunes add-on has been installed. It enables the playing of theme songs when you enter a TV show's listings from the library.

=== Startup window ===
;Enable Playlist at Startup
:Runs any supported playlist at startup.
;Path
:Path to playlist
{{-}}

== Home window options ==
[[File:Conf Skin Home window 1.png|500px|right]]
[[File:Conf Skin Home window 2.png|325px|right|thumb|options continued]]
=== Home screen options ===
;Show Video Info
:Shows info on video playing when on the Home Window.
;Show Music info
:Shows info on music playing when on the Home Window.
;Show Weather info
:Shows info on Weather when on the Weather button of the Home Window.
;Show Recently added Videos
:Shows your most recently added videos that have been scanned into the library.
;Show Recently added Albums
:Shows your most recently added albums that have been scanned into the library.

=== Hide Main Menu Buttons ===
;Various options
:Hides or shows the selected button/tab from the home window.

{{note|"Movies" and "TV shows" are only available options when you have [[adding videos to the library|scanned videos into the library]].}}
{{-}}

== Background options ==
[[File:Conf Skin Background.png|500px|right]]
=== Miscellaneous options ===
;Hide Background Fanart
:Hides [[fanart]] images in various library/file views.
;Hide Fanart in full screen visualization
:Hides music fanart in the [[music visualizer]].
;Show Background "Now Playing" Video
:Shows the currently playing video in the background when you exit out of full screen playback.
;Show Background "Now Playing" Visualization
:Shows the [[Music playback|music visualizer]] in the background when you exit out of full screen playback.
=== Background ===
;Enable Custom Background
:Selects a custom background image for '''all''' window views. Since v12, Confluence in Kodi now only supports one customized background.
;Path
:File path to background image.
{{-}}

== Add-on shortcuts ==
[[File:Conf Skin Add-on 1.png|500px|right]]
[[File:Conf Skin Add-on 2.png|325px|right|thumb|options continued]]
=== Music OSD ===
;Lyrics Add-on
:Selects the [[:Category:Lyrics add-ons|Lyrics look up add-on]] to be used when you press the Lyrics button in the [[Music playback|music OSD]].

=== Video OSD ===
;Subtitle Add-on
:Selects the [[:Category:Subtitle add-ons|Subtitle look up add-on]] to be used when you press the Subtitles button in the [[Video playback|video OSD]].

=== Home Page Video Submenu ===
;Add-on (1-5)
:Allows you to assign up to five add-ons to be displayed below the main menu when "Videos", "Movies", or "TV shows" is selected.

=== Home Page Music Submenu ===
;Add-on (1-5)
:Allows you to assign up to five add-ons to be displayed below the main menu when "Music" is selected.

=== Home Page Pictures Submenu ===
;Add-on (1-5)
:Allows you to assign up to five add-ons to be displayed below the main menu when "Pictures" is selected.

=== Home Page Programs Submenu ===
;Add-on (1-6)
:Allows you to assign up to six add-ons to be displayed below the main menu when "Programs" is selected.
{{-}}
{{Isengard updated}}

[[Category:Manual]]
[[Category:Settings]]

Estuary

2017-04-19T05:40:56Z

Tinwarble: Redirected page to Add-on:Estuary

#REDIRECT [[Add-on:Estuary]]

HOW-TO:Change skins

2017-04-19T05:21:02Z

Tinwarble: /* Installing a new skin */

{{mininav|[[Extras]]|[[Add-ons]]|[[Skins]]|page={{FULLPAGENAME}} }}
<section begin="intro"/>Many of us have been tempted by the allure of Kodi's beauty. There are some excellent skin designers out there who have gone to great lengths to create and share beautiful ways of viewing and navigating our media collections. As default, Kodi comes with the excellent skin Estuary, but there are plenty more to choose from.<section end="intro"/>

== Installing a new skin==
<gallery widths=500px heights=313px>
File:Estuary_home_blank.png|'''Step 1:''' Start from the Home screen
File:Estuary_home_settings_icon.png|'''Step 2:''' Navigate to the top of the menu and select '''Settings''' (the gear icon).
File:Interface_settings.png|'''Step 3:''' Select '''Interface settings'''.
File:Interface_settings_skin.png|'''Step 4:''' In the Interface setttings, select '''Skin''', then '''Skin''' under '''Look and feel'''.
File:Skin_get_more.png|'''Step 5:''' By default, there are only 2 skins installed, '''Estuary'''(the default skin) and '''Estouchy'''. To install another skin, select '''Get more...'''
File:Skin_get_more_browse.png|'''Step 6:''' In the new window, select the skin you want to install from the list.
File:Skin_get_more_downloading.png|'''Step 7:''' After you have select the skin it will begin downloading.
File:Skin_get_more_installing.png|'''Step 8:''' Once downloaded, the skin and any dependencies it requires will install.
File:Skin_get_more_switch_skin.png|'''Step 9:''' Once installed, Kodi will ask you if you want to start using that skin. If you do the select '''Yes'''
File:Skin_get_more_new_skin.png|'''Step 10:''' Enjoy your new skin!!!
</gallery>

== Installing a skin from a zip file. ==
Although there are many skins already available to you from Kodi Add-on repository, there are even more that you may want to try out, including modified skins of the ones available. Some of those skins can be found in the [http://forum.kodi.tv/forumdisplay.php?fid=67 Skin Support] section of the Kodi forum as well as Work in Progress skins which can be found in the [http://forum.kodi.tv/forumdisplay.php?fid=67 Skinning/WIP Skins] sub-section of the Kodi forum.

To install these skins you will need to install them from a zip file. See [[Add-on_manager#How_to_install_from_a_ZIP_file|How to install from a ZIP file]] for how to install.

:''Note: Estuary was designed to be fully featured. Sometimes as a new user, it can be daunting enough to get used to the program for starters without changing things. It is highly recommended that you stick to Estuary until you’re sure of how things work. Should you ever encounter issues with another skin, such as the feeling that something is missing, consider reverting to Estuary to see if it was simply an issue with that skin.'

{{helix updated}}

[[Category:How-to]]
[[Category:Skins|*]]
[[Category:Manual]]
[[Category:Add-ons]]

File:Estuary home settings icon.png

2017-04-19T05:20:31Z

Tinwarble: