System settings are found here. Set up and calibrate displays/video output, configure audio output, set up remote controls, set power saving options, enable debugging, set up master lock.
1 Video output
|Display Mode||Display Kodi in a window, or fullscreen on the selected screen.|
||Changes the resolution that the User Interface is displayed in.|
||...when active (Windows only). Does not use the DirectX fullscreen mode. The main benefit is for multi-screen configurations, where Kodi can be used at the same time as other applications without automatically minimizing. Uses a bit more resources and playback may be slightly less smooth.|
||In a multi-screen configuration, the screens where Kodi is not displayed are blacked out.|
|Stereoscopic mode (current)|
|Vertical blank sync||Compensation for vertical tearing.|
|Video calibration...||See #Video calibration...|
|Use limited color range (16-235)||Use limited color range instead of full color range (0-255). Limited range should be used if your display is a regular HDMI TV, while full color range should be used if your display is a PC monitor.|
1.1 Video calibration...
This screen allows you to calibrate the User Interface by adjusting the overscan. Use this tool if the image being displayed is too large or small for your display.
Simply adjust the screen so that the arrows are in the top left and bottom right corners and that the entire frame is visible on screen.
It offers the ability to adjust:
- The overscan of the video - How close to the edges of the screen that the image is displayed.
- The position where subtitles are displayed.
- The pixel ratio allows you calibrate the aspect ratio at which videos are played back.
2 Audio output
|Setting||Description||Setting level||Device type|
|Audio output device||Select the device to be used for audio output.||Standard||All|
|Number of channels||Select the number of channels supported by the audio connection.
|Output configuration||Fixed||Select how the properties of the audio output are set:
[Fixed] - output properties are set to the specified sampling rate & speaker configuration at all times
|Limit sampling rate (kHz)||Maximum sampling rate for spdif or sampling rate for fixed output configuration||Advanced||SPDIF|
|Stereo upmix||Select to enable upmixing of 2 channel audio to the number of audio channels specified by the channel configuration||Advanced||All|
|Normalize levels on downmix||Select how audio is downmixed, for example from 5.1 to 2.0:
[Enabled] maintains the dynamic range of the original audio source when downmixed however volume will be lower
|Resample quality||Low||Select the quality of resampling for cases where the audio output needs to be at a different sampling rate from that used by the source
[Low] is fast and will have minimal impact on system resources such as the use of the CPU
|Keep audio device alive||Select the behaviour when no sound is required for either playback or GUI sounds:
[Always] - continuous inaudible signal is output, this keeps the receiving audio device alive for any new sounds, however this might also block sound from other applications
|Play GUI sounds||Configure how interface sounds are handled, such as menu navigation and important notifications||Basic||All|
|Enable passthrough||Select to enable the passthrough audio options for playback of encoded audio such as Dolby Digital||Advanced||HDMI/SPDIF|
|Passthrough output device||Select the device to be used for playback of encoded formats, these are any of the formats below in the 'capable receiver' options||Advanced||HDMI/SPDIF|
|Dolby Digital (AC3) capable receiver||Select this option if your receiver is capable of decoding AC3 streams||Advanced||HDMI/SPDIF|
|- Enable Dolby Digital transcoding||Select this if the audio out connection only supports multichannel audio as Dolby Digital 5.1, such as an SPDIF connection. If your system supports LPCM multichannel sound via HDMI then leave this disabled. This option is only available where the number of channels is 2.0, for SPDIF this is set automatically so this option is always available, if using HDMI then you may need to change the Number of Channels setting to 2.0.||Advanced||HDMI/SPDIF|
|Dolby Digital Plus (E-AC3) capable receiver||Select this option if your receiver is capable of decoding E-AC3 streams||Advanced||HDMI|
|DTS capable receiver||Select this option if your receiver is capable of decoding DTS streams||Advanced||HDMI/SPDIF|
|TrueHD capable receiver||Select this option if your receiver is capable of decoding TrueHD streams||Advanced||HDMI|
|DTS-HD capable receiver||Select this option if your receiver is capable of decoding DTS-HD streams||Advanced||HDMI|
3 Input devices
|Apple remote (OS X only)|
|Allow start of Kodi using the remote (OS X only)|
|Sequence delay time|
|Remote control sends keyboard presses||When activated, your keyboard arrows will move the selection on the virtual keyboard. When deactivated, they will move the cursor from your text.|
|Enable mouse and touch screen support||
If deactivated, Kodi will ignore all mouse movements and clicks.
|Enable joystick and gamepad support|
|Enable system keys in fullscreen (Linux only)|
4 Internet access
|Use an HTTP proxy server to access the internet||If your internet connection uses a proxy, configure it here.|
||Proxy server address.|
||Defines the port of the proxy server|
||Defines the username used for the proxy server|
||Defines the password used for the proxy server|
|Internet connection bandwidth limitation||If you have limited bandwidth available, select a suitable value here and Kodi will try to keep to these limits. ?|
5 Power saving
|Put display to sleep when idle||Turns off display when idle. Useful for TVs that turn off when there is no display signal detected, but you don't want to suspend/shutdown the whole computer. Selectable from 5 minutes to 120 minutes.|
|Shutdown function timer||Sleeps the computer when idle. Selectable from 5 minutes to 120 minutes.|
|Shutdown function||Defines what "Shutdown" will do by default. Can be set to actually shutdown, suspend, minimize, or quit.|
|Try to wake remote servers on access|
|Enable debug logging||Toggles debug log on / off. Useful for troubleshooting.|
|Enable component-specific logging||Enables extra logging for specific areas of Kodi.|
Select which additional components to include in the debug log.
|Screenshot folder||Folder used to save screenshots taken within Kodi. (see Keyboard controls for the screenshot key for your OS)|
6.1 Component-specific logging
Component-specific logging options enables extra logging for specific areas of Kodi. This allows the debug logs to be easier to read as they can exclude information that is not important for a specific bug or issue, while still allowing that extra information to be turned on as-needed. Multiple components can be enabled if needed.
Setting Description SMB library CURL library CMYTH library FFMPEG libraries AUDIO component VIDEO component RTMP library JSON-RPC requests AirTunes library UPnP components CEC library
7 Master lock
|Master lock code and settings||Opens the Master lock settings window, where you can configure your Master Lock options. See #Master lock settings.|
||If enabled, the master lock code is required to unlock Kodi on startup|
7.1 Master lock settings
|Master Lock|| Allows you to set the master lock password. Can be one of three types:
|Lock music window|
|Lock video window|
|Lock pictures window|
|Lock programs and scripts windows|
|Lock file manager|
|Lock Add-on manager|
7.2 Locking media sources
If you want to make a source more private, you can use lockcodes or passwords to protect that source. The easiest way to accomplish this in Kodi, is using the GUI dialogs. First, enable the Master Lock in
7.3 Locked out?
Kodi will give you three tries when you need to enter a lock/password to access something that is locked. If you max out these three tries then just quit Kodi and re-open it to get three more tries. The Master Lock code is stored in the "profiles.xml" file in the userdata folder. Should you get locked out, you can delete or edit the "profiles.xml" file.
7.4 Advanced settings
The number of tries before being "locked out" can be tweaked by manually editing the guisettings.xml file in the userdata folder.
<maxretries>3</maxretries> <!-- enter the max number of retries to input code, 3 is default. This setting isn't exposed in the actual GUI and can only be changed by manually editing this XML file -->
<startuplock>false</startuplock> <!-- true prompts user for code upon startup -->