Troubleshooting, Advancedsettings.xml

From XBMC
(Difference between pages)
Jump to: navigation, search
m (Lost control)
 
(<videostacking>)
 
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 "'''\XBMC\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. (The "'''\XBMC\UserData\'''" folder is located where you installed XBMC, so usually  under "E:\XBMC\UserData\", "F:\XBMC\UserData\", "E:\Apps\XBMC\UserData\" or "F:\Apps\XBMC\UserData\")
This provides more detailed info on what's going on, this is done like this: link
+
<br>
+
  
==Lost control==
+
:'''NOTE! This file will not exist unless created by the end-user, meaning YOU!'''
;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.
+
: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 <controllerdeadzone> in ''Advancedsettings.xml''.
+
<br>
+
  
==Audio related issues==
+
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 manualy 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.
;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!
+
==Layout==
: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 ?
+
<br>
+
  
 +
The layout of AdvancedSettings.xml is as follows:
  
==Video output issues / Issues with video playback==
+
<xml>
;I changed to another skin, and the screen went black. Now, whenever I boot XBMC it stays black and I can't do anything!
+
<advancedsettings>
: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).
+
    <setting>value</setting>
 +
    ...
 +
    <setting>value</setting>
 +
</advancedsettings>
 +
</xml>
  
;I use XBMC in 1080i, and when I try and watch videos it fails. What can I do?
+
where "setting" gives the name of the setting, and "value" gives it's value.
: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?
+
A list of the available "setting" strings and their values is given below.
: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 playback.  When 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.
+
  
;I can't seem to be able to select Widescreen/HDTV modes. How can I fix this?
 
: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.'''
 
<br>
 
  
 +
==List of available settings==
  
==XBMC won't start==
+
====<loglevel>====
;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?
+
The logging level that XBMC will use to log errors and information. Available values are:
: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!
+
*-1  No logging, supresses all log output.
;I try to launch XBMC from a dashboard and it does not start (freeze or black screen), why?
+
*0  Normal logging, only logging errors (Default)
: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.
+
*1  Debug logging.
<br>
+
*2  Debug logging with freemem shown on screen.
 +
*3  Debug logging with freemem and full smb logging.
  
 +
====<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
  
==XBMC won't play a file==
+
====<imdbaddress>====
;I got one or several AVI files that plays choppy and/or ends in the middle of playback, what could be the cause?
+
The address of the online IMDb database. You may set this to another of IMDb's servers for more localized results. Defaults to akas.imdb.com
: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>
+
  
 +
====<autodetectfg>====
 +
Set to false if you have an old bios that can't handle the auto-detection of the F and G partitions of the XBox Hard disk drive.  Defaults to true.
  
==Network performance issues (wired or wireless)==
+
<autodetectfg>False</autodetect>
'''Do you experince slow throughput/load-times when streaming video or audio over a wired or wireless-network?''' Here are some hints and tips that can aid wired and wireless performance issues:
+
  
===General (both wired and wireless) tips:===
+
====<usefdrive>====
*If your computers operating-system is windows based (like 95/98/ME/XP/2000/2003) then follow/perform this tweaks:
+
Set to true if you have an F partition. Only read if <autodetectfg> is set to false.
**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)].
+
<usefdrive>True</usefdrive>
  
*In windows make you you 'unmount' (or disable) all virtual cd/dvd-rom drives (ex. from daemon-tools, alcohol 120%, clonedvd/clonecd, etc.).  
+
====<usegdrive>====
 +
Set to true if you have a G partition. Only read if <autodetectfg> is set to false.
  
*During smb streaming troubleshooting you should of course also (temporarly) try disabling any antivirus and firewall softwares on your computer.
+
====<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.
  
===Wired specific tips:===
+
====<detectasudf>====
*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...).
+
Set to true if you wish to detect joint ISO9660/UDF disks as UDF. Defaults to false.
  
===Wireless specific tips:===
+
====<cachepath>====
* 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.
+
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:\
  
* Disable WEP/WPA encryption (as it increases overhead which lowers throughput), enable MAC-address filtering as security instead.
+
====<pictureextensions>====
 +
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Pictures window.
  
* 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.
+
These are the current default extensions for PICTURES:
  
* 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
+
.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .zip .cbr .rar .m3u
  
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.
+
<xml>
<br>
+
<pictureextensions>
 +
  <add>.ex1|.ex2</add>
 +
  <remove>.ex3|.ex4</remove>
 +
</pictureextensions>
 +
</xml>
  
==Annoyances==
+
====<musicextensions>====
;Where did the Record Button go?
+
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Music windows.
:It's in My Music OSD now
+
;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>
+
  
==Limitations==
+
These are the current default extensions for MUSIC:
*XBMC can currently not play any audio/video files protected/encrypted with Digital Rights Management (DRM), such as music purchased from [http://en.wikipedia.org/wiki/ITunes_Music_Store ITunes Music Store], [http://en.wikipedia.org/wiki/MSN_Music MSN Music] or [http://en.wikipedia.org/wiki/Audible.com Audible.com]. Workaround: Removed that DRM protection/encryption with some third-party software before you try to play it, like: [http://en.wikipedia.org/wiki/JHymn hymn (for iTunes DRM files)].
+
*XBMC only support [http://en.wikipedia.org/wiki/Universal_Disk_Format Universal Disk Format (UDF CD/DVD file-system)] version 1.02 (which was designed for [http://en.wikipedia.org/wiki/DVD-Video´DVD-Video] media), and that early version has a maximum file of 1GB (meaning if you burn a DVD-media in a newer UDF version with a video that is larger than 1GB then XBMC will not be able to play that file), same goes for UDF/ISO hybrid formats (a.k.a. UDF Bridge format). Workaround: Burn all your CD/DVD-media in ISO 9660 format which is the largest is standard anyway, (though ISO9660 has a 2GB file-size limitation that there is no workaround for).
+
*The Xbox built-in harddrive is formated in [http://en.wikipedia.org/wiki/FATX FATX] which has a 4GB file-size limitation, and only supports file/folder-names up to 42 characters, a maximum of 255 in total file-structure character-deept and a maximum number of 4096 files/folders in a single subfolder, plus in the root of each partition the maximum number of files/folders is 256. FATX does not either support all ACSII characters in file/folder names (like for example < > = ? : ; " * + , / \ | ¤ &). XBMC will automaticly rename any files/folders you transfer to the Xbox by these limitations. (None of these are XBMC issues that can be fixed as the limitation is in the Xbox itself). Workaround: Store your files/folders on your computer or a [http://en.wikipedia.org/wiki/Network-attached_storage Network-Attached Storage (NAS)] device/box and share them over a [[smb|local-area-network]] instead.
+
*With its 733Mhz Intel Pentium III and 64MB shared memory, the Xbox game-console does not have enough hardware-resources (not fast enough CPU nor large enough RAM-memory) to play 720p/1080i resolution-native HDTV video (at 1280x720 and 1920x1080 pixels), (like 720p/1080i [http://en.wikipedia.org/wiki/WMVHD WMV HD] or MPEG-2). Workaround: XBMC can however upconvert all 480p/576p standard-resolution movies and output them to 720p or 1080i HDTV resolutions in better quality than most (if not all) HDTV's native function to upconvert video.
+
* Again with its 733Mhz Intel Pentium III and 64MB shared memory, the Xbox does not have enough hardware-resources (not fast enough CPU nor large enough RAM-memory) to play [http://en.wikipedia.org/wiki/H264 MPEG-4 AVC (H.264)] encododed videos with [http://en.wikipedia.org/wiki/H.264#Profiles Cabac and Deblocking] if the video-resolution is higher than 352x288 pixels. Workaround: If you encode your MPEG-4 AVC (H.264) videos without Cabac and Deblocking then the Xbox hardware can handle up to 480x576 pixels video-resolution. Though best is to encode your videos to [http://en.wikipedia.org/wiki/MPEG-4 MPEG-4 ASP] (like [http://en.wikipedia.org/wiki/DivX DivX] or [http://en.wikipedia.org/wiki/XviD XviD]) instead, then the videos native-resolution can be up to 960x540 pixels (a.k.a. [http://en.wikipedia.org/wiki/Half_Resolution_High_Definition HRHD] resolution).
+
  
 +
.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
  
<br><br><br><br><br><br>
+
<xml>
 +
<musicextensions>
 +
  <add>.ex1|.ex2</add>
 +
  <remove>.ex3|.ex4</remove>
 +
</musicextensions>
 +
</xml>
 +
 
 +
====<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>
 +
 
 +
====<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)
 +
</samba>
 +
</xml>
 +
 
 +
====<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>
 +
  <videostacking>
 +
    <regexp>[ _\.-]+cd[ _\.-]*([0-9a-d]+)</regexp>
 +
    <regexp>[ _\.-]+dvd[ _\.-]*([0-9a-d]+)</regexp>
 +
    <regexp>[ _\.-]+part[ _\.-]*([0-9a-d]+)</regexp>
 +
    <regexp>()[ _\.-]+([0-9]*[abcd]+)(\....)$</regexp>
 +
    <regexp>()[\^ _\.-]+([0-9]+)(\....)$</regexp>
 +
    <regexp>([a-z])([0-9]+)(\....)$</regexp>
 +
    <regexp>()([ab])(\....)$</regexp>
 +
  </videostacking>
 +
</xml>
 +
 
 +
If the argument append="yes" is supplied all default videostackings will stay intact and the ones specified will be added to the end.
 +
<xml>
 +
  <videostacking append="yes">
 +
    <regexp>custom[ _\.-]*([0-9a-d]+)</regexp>
 +
  </videostacking>
 +
</xml>
 +
 
 +
====<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>
 +
    <twopart>
 +
        <regexp>\[[Ss]([0-9]*)\]_\[[Ee][0-9][0-9]\-([0-9]*)\][^\\/]*</regexp>
 +
        <regexp>[\._ \-][Ss]([0-9]*)[^0-9]*[Ee][0-9][0-9]\-([0-9]*)[^\\/]*</regexp>
 +
        <regexp>[\._ \-][0-9]*x[0-9]*[\._ \-]*([0-9]*)x([0-9]*)[^\\/]*</regexp>
 +
    </twopart>
 +
  </tvshowmatching>
 +
</xml>
 +
 
 +
The append="yes" argument works as in videostacking and is possible for the twopart and tvshowmatching 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>
 +
 
 +
====<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:<br>
 +
When you select a playlist, its content is added to the list of elements to be played.
 +
 
 +
====<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 to within this square.  Default is 192.
 +
 
 +
====<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>
 +
 
 +
====<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>#<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>
 +
  <headroom>0</headroom> # Amount of headroom XBMC should use above the maximum volume level, in decibels.  Defaults to 0, valid values 0, 6, 12.
 +
  <karaokesyncdelay>0</karaokesyncdelay> # Delay in sync to karaoke in seconds. Valid values are -3.0...3.0.
 +
</audio>
 +
</xml>
 +
 
 +
====<video>====
 +
 
 +
<xml>
 +
<video> # use "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.
 +
</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
 +
    <hidecompilationartists>true</hidecompilationartists> # only shows primary album artists when at the unfiltered artist listing
 +
    <albumssortbyartistthenyear>true</albumssortbyartistthenyear> # at an albums listing, when you sort by artist, secondary sort will be year.
 +
    <albumformat>%B - %Y</albumformat> # album label template, default is "%B"
 +
    <albumformatright>%A</albumformatright> # album label template for right column, default is "%A"
 +
  </musiclibrary>
 +
</xml>
 +
 
 +
====<videolibrary>====
 +
Options specific to the Video Library
 +
 
 +
<xml>
 +
  <videolibrary>
 +
    <hideallitems>true</hideallitems> # removes the "*All" items from the video library
 +
    <allitemsonbottom>true</allitemsonbottom> # sorts the "*All" items at the bottom of the list when  in Ascending order
 +
  </videolibrary>
 +
</xml>
 +
====<slideshow>====
 +
 
 +
<xml>
 +
<slideshow>
 +
  <panamount>2.5</panamount>  # Amount to pan images as a percentage of the screen
 +
  <zoomamount>5.0</zoomamount>  # Amount to zoom images as a percentage of the screen
 +
  <blackbarcompensation>20</blackbarcompensation>  # 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.
 +
</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.
 +
</lcd>
 +
</xml>
 +
 
 +
====<network>====
 +
 
 +
<xml>
 +
<network>
 +
  <autodetectpingtime>30</autodetectpingtime>  #Length in seconds between pinging the network to detect new xbox's.
 +
</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.
 +
 
 +
==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>
 +
 
 +
====<audio>====
 +
<xml>
 +
<audio>
 +
  <headroom>0</headroom>                # Headroom in dB to use on the master volume.  0, 6, or 12.
 +
  <karaokesyncdelay>0</karaokesyncdelay> # Delay in ms of displaying karoke.
 +
</audio>
 +
</xml>
 +
 
 +
====<slideshow>====
 +
<xml>
 +
<slideshow>
 +
  <panamount>2.5</panamount>            # percentage to pan images during slideshow
 +
  <zoomamount>5</zoomamount>            # percentage to zoom images during slideshow
 +
  <blackbarcompensation>20</blackbarcompensation> # percentage difference from the screen aspect ratio that will cause images to zoom to eliminate black bars.
 +
</slideshow>
 +
</xml>
 +
[[category:Settings]]

Revision as of 19:59, 14 March 2007

The "AdvancedSettings.xml" file, which does not exist by default, may be created by a user in their "\XBMC\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. (The "\XBMC\UserData\" folder is located where you installed XBMC, so usually under "E:\XBMC\UserData\", "F:\XBMC\UserData\", "E:\Apps\XBMC\UserData\" or "F:\Apps\XBMC\UserData\")

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 manualy 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.

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, supresses all log output.
  • 0 Normal logging, only logging errors (Default)
  • 1 Debug logging.
  • 2 Debug logging with freemem shown on screen.
  • 3 Debug logging with freemem 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 <imdbaddress>

The address of the online IMDb database. You may set this to another of IMDb's servers for more localized results. Defaults to akas.imdb.com

2.4 <autodetectfg>

Set to false if you have an old bios that can't handle the auto-detection of the F and G partitions of the XBox Hard disk drive. Defaults to true.

<autodetectfg>False</autodetect>

2.5 <usefdrive>

Set to true if you have an F partition. Only read if <autodetectfg> is set to false.

<usefdrive>True</usefdrive>

2.6 <usegdrive>

Set to true if you have a G partition. Only read if <autodetectfg> is set to false.

2.7 <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.

2.8 <detectasudf>

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

2.9 <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.10 <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.11 <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.12 <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.13 <languagecodes>

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

<xml>

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

</xml>

2.14 <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.15 <samba>

<xml> <samba>

  <doscodepage></doscodepage> # code page to use for filenames
  <clienttimeout>10</clienttimeout> # timeout (in seconds)

</samba> </xml>

2.16 <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>

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

</xml>

If the argument append="yes" is supplied all default videostackings will stay intact and the ones specified will be added to the end. <xml>

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

</xml>

2.17 <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>
   <twopart>
       <regexp>\[[Ss]([0-9]*)\]_\[[Ee][0-9][0-9]\-([0-9]*)\][^\\/]*</regexp>
       <regexp>[\._ \-][Ss]([0-9]*)[^0-9]*[Ee][0-9][0-9]\-([0-9]*)[^\\/]*</regexp>
       <regexp>[\._ \-][0-9]*x[0-9]*[\._ \-]*([0-9]*)x([0-9]*)[^\\/]*</regexp>
   </twopart>
 </tvshowmatching>

</xml>

The append="yes" argument works as in videostacking and is possible for the twopart and tvshowmatching 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 <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.

2.20 <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.21 <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.22 <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.23 <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.24 <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 to within this square. Default is 192.

2.25 <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.26 <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.27 <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> # 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>#<maxretries> enter the max number of retries to input code, 3 is default.

</masterlock> </xml>

2.28 <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>

2.29 <audio>

<xml> <audio>

 <headroom>0</headroom> # Amount of headroom XBMC should use above the maximum volume level, in decibels.  Defaults to 0, valid values 0, 6, 12.
 <karaokesyncdelay>0</karaokesyncdelay> # Delay in sync to karaoke in seconds. Valid values are -3.0...3.0.

</audio> </xml>

2.30 <video>

<xml> <video> # use "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.

</video> # use "VideoSettings" instead of "video" for builds prior to May 22, 2006 </xml>

2.31 <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
   <hidecompilationartists>true</hidecompilationartists> # only shows primary album artists when at the unfiltered artist listing
   <albumssortbyartistthenyear>true</albumssortbyartistthenyear> # at an albums listing, when you sort by artist, secondary sort will be year.
   <albumformat>%B - %Y</albumformat> # album label template, default is "%B"
   <albumformatright>%A</albumformatright> # album label template for right column, default is "%A"
 </musiclibrary>

</xml>

2.32 <videolibrary>

Options specific to the Video Library

<xml>

 <videolibrary>
   <hideallitems>true</hideallitems> # removes the "*All" items from the video library
   <allitemsonbottom>true</allitemsonbottom> # sorts the "*All" items at the bottom of the list when  in Ascending order
 </videolibrary>

</xml>

2.33 <slideshow>

<xml> <slideshow>

 <panamount>2.5</panamount>  # Amount to pan images as a percentage of the screen
 <zoomamount>5.0</zoomamount>  # Amount to zoom images as a percentage of the screen
 <blackbarcompensation>20</blackbarcompensation>  # 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.

</slideshow> </xml>

2.34 <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.

</lcd> </xml>

2.35 <network>

<xml> <network>

 <autodetectpingtime>30</autodetectpingtime>  #Length in seconds between pinging the network to detect new xbox's.

</network> </xml>

2.36 <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.37 <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.

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>

3.6 <audio>

<xml> <audio>

 <headroom>0</headroom>                 # Headroom in dB to use on the master volume.  0, 6, or 12.
 <karaokesyncdelay>0</karaokesyncdelay> # Delay in ms of displaying karoke.

</audio> </xml>

3.7 <slideshow>

<xml> <slideshow>

 <panamount>2.5</panamount>             # percentage to pan images during slideshow
 <zoomamount>5</zoomamount>             # percentage to zoom images during slideshow
 <blackbarcompensation>20</blackbarcompensation> # percentage difference from the screen aspect ratio that will cause images to zoom to eliminate black bars.

</slideshow> </xml>

Personal tools
Namespaces

Variants
Actions
Navigation
Wiki help
Toolbox