Troubleshooting, Advancedsettings.xml

From XBMC
(Difference between pages)
Jump to: navigation, search
(Network performance issues (wireless))
 
(added virtualshares)
 
Line 1: Line 1:
Before starting troubleshooting it's always a good idea to enable DebugLog in XBMC.
+
The "'''advancedsettings.xml'''" file, which does not exist by default, may be created by a user in their "'''\[[The UserData Folder|UserData]]\'''" folder.<BR>
This provides more detailed info on what's going on, this is done like this: link
+
This file can contain additional settings and pre-defined values for the settings available in the GUI (thus removing them from the GUI settings screens).<BR>
<br>
+
"'''advancedsettings.xml'''" is useful for advanced/expert users and for installers.<BR>
 +
:'''NOTE! This file will not exist unless created by the end-user, meaning YOU!'''<BR>
  
==Lost control==
+
The XBMC software will never write to this file, so any settings you define will not be overwritten by any XBMC GUI settings.<BR>
;Why did my XBMC freeze? There is a new item on the rightside of the top of the screen and my controller isn't working.
+
So you can only edit this file manually on your computer, via a text-editor (like Notepad in Windows or a XML-editor).<BR>
:That is the volume control or seekbar popup menu. It is assigned to the right thumbstick on the controller (up and down for volume, left and right for seeking). Try recalibrating your analog sticks by moving them in full circles several times. If this does not fix the problem, your controller may simply be more sensitive than others. Increase the value of <deadzone> in ''XBoxMediaCenter.xml''.
+
All the settings available outside of the GUI are documented on this page.<BR>
<br>
+
<BR>NOTE: This file is CaSe SeNsItIvE, so make sure you use all lower-case tags or they will not be read properly by XBMC.<BR>
  
 +
==Layout==
  
==Audio related issues==
+
The layout of advancedsettings.xml is as follows:
;The volume level in XBMC is down really, really low – I can't hear anything!
+
:The right thumb stick (push up or down) alters the volume level. Sometimes a second controller is tucked away and could be lowering the volume.
+
<br>
+
  
;Help! My Music visualization doesn't change!
+
<xml>
:Milkdrop and Vortex support a locked mode where presets don't change automatically. This is toggled using controller and the [[Image:2d_btn_back.png]] button. Notice that little padlock ?
+
<advancedsettings>
<br>
+
    <setting>value</setting>
 +
    ...
 +
    <setting>value</setting>
 +
</advancedsettings>
 +
</xml>
  
 +
where "setting" gives the name of the setting, and "value" gives it's value.
  
==Video output issues / Issues with video playback==
+
A list of the available "setting" strings and their values is given below.
;I changed to another skin, and the screen went black. Now, whenever I boot XBMC it stays black and I can't do anything!
+
:Hold down both thumbsticks (clicked) when launching or booting XBMC. This will cause a screen to pop up asking you if you want to reset your settings (including the active skin) to the defaults. The only settings not reset by this method is the Master lock code, and the advaced settings only accessable via manual edit of XML-files, (such as AdvancedSettings.xml, Keymap.xml, LCD.xml, RssFeeds.xml and PartyMode.xml).
+
  
;I use XBMC in 1080i, and when I try and watch videos it fails. What can I do?
+
==List of available settings==
:The Xbox comes equipped with 64Mb of unified RAM, which means that system and graphics memory are shared (unlike a standard PC where they are separate.) This means that when you use 1080i you have to be mindful of things that can take up memory:
+
* Cache sizes
+
* Skin used
+
* Enabled services (Webserver, Ftpserver, Python)
+
Due to the shortage of RAM, it may be a wise idea to turn off all of the listed services at first until you know what can be sustained.  A video cache size of 1Mb is more than enough for playback over a wired local network.  If you use wireless, then you may need it slightly higher, though expect problems with streaming over wireless - wireless very rarely runs at it's advertised speed - often it is significantly slower, so experiment with placement of access points and the like.
+
  
;When I play videos, they display using the wrong aspect ratio. What can I do to fix this?
+
====<loglevel>====
:XBMC has built-in aspect ratio control, as well as zoom control. This can be changed by use of the [[Image:Btn_y3.png]] button during video playbackWhen you press [[Image:Btn_y3.png]] you will also see which resolution it is using. If you find your 4x3 movies play on your 16x9 screen stretched out, instead of with black bars either side of the image, it may be that you have selected "Auto" as the video output resolution in the Video Player settings, and your TV does not auto-switch to it's 4x3 mode.  Set it to 16x9 in this case.  See Movie Playback & OSD for more information.
+
The logging level that XBMC will use to log errors and informationAvailable values are:
 +
*-1  No logging, suppresses all log output.
 +
*0  Normal logging, only logging errors (Default)
 +
*1  Debug logging.
 +
*2  Debug logging with freemem, fps and cpu usage shown on screen.
 +
*3  Debug logging with freemem, fps and cpu usage and full smb logging.
  
;I can't seem to be able to select Widescreen/HDTV modes. How can I fix this?
+
====<cddbaddress>====
:You must enable Widescreen/HDTV Modes in the Microsoft Dashboard. Once this is done, the options will appear in XBMC.<br>'''Note: For HDTV modes you need two things. The xbox must be in NTSC mode and you also need a suitable AV cable.'''
+
The address of the online CDDb database. You may set this to another freedb mirror if there is a more suitable one. Defaults to freedb.freedb.org
<br>
+
  
 +
====<nodvdrom>====
 +
Set to true if you have no DVD-ROM drive in your XBox, or if it's broken.  Defaults to false.
  
==XBMC won't start==
+
====<usepcdvdrom>====
;I recently upgraded my XBMC and now it loads with a XBMC Fatal Load Error – Q:\XboxMediaCenter.xml, Line 0 – Failed to open file. I don't even have a Q: drive?
+
Set to true if you have replaced the XBox DVD-ROM drive with a standard PC DVD-ROM. Expect performance to be somewhat variable. Defaults to false. <br>
:The Q: drive is the temporary drive that XBMC sets up in it's own directory. You probably did an edit to ''XboxMediaCenter.xml'' that broke the file (forgot to close a tag perhaps?) A good practise is to always verify the integrity by opening ''XboxMediaCenter.xml'' in a Webbrowser before uploading!
+
removed for non XBox builds with r14123.
;I try to launch XBMC from a dashboard and it does not start (freeze or black screen), why?
+
:If you have a very old BIOS in your modchip, make sure that XBMC's XBE (executable) is patched from DEBUG to RETAIL, as old BIOS's can't run DEBUG executeables. You can patch it with xbepatch or deXBE. If you get same problem again try another build of XBMC, if still same issue follow EvoX FAQ.
+
<br>
+
  
 +
====<detectasudf>====
 +
Set to true if you wish to detect joint ISO9660/UDF disks as UDF.  Defaults to false.
  
==XBMC won't play a file==
+
====<disablemodchipdetection>====
;I got one or several AVI files that plays choppy and/or ends in the middle of playback, what could be the cause?
+
Set to true to disable modchip detection. This is required for X2 chips to launch XBEs.
:There's basically 2 types of AVI files, AVI and AVI2.0. AVI2.0 is also known as OpenDML. If your file is encoded with XviD (or another MPEG-4 Codec) video and MP3 audio (use GSPOT to findout) this is almost certainly the cause to the playback problems. The issue can be resolved by RE-MUXING the video to old AVI format using a tool like AVIMux-GUI. If the file is a '''.MP4''' file, it could be streamripped or just created as a Stream. Then you need to enable ''No Cache'' in Video OSD Settings.
+
;Why can't Xbox Media Center read/play files larger than 1GB from a UDF DVD-R/RW media?
+
:This is due to a Xbox™ limitation reading UDF128 (this is not a XBMC failure or our fault).
+
;Why can't Xbox Media Center read/play files larger than 4GB from the Xbox™ harddrive?
+
:This is due to a Xbox™ limitation in the FAT-X format (not a XBMC issue that can be fixed).
+
;Why can't XBMC read/play AVI video files after 2GB or play/read a 2GB+ AVI video file?
+
:All AVI files over 2GB in size are OpenDML AVI's and XBMC does not yet support OpenDML. '''PS! We know that XBMC also has other problems with OpenDML AVI's that are under 2GB in size. A couple of such problems are that XBMC cannot FF/RW in OpenDML, and/or video distortions. Note! Reason for this is that MPlayer which XBMC is based upon do not yet support OpenDML'''.
+
<br>
+
  
 +
====<cachepath>====
 +
Set to the path on the XBox Harddisk that XBMC should use for when it caches files (such as when caching subtitles or for unzipping or unrarring).  Defaults to Z:\
  
==Network performance issues (wired or wireless)==
+
====<virtualshares>====
'''Do you experince slow throughput/load-times when streaming video or audio over a wired or wireless-network?'''
+
Set to false to disable virtual shares like plugins, last.fm or shoutcast sources. Defaults to true.
Here are some general hints and tips that can aid wired and wireless performance issues:
+
  
===General (both wired and wireless) tips:===
+
====<pictureextensions>====
*If your computers operating-system is windows based (like 95/98/ME/XP/2000/2003) then follow/perform this tweaks:
+
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Pictures window.
**Tweak the DNS errors caching in windows by following the first in [http://www.speedguide.net/read_articles.php?id=158 this url (link)] to speedup/fix failed dns lookups.
+
**Follow this [http://www.tweakxp.com/article37107.aspx tweakxp.com (link)] register tweak to change the dir commad's buffer from 14000 to 65000 to raise the cache.
+
** Uninstalled or reconfigure the "qos packet scheduler" service from the tcp/ip stack under properties in local area connection;
+
***(Alernative 1: in windows => control panel => network connections => local area connection => properties => uninstall).
+
***(Alernative 2: lower or disable the amount of bandwith reserved for qos, do this by following the last article [http://www.speedguide.net/read_articles.php?id=158 in this link]).
+
  
*If your computers operating-system is unix based like linux or freebsd then [http://www.dd.iij4u.or.jp/~okuyamak/Documents/tuning.english.html follow/perform this tip to change transmission area window (link)].
+
These are the current default extensions for PICTURES:
  
*In windows make you you 'unmount' (or disable) all virtual cd/dvd-rom drives (ex. from daemon-tools, alcohol 120%, clonedvd/clonecd, etc.).  
+
.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .zip .cbr .rar .m3u
  
*During smb streaming troubleshooting you should of course also (temporarly) try disabling any antivirus and firewall softwares on your computer.
+
<xml>
 +
<pictureextensions>
 +
  <add>.ex1|.ex2</add>
 +
  <remove>.ex3|.ex4</remove>
 +
</pictureextensions>
 +
</xml>
  
===Wired specific tips:===
+
====<musicextensions>====
*Force from "auto-detect speed" to "100mbps/full-duplex" becuase it disables auto-negotiation which can sometimes slow network connections, (in windows xp => control panel => network connections => local area connection properties => configure... => advanced => link speed...).
+
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Music windows.
  
===Wireless specific tips:===
+
These are the current default extensions for MUSIC:
* If your wireless access-point/router/adapters are 802.11b then upgrade (buy!) all to [[http://en.wikipedia.org/wiki/802.11g 802.11g, 802.11g+, 802.11n or 802.11a] equipment with [http://en.wikipedia.org/wiki/Multiple-input_multiple-output_communications MIMO] support instead. Know that in practice the maximum 802.11b throughput that an application can achieve is about 5.9Mbit/s (for burst transmission) and the average throughput is usually bellow 1Mb/second which is too slow to stream video in real-time. The average throughput for 802.11g is 25Mbit/s, and 50Mbit/s for 802.11g+ with [http://en.wikipedia.org/wiki/Multiple-input_multiple-output_communications MIMO] so even that might have problems streaming [http://en.wikipedia.org/wiki/DVD#DVD-Video DVD-Video movies] over wireless. 802.11n on the other hand (which all support [http://en.wikipedia.org/wiki/Multiple-input_multiple-output_communications MIMO] as standard) has an average throughput of 200Mbit/s, and that is fast enough for all audio/video streams.
+
  
* Disable WEP/WPA encryption (as it increases overhead which lowers throughput), enable MAC-address filtering as security instead.
+
.nsv .m4a .flac .aac .strm .pls .rm .mpa .wav .wma .ogg .mp3 .mp2 .m3u .mod .amf .669 .dmf .dsm .far .gdm
 +
.imf .it .m15 .med .okt .s3m .stm .sfx .ult .uni .xm .sid .ac3 .dts .cue .aif .aiff .wpl .ape .mac .mpc
 +
.mp+ .mpp .shn .zip .rar .wv .nsf .spc .gym .adplug .adx .dsp .adp .ymf .ast .afc .hps .xsp
  
* Move your wireless router/access-point and network-adapters closer to each other as the data-rates decreases significantly the longer the signal have to travel, also remove all possible obsticals if possible (as the data-rates slows down significantly if the signal have to travel through thick walls, floors/ceelings or furnature, etc.). In addition try to place your wireless router/access-point at the same hight as your network-adapters, preferably on the middle of the wall instead of on the floor or close to the ceeling.
+
<xml>
 +
<musicextensions>
 +
  <add>.ex1|.ex2</add>
 +
  <remove>.ex3|.ex4</remove>
 +
</musicextensions>
 +
</xml>
  
* Do not mix formats, the presence of an 802.11b participant significantly reduces the speed of an 802.11g/802.11g+ networks. Same with 802.11g and 802.11n. Also non-network wireless products, or other products that are operating in the 2.4GHz band (as 802.11b/802.11g/802.11g+ do), like microwave ovens, bluetooth devices, and cordless telephones
+
====<videoextensions>====
 +
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Video windows.
  
Note! If above don't help then test the alternative [[XBMSP]]/[[XBMS]] or [[UPnP Sharing|UPnP]] protocols, instead of [[SMB]]/[[SAMBA]]/[[CIFS]] as they have much less overhead.
+
These are the current default extensions for VIDEOS:
<br>
+
  
==Annoyances==
+
.m4v .3gp .nsv .ts .ty .strm .rm .rmvb .m3u .ifo .mov .qt .divx .xvid .bivx .vob .nrg .img
;Where did the Record Button go?
+
.iso .pva .wmv .asf .asx .ogm .m2v .avi .bin .dat .dvr-ms .mpg .mpeg .mp4 .mkv .avc .vp3
:It's in My Music OSD now
+
.svq3 .nuv .viv .dv .fli .flv .rar .001 .wpl .zip
;When I start the XBOX and XBMC there is a startup music that plays every restart or when I enter xbmc. How can I disable this music?
+
:There is a script running on startup (scripts\autoexec.py) that is loading another script and causing playback to start. Remove the autoexec.py script (or rename it) to stop this. It was put there by whoever created your build. Furthermore, there is also a startup sound that can be played (a file named media\start.wav) which is normally played when the splash screen is displayed. Remove this file if you don't like it.
+
;After I deleted some albums from my harddisk, they are still visible when in My Music Libary. How can I delete these empty albums?
+
:Go to Settings->My Music and choose '''"Clean the music database"'''.
+
;I'm using XBMSP or SMB to share my music to XBMC, and whenever I go to browse the shared folders it takes a while and presents me with the message scanning media info...what is it doing and is there anyway to remove this scanning?
+
:It is scanning the media files for tag information, so that it can display artist, title, year, genre, album information, as well as any embedded thumbnails. This takes a while over a network connection. You can turn this off completely by disabling ID3 tag reading in Settings->My Music. A better thing to do is to perform a Scan on the folders from My Music. This will store the retreived tag information in the database, allowing you to take advantage of the database views (using the Switch View button). See My Music for more information.
+
;When XBMC loads, it always starts in My Music (or some other screen). How can I get it to start on the home page?
+
:The most likely reason for this is you have altered the '''<startwindow>''' tag in ''XBoxMediaCenter.xml'', or via the Appearance Settings. Set it to Home via the GUI, or 0 in <startwindow> to start on the homepage.
+
;I get an error message '''Error: Out of memory loading picture''' when running slideshows
+
:Running slideshows uses a large amount of memory – particularly when loading images. You could try freeing up memory by turning off any music you have running. See here under the section “How it works” for more information.
+
;I upgraded XBMC and now I can no longer access my '''F''' partition?
+
:You possibly upgraded from a build prior to 19th of March 2005, to a build made after this date. You also use an old Bios. A possible fix to this issue is to disable '''<AutodetectFG>''' (set to no) in ''XboxMediaCenter.xml''.
+
;Why can't I access X, Y or Z partition using eg. My Files or by FTP?
+
:Early on a deciscion was made to make it a little 'harder' for new unknowing users to access '''X''', '''Y''' or '''Z''' due to the fact that these are "cache partitions" and no data put there stays there. You can make a bookmark yourself for ''My Files'' or edit ''Filezilla Server.xml'' yourself and add these!
+
  
<br><br><br><br><br><br>
+
<xml>
 +
<videoextensions>
 +
  <add>.ex1|.ex2</add>
 +
  <remove>.ex3|.ex4</remove>
 +
</videoextensions>
 +
</xml>
 +
 
 +
====<languagecodes>====
 +
Translation table for subtitle and audio names.  Contains entries of the form
 +
 
 +
<xml>
 +
    <code><short>alt</short><long>Alternate</long></code>
 +
</xml>
 +
 
 +
====<sorttokens>====
 +
Allows you to specify additional tokens that will be ignored at the start of lines during sorting.
 +
<xml>
 +
  <sorttokens>
 +
    <token>the</token>
 +
  </sorttokens>
 +
</xml>
 +
 
 +
====<samba>====
 +
<xml>
 +
<samba>
 +
  <doscodepage></doscodepage>  <!-- code page to use for filenames -->
 +
  <clienttimeout>10</clienttimeout>  <!-- timeout (in seconds) -->
 +
  <nostat>false</nostat>  <!-- Disable smb stat() on files to speed up listings of large directories (over slow links) (Xbox only) -->
 +
</samba>
 +
</xml>
 +
 
 +
====<moviestacking>====
 +
This tag used to be called <videostacking>.<br>
 +
Contains regular expressions for use in matching filenames in a "stack" of video files.  The regular expression must have a (...) surrounding the volume label portion.  Text matching is compared case-insensitive.  Anything matched by the regular expression will be removed from the titlename.  If more than one (...) section is used, the first one will be the prefix, the second one the volume label, and the third one (if it exists) will be the suffix.  Use this to keep extensions after matching.  If more than one expression matches a particular filename, the first one will be used.
 +
 
 +
Default stacking:
 +
<xml>
 +
  <moviestacking>
 +
    <regexp>[ _\.-]+cd[ _\.-]*([0-9a-d]+)</regexp>
 +
    <regexp>[ _\.-]+dvd[ _\.-]*([0-9a-d]+)</regexp>
 +
    <regexp>[ _\.-]+part[ _\.-]*([0-9a-d]+)</regexp>
 +
    <regexp>[ _\.-]+dis[ck][ _\.-]*([0-9a-d]+)</regexp>
 +
    <regexp>()[ _\.-]+([0-9]*[abcd]+)(\.....?)$</regexp>
 +
    <regexp>([a-z])([0-9]+)(\.....?)$</regexp>
 +
    <regexp>()([ab])(\.....?)$</regexp>
 +
  </moviestacking>
 +
</xml>
 +
 
 +
If the argument '''action="append"''' or '''append="yes"''' is supplied, the default videostacking regular expressions will remain intact and the user specified ones will be added to the end.  Example:
 +
<xml>
 +
  <moviestacking action="append">
 +
    <regexp>custom[ _\.-]*([0-9a-d]+)</regexp>
 +
  </moviestacking>
 +
</xml>
 +
 
 +
 
 +
If the argument '''action="prepend"''' is supplied, the default videostacking regular expressions will remain intact and the user specified ones will be added to the beginning. Example:
 +
<xml>
 +
  <moviestacking action="prepend">
 +
    <regexp>custom[ _\.-]*([0-9a-d]+)</regexp>
 +
  </moviestacking>
 +
</xml>
 +
 
 +
If no argument is supplied, or the argument '''append="no"''' is supplied, the default videostacking regular expressions are overwritten by the user specified ones.
 +
 
 +
====<tvshowmatching>====
 +
Contains regular expression to match the season and episode numbers in filenames.
 +
 
 +
Default stacking:
 +
 
 +
<xml>
 +
  <tvshowmatching>
 +
    <regexp>\[[Ss]([0-9]+)\]_\[[Ee]([0-9]+)([^\\/]*)</regexp>  <!-- foo_[s01]_[e01] -->
 +
    <regexp>[\._ \-]([0-9]+)x([0-9]+)([^\\/]*)</regexp>  <!-- foo.1x09 -->
 +
    <regexp>[\._ \-][Ss]([0-9]+)[\.\-]?[Ee]([0-9]+)([^\\/]*)</regexp>  <!-- foo, s01e01, foo.s01.e01, foo.s01-e01 -->
 +
    <regexp>[\._ \-]([0-9]+)([0-9][0-9])([\._ \-][^\\/]*)</regexp>  <!-- foo.103 -->
 +
  </tvshowmatching>
 +
</xml>
 +
 
 +
The "append" and "action" arguments described in the videostacking section work the same for tvshowmatching tags.  Examples of matching regexps for certain filenames can be found on the [[TV_Shows]] page.
 +
 
 +
NOTE: for multi-episode matching to work, there needs to be a third set of parentheses on the end.  This part is fed back into the regexp engine.
 +
 
 +
====<excludefromscan>====
 +
Contains regular expressions to match filenames which should be excluded from a library scan.
 +
 
 +
Default stacking:
 +
 
 +
<xml>
 +
  <excludefromscan>
 +
    <regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
 +
  </excludefromscan>
 +
</xml>
 +
 
 +
The "append" and "action" arguments described in the videostacking section work the same for excludefromscan tags.
 +
 
 +
====<pathsubstitution>====
 +
Path substitutions for use with playlist loading.  These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for XBMC to handle.  Default is no path substitutions defined.  An example is:
 +
 
 +
<xml>
 +
  <pathsubstitution>
 +
    <substitute>
 +
      <from>G:\dvds\</from>
 +
      <to>smb://somecomputer/g-share/dvds/</to>
 +
    </substitute>
 +
  </pathsubstitution>
 +
</xml>
 +
 
 +
====<forcedswaptime>====
 +
Use to force a backbuffer->frontbuffer swap while vsync is enabled. Set to the time (in ms) to allow for the swap (eg <forcedswaptime>1</forcedswaptime> is typical).  It defaults off.
 +
 
 +
====<playlistasfolders>====
 +
In the recent releases, playlists are treated as folders. Selecting a playlist no longer plays it, but opens it, as if it were a folder.<br>
 +
Set to false to revert to the previous behavior. When you select a playlist, its content is added to the list of elements to be played.<br>
 +
'''NOTE!''' This setting will not affect smart playlists, they will always show as folders.
 +
 
 +
====<playlistretries>====
 +
The default number of retries if for example a source is offline is 100.
 +
With this control you can alter the number of consecutive failed items before a playlist fails.
 +
 
 +
<xml>
 +
  <playlistretries>100</playlistretries>
 +
</xml>
 +
 
 +
====<playlisttimeout>====
 +
The default timeout before item failure is 20 sec. It can be changed with this control
 +
 
 +
<xml>
 +
  <playlisttimeout>20</playlisttimeout>
 +
</xml>
 +
 
 +
====<songinfoduration>====
 +
This controls how long the song information will remain onscreen when the song changes during visualisations.  The valid range is 1 to 15, in seconds.  This does not include the duration of any transition effects. (The default is 2 seconds.)
 +
 
 +
<xml>
 +
  <songinfoduration>10</songinfoduration>
 +
</xml>
 +
 
 +
====<remoterepeat>====
 +
The repeat delay for the Infrared remote control, in milliseconds.  Length of time a remote button needs to be held before it will start repeating (ie continuously sending button pushes while it's held down).  Defaults to 480.
 +
 
 +
====<controllerdeadzone>====
 +
Deadzone for controller thumb sticks.  0 indicates no deadzone at all.  1 indicates all deadzone (ie no movement will be detected).  Defaults to 0.2
 +
 
 +
====<displayremotecodes>====
 +
Set to true to have XBMC display the Infrared Remote's button codes (OBC's) on screen when you press buttons.  Useful for assigning functions to the buttons on a universal remote control.  Defaults to false.
 +
 
 +
====<thumbsize>====
 +
Size of the square in pixels that XBMC will use to cache thumbnail images.  If the thumb is smaller than this size it will be cached as-is.  If it is larger it will be scaled so that the number of pixels is less than a square of this value.  Default is 512 (192 on xbox), which refers to 512x512 = 262144 (for XBox 192x192 = 36864) pixels in total.  The thumbnail will be cached at using the same aspect ratio as the original image, using up to 262144 (for XBox 36864) pixels.
 +
 
 +
====<musicthumbs>====
 +
A list of additional files to try when searching for music thumbnail images.  (The default is folder.jpg which can be removed.)
 +
 
 +
<xml>
 +
<musicthumbs>
 +
  <remove>folder.jpg</remove>
 +
  <add>thumb.jpg|cover.jpg</add>
 +
</musicthumbs>
 +
</xml>
 +
 
 +
====<musicfilenamefilters>====
 +
Contains filters to match music information (artist, title etc.) from a tagless music filename.  The first <filter> to match completely is used. Matched items include:
 +
 
 +
%A - Artist
 +
%T - Title
 +
%B - Album
 +
%N - Track number
 +
%S - Part of set (disk number)
 +
%D - Duration
 +
%G - Genre
 +
%Y - Year
 +
%R - Rating
 +
 
 +
<xml>
 +
  <musicfilenamefilters>
 +
    <filter>%A - %T</filter>
 +
  </musicfilenamefilters>
 +
</xml>
 +
 
 +
====<dvdthumbs>====
 +
A list of additional files to try when searching for dvdrom thumbnail images.  (The default is folder.jpg which can be removed.)
 +
 
 +
<xml>
 +
<dvdthumbs>
 +
  <remove>folder.jpg</remove>
 +
  <add>thumb.jpg|cover.jpg</add>
 +
</dvdthumbs>
 +
</xml>
 +
 
 +
====<masterlock>====
 +
If you enable any masterlock settings below, they will be removed from UI. Code needs to be MD5'd, and you can use [http://pajhome.org.uk/crypt/md5/ this site] to hash it.
 +
 
 +
<xml>
 +
 
 +
<masterlock>     
 +
  <startuplock>false</startuplock>  <!-- true prompts user for code upon startup -->
 +
  <enableshutdown>false</enableshutdown>  <!-- true shuts down xbox after 3 failed attempts to enter  correct code -->
 +
  <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. -->
 +
</masterlock>
 +
</xml>
 +
 
 +
====<postprocessing>====
 +
MPlayer postprocessing settings.  This is unreliable, and so they're in here only.
 +
 
 +
<xml>
 +
  <postprocessing>
 +
    <enable>false</enable>  <!-- enable/disable postprocessing -->
 +
    <auto>true</auto>  <!-- auto filter settings (overrides the below) -->
 +
    <verticaldeblocking>false</verticaldeblocking>  <!-- use vertical deblocking -->
 +
    <verticaldeblocklevel>0</verticaldeblocklevel>  <!-- level of vertical deblocking (0-100) -->
 +
    <horizontaldeblocking>false</horizontaldeblocking>  <!-- use horizontal deblocking -->
 +
    <horizontaldeblocklevel>0</horizontaldeblocklevel>  <!-- level of horizontal deblocking (0-100) -->
 +
    <autobrightnesscontrastlevels>false</autobrightnesscontrastlevels>  <!-- whether to use mplayers colour balancing -->
 +
    <dering>false</dering>  <!-- whether to apply the dering filter -->
 +
  </postprocessing>
 +
</xml>
 +
 
 +
====<audio>====
 +
<xml>
 +
<audio>
 +
  <!-- Amount of headroom XBMC should use above the maximum volume level, in decibels.  Defaults to 0, valid values 0, 6, 12. -->
 +
  <headroom>0</headroom>
 +
  <!-- Delay in sync to karaoke in seconds. Valid values are -3.0...3.0. -->
 +
  <karaokesyncdelay>0</karaokesyncdelay> 
 +
  <!-- Default audio player: paplayer, dvdplayer or mplayer (Xbox only) -->
 +
  <defaultplayer>paplayer</defaultplayer>
 +
</audio>
 +
</xml>
 +
 
 +
====<video>====
 +
<xml>
 +
<video> <!-- "VideoSettings" instead of "video" for builds prior to May 22, 2006 -->
 +
  <subsdelayrange>10</subsdelayrange>  <!-- Delay range for subtitles, in seconds. -->
 +
  <audiodelayrange>10</audiodelayrange>  <!-- Delay range for audio/video sync, in seconds. -->
 +
  <smallstepbackseconds>7</smallstepbackseconds>  <!-- Length of the small skip back (normally the BACK button) when playing a video -->
 +
  <smallstepbacktries>3</smallstepbacktries>
 +
  <smallstepbackdelay>300</smallstepbackdelay>
 +
  <usetimeseeking>true</usetimeseeking>  <!-- Whether to use time based or percentage based seeking. -->
 +
  <timeseekforward>30</timeseekforward>  <!-- Time to seek forward in seconds when doing a short seek.  Defaults to 30. -->
 +
  <timeseekbackward>-30</timeseekbackward>  <!-- Time to seek backward in seconds when doing a short seek.  Defaults to -30. -->
 +
  <timeseekforwardbig>600</timeseekforwardbig>  <!-- Time to seek forward in seconds when doing a long seek.  Defaults to 600 (10 minutes). -->
 +
  <timeseekbackwardbig>-600</timeseekbackwardbig>  <!-- Time to seek forward in seconds when doing a long seek.  Defaults to -600 (10 minutes). -->
 +
  <percentseekforward>2</percentseekforward>  <!-- Amount to seek forward as a percentage, when doing a short seek.  Defaults to 2. -->
 +
  <percentseekbackward>-2</percentseekbackward>  <!-- Amount to seek backward as a percentage, when doing a short seek.  Defaults to -2. -->
 +
  <percentseekforwardbig>10</percentseekforwardbig>  <!-- Amount to seek forward as a percentage, when doing a long seek.  Defaults to 10. -->
 +
  <percentseekbackwardbig>-10</percentseekbackwardbig>  <!-- Amount to seek forward as a percentage, when doing a long seek.  Defaults to -10. -->
 +
  <blackbarcolour>1</blackbarcolour>  <!-- colour of the black bars (0->255), (black->white) on videos. -->
 +
  <fullscreenonmoviestart>true</fullscreenonmoviestart> <!-- Whether to go to fullscreen or not when starting a movie. Defaults to true. -->
 +
  <defaultplayer>dvdplayer</defaultplayer> <!-- Set the default video player: mplayer or dvdplayer (only available on xbox). -->
 +
</video> <!-- use "VideoSettings" instead of "video" for builds prior to May 22, 2006 -->
 +
</xml>
 +
 
 +
====<musiclibrary>====
 +
Options specific to the Music Library
 +
 
 +
<xml>
 +
  <musiclibrary>
 +
    <hideallitems>true</hideallitems> <!-- removes the "*All" items from the music library -->
 +
    <allitemsonbottom>true</allitemsonbottom> <!-- sorts the "*All" items at the bottom of the list when in Ascending order -->
 +
    <!-- only shows primary album artists when at the unfiltered artist listing -->
 +
    <hidecompilationartists>true</hidecompilationartists>
 +
    <!-- at an albums listing, when you sort by artist, secondary sort will be year. -->
 +
    <albumssortbyartistthenyear>true</albumssortbyartistthenyear>
 +
    <albumformat>%B - %Y</albumformat>  <!-- album label template, default is "%B" -->
 +
    <albumformatright>%A</albumformatright>  <!-- album label template for right column, default is "%A" -->
 +
    <prioritiseapetags>true</prioritiseapetags>  <!-- prioritise APEv2 tags over ID3v1/2 tags, default is false. -->
 +
    <!-- separator used for multiple artists/genres in tags. Note, this *space* *slash* *space* -->
 +
    <itemseparator> / </itemseparator>
 +
  </musiclibrary>
 +
</xml>
 +
 
 +
====<videolibrary>====
 +
Options specific to the Video Library
 +
 
 +
<xml>
 +
  <videolibrary>
 +
    <allitemsonbottom>true</allitemsonbottom>  <!-- sorts the "*All" items at the bottom of the list when in Ascending order -->
 +
    <backgroundupdate>true</backgroundupdate> <!-- set to hide the video scanner dialog from the gui -->
 +
    <cleanonupdate>true</cleanonupdate>  <!-- set to false to prevent xbmc from removing items from the database while updating -->
 +
    <hideallitems>true</hideallitems>  <!-- removes the "*All" items from the video library -->
 +
    <hideemptyseries>true</hideemptyseries>  <!-- hide empty series in the video library -->
 +
    <hiderecentlyaddeditems>true</hiderecentlyaddeditems>  <!-- removes the "Recently added ..." items from the video library. -->
 +
    <itemseparator> / </itemseparator>  <!-- separator used for multiple artists/genres in tags. Note, this is *space* *slash* *space* -->
 +
  </videolibrary>
 +
</xml>
 +
 
 +
====<slideshow>====
 +
<xml>
 +
<slideshow>
 +
  <!-- Amount to pan images as a percentage of the screen -->
 +
  <panamount>2.5</panamount>
 +
  <!-- Amount to zoom images as a percentage of the screen -->
 +
  <zoomamount>5.0</zoomamount>
 +
  <!-- Amount to compensate (zoom) images to attempt to reduce black bars. -->
 +
  <!-- Results in cropping of the longer length of the image in order to reduce the black bars on the shorter length of the image.  -->
 +
  <!-- Defaults to 20. -->
 +
  <blackbarcompensation>20</blackbarcompensation> 
 +
</slideshow>
 +
</xml>
 +
 
 +
====<lcd>====
 +
<xml>
 +
<lcd>
 +
  <rows>4</rows>              <!-- Number of rows to use for the LCD. -->
 +
  <columns>20</columns>        <!-- Number of columns to use for the LCD. -->
 +
  <address1>0</address1>      <!-- Memory address for row 1. -->
 +
  <address2>20</address2>      <!-- Memory address for row 2. -->
 +
  <address3>64</address3>      <!-- Memory address for row 3. -->
 +
  <address4>84</address4>      <!-- Memory address for row 4. -->
 +
  <heartbeat>true</heartbeat>  <!-- Enables LCDprocs heartbeat symbol. Defaults to false. -->
 +
  <scrolldelay>2</scrolldelay> <!-- Delay of the scroller widget. Defaults to 1. -->
 +
</lcd>
 +
</xml>
 +
 
 +
====<network>====
 +
<xml>
 +
<network>
 +
  <autodetectpingtime>30</autodetectpingtime>  <!-- Length in seconds between pinging the network to detect new xbox's -->
 +
  <curlclienttimeout>10</curlclienttimeout>  <!-- Timeout in seconds for libcurl (http/ftp) connections -->
 +
  <httpproxyusername></httpproxyusername>  <!-- username for Basic Proxy Authentication -->
 +
  <httpproxypassword></httpproxypassword>  <!-- password for Basic Proxy Authentication -->
 +
</network>
 +
</xml>
 +
 
 +
====<tuxbox>====
 +
<xml>
 +
<tuxbox>
 +
    <!-- "audiochannelselection"; default is 'false', 'true' will popup the audio channel selection if
 +
          there is more then one audio stream !-->
 +
    <audiochannelselection>false</audiochannelselection>
 +
    <!-- "submenuselection"; default is 'false', 'true' will popup the Submenu selection !-->
 +
    <submenuselection>false</submenuselection>
 +
    <!-- "defaultrootmenu"; MODE: 0 = TV (Default), 1 = Radio, 2 = Data, 3 = Movies, 4 = Root !-->
 +
    <defaultrootmenu>0</defaultrootmenu>
 +
    <!-- "defaultsubmenu"; 1=Services  2=Satellites 3=Providers 4=Bouquets (default) !-->
 +
    <defaultsubmenu>4</defaultsubmenu>
 +
    <!-- "pictureicon"; default is 'true', will use the Picture Icons from folder /UserData/PictureIcon/ !-->
 +
    <pictureicon>true</pictureicon>
 +
    <!-- "epgrequesttime"; default is '10', 0-3600, defines the time in seconds between epg queries, some tuxbox
 +
          devices need longer to response (Minimum: 1, Maximum: 3600) !-->
 +
    <epgrequesttime>10</epgrequesttime>
 +
    <!-- "zapwaittime"; default is '0' (0 = OFF), defines the time in seconds to wait for a valid PMT after the
 +
          zaping was send (Minimum: 0, Maximum: 120) !-->
 +
    <zapwaittime>0</zapwaittime> 
 +
  </tuxbox>
 +
</xml>
 +
 
 +
====<playcountminimumpercent>====
 +
Video: Minimum percentage that has to be played before it is marked as watched.
 +
 
 +
Music: Minimum percentage that has to be played before it is considered for incrementing in the Top 100 database view, or for last.fm submittal.
 +
 
 +
====<ftpshowcache>====
 +
default is false, if set to true, shows cache (X Y Z) partitions in the root directory listing
 +
 
 +
====<screensaver>====
 +
To avoid potential worries of plasma screen burn-in, you can set the Dim screensaver fade level to 0% here or in the Settings.
 +
<xml>
 +
<screensaver>
 +
  <dimlevel>0</dimlevel>  <!-- This will remove the Fade Level control from the settings screen altogether -->
 +
</screensaver>
 +
</xml>
 +
 
 +
====<busydialogdelay>====
 +
Set the delay in milliseconds before the busydialog pops up (default 2000).
 +
<xml>
 +
<busydialogdelay>2000</busydialogdelay>
 +
</xml>
 +
 
 +
====<rootovershoot>====
 +
Disable root overshooting aka evil B(tm) navigation. 'Evil B' navigation refers to the 'previous folder' action returning to the parent window from the root location of a media window.  Sometimes a user would just want to repeatedly hit the B button to reach the root location without worrying of overshooting to the previous window.  For this you should disable evil b by setting this value to false.
 +
<xml>
 +
<rootovershoot>false</rootovershoot>
 +
</xml>
 +
 
 +
====<hosts>====
 +
Static dns entries which take precedence over your dns server.
 +
<xml>
 +
<hosts>
 +
  <entry name="HOSTNAME">IPADDRESS</entry>
 +
</hosts>
 +
</xml>
 +
 
 +
====<fullscreen>====
 +
Starts XBMC in full screen (check resolutions!). The same as starting XBMC with -fs.
 +
 
 +
<xml>
 +
<fullscreen>false</fullscreen>
 +
</xml>
 +
 
 +
==How to include GUI settings==
 +
 
 +
You can also define the settings normally defined in the GUI in advancedsettings.xml.  Any GUI based settings defined in advancedsettings.xml will override the GUI values, and the settings will be removed completely from the GUI (ie only alterable by editting advancedsettings.xml).
 +
 
 +
The easiest way to include a GUI setting is to first make sure it is set in the GUI to the value that you want, and then to open the '''UserData\guisettings.xml''' file and find the XML entry that corresponds to that setting.
 +
 
 +
Then just add that entry to the advancedsettings.xml file.
 +
 
 +
For instance, to set the Font Character Set for the GUI (found in the appearance setting, in the Look and Feel section), you'd open up guisettings.xml and find:
 +
 
 +
<xml>
 +
  <lookandfeel>
 +
    <charset>Hebrew (Windows)</charset>
 +
  </lookandfeel>
 +
</xml>
 +
 
 +
Simply take that entry and place it in advancedsettings.xml.  The GUI entry for the character set will then no longer appear, and XBMC will always use the Hebrew (Windows) character set.
 +
 
 +
 
 +
Here are some special cases, if they aren't defined the user will be prompted first time he/she tries to access any of these paths:<br>
 +
'''Note: There are no default pre-set values'''
 +
 
 +
====<trainerpath>====
 +
<xml>
 +
<myprograms>
 +
    <trainerpath>Q:\system\trainers</trainerpath>
 +
</myprograms>
 +
</xml>
 +
 
 +
====<recordingpath>====
 +
<xml>
 +
<mymusic>
 +
    <recordingpath>E:\Recordings</recordingpath>
 +
</mymusic>
 +
</xml>
 +
 
 +
====<cddaripperpath>====
 +
<xml>
 +
<cddaripper>
 +
    <path>E:\Recordings</path>
 +
</cddaripper>
 +
</xml>
 +
 
 +
====<playlistspath>====
 +
<xml>
 +
<system>
 +
    <playlistspath>E:\Playlists</playlistspath>
 +
</system>
 +
</xml>
 +
 
 +
====<screenshotpath>====
 +
<xml>
 +
<pictures>
 +
  <screenshotpath>E:\Screenshots</screenshotpath>
 +
</pictures>
 +
</xml>
 +
 
 +
[[category:Settings]]
 +
[[category:Customization]]
 +
[[category:Thumbnails]]

Revision as of 12:34, 22 November 2008

The "advancedsettings.xml" file, which does not exist by default, may be created by a user in their "\UserData\" folder.
This file can contain additional settings and pre-defined values for the settings available in the GUI (thus removing them from the GUI settings screens).
"advancedsettings.xml" is useful for advanced/expert users and for installers.

NOTE! This file will not exist unless created by the end-user, meaning YOU!

The XBMC software will never write to this file, so any settings you define will not be overwritten by any XBMC GUI settings.
So you can only edit this file manually on your computer, via a text-editor (like Notepad in Windows or a XML-editor).
All the settings available outside of the GUI are documented on this page.

NOTE: This file is CaSe SeNsItIvE, so make sure you use all lower-case tags or they will not be read properly by XBMC.

Contents

1 Layout

The layout of advancedsettings.xml is as follows:

<xml> <advancedsettings>

   <setting>value</setting>
   ...
   <setting>value</setting>

</advancedsettings> </xml>

where "setting" gives the name of the setting, and "value" gives it's value.

A list of the available "setting" strings and their values is given below.

2 List of available settings

2.1 <loglevel>

The logging level that XBMC will use to log errors and information. Available values are:

  • -1 No logging, suppresses all log output.
  • 0 Normal logging, only logging errors (Default)
  • 1 Debug logging.
  • 2 Debug logging with freemem, fps and cpu usage shown on screen.
  • 3 Debug logging with freemem, fps and cpu usage and full smb logging.

2.2 <cddbaddress>

The address of the online CDDb database. You may set this to another freedb mirror if there is a more suitable one. Defaults to freedb.freedb.org

2.3 <nodvdrom>

Set to true if you have no DVD-ROM drive in your XBox, or if it's broken. Defaults to false.

2.4 <usepcdvdrom>

Set to true if you have replaced the XBox DVD-ROM drive with a standard PC DVD-ROM. Expect performance to be somewhat variable. Defaults to false.
removed for non XBox builds with r14123.

2.5 <detectasudf>

Set to true if you wish to detect joint ISO9660/UDF disks as UDF. Defaults to false.

2.6 <disablemodchipdetection>

Set to true to disable modchip detection. This is required for X2 chips to launch XBEs.

2.7 <cachepath>

Set to the path on the XBox Harddisk that XBMC should use for when it caches files (such as when caching subtitles or for unzipping or unrarring). Defaults to Z:\

2.8 <virtualshares>

Set to false to disable virtual shares like plugins, last.fm or shoutcast sources. Defaults to true.

2.9 <pictureextensions>

A list of additional file-extensions to allow (add) or exclude (remove) in the My Pictures window.

These are the current default extensions for PICTURES:

.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .zip .cbr .rar .m3u

<xml> <pictureextensions>

 <add>.ex1|.ex2</add>
 <remove>.ex3|.ex4</remove>

</pictureextensions> </xml>

2.10 <musicextensions>

A list of additional file-extensions to allow (add) or exclude (remove) in the My Music windows.

These are the current default extensions for MUSIC:

.nsv .m4a .flac .aac .strm .pls .rm .mpa .wav .wma .ogg .mp3 .mp2 .m3u .mod .amf .669 .dmf .dsm .far .gdm .imf .it .m15 .med .okt .s3m .stm .sfx .ult .uni .xm .sid .ac3 .dts .cue .aif .aiff .wpl .ape .mac .mpc .mp+ .mpp .shn .zip .rar .wv .nsf .spc .gym .adplug .adx .dsp .adp .ymf .ast .afc .hps .xsp

<xml> <musicextensions>

 <add>.ex1|.ex2</add>
 <remove>.ex3|.ex4</remove>

</musicextensions> </xml>

2.11 <videoextensions>

A list of additional file-extensions to allow (add) or exclude (remove) in the My Video windows.

These are the current default extensions for VIDEOS:

.m4v .3gp .nsv .ts .ty .strm .rm .rmvb .m3u .ifo .mov .qt .divx .xvid .bivx .vob .nrg .img .iso .pva .wmv .asf .asx .ogm .m2v .avi .bin .dat .dvr-ms .mpg .mpeg .mp4 .mkv .avc .vp3 .svq3 .nuv .viv .dv .fli .flv .rar .001 .wpl .zip

<xml> <videoextensions>

 <add>.ex1|.ex2</add>
 <remove>.ex3|.ex4</remove>

</videoextensions> </xml>

2.12 <languagecodes>

Translation table for subtitle and audio names. Contains entries of the form

<xml>

   <short>alt</short><long>Alternate</long>

</xml>

2.13 <sorttokens>

Allows you to specify additional tokens that will be ignored at the start of lines during sorting. <xml>

 <sorttokens>
   <token>the</token>
 </sorttokens>

</xml>

2.14 <samba>

<xml> <samba>

  <doscodepage></doscodepage>  
  <clienttimeout>10</clienttimeout>  
  <nostat>false</nostat>  

</samba> </xml>

2.15 <moviestacking>

This tag used to be called <videostacking>.
Contains regular expressions for use in matching filenames in a "stack" of video files. The regular expression must have a (...) surrounding the volume label portion. Text matching is compared case-insensitive. Anything matched by the regular expression will be removed from the titlename. If more than one (...) section is used, the first one will be the prefix, the second one the volume label, and the third one (if it exists) will be the suffix. Use this to keep extensions after matching. If more than one expression matches a particular filename, the first one will be used.

Default stacking: <xml>

 <moviestacking>
   <regexp>[ _\.-]+cd[ _\.-]*([0-9a-d]+)</regexp>
   <regexp>[ _\.-]+dvd[ _\.-]*([0-9a-d]+)</regexp>
   <regexp>[ _\.-]+part[ _\.-]*([0-9a-d]+)</regexp>
   <regexp>[ _\.-]+dis[ck][ _\.-]*([0-9a-d]+)</regexp>
   <regexp>()[ _\.-]+([0-9]*[abcd]+)(\.....?)$</regexp>
   <regexp>([a-z])([0-9]+)(\.....?)$</regexp>
   <regexp>()([ab])(\.....?)$</regexp>
 </moviestacking>

</xml>

If the argument action="append" or append="yes" is supplied, the default videostacking regular expressions will remain intact and the user specified ones will be added to the end. Example: <xml>

 <moviestacking action="append">
   <regexp>custom[ _\.-]*([0-9a-d]+)</regexp>
 </moviestacking>

</xml>


If the argument action="prepend" is supplied, the default videostacking regular expressions will remain intact and the user specified ones will be added to the beginning. Example: <xml>

 <moviestacking action="prepend">
   <regexp>custom[ _\.-]*([0-9a-d]+)</regexp>
 </moviestacking>

</xml>

If no argument is supplied, or the argument append="no" is supplied, the default videostacking regular expressions are overwritten by the user specified ones.

2.16 <tvshowmatching>

Contains regular expression to match the season and episode numbers in filenames.

Default stacking:

<xml>

 <tvshowmatching>
   <regexp>\[[Ss]([0-9]+)\]_\[[Ee]([0-9]+)([^\\/]*)</regexp>  
   <regexp>[\._ \-]([0-9]+)x([0-9]+)([^\\/]*)</regexp>  
   <regexp>[\._ \-][Ss]([0-9]+)[\.\-]?[Ee]([0-9]+)([^\\/]*)</regexp>  
   <regexp>[\._ \-]([0-9]+)([0-9][0-9])([\._ \-][^\\/]*)</regexp>  
 </tvshowmatching>

</xml>

The "append" and "action" arguments described in the videostacking section work the same for tvshowmatching tags. Examples of matching regexps for certain filenames can be found on the TV_Shows page.

NOTE: for multi-episode matching to work, there needs to be a third set of parentheses on the end. This part is fed back into the regexp engine.

2.17 <excludefromscan>

Contains regular expressions to match filenames which should be excluded from a library scan.

Default stacking:

<xml>

 <excludefromscan>
   <regexp>[-\._ ](sample|trailer)[-\._ ]</regexp>
 </excludefromscan>

</xml>

The "append" and "action" arguments described in the videostacking section work the same for excludefromscan tags.

2.18 <pathsubstitution>

Path substitutions for use with playlist loading. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for XBMC to handle. Default is no path substitutions defined. An example is:

<xml>

 <pathsubstitution>
   <substitute>
     <from>G:\dvds\</from>
     <to>smb://somecomputer/g-share/dvds/</to>
   </substitute>
 </pathsubstitution>

</xml>

2.19 <forcedswaptime>

Use to force a backbuffer->frontbuffer swap while vsync is enabled. Set to the time (in ms) to allow for the swap (eg <forcedswaptime>1</forcedswaptime> is typical). It defaults off.

2.20 <playlistasfolders>

In the recent releases, playlists are treated as folders. Selecting a playlist no longer plays it, but opens it, as if it were a folder.
Set to false to revert to the previous behavior. When you select a playlist, its content is added to the list of elements to be played.
NOTE! This setting will not affect smart playlists, they will always show as folders.

2.21 <playlistretries>

The default number of retries if for example a source is offline is 100. With this control you can alter the number of consecutive failed items before a playlist fails.

<xml>

 <playlistretries>100</playlistretries>

</xml>

2.22 <playlisttimeout>

The default timeout before item failure is 20 sec. It can be changed with this control

<xml>

 <playlisttimeout>20</playlisttimeout> 

</xml>

2.23 <songinfoduration>

This controls how long the song information will remain onscreen when the song changes during visualisations. The valid range is 1 to 15, in seconds. This does not include the duration of any transition effects. (The default is 2 seconds.)

<xml>

 <songinfoduration>10</songinfoduration>

</xml>

2.24 <remoterepeat>

The repeat delay for the Infrared remote control, in milliseconds. Length of time a remote button needs to be held before it will start repeating (ie continuously sending button pushes while it's held down). Defaults to 480.

2.25 <controllerdeadzone>

Deadzone for controller thumb sticks. 0 indicates no deadzone at all. 1 indicates all deadzone (ie no movement will be detected). Defaults to 0.2

2.26 <displayremotecodes>

Set to true to have XBMC display the Infrared Remote's button codes (OBC's) on screen when you press buttons. Useful for assigning functions to the buttons on a universal remote control. Defaults to false.

2.27 <thumbsize>

Size of the square in pixels that XBMC will use to cache thumbnail images. If the thumb is smaller than this size it will be cached as-is. If it is larger it will be scaled so that the number of pixels is less than a square of this value. Default is 512 (192 on xbox), which refers to 512x512 = 262144 (for XBox 192x192 = 36864) pixels in total. The thumbnail will be cached at using the same aspect ratio as the original image, using up to 262144 (for XBox 36864) pixels.

2.28 <musicthumbs>

A list of additional files to try when searching for music thumbnail images. (The default is folder.jpg which can be removed.)

<xml> <musicthumbs>

 <remove>folder.jpg</remove>
 <add>thumb.jpg|cover.jpg</add>

</musicthumbs> </xml>

2.29 <musicfilenamefilters>

Contains filters to match music information (artist, title etc.) from a tagless music filename. The first <filter> to match completely is used. Matched items include:

%A - Artist %T - Title %B - Album %N - Track number %S - Part of set (disk number) %D - Duration %G - Genre %Y - Year %R - Rating

<xml>

 <musicfilenamefilters>
   <filter>%A - %T</filter>
 </musicfilenamefilters>

</xml>

2.30 <dvdthumbs>

A list of additional files to try when searching for dvdrom thumbnail images. (The default is folder.jpg which can be removed.)

<xml> <dvdthumbs>

 <remove>folder.jpg</remove>
 <add>thumb.jpg|cover.jpg</add>

</dvdthumbs> </xml>

2.31 <masterlock>

If you enable any masterlock settings below, they will be removed from UI. Code needs to be MD5'd, and you can use this site to hash it.

<xml>

<masterlock>

  <startuplock>false</startuplock>  
  <enableshutdown>false</enableshutdown>  
  <automastermode>false</automastermode>  
  <loginlock>true</loginlock>  
  <maxretries>3<maxretries> 

</masterlock> </xml>

2.32 <postprocessing>

MPlayer postprocessing settings. This is unreliable, and so they're in here only.

<xml>

 <postprocessing>
   <enable>false</enable>  
   <auto>true</auto>  
   <verticaldeblocking>false</verticaldeblocking>  
   <verticaldeblocklevel>0</verticaldeblocklevel>  
   <horizontaldeblocking>false</horizontaldeblocking>  
   <horizontaldeblocklevel>0</horizontaldeblocklevel>  
   <autobrightnesscontrastlevels>false</autobrightnesscontrastlevels>  
   <dering>false</dering>  
 </postprocessing>

</xml>

2.33 <audio>

<xml> <audio>

 <headroom>0</headroom>
 <karaokesyncdelay>0</karaokesyncdelay>  
 <defaultplayer>paplayer</defaultplayer>

</audio> </xml>

2.34 <video>

<xml> <video>

 <subsdelayrange>10</subsdelayrange>  
 <audiodelayrange>10</audiodelayrange>  
 <smallstepbackseconds>7</smallstepbackseconds>  
 <smallstepbacktries>3</smallstepbacktries>
 <smallstepbackdelay>300</smallstepbackdelay>
 <usetimeseeking>true</usetimeseeking>  
 <timeseekforward>30</timeseekforward>  
 <timeseekbackward>-30</timeseekbackward>  
 <timeseekforwardbig>600</timeseekforwardbig>  
 <timeseekbackwardbig>-600</timeseekbackwardbig>  
 <percentseekforward>2</percentseekforward>  
 <percentseekbackward>-2</percentseekbackward>  
 <percentseekforwardbig>10</percentseekforwardbig>  
 <percentseekbackwardbig>-10</percentseekbackwardbig>  
 <blackbarcolour>1</blackbarcolour>  
 <fullscreenonmoviestart>true</fullscreenonmoviestart> 
 <defaultplayer>dvdplayer</defaultplayer> 

</video> </xml>

2.35 <musiclibrary>

Options specific to the Music Library

<xml>

 <musiclibrary>
   <hideallitems>true</hideallitems> 
   <allitemsonbottom>true</allitemsonbottom> 
   <hidecompilationartists>true</hidecompilationartists>
   <albumssortbyartistthenyear>true</albumssortbyartistthenyear>
   <albumformat>%B - %Y</albumformat>  
   <albumformatright>%A</albumformatright>  
   <prioritiseapetags>true</prioritiseapetags>  
   <itemseparator> / </itemseparator>
 </musiclibrary>

</xml>

2.36 <videolibrary>

Options specific to the Video Library

<xml>

 <videolibrary>
   <allitemsonbottom>true</allitemsonbottom>  
   <backgroundupdate>true</backgroundupdate> 
   <cleanonupdate>true</cleanonupdate>  
   <hideallitems>true</hideallitems>  
   <hideemptyseries>true</hideemptyseries>  
   <hiderecentlyaddeditems>true</hiderecentlyaddeditems>  
   <itemseparator> / </itemseparator>  
 </videolibrary>

</xml>

2.37 <slideshow>

<xml> <slideshow>

 <panamount>2.5</panamount>
 <zoomamount>5.0</zoomamount>
 <blackbarcompensation>20</blackbarcompensation>  

</slideshow> </xml>

2.38 <lcd>

<xml> <lcd>

 <rows>4</rows>               
 <columns>20</columns>        
 <address1>0</address1>       
 <address2>20</address2>      
 <address3>64</address3>      
 <address4>84</address4>      
 <heartbeat>true</heartbeat>  
 <scrolldelay>2</scrolldelay>  

</lcd> </xml>

2.39 <network>

<xml> <network>

 <autodetectpingtime>30</autodetectpingtime>  
 <curlclienttimeout>10</curlclienttimeout>  
 <httpproxyusername></httpproxyusername>  
 <httpproxypassword></httpproxypassword>  

</network> </xml>

2.40 <tuxbox>

<xml>

<tuxbox>
   <audiochannelselection>false</audiochannelselection>
   <submenuselection>false</submenuselection>
   <defaultrootmenu>0</defaultrootmenu>
   <defaultsubmenu>4</defaultsubmenu>
   <pictureicon>true</pictureicon>
   <epgrequesttime>10</epgrequesttime>
   <zapwaittime>0</zapwaittime>  
 </tuxbox>

</xml>

2.41 <playcountminimumpercent>

Video: Minimum percentage that has to be played before it is marked as watched.

Music: Minimum percentage that has to be played before it is considered for incrementing in the Top 100 database view, or for last.fm submittal.

2.42 <ftpshowcache>

default is false, if set to true, shows cache (X Y Z) partitions in the root directory listing

2.43 <screensaver>

To avoid potential worries of plasma screen burn-in, you can set the Dim screensaver fade level to 0% here or in the Settings. <xml> <screensaver>

 <dimlevel>0</dimlevel>  

</screensaver> </xml>

2.44 <busydialogdelay>

Set the delay in milliseconds before the busydialog pops up (default 2000). <xml> <busydialogdelay>2000</busydialogdelay> </xml>

2.45 <rootovershoot>

Disable root overshooting aka evil B(tm) navigation. 'Evil B' navigation refers to the 'previous folder' action returning to the parent window from the root location of a media window. Sometimes a user would just want to repeatedly hit the B button to reach the root location without worrying of overshooting to the previous window. For this you should disable evil b by setting this value to false. <xml> <rootovershoot>false</rootovershoot> </xml>

2.46 <hosts>

Static dns entries which take precedence over your dns server. <xml> <hosts>

 <entry name="HOSTNAME">IPADDRESS</entry>

</hosts> </xml>

2.47 <fullscreen>

Starts XBMC in full screen (check resolutions!). The same as starting XBMC with -fs.

<xml> <fullscreen>false</fullscreen> </xml>

3 How to include GUI settings

You can also define the settings normally defined in the GUI in advancedsettings.xml. Any GUI based settings defined in advancedsettings.xml will override the GUI values, and the settings will be removed completely from the GUI (ie only alterable by editting advancedsettings.xml).

The easiest way to include a GUI setting is to first make sure it is set in the GUI to the value that you want, and then to open the UserData\guisettings.xml file and find the XML entry that corresponds to that setting.

Then just add that entry to the advancedsettings.xml file.

For instance, to set the Font Character Set for the GUI (found in the appearance setting, in the Look and Feel section), you'd open up guisettings.xml and find:

<xml>

 <lookandfeel>
   <charset>Hebrew (Windows)</charset>
 </lookandfeel>

</xml>

Simply take that entry and place it in advancedsettings.xml. The GUI entry for the character set will then no longer appear, and XBMC will always use the Hebrew (Windows) character set.


Here are some special cases, if they aren't defined the user will be prompted first time he/she tries to access any of these paths:
Note: There are no default pre-set values

3.1 <trainerpath>

<xml> <myprograms>

   <trainerpath>Q:\system\trainers</trainerpath> 

</myprograms> </xml>

3.2 <recordingpath>

<xml> <mymusic>

   <recordingpath>E:\Recordings</recordingpath>

</mymusic> </xml>

3.3 <cddaripperpath>

<xml> <cddaripper>

   <path>E:\Recordings</path>

</cddaripper> </xml>

3.4 <playlistspath>

<xml> <system>

   <playlistspath>E:\Playlists</playlistspath>

</system> </xml>

3.5 <screenshotpath>

<xml> <pictures>

 <screenshotpath>E:\Screenshots</screenshotpath>

</pictures> </xml>

Personal tools
Namespaces

Variants
Actions
Navigation
Wiki help
Toolbox