Here's a list (currently updated to reflect the [Winamp] section) of valuable references in the WINAMP.INI file for those Winamp users who find mostly anything wrong with their Winamp, well, maybe not
Make sure Winamp is closed before attempting to edit this file (using Notepad or Wordpad), and save it to the same name upon completing an edit.
All skin fixes are relevant to classic skins only!
As of Winamp 5.5 Winamp.ini and other user setting are stored at %appdata%\Winamp
Where %appdata% is a shortcut to the 'Application Data'/'User Settings' folder. You can type %appdata%/winamp
in to Windows Explorer address bar and press Enter -or- you can click on the Start button > click the Run icon and put %appdata%\Winamp
in the Open box and click OK. That should bring you to the Winamp settings folder in 'Application Data'/'User Settings'.
The actual path will vary with the current Windows version you are using. Example...
Windows 2000 & Windows XP
C:\Documents and Settings\UserName\Application Data\Winamp
Windows Vista & WIndows 7
The exception to that is if you installed Winamp over a previous (pre 5.5) version that had shared settings, the settings are stored in Winamp's install/default folder. Example
Where %ProgramFiles% is a shortcut to the Program Files folder
Controls a user's ability to enqueue files from Windows Explorer. Default is 0, off. Additional values are 1, on.
1 enables always-on-top mode, 0 disables it.
Controls whether the Winamp Clutterbar is displayed, adjacent to the built in visualization and play timer. 0=off, 1=on
If this is set to 1, equalizer presets created for individual songs are used upon playback, otherwise this feature is disabled with 0.
If this option is enabled (=1), Winamp scrolls the name of the currently playing song in the Main Window. If the option is disabled, the display is static.
If this is set to 0, the font specified by the skin or language pack is used, or otherwise a system font. If this is set to 1, a special, skinnable Winamp font is used. Internalization is disabled if this option is enabled (=1).
Checks to see that no other program has hijacked one of Winamp's extensions, and if this has occurred, restores the extension to Winamp.
The list of file extensions associated with Winamp (ie. Winamp is the default player for these types). Note: This is not the full list of extensions available via "Prefs > File Types", only the hi-lighted/selected ones.
This is limited by the plugins installed and the native support of said plugins to play those formats inputted here.
Used in conjunction with playlist_custom_font.
Specifies the current working directory (for Open Files Dialog).
If Winamp is chosen to play a file with an extension unbeknownst to it, it will default to this extension. Default is MP3.
Allows the user to disable built-in visualization when external visualization plugins are active (eg. AVS, Milkdrop) 0=off, 1=on.
"Disable always on top while fullscreen applications are focused" in General Preferences
1 enables DoubleSize, 0 disables it.
Controls the DSP plugin used when a user enables it through the DSP tab in the Preferences. Generally, dsp plugins begin with dsp_*.dll
This option controls which mode the current DSP plugin is set to, if available.
1 enables 'EasyMove' which allows you to move Winamp by clicking anywhere in its component windows. 0 disables this option.
Resizable skinned windows are smoothly resized if this option is set to 1, otherwise smooth resizing is disabled with 0.
Any number between 0 and 63 is acceptable here, for any combination of values. 0=+12dB 31=0dB and 63=-12dB.
Allows the equalizer doublesize setting to be linked with that of the main window. 0=off, 1=on.
The Equalizer window is visible when this equals 1. The only other value accepted here is 0, disabled.
If this is enabled (=1), the equalizer docks in windowshade mode. 0 disables this option.
If this option is set to 0, no updating is performed on titles. If this option is set to 1, %20 in titles are converted to spaces. If this option is set to 2, underscores in titles are converted to spaces. If this option is set to 3, both of the above are performed.
If this is enabled (=1) the corresponding option in Preferences/Skins/Classic Skins/Classic Skin Options/ "Dim windows titlebars when not in focus" is also enabled. 0 disables this option.
Defines the connection a user has to the internet.
0=LAN/DSL/Cable, 1=Dial-up Modem, 2=No connection
The name of the language file, nothing if the default is used.
keeponscreen=1, This will make sure both "Litestep VWM Compatible mode" and "Always on Litestep Virtual Desktops" are unchecked. keeponscreen=2 enables "Litestep VWM mode." keeponscreen=3 enables "Always on LVDs." keeponscreen=4 enables both.
A description associated with the last URL accessed in the Minibrowser ("More" button), used in conjunction with last_shorturl=.
The last URL accessed in the minibrowser.
A defunct setting which controlled whether the MiniBrowser was shown or hidden (1, shown; 0, hidden), no longer used as a result of the MiniBrowser's inclusion into the Media Library.*
0=full size, 1= minimized to system tray
Allows Winamp to be opened under multiple instances. 0=off, 1=on.
Controls whether the Main Window is displayed or not. 0=hidden, 1=shown
The current version is checked against what is available at winamp.com, and the user is notified if a new version exists if this option is set to 1; otherwise this is disabled with 0.
Anonymous usage statistics are reported to winamp.com if this option is set to 1; otherwise this is disabled with 0.
Instructs Winamp whether to save file associations to the registry or not. Default value is "0" which allows writing to registry. Setting it to "1" will disable saving file associations to the registry (Winamp 5.11 and higher only - and only available in winamp.ini, and not via the ui).
SEH is disabled for visualization plugins if this option is set to 0. Otherwise exception handling messages appear (=1).
Common entries are out_wave.dll (9x/ME) and out_ds.dll (XP)
Old school playlist buttons. This controls whether the buttons within the playlist editor are activated by a click and release, or by two distinct clicks of the mouse. 0=user must click and then click again to activate button, 1=user may activate button by simple release of left mouse button.
Controls the balance slider. Any number between -127 and 127 is acceptable here. -127 is 100% left, 0 is center and 127 is 100% right.
Old defunct 1.x setting. See here
The size of the font in the playlist editor. Enter a integer here, greater than 0. Default is 11.
If this is enabled (=1), the playlist editor docks in windowshade mode. 0 disables this option.
The Playlist Editor is visible when this equals 1. The only other value accepted here is 0, disabled.
The track prior to the active entry in the Winamp playlist upon close (eg. if you close wa with track 7509 active, then pilp=7508)
0=manual playlist advance, 1=automatic
If custom_plfont is enabled (=1), the specified font is used in the playlist editor. Arial is the default font. The font must be installed on your system to function correctly.
Deleted files are deleted or sent to the recycle bin. (Playlist Editor: REM > Remove... > Physically remove selected file(s)"). "Recycle permantly deleted files" in General Preferences.
Any number between 0 and 63 is acceptable here. 0=+12dB 31=0dB and 63=-12dB.
Last page active when Prefs were closed (uses internal page id #)
0=Idle, 1=Normal, 2=High, 3=Real Time
A user defined field in Preferences/General Preferences "(Optional) Specify HTTP proxy address: 'Server: port'"
Controls the setting in Preferences/General Preferences "Use proxy only for port 80 URLs." 0=unchecked, 1=checked, 0 is default
A random skin is selected upon playback of a new song if this is set to 1, otherwise is disabled with 0.
: Delete these entries to clear your URL history
The list of recent URLs for the MiniBrowser.
Removes gen_nomad, if set to 1.
1 enables repeat mode, 0 disables it, and causes Winamp to stop once the playlist has completed playing.
Instructs Winamp whether to read file metadata on load, play/view, or play. Default is 0, read on play or view in playlist editor. Additional settings are 1, read on load, and 2, read on simply play.
This allows the user to select whether multiple files are sorted by name on load. 0=off, 1=on.
0=No built in visualization, 1=Spectrum Analyzer, 2=Oscilloscope
Any number between 0 and 4 is acceptable here. 0 is Slow and 4 is
classic vis > spectrum analyzer, fire style
Any number between 0 and 4 is acceptable here. 0 is Slow and 4 is Fast.
Analyzer peaks are visible when this equals 1. Peaks are not visible when this equals 0.
0 = 9fps, 1=18fps, 2=35fps, 3=70fps
This allows the user to show or hide the numbers preceding each entry in the playlist editor. 0=off, 1=on.
Hides (=0) or shows (=1) the preferences window
1 enables shuffle, 0 disables it and plays the playlist in order
Any number between 0 and 50 is acceptable here, as this determines the level at which Winamp shuffles your playlist. 0 is Slow and 50 is Fast.
Allows Winamp components to be docked with one another. 0=off, 1=on.
The proximity of two components before they can be docked with one another, in pixels. Default is 10.
Controls whether a leet splash screen of Winamp's Mike the Llama
pops up at startup.
Controls whether there is a system tray icon for Winamp. 0=off, 1=on.
"taskbar=0" makes winamp show in taskbar only, "taskbar=1" = systray only, "taskbar=2" = both taskbar & systray, "taskbar=3" = none.
1 causes Winamp to display a song's playing time as a decreasing value dependent on the length left to play in the song. 0 causes Winamp to display this time as an increasing value.
Returns the title formatting specified by the user (Preferences/Titles)
Controls whether tooltips for Classic skins are displayed in Winamp's main window. 0=off, 1=on.
Allows the user to select whether the Windows default cursors are used, or a special set built-into the skin instead. Winamp-skinned cursors are enabled with 1, otherwise Windows default cursors are used.
Controls whether the equalizer is used. 0=off, 1=on. This setting is independent of eqopen=.
Instructs Winamp to use Advanced Title Formatting, using the format listed in titlefmt above. 0=off, 1=on.
1 locks the video aspect ratio, 0 frees it.
This option closes the video window upon completed playback of a video file. 0=off, 1=on.
This option displays the video window upon playback of a video file. 0=off, 1=on.
Enables autofullscreen for video playback. 0=disabled, 1=enabled. Note, this setting is only available in winamp.ini, and not via the ui.
Default setting = 1. Used to fallback to DirectDraw Mode when hardware overlay is disabled. It is not recommended to change this setting.
If this option is enabled, =1, any screensaver is disabled during playback of a video file.
On-screen display is visible during playback in fullscreen if this option is set to 1, otherwise disabled with 0.
The Video window is visible when this equals 1. The only other value accepted here is 0, disabled.
If this option is set to 1 it allows for hardware overlay of video.
Video_ratio1 and video_ratio2:
Controls the screen size of the scalable area by the video window (4:3 and 16:9 for VR1:VR2 respectively are common ratios, 4:3 for TV and 16:9 for widescreen)
If a video is playing in full screen, this option will cause it to be removed after it has finished playback (=1)
Video playback is halted if the video window is closed, =1.
Resizes the video to fit window, if this option is enabled with =1.
If this is set to 1, the custom ratio specified by video_ratio1 and video_ratio2 is used by the DirectShow filters.
1 syncs the video playback to the screen refresh rate, 0 disables this feature.
YV12 overlay is enabled if this is set to 1. Otherwise it is disabled with 0, also disabled by default.
This controls whether or not Winamp runs with visualization on file playback. 0=off, 1=on.
Controls the visualization used when a user enables it with Control-Shift-K, or through the Visualization tab in the Preferences. Generally, visualization plugins begin with vis_*.dll
This option controls which mode the current visualization plugin is set to (eg. Within vis_nsfs.dll, 4=Random Intelligent Visualization)
The threading priority of Winamp's visualization plugins. Acceptable entries are 0, 1, 2, 3 or 4. 0=idle, 2=normal, 4=high.
Any number between 0 and 255 is acceptable here. 255 translates to 100% volume in Winamp.
Used with Winamp 5.x's CD Ripping, when outputting files to file type WAV (Convert to Format).
Used with Winamp 5.x's CD Ripping to write a WAV header
Specifies the default WAV extension (*.wav)
Allows the user to choose which icon is displayed for Winamp associated files. Accepted values range from 0 to 11.
Allows the user to choose which icon is displayed for Winamp playlists. Accepted values range from 0 to 11.
If this is set to 1, the main window docks in windowshade mode. Otherwise, equaling 0, this window appears in full size.
Wx and wy:
Controls the placement of the main window. X controls the horizontal component of placement, Y the vertical.
Eq_wx and eq_wy:
Controls the placement of the equalizer. X controls the horizontal component of placement, Y the vertical.
Pe_wx and pe_wy:
Controls the placement of the playlist editor. X controls the horizontal component of placement, Y the vertical.
Video_wx and video_wy:
Controls the placement of the video window. X controls the horizontal component of placement, Y the vertical.
Mb_wx and mb_wy:
Defunct placement settings for the Winamp 2.x MiniBrowser, no longer used as a result of the MiniBrowser's Now Playing inclusion into the Media Library. *
Pe_width and pe_height
: Controls the proportions held by the playlist editor
Mb_width and mb_height:
Defunct settings for the proportions of the Winamp 2.x MiniBrowser, no longer used as a result of the MiniBrowser's inclusion into the Media Library.*
Video_width and video_height:
Controls the proportions held by the video window
Delete any one of these entries along with its corresponding entry to revert a particular window back to default.
As of Winamp 5, the MiniBrowser has been renamed "Now Playing". Winamp 5 will not modify the values for mb_wx, mb_wy, mb_width or mb_height. It will however modify the value for mb_open and force it to be 0, no matter what. The default settings for the original MB values are
Thanks to DJ Egg and DrO for help in compiling this hopefully useful reference for all Winamp users.