Copyright © 2003–2008 Artur Dorochowicz
Released under the terms of the following MIT/X11 licence, however, at this time the source code is not available.
Permission is hereby granted,
free of charge, to any person obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
the Software, and to permit persons to whom the Software is furnished to do so, subject to the
following conditions:
The above copyright notice and this permission notice shall be included in all copies or
substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
WinampC is a PowerPro plugin which gives you the ability to control Winamp from your PowerPro bars, menus and scripts. The plugin allows you to control multiple Winamp instances independently, even when they are minimized to system tray.
The plugin requires PowerPro version 4.5.12 or newer.
The plugin was developed against the newest SDK for Winamp 5. The exact used version is Winamp SDK 5.34 BETA, additional information is available here.
Almost all of the services will work with Winamp versions earlier than 5. If specific service requires some minimum version of Winamp to work, such information is given in the service description.
Some of the services will work with Foobar2000 player with foo_winamp_spam extension installed. However, this option is really not supported.
The plugin must be placed in PowerPro's plugins directory. After that, its services can be used just like services of any other plugin. Read PowerPro's help for general information on using plugins.
All services can take two additional, optional arguments: response_type and class_name (in this order only). For clarity, these arguments are not listed in the descriptions.
Specify class_name argument if given command should be issued against specific Winamp instance (identified by Winamp's window class name). If you omit this argument or specify an empty string (""), default class name (which is "Winamp v1.x") will be used. The class_name argument enables you to control many Winamp instances at the same time as long as they use different class names. Winamp can be started with special command line argument (/class="class name here"), which makes it use a class name of your choice.
The response_type argument allows you to choose how the plugin should react if specified Winamp window does not exist i.e. Winamp is not running at all or there is no Winamp window of specified class.
Any other value or when you omit this argument will make the plugin not react in any way if specified Winamp window wasn't found.
If you want to specify class_name argument, you must provide response_type argument as well. Example service usage might be:
In the desciptions below the following data types are used:
Add specified file/URL to Winamp's bookmark list.
Winamp 2.4+
No return value.
Add current track as bookmark.
No return value.
Get full caption of the Winamp window. This is something like: 'Number. Song title - Winamp'. Obviously, Winamp's option 'Scroll song title in the Windows taskbar' influences the output from this service.
Get the track title with preceding playlist entry number. The information is retrieved from Winamp's window caption. In order for this to work properly, Winamp's option "Scroll song title in the Windows taskbar" must be disabled. Otherwise the result is undefined.
No return value.
Get the title of the current track. The information is retrieved from Winamp's window caption. In order for this to work properly, Winamp's option 'Scroll song title in the Windows taskbar' must be disabled. Otherwise the result is undefined.
No return value.
Change Winamp's current working directory.
No return value.
Clear Winamp's internal playlist.
No return value.
Close Winamp.
No return value.
Open "About Winamp" window.
No return value.
Open configuration dialog of the current visualisation plugin.
No return value.
Open "Delete auto-load preset" dialog.
No return value.
Open "Delete preset" dialog.
No return value.
Open "Edit bookmarks" dialog.
No return value.
Open "File info" window.
No return value.
Open "Jump to file" dialog.
No return value.
Open "Jump to time" dialog.
No return value.
Open "Load auto-load preset" dialog.
No return value.
Open "Load EQ preset" dialog.
No return value.
Open "Load preset from EQF" dialog.
No return value.
Open "Open file(s)" dialog.
No return value.
Open "Open URL" dialog.
No return value.
Open "Winamp preferences" window.
No return value.
Open "Save auto-load preset" dialog.
No return value.
Open "Save EQ preset" dialog.
No return value.
Open "Save equaliser preset to EQF" dialog.
No return value.
Open skin selector dialog.
No return value.
Open "Visualisation plug-ins options" dialog.
No return value.
Play the last file on the playlist. When shuffle is on, it is the last played file.
No return value.
Enqueue file.
No return value.
Flush the playlist cache buffer. Makes Winamp refetch the titles for all of the entries in the current playlist.
No return value.
Fast forward 5 seconds.
No return value.
Get momentary bitrate of current song.
Winamp 2.05+
Get directory where Winamp configuration files are stored.
Query the status of equaliser.
Winamp 2.05+
Query the status of equaliser. Data is returned exactly as received from Winamp.
Winamp 2.05+
Get metadata information from specified file.
Winamp 2.9+
Get length of the current song.
Check if the Internet connection is available for Winamp. Relates to the Internet connection type setting on the main general preferences page in the Winamp preferences.
Winamp 2.05+
Get number of channels of the current song.
Winamp 2.05+
Get value describing panning setting.
Winamp 2.0+
Get value describing panning setting. Data is returned exactly as received from Winamp.
Winamp 2.0+
Get status of the playback.
Get metadata information from current entry in the playlist.
Winamp 2.9+
Get full path of current playlist entry.
Winamp 2.04+
Get title of current playlist entry.
Winamp 2.04+
Get metadata information from specified entry in the playlist.
Winamp 2.9+
Get full path of playlist entry at specified position.
Winamp 2.04+
Get title of playlist entry at specified position.
Winamp 2.04+
Gets playlist length in tracks.
Winamp 2.0+
Get the status of the Manual Playlist Advance option.
Winamp 5.03+
Get position in the current playlist, in tracks.
Winamp 2.05+
Write current playlist to %winamp.ini.dir%\Winamp.m3u and return position in the playlist.
Winamp 1.666+
Get directory where Winamp plugins are stored.
Get position in the current track.
Get position in the current track.
Get rating of the current track.
Winamp 5.04+ with Media Library
Get status of the repeat option.
Winamp 2.4+
Get sample rate of the current track.
Winamp 2.05+
Get sample rate of the current track.
Winamp 5.25+
Get status of the shuffle option.
Winamp 2.4+
Get time display mode.
Winamp 2.05+
Get Winamp's version number.
Get Winamp's version number.
Get height of the current video.
Winamp 5+
Get width of the current video.
Winamp 5+
Get value of the volume setting.
Get value of the volume setting. Data is returned exactly as received from Winamp.
Get path of the winamp.ini configuration file.
Get directory where winamp.m3u file is saved.
Check if Double size option is enabled.
Check if video or visualisation is in fullscreen mode.
Check if Winamp is running. Check is done by searching for Winamp's window.
Check if visualisation is running.
Check if specified Winamp window is set to Windowshade mode. Works with classic Winamp skins only.
Winamp 5.04+
Check if specified Winamp window is visible.
Winamp 2.9+
Jump to specified position in the current track.
Winamp 1.60+
Load default equaliser preset.
No return value.
Minimize the Winamp's window if it is not minimized, restore if minimized.
No return value.
Minimize the Winamp's window.
No return value.
Move 10 tracks back and start playing.
No return value.
Move 10 tracks forward and start playing.
No return value.
Start the next track.
No return value.
Pause if playing, start playing if paused.
No return value.
Start playback.
No return value.
Begin playing Audio CD in specified drive.
No return value.
Begin playing Audio CD.
No return value.
Same as hitting play button. There's also play service and according to Nullsoft there are some differences between them.
No return value.
Start previous track.
No return value.
Reload current skin.
No return value.
Turn repeat off.
Winamp 2.4+
No return value.
Turn repeat on.
Winamp 2.4+
No return value.
Restart Winamp.
Winamp 2.2+
No return value.
Restore the Winamp's window and make it foreground.
No return value.
Rewind 5 seconds.
No return value.
Save default equaliser preset.
No return value.
Change the status of equaliser.
Winamp 2.92+
No return value.
Change the status of equaliser using Winamp's data format.
Winamp 2.92+
No return value.
Write metadata information to the specified file.
Winamp 2.9+
Change panning setting.
Winamp 2.0+
No return value.
Change panning setting using Winamp's data format.
Winamp 2.0+
No return value.
Write metadata information for the current entry in the playlist.
Winamp 2.9+
Write metadata information for the specified entry in the playlist.
Winamp 2.9+
Set the status of the Manual Playlist Advance option.
Winamp 5.03+
No return value.
Set position in the playlist.
Winamp 2.0+
No return value.
Set rating of the current track.
Winamp 5.04+ with Media Library
No return value.
Set time display mode.
No return value.
Change volume.
Winamp 2.0+
No return value.
Change volume using Winamp's data format.
Winamp 2.0+
No return value.
Turn shuffle off.
Winamp 2.4+
No return value.
Turn shuffle on.
Winamp 2.4+
No return value.
Play the first file on the playlist. When shuffle is on it is the first played file.
No return value.
Start current visualisation plugin.
No return value.
Stop playback.
No return value.
Stop playback after current track.
No return value.
Stop playback with fadeout.
No return value.
Toggle double size option.
No return value.
Toggle easy move option.
No return value.
Toggle equalizer window.
No return value.
Toggle visibility of the Winamp's main window.
No return value.
Toggle always on top option.
No return value.
Toggle playlist window.
No return value.
Toggle window shade of the playlist window.
No return value.
Toggle repeat setting.
No return value.
Toggle shuffle setting.
No return value.
Toggle window shade option of the Winamp's main window.
No return value.
Make Winamp update the information about the current track.
Winamp 2.2+
No return value.
Decrease the volume a bit.
No return value.
Increase the volume a bit.
No return value.
Disable all main Winamp windows. Works with simple skin only.
Winamp 2.9+
No return value.
Enable back Winamp windows.
Winamp 2.9+
No return value.
All comments, feature requests, bug reports are welcome and appreciated.
Please use Yahoo PowerPro group to contact the author.