Main Page

From Winamp Developer Wiki
Jump to: navigation, search

Wiki Main : Skin Developer : Visual Developer : Plug-in Developer : Online Service Developer : SHOUTcast Broadcaster : SHOUTcast Developer : Articles Page : FAQ : Glossary


Welcome

Welcome to Winamp's Developer Network wiki. By consolidating Winamp documentation, code samples, reference materials, and sample articles, we've created a one-stop shop for all things related to Winamp development. The purpose of this site is to help facilitate the development of Winamp skins, plug-ins, visualization presets and online services. In order to offer the most relevant material (and since no one is more of an expert than you), our goal is to present a wiki that is updated, maintained, and moderated by the Winamp developer community.

Why develop for Winamp, you ask? Besides being a kickass media player with a flexible programming platform, Winamp has a very loyal fan base with over 72 million worldwide users per month. So chances are your creative masterpiece will live well beyond the boundaries of your hard drive. Now that we've got your creative juices flowing (or at a minimum, appealed to your desire for fame and adoration), you can use the Developer Network as a springboard for everything you need. Most importantly, you can upload your creation and share it with the World. (Note: You'll need a winamp.com account to upload).

How to use the Wiki

There are several ways that you can use this wiki. Use it as a reference guide. Start sifting through the content to find the information you need to start developing. If you find out that some key information is missing or you see that something on the site is completely inaccurate, we welcome your contributions. We'd love for you to update the site with killer content and Articles. Before you start contributing though, make sure you check out the Developer Network Policies & Guidelines page and create an account. By creating an account or logging into the Winamp Developer Network, you are agreeing to our Terms of Service and Privacy Policy


If you've never edited a wiki before, you might want to check out Wikipedia: How to edit a pagefor some pointers.

Who Should Use the Wiki

This wiki is for everyone. Whether you're a seasoned vet, intermediate coder, loyal fan, or even newbie. Primarily though, it's for Winamp developers and user-contributors who want to be actively engaged in the advancement of the Winamp media player. Either by leveraging the content of this site to build better skins, plug-ins, visualizations and online services; or by sharing your knowledge and expertise with the community.

Skin Developer

To put it as simply as possible, skins change the way your Winamp player looks. If you want to get fancy and say that it changes the GUI (graphical user interface) then you can, but really all you need to know is if you download or create a new skin, Winamp will put on a little mask and pretend to look different. Check Skin Developer page for more details.

Classic Skins

Based on the Winamp 2 model, Classic skins are easier to create than Modern skins, but they do not allow the developer to change the form or function of the player. Classic skins developers may only replace a standard set of images that alter the player's visual appearance.

Modern Skins

Modern skins are skins that adhere to the Winamp 3+ skin model. Modern (or freeform) skins offer developers a tremendous amount of flexibility by allowing you to change the player's shape, size, layout, and function. Learn how to create a modern skin for Winamp!

Visual Developer

You know those funny dancing colors you see when you hear music – and no Autumn Moonpuppy, I’m not talking about that time you "toured" with The Dead. Visualizers are dynamic add-ons that produce images, colors, and textures that change based elements of the music being played. Winamp offers two primary visualization platforms (AVS & MilkDrop) allowing you to create different presets. If you’re feeling invincible, you can even attempt to create your own visualization environment.

Plug-in Developer

Plug-ins can pretty much do anything! ...within reason, of course. You can alter the sound of your music, turn your mobile phone into a Winamp remote control, or if ya’d like, translate Winamp into another language. Basically, we’ve made the platform flexible enough so that you can craft your idyllic feature and plug it right into Winamp.

Types of Plug-ins

There are all kinds of categorizes of plug-ins: Input, Output, Visualization, DSP/Effect, General Purpose, Media Library and Portables. That means, you can go nuts in discovering how a single plug-in can change your life. You can read up on the taxonomy of a plug-in here.

Start Creating Your Plug-in

If you feel like developing one yourself, you can –

  1. Check out the suggested tools
  2. Read-up on the SDK documentation
  3. Download the SDK
  4. Visit the Winamp Forums
  5. Submit your plug-in. Ain’t it easy?

Online Service Developer

Online Services are web pages that are rendered by the embedded browser within Winamp. The awesomeness of these pages is that they can interact with the Winamp Player. In this way a web page can start and stop the player, examine and create playlists, enqueue songs for playback, the colors used in the skin of the player, etc. We're excited to see what you come up with by merging html web pages and the Winamp player.

Developer Resources

FAQ

Check out the Developers FAQ. Not to mistaken for the standard frequently asked questions that live on the Winamp Forums (although there may be some overlap), this FAQ is specific to developers.

Contribute to the Wiki

Just like the success of Winamp itself, the success of the Developer Network relies on you. We encourage everyone to contribute - from the expert developer to the passionate user. Your updates, additions, and moderation efforts are critical and we definitely appreciate your efforts making this one of the premier developer sites.