21 Aug 2020 - The wiki is undergoing a major cleanup. If you arrived here from a search engine and cannot find the page, please use the wiki search instead (top right corner of page)
More info can be found on the forum

Difference between revisions of "Settings/System"

From Official Kodi Wiki
Jump to: navigation, search
m (Robot: Substituting template: Name)
m (Audio output: no wrap on first column content.)
Line 81: Line 81:
{| class="prettytable" style="color: black;"
{| class="prettytable" style="color: black;"
!style="width:12%" colspan="2"| Setting
!style="width:15%" colspan="2"| Setting
!style="width:70%" | Description
!style="width:70%" | Description
!style="width:8%" | Setting level
!style="width:8%" | Setting level
!style="width:10%" | Device type
!style="width:7%" | Device type
|colspan="2"|'''Audio output device'''  
|colspan="2"|'''Audio output device'''  

Revision as of 04:56, 14 July 2014

Home icon grey.png   ▶ Settings ▶ System

System settings are found here. Setup and calibrate displays/video output, configure audio output, setup remote controls, set power saving options, enable debugging, setup master lock.

1 Video output

Settings.system.video output.png
Setting Description Setting level
Display Mode Display XBMC in a window, or fullscreen on the selected screen.
Changes the resolution that the User Interface is displayed in.
-Use a fullscreen window rather than true fullscreen
...when active (Windows only). Does not use the DirectX fullscreen mode. The main benefit is for multi-screen configurations, where XBMC 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.
-Blank other displays
In a multi-screen configuration, the screens where XBMC is not displayed are blacked out.
Stereoscopic mode (current)
-Preferred mode
Vertical blank sync Compensation for vertical tearing.
Video calibration... See #Video calibration...
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...

Note: Always adjust your TV display settings before XBMC's settings (such as overscan, etc). In most cases, you can get a "just scan/just fit/PC mode/something" mode turned on that will not require any adjustments in XBMC, and will allow for the best screen quality. 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

Settings - Audio Output.png

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.
For digital connections
This is the number of PCM channels that the audio connection supports and not the number of speakers connected. For example, using Dolby Digital over SPDIF will provide 5.1 audio to your system, even though SPDIF only supports 2.0 PCM channels. This setting does not apply to passthrough audio connections, if enabled.
For analog connections
This is the number of speakers outputs used, which is likely the number of speakers your system is using. Note that some "2.1" systems only use two audio channels and do not have a dedicated subwoofer output.

Note: This setting might not be exposed depending on what is set for Audio output device.

Basic HDMI/Analog-Speakers
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
[Optimized] - output properties are set at the start of playback and will not change if the properties of the source changes
[Best Match] - output properties are set to always be as close a match to the source properties as possible

Advanced All
Best Match
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
[Disabled] maintains volume level of the original audio source however the dynamic range is compressed. Note - Dynamic range is the difference between the quietest and loudest sounds in a audio source

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
[Medium] & [High] will use progressively more system resources

Advanced All
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
[1- 10 Minutes] - same as Always except that after the selected period of time audio enters a suspended state
[Off] - audio output enters a suspended state. Note - sounds can be missed if audio enters suspended state

Standard All
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

The "capable receiver" options relate only to the passthrough of audio to another device such as an AVR, where that device must support decoding of the format. Before leaving any "capable receiver" option enabled check to make sure that both the playback device running XBMC (e.g. HTPC) and the connected device (e.g. AVR) both support that format.

If you have a "capable receiver" option enabled that your device does not support then this will result in poor playback of video typically with a very low frames-per-second and no audio, so for example if the TrueHD capable receiver option were enabled then make sure that the playback device can passthrough TrueHD and that the connected device can decode TrueHD, if either of the devices do not support TrueHD then the TrueHD capable receiver option MUST be left disabled.

For any format where the "capable receiver" option is not selected, XBMC will still playback any content containing those audio types, however instead of the audio being passed through, XBMC will decode audio and then send the audio in a compatible format.

If connected directly to a TV be aware that TV are not compatible with DTS, TrueHD or DTS-HD, typically the only encoded format a TV will be compatible with is AC3.

3 Input devices

Note: The content of this screen largely depends on the input devices that XBMC detects and the OS being used.

Settings.system.input devices.png
Setting Description Setting level
Peripherals See #Peripherals.
Apple remote (OS X only)
Allow start of XBMC 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, XBMC will ignore all mouse movements and clicks.

Enable joystick and gamepad support
Enable system keys in fullscreen (Linux only)

3.1 Peripherals

4 Internet access

Settings.network.internet access.png
Setting Description Setting level
Use an HTTP proxy server to access the internet If your internet connection uses a proxy, configure it here.
-Proxy type
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 XBMC will try to keep to these limits. ?

5 Power saving

Note: Some options might not be available on all hardware or OSes. For example, XBMC cannot control shutdown or sleep on Android.

Settings.system.power saving.png
Setting Description Setting level
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

Note: XBMC also has a "Custom shutdown timer" selectable from the power icon on the home screen, or from the shutdown menu (press S on a keyboard or Power on a remote).

6 Debugging

Setting Description Setting level
Enable debug logging Toggles debug log on / off. Useful for troubleshooting.
-Verbose logging

See #Verbose logging

Screenshot folder Folder used to save screenshots taken within XBMC. (see Keyboard controls for the screenshot key for your OS)

6.1 Verbose logging

Verbose logging options.png

7 Master lock

Note: The Master lock options are ONLY available while using the default user profile.

Settings.system.master lock.png
Setting Description Setting level
Master lock code and settings Opens the Master lock settings window, where you can configure your Master Lock options. See #Master lock settings.
-Ask for master lock code on startup
If enabled, the master lock code is required to unlock XBMC on startup

7.1 Master lock settings

Lock settings.png
Setting Description
Master Lock Allows you to set the master lock password. Can be one of three types:
  • Numeric password - Enter a Numeric Password using the On Screen Keyboard
  • Gamepad button combo - Enter a series of buttons using the Gamepad
  • Full-text password - Enter a plain-text password using the On Screen Keyboard
Lock music window
Lock video window
Lock pictures window
Lock programs and scripts windows
Lock file manager
Lock settings
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 Settings/Interface/Master_lock. After enabling the Master Lock, a Set Lock button will pop up in the Context Menu allowing you to set a lock on specific sources. Kodi will ask for the master lock code and then give you the opportunity to set a unique Password on that specific share. To Remove the Lock you need to remember the Master Lock code.

Note: Locking a source means you only give it protection in Kodi. Outside Kodi the source is still available and only protected, or not protected at all, by the Operating System. In the same way, if someone has access to manually edit the sources.xml he or she can remove or change the settings for the locked source. So, don't feel too safe when you protect a source in Kodi.

7.3 Locked out?

XBMC 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 XBMC 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 additional settings

Editor note: This was in advancedsettings.xml, but it appears to be documenting something in guisettings.xml that don't actually have a GUI setting. Code needs to be MD5'd, and you can use this site to hash it.

   <startuplock>false</startuplock>  <!-- true prompts user for code upon startup -->
   <automastermode>false</automastermode>  <!-- automatically enters master mode if the master code is given -->
   <loginlock>true</loginlock>  <!-- whether to use locks on login screen or not -->
   <!-- advancedsettings.xml ONLY: -->
   <maxretries>3<maxretries> <!-- enter the max number of retries to input code, 3 is default. -->