Advanced Configuration (config.xml)

NextPVR stores most of its configuration settings in a config.xml file which can be found in the data directory. Advanced users can open the file in notepad to tweak the configuration, and to access settings that aren't available from the Settings dialog.

Incorrectly editing the config.xml file could cause NextPVR to crash or not even start. Make a backup first, and ensure any changes are made while NextPVR is not running.

Below are a number of values that may be useful for some users, especially those with * next to their title as these are not configurable using the Settings dialog.

Skin

Skin

Refers to the Active Skin setting from the General Settings tab.

Version

OnlineVersionCheck

Refers to the Check online for new versions at startup setting from the About tab.

CurrentVersion*

Stores the current version number of NextPVR. Some plugins may read and use this value and it should never be changed manually.

Default value (text): <depends on installed version>

OnlineVersionCheckURL*

Stores the URI of the file holding information that can be used to determine if a new version is available or not.

Default value (text, uri): http://www.gbpvr.com/version.xml

LastNotifiedVersion*

TODO:

LastChecked*

TBC: Stores the number of days that have passed since the last check for an updated version was carried out.

Default value (integer, number of days): 0

DaysBetweenChecks*

Stores the number of days that must pass before another check for an updated version will be made. TBC: If set to 0, then a check will be made every time NextPVR is launched.

Default value (integer, number of days): 0

General

PvrMode

Refers to the UI Mode setting from the General Settings tab.

Language

Refers to the Language setting from the General Settings tab.

StartFullscreen

Refers to the Start in fullscreen mode setting from the General Settings tab.

StartOnSecondMonitor

Refers to the Start on secondary monitor setting from the General Settings tab.

UiResolution

Refers to the UI Resolution setting from the General Settings tab.

EnableAnimation

Refers to the Enable Animation setting from the General Settings tab.

ContextMenuOnRightMouseButton

Refers to the Context Menu on right mouse button setting from the General Settings tab.

LastXmltvFile*

Stores the path to the last xmltv file that was accessed via the Settings dialog.

Default value (text, file path): C:\Temp\TVGUIDE.xml

SchedulesDirectDays*

Stores the number of days worth of guide data that will be retrieved from the Schedules Direct service.

Default value (integer, number of days): 8

SchedulesDirectUsername

Refers to the Schedules Direct Username setting visible on the channel mapping screen.

SchedulesDirectPassword

Refers to the Schedules Direct Password setting visible on the channel mapping screen.

VisibleGuideMinutes

Refers to the TV Guide Minutes setting from the General Settings tab.

DeleteAdditionalExtensions*

TBC: Stores a list of file extensions that will be used to determine what additional files (if any) will be deleted whenever a recording is removed from disk.

Default value (text, comma-separated list of extensions): srt,txt,log,d2a,edl,csv,bat,wme,vprj,logo.txt,dvbsub,sm

Zoom

Refers to the UI Zoom Percent setting from the General Settings tab.

OffsetX

Refers to the Offset X setting from the General Settings tab.

OffsetY

Refers to the Offset Y setting from the General Settings tab.

ScanCollectionMS*

TODO:

Default value (integer, time in milliseconds): 5000

ScheduleWakeups*

TBC: If true, NextPVR will request Windows to wake from sleep or hibernate power states in order to record scheduled EPG events.

Default value (boolean): true

WakeupPreRecordingSeconds*

The number of seconds that the system would wake before a recording happens.

Default value (integer, time in seconds): 90

LastChannel*

Stores the channel number of the last channel viewed using Live TV.

Default value (integer, channel number): 0

WaitForVSync

Refers to the Animations wait for VSync setting from the General Settings tab.

AutoCombineChannels*

TODO:

EPGUpdateHour

Refers to the EPG Update Hour setting from the General Settings tab.

OldStyleTimeLine*

TODO: Some details in this thread.

Default value (boolean): false

AutoShufflePlaylist*

TODO:

HDPVRBufferLonger*

TODO:

AutoSkip*

TODO:

HideRadioInTVGuide

Refers to the Hide DVB/ATSC radio channels in TV Guide setting from the General Settings tab.

Culture*

TODO:

SlideshowDelay*

Stores the time (in milliseconds) that a picture will remain on screen for before moving on to the next image when viewing an image slideshow.

Default value (integer, time in milliseconds): 5000

ForceMpgGraph*

TBC: If true, specifies that DirectShow will be used to give a default graph for .mpg files.

Default value (boolean): true

LanguagePreference1*

TODO:

LanguagePreference2*

TODO:

EPGScanSeconds*

TODO:

EPGLiveTVUpdates

Refers to the Update DVB EPG during live tv setting from the Misc Settings tab.

PreResumeDelay*

TODO:

AutoQueueAudioTracks

Refers to the Music Library, auto queue all remaining directory files setting from the Misc Settings tab.

QueueAudioTracksInsteadOfReplace

Refers to the Music Library, queue new tracks instead of replace setting from the Misc Settings tab.

LogTranslations*

TODO:

Default value (boolean): false

ResumeStartupDelay*

TODO:

Default value (integer, time in milliseconds): 0

ChannelSelectorPinned*

TODO:

Default value (boolean): true

ChannelSelectorPos*

TODO:

StartupActivity

Refers to the Default Activity setting from the Misc Settings tab.

DumpSchedulesDirectData*

TODO:

Default value (boolean): false

PreferredMenuStyle

Refers to the Preferred Style setting from the General Settings tab.

ComskipStartOffset*

TODO:

ComskipEndOffset*

TODO:

PromptForResumeVideoLibrary

Refers to the Prompt for Resume in Video Library setting from the Misc2 Settings tab.

PromptForResumeDVD

Refers to the Prompt for Resume in DVD Playback setting from the Misc2 Settings tab.

ReversePriorityForLiveTV

Refers to the Use Reverse Priority for Live TV setting from the Devices Settings tab.

OSDTimeoutInfo*

Stores the time (in milliseconds) that the on-screen information popup will remain visible for.

Default value (integer, time in milliseconds): 4000

OSDTimeoutInfoOnPause*

Stores the time (in milliseconds) that the on-screen information popup will remain visible for when video playback is paused.

Default value (integer, time in milliseconds): 4000

OSDTimeoutStatus*

TODO:

Default value (integer, time in milliseconds): 4000

OSDTimeoutTimeline*

Stores the time (in milliseconds) that the on-screen timeline bar popup will remain visible for.

Default value (integer, time in milliseconds): 4000

HandleMCERemoteEvents

Refers to the Handle MCE Remote events setting from the Misc2 Settings tab.

AlwaysShowNowNextDetails*

If true, causes the EPG details for the current programme to appear at the top of the screen when you quick-browse channels in Live TV with Up/Down. If false, then the details only appear after pressing Alt+B.

Default value (boolean): false

ScreenSaver

ActiveScreenSaver

Refers to the Screen Saver setting from the Misc Settings tab.

InactivityMinutes

Refers to the Inactivity Minutes setting from the Misc Settings tab.

AspectRatio

TVShape

Refers to the TV Shape setting from the General Settings tab.

DefaultBehaviour

Refers to the Default Mode setting from the Misc Settings tab.

AspectRatioModes*

TBC: For each of the defined aspect ratios (4:3, 16:9, 16:10) there are a set of modes that define how the image will be manipulated to fit on screen. Each mode has a name, and a set of four values defined in the order: top-left-x, top-left-y, bottom-right-x, bottom-right-y. The values relate to the distance - either positivily or negativily - that the video should be adjusted in relation to the screen (0=0%, 1=100%). More needed...

Recording

AllowInProcessRecording*

TODO:

Default value (boolean): true

ForceRecordingServiceUse*

TODO:

Default value (boolean): true

ClientMode

Refers to the Act as client PC setting from the Devices Settings tab.

ServerName

Refers to the Server Name setting from the Devices Settings tab.

ServerPort*

Stores the port number that will be used for communication with clients. This port must be open and accessible and not blocked by any software firewalls.

Default value (integer, port number): 7969

DatabaseShare

Refers to the Database Share setting from the Devices Settings tab.

AutoCreateFolders*

Determines whether NextPVR will create a folder for each recording group under the recordings directory.

Default value (boolean): true

NewStyle*

TODO:

Default value (boolean): true

WhatsNewDays

Refers to the Whats New Days setting from the Recording Settings tab.

DefaultView

Refers to the Initial Recording List setting from the Recording Settings tab.

UseHigherPriority*

If true, specifies that the background recording service (NRecord.exe) will run at "Above Normal" priority rather than "Normal".

Default value (boolean): false

UseRecordingService*

Set whether to use the external NextPVR Recording Service to manage scheduled recordings and any configured clients. It is recommended to leave this option ticked as without it, NextPVR will only record TV shows while it is running. If you are not interested in recording TV shows, then you might like to un-tick this and also disable the NextPVR Recording Service to save PC resources.

Default value (boolean): false

PrePadding

Refers to the Pre-Padding Mins setting from the Recording Settings tab.

PostPadding

Refers to the Post-Padding Mins setting from the Recording Settings tab.

RecordingDirectory

Refers to the Recording Directory setting from the Recording Settings tab.

LiveTVBufferDirectory

Stores the path that will be used to buffer the Live TV stream to disk. Note that NextPVR is always recording, even when just watching Live TV, which allows for instant pausing or rewinding. Refers to the Buffer Directory in the Misc Settings tab.

Default value (text, file path): C:\Temp\

AutoRemoveMissingRecordings*

If true, specifies that information on recordings should be automatically removed from the database if the source video files can no longer be found.

Default value (boolean): true

CheckForRenamedRecordings*

TODO:

Default value (boolean): true

NoRemoveWhenTreeMissing*

TODO:

Default value (boolean): true

TimeSlotMinutes*

TBC: Stores the timeslot size (in minutes) that the recording engine uses to determine whether a programme is within allowed limits for a recurring timeslotted recording. For example, if a recording was scheduled to take place daily at 5pm, and the timeslot value was set at 90 minutes, then all matching programmes starting between 3.30pm and 6.30pm would be recorded.

Default value (integer, time in minutes): 90

ConfirmOnDelete*

TODO:

Default value (boolean): true

KeepDigitalGraphsContructed

Refers to the Keep digital graphs constructed setting from the Misc Settings tab.

StoreSeparateMetadataXml*

If true, metadata about recordings will be stored in a separate file (alongside the original recording) rather than as an alternative data stream (ADS) associated with the file itself (which requires an NTFS filesystem).

Default value (boolean): false

RecurringMatch

Refers to the Recurring Match setting from the Recording Settings tab.

WebServer

Enabled

Refers to the Enable web server setting from the MVP & Web Settings tab.

Port

Refers to the Web server port setting from the MVP & Web Settings tab.

Username

Refers to the Username setting from the MVP & Web Settings tab.

Password

Refers to the Password setting from the MVP & Web Settings tab.

AllowRemoteTranscode*

TODO:

Default value (boolean): false

Playback

VolumeControl*

TODO:

SkipForwardSeconds*

Stores how long (in seconds) a skip forward event (Ctrl+Right Arrow) will jump through a recording/video.

Default value (integer, time in seconds): 60

SkipBackSeconds*

Stores how long (in seconds) a skip back event (Ctrl+Left Arrow) will jump through a recording/video.

Default value (integer, time in seconds): 30

SkipFFSeconds*

Stores how long (in seconds) a fast forward event (Ctrl+F) will jump through a recording/video.

Default value (integer, time in seconds): 10

SkipRWSeconds*

Stores how long (in seconds) a rewind event (Ctrl+F) will jump through a recording/video.

Default value (integer, time in seconds): 10

PrePlayDelay*

TODO:

Default value (integer, time in milliseonds): 500

DVDDrive

Refers to the Drive setting from the DVD Settings tab.

DaemonToolsExe

Refers to the Daemon Tools .exe setting from the DVD Settings tab.

DaemonToolsDrive

Refers to the Daemon Tools Drive setting from the DVD Settings tab.

DaemonToolsDelay*

Stores how long (in milliseconds) NextPVR will wait between asking Daemon Tools to mount an ISO and then attempting playback from it.

Default value (integer, time in milliseconds): 3500

Subtitles

PreferredLanguage*

Stores the preferred language to display subtitles in when more than one locale is available.

Default value (text): eng

MVP

Dongle*

TODO:

Default value (type): dongle.bin

AutostartServers*

TODO:

Default value (type): 0

ShowServerUI*

TODO:

Default value (boolean): false

TranscodeTsForMVP*

TODO:

Default value (boolean): true

EnableOSDGraphics

Refers to the Enable OSD Graphics setting from the MVP & Web Settings tab.

ExtendedLogging*

TODO:

Default value (boolean): false

StartPortControl*

TODO:

Default value (integer, port number): 5906

StartPortMedia*

TODO:

Default value (integer, port number): 8337

AllowedMediaExtensions*

TODO:

Default value (text, regex): ^.+\.(mpeg|mpg|m2v|avi|mp4|mov|m2ts|wmv|iso|rm|dvr-ms|ts|mkv|vob|divx|flvm4v|wtv|mp3|ogg|m3u|wma|aac|wav|m4a|fla|flac)$

MVPSpecificSettings*

TODO:

Renderers

VideoRenderer

Refers to the Video Renderer setting from the Decoders Settings tab.

AudioRenderer

Refers to the Audio Renderer setting from the Decoders Settings tab.

DVDVideoRenderer

Refers to the Video Renderer setting from the DVD Settings tab.

DVDAudioRenderer

Refers to the Audio Renderer setting from the DVD Settings tab.

AlternateOSDForMissingVideo

Refers to the Use alternate OSD with missing video setting from the Misc2 tab.

Decoders

DecoderH264

Refers to the H.264 Video setting from the Decoders Settings tab.

DecoderMPEG2

Refers to the MPEG2 Video setting from the Decoders Settings tab.

OnlyIncludeMappedAudioDecodersForTS

Refers to the Only use mapped audio decoders during .ts playback setting from the Decoders Settings tab.

DecoderAC3

Refers to the AC3 Audio setting from the Decoders Settings tab.

DecoderEAC3

Refers to the E-AC3 Audio setting from the Decoders Settings tab.

DecoderAAC

Refers to the AAC Audio setting from the Decoders Settings tab.

DecoderHEAAC

Refers to the HE-AAC Audio setting from the Decoders Settings tab.

DecoderMPEG1Layer2

Refers to the MPEG1 Audio setting from the Decoders Settings tab.

DVDDecoderMPEG2

Refers to the MPEG2 Video setting from the DVD Settings tab.

DVDDecoderAC3

Refers to the AC3 Audio setting from the DVD Settings tab.

DVDDecoderMPEG1Layer2*

Stores the name of the DirectShow filter that will be used to process MP2 audio on DVDs.

Default value (text, filter name): Microsoft DTV-DVD Audio Decoder

MenuLayout

MenuItem*

Stores the set of top-level menu options that will be displayed by NextPVR . Each item is defined using an MenuItem element, with the enabled attribute defining whether the item should be shown or not. The order of the elements in config.xml dictates the order that the items will appear once onscreen (either left-to-right or top-to-bottom, depending on the active skin).

PluginSettings

DefaultTVGuide*

Stores the name of the plugin that should be activated when the keyboard (or remote) shortcut is selected for "TV Guide" (F1 by default).

Default value (string, plugin name):

DefaultVideo*

Stores the name of the plugin that should be activated when the keyboard (or remote) shortcut is selected for "Videos" (F3 by default).

Default value (string, plugin name):

DefaultMusic*

Stores the name of the plugin that should be activated when the keyboard (or remote) shortcut is selected for "Music" (F4 by default).

Default value (string, plugin name):

DefaultPictures*

Stores the name of the plugin that should be activated when the keyboard (or remote) shortcut is selected for "Pictures" (F5 by default).

Default value (string, plugin name):

DefaultRadio*

Stores the name of the plugin that should be activated when the keyboard (or remote) shortcut is selected for "Radio" (F6 by default).

Default value (string, plugin name):

DefaultRecordings*

Stores the name of the plugin that should be activated when the keyboard (or remote) shortcut is selected for "Recordings" (F8 by default).

Default value (string, plugin name):

HDPVR

ForceSPDIF*

TODO:

Default value (boolean): false

HDPVR*

Stores the encoder quality settings to be used when recording content via a Hauppauge HD-PVR. For each resolution (SD, 720p, or 1080i), three settings are available:

TODO:

Analog

Bitrate*

TODO:

BitratePeak*

TODO:

BitrateMode*

TODO:

LibraryDirectories

HideFileExtensions*

If true, specifies that the extensions on files should be hidden when displaying file names in NextPVR .

Default value (boolean): false

HideDotDot*

If true, hides the up-one-level "[..]" entries in the library screens.

Default value (boolean): false

AllowVideoDelete*

If true, NextPVR will show the option in the Video Library's menu bar that enables deletion of video files.

Default value (boolean): true

MusicLibrary*

Stores a list of file extensions that identify music files to NextPVR . A file must have one of these extensions to be displayed while browsing music directories. The Directory entry refers to the Music Folders setting from the Media Folders Settings tab.

Default value (text, regex): ^.+\.(mp3|ogg|m3u|wma|aac|wav|m4a|fla|flac)$

VideoLibrary*

Stores a list of file extensions that identify video files to NextPVR . A file must have one of these extensions to be displayed while browsing video directories. The Directory entry refers to the Video Folders setting from the Media Folders Settings tab.

Default value (text, regex): ^.+\.(mpeg|mpg|m2v|avi|ty|avs|ogm|mp4|mov|m2ts|wmv|cdg|iso|rm|dvr-ms|ts|mkv|vob|divx|flv|ratDVD|m4v|3gp|rmvb|wtv)$

PictureLibrary*

Stores a list of file extensions that identify picture/image files to NextPVR . A file must have one of these extensions to be displayed while browsing music directories. The Directory entry refers to the Picture Folders setting from the Media Folders Settings tab.

Default value (text, regex): ^.+\.(bmp|jpg|png|tiff|tif)$