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 horizontal tearing.|
|Video calibration...||See #Video calibration...|
|Test patterns...||See #Test patterns...|
|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 (default 1042 for 1080p, 694 for 720p and 463 for 480p).
- The pixel ratio allows you calibrate the aspect ratio at which videos are played back.
1.2 Test patterns...
This is a variation of a pluge pattern, with both white and black. It is only accurate if you have "Use limited color range (16-235)" active.
Top left and bottom right quadrants: This is used to set the brightest part of the video. It consists of a black (0,0,0 - see note below) area with a white (235,235,235) block in the center and a blinking circle in the very center. The circle blinks alternately between 255,255,255 and 222,222,222. On a properly calibrated display you should be able to see the 222,222,222 circle as dimmer than the surrounding rectangle. But the 255,255,255 circle should look the same as the 235,235,235 surround. Some say that having a bit of headroom isn't a bad thing so seeing 255,255,255 as slightly brighter than the surrounding rectangle is okay. It's your call.
NOTE: This is incorrect! It should be (16,16,16)! No broadcast video signal should ever go below that! (0,0,0) black is illegal for broadcast video! ONLY VALUES 16-235 ARE LEGAL!!!
Top right and bottom left quadrants: This is used to set the darkest part of the video. It consists of a white (235,235,235) area with a black (16,16,16) block in the center and a blinking circle in the very center. The circle blinks alternately between 0,0,0 and 28,28,28. On a properly calibrated display you should be able to see the 28,28,28 circle as brighter than the surrounding rectangle. But the 0,0,0 circle should look the same as the 16,16,16 surround.
The thin frame line denotes a 10% overscan area.
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, e.g. from 5.1 to 2.0.[CR][Enabled] Maintains volume level of the original audio source however the dynamic range is compressed.[CR][Disabled] Maintains the dynamic range of the original audio source when downmixed however volume will be lower. Note: Dynamic range is the difference between the quietest and loudest sounds in an audio source. Enable this setting if movie dialogues are barely audible.||Advanced||All|
|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|
|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
<masterlock> <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 --> </masterlock>