WinampC 1.2.1

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.


Table of contents

  1. Overview
  2. List of services
  3. Using the plugin
  4. Description of services
  5. History
  6. Contacting the author

1. Overview

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.

2. List of services

3. Using the plugin

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:

4. Description of services

In the desciptions below the following data types are used:

5. History

  1. 1.2.1 - 2008-04-15
  2. 1.2.0 - 2008-04-07
  3. 1.1.2 - 2007-11-13
  4. 1.1.1
  5. 1.1.0
  6. 1.0.2
  7. 1.0.1
  8. 1.0.0

6. Contacting the author

All comments, feature requests, bug reports are welcome and appreciated.
Please use Yahoo PowerPro group to contact the author.