Quick start

Beginner's Guide

Illustrated Manual



Skins (146)

Visuals (115)

Input Plug-ins (35)

Output Plug-ins (5)

General Plug-ins (11)

Archive Reader (16)

Input Plug-ins (40)

DSP Plug-ins (10)

Tag Editing Plug-ins (6)

External Encoders (3)

External Add-ons (15)

XMPlay Archive (69)

Extra Tools
6.02 - Secret INI settings
by Jimmy Neutron, 2018-01-21 11:18:00

How things work normally:
When XMPlay starts for the first time, an xmplay.ini file is created that holds the original program settings. Thereafter, most settings that affect the operation and appearance of XMPlay are modified through the built-in menu system. To reach this menu system, right-click on an unused portion of the XMPlay screen and select "Options and Settings". When changes are made, XMPlay keeps track by writing them to the xmplay.ini file.

For the more advanced user:
Certain settings are either too new, too unique, being tested, or for some other reason do not appear in the "Options and Settings" menu system. An advanced user can apply these "secret" settings by manually editing the xmplay.ini file with a text editor such as Notepad. Do not use a wordprocessor as it will probably insert unwanted control codes into xmplay.ini and may cause undesired issues.

Will this always work?
Often a "secret" setting is introduced as a new feature in a test version of XMPlay that is not available in the official distribution package. Such a version has become known as "stuff", because it is stored in and downloaded from the stuff folder of the webserver. You may need to get a newer version to use a certain "secret" setting as a version will ignore settings it doesn't understand. The latest stuff version can be downloaded from the official XMPlay forum.

How to use a "secret" setting:
The "secret" settings are entered as a line in the [XMPlay] section of xmplay.ini file. As the xmplay.ini can have several different sections, you must be careful when editing since the "secret" setting will not work if it isn't in the [XMPlay] section. Perhaps the easiest way to ensure correct placement is to find the [XMPlay] section header (often the first line in the xmplay.ini file) and insert your line immediately below it. This also places your edits at the top of the list, making them easier to find or change later. The format is the setting name, an equals sign, and the desired value of the setting. For example, a line could be "SingleClickTray=1" and is entered without the quotes.

Example Secret Setting in Notepad

Put them all there:
Some of the cutting edge users intentionally put all of the "secret" settings (each with the default value) into the xmplay.ini file even if they don't intend to modify the setting. If they want to experiment later, they can see the setting's correctly-spelled name and change from the default value on that line.

Restart XMPlay to activate:
XMPlay reads the xmplay.ini file when it starts. When you change a "secret" setting by manually editing the xmplay.ini file, XMPlay won't know. Restart XMPlay to re-read the xmplay.ini file and make the setting take effect.

XMPlay "Secret" Settings
Last updated on: 2016 February 9 Through Version:

Setting NameDefaultBrief Description
AutoMini 0 When mini-mode layout is active, AutoMini=1 switches to normal layout when mouse is hovering. The view reverts back to mini layout when mouse is no longer hovering on the normal layout. Forum Link
AutoMiniDelay 500 Used with the AutoMini setting. Adjusts or disables the delay in AutoMini response to mouse-over, and is expressed in milliseconds. A setting too short may cause problems if the normal footprint doesn't visually overlap the mini footprint (view pops from mini to normal and then back immediately because the mouse isn't hovering on the normal view). If the setting is too long, operation of AutoMini may seem sluggish. Forum Link
Boost n/a Boost (merely present, regardless of type/value assigned) increases the priority Windows assigns to the XMPlay GUI. The audio decoding and playback thread is always at real-time priority, so Boost has no affect on audio, but may help minimize visualization choppiness if you have other programs competing for CPU resources. Forum Link
CueMark 0 [ and later] When using CUE files, CueMark=1 will enable a one-pixel markers on the seekbar to denote the track borders to aid position seeking. Forum Link
EndPadding 0 [ and later] Specify amount of padding (in milliseconds) to add at the end of playback to eliminate cutting the music selection short. "EndPadding=50" would add 50ms of padding. Forum Link
FlashTrack 0 [ and later] The currently playing track on the playlist or library can be visually difficult to identify, especially with certain skins and/or colors. FlashTrack=1 enables flashing of the current track to enhance visibility. Forum Link
NetBufferOld 0 [ and later] NetBufferOld sets an amount (in seconds) to buffer the output of a ShoutCast stream (in addition to the incoming buffer set in Miscellaneous options) and use that buffer when "write to disk" is started. "NetBufferOld=10" would establish a 10 second buffer. Forum Link
NoBackup 0 As a safety feature, XMPlay backs up xmplay.library to xmplay.library~ before writing any changes to the library. NoBackup=1 disables this feature. This setting might appeal to people with large libraries and limited disc storage space, such as on a USB drive. Also, this setting limits the numbers of writes, which is also a concern on a USB drive. Forum Link
NoBeeps 0 NoBeeps=1 disables all beeping, such as the Windows critical stop sound. Forum Link
NoCheckDead 0 XMPlay checks whether each of the tracks (local files) exists in the library shortly after it is launched, but that can be disabled with NoCheckDead=1. May decrease startup delays on slower systems with large libraries. Forum Link
NoCheckScan 0 NoCheckScan=1 disables display of the "Title scanning in progress" warning when closing XMPlay. Forum Link
NoConfirmDelete 0 This setting turns off confirmations for every track when doing "Remove + Delete" with multiple files. Forum Link
NoDelete 0 This setting disables the "delete file" option in the right-click menu. Forum Link
NoFlashPause 0 When XMPlay is paused, the pause button flashes as an indicator. Some people find the flashing distracting. NoFlashPause=1 will disable the pause button flashing behavoir, and allows the skin to determine visual indicators. Forum Link
NoFlashTotal 0 XMPlay alternately displays the time between total and selected tracks when multiple items are selected from a list. NoFlashTotal=1 disables this back and forth time display and maintains the display as the total time only. In that case, selected tracks total time can be found by right-clicking one of the selected tracks and choosing Track Info. Forum Link Since [ and later], NoFlashTotal=2 will maintain the display as selected tracks time. Forum Link
NoHistory 0 For user convenience, XMPlay stores 20 entries in each of the URL, folder, and search histories in xmplay.ini. NoHistory=1 disables the history tracking, and minimizes writing to the ini file (which may be significant when using XMPlay from a USB drive). Forum Link
NoLameRG 0 When LAME encodes an MP3, it can embed replaygain information in the file's header. Other softwares may use this area to enter or modify replaygain data. XMPlay reads the header to access various information about the file. NoLameRG=1 makes XMPlay ignore any LAME replay gain information that may be present. Forum Link
NoNetErrors 0 NoNetErrors=1 disables internet error messages such as "ICY 400 Server Full". The playlist entry still gets a red strikethrough as if the track were dead, but XMPlay proceeds to the next entry without having to acknowledge/dismiss the connection error.
NoPageScroll 0 XMPlay scrolls pages with the same look and feel of Windows itself (page up/down when mouse clicking above/below the slider). NoPageScroll=1 disables this default page scrolling behavior and reverts to the old way that XMPlay used to move through a large list or library (click at two-thirds on the list's scrollbar to go to two-thirds through the list). Forum Link
NoPreload 0 [ and later] To achieve gapless playback, XMPlay preloads the next track before the current track finishes playing. Under certain situations, the title/time display might not exactly match the actual transition point. NoPreload=1 will disable preloading of next track, forcing accuracy. Does not apply if crossfading is enabled (which requires loading both tracks). NoPreload inherently subverts gapless playback. Forum Link
NoRandomReset 0 [ and later] NoRandomReset=1 will disable the resetting of the "already played" tracking when the "Random order" setting is toggled. Forum Link
NoReg 0 NoReg=1 prevents XMPlay writing to the Windows registry (disables the filetype association options). Forum Link
NoResumeNext 0 [ and later] If playback is currently paused or stopped, the next/previous selection will start playback. NoResumeNext=1 maintains the paused/stopped state when pressing the next/previous button. Forum Link
NoSaveList 0 [ and later] XMPlay saves the current playlist to xmplay.pls upon exiting. If you prefer to have a static playlist file (with no automatic updates) NoSaveList=1 will disable the saving. Forum Link
NoScanList 0 [ and later] XMPlay scans the file titles in a playlist to reproduce formatted titles for display. If there are a lot of titles (perhaps within archives) NoScanList=1 will disable the pre-scanning when the playlist entry includes the length. Recently added variations:
  • 1 = disable info scanning for playlist entries that include length info
  • 2 = disable info scanning for all playlist entries
  • 3 = disable info scanning for all files (from a playlist or otherwise)
Note this "NoScanList" option does not affect adding files to the library, unless they were added to the playlist first.Forum Link
NoScanMP3 0 For mp3 files, XMPlay scans the entire file and then maintains the file in a read-ahead buffer. NoScanMP3=1 disables the pre-scanning and read-ahead buffer for mp3 files. See ReadAhead setting (below) for related information. Forum Link
NoSpectrumFade 0 [ and later] To more smoothly display the built-in spectrum visualization, a small level of blurring is introduced. NoSpectrumFade=1 will disable this intentional blur. Forum Link
NoStickyMark 0 [ and later] To remove the "Don't auto-remove" triangle markers in the playlist (doesn't affect skins that include a bitmap marker). "NoStickyMark=1" will remove the markers. Forum Link
NoteOffAll 0 [ and later] and [xmplay-midi.dll rev 15 and later] To have ALL instances of a note released by a note-off, add a "NoteOffAll=1" line to your XMPLAY.INI file (under the "[MIDI]" line) to enable. Forum Link
NoUserConfig 0 When started, XMPlay defaults to the xmplay.ini in the user's directory (if it exists) to retain per-user settings. This may present undesired effects if a customized version of XMPlay is used (perhaps as a demo from a USB drive) since the local xmplay.ini may never be activated. NoUserConfig=1 in the local xmplay.ini will ignore the user's directory xmplay.ini (if found). Forum Link
NoWheelVol 0 When the main XMPlay window has focus, the mouse scroll-wheel will control volume even if the mouse is not over the XMPlay window. NoWheelVol=1 disables mouse scroll-wheel volume control unless the mouse is focused on the actual volume control. Forum Link
PauseStop 0 [ and later] PauseStop=1 provides the option of stopping/releasing the output (instead of just pausing it) when the pause button is pressed. Forum Link
PlayDelay 1 [ and later] When dragging/dropping a folder on XMPlay, tracks that are contained in the folder may not sort (or be randomized) as desired before audio begins. PlayDelay creates a delay (expressed in seconds) to allow the this to take place. PlayDelay=0 disables any delay. Forum Link
ReadAhead 0 [ and later] For mp3 files, XMPlay scans the entire file and then maintains the file in a read-ahead buffer (unless NoScanMP3=1 is set). XMPlay does not do this for other types of files, which may cause unwanted disc activity (repeated small reads). ReadAhead=[max file size in MB] will enable the specified read-ahead buffer for non-mp3 files. Forum Link
RecentTracks 5 [ and later] Configure number of entries in the Recent Tracks list. Default is RecentTracks=5. Disable Recent Track list with RecentTracks=0. Forum Link
ReconnectAttempts 1 [ and later] Configure number of reconnect attempts before an Internet stream is marked "dead". Default is ReconnectAttempts=1. Forum Link
SeparateToggle 0 [ and later] When set to SeparateToggle=1, the "Separate subsongs" option will work as a toggle to separate/unseparate subsongs instead of using two menu options. Forum Link
SingleClickTray 0 Used with the "Always in Tray" setting found in the "Options and Settings" menu. When the XMPlay icon is minimized to Window's system tray, a double-click will restore the full display. SingleClickTray=1 will restore XMPlay from the system tray with a single click, and another single click on the system tray icon will minimize XMPlay again. Forum Link
StartInTray 0 [ and later] StartInTray=1 will force XMPlay to start and display only in the system tray. Forum Link
UpdateStuff 0 [ and later] Include UpdateStuff=1 to receive notifications of updated stuff versions, including updated plugins. Forum Link
VolStep 3 [ and later] XMPlay adjusts the mouse scroll-wheel volume based on the default Windows scroll-wheel lines setting. VolStep allows setting the size of the mouse wheel volume adjustment independent of the Windows setting. Also see NoWheelVol (above). Forum Link

Updates for this page should be forwarded to:
Jimmy Neutron via the Secret Settings topic of the XMPlay forum.

Next page: Command line interaction