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
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.
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.
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 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!
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-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 –
- Check out the suggested tools
- Read-up on the SDK documentation
- Download the SDK
- Visit the Winamp Forums
- 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.
- Articles - link consolidation of all articles written by all types of developers
- SDK Documentation
- Download the SDK
- Frequently Asked Questions
- Skin Developer
- Visual Developer
- Plug-in Developer
- Online Service Developer
- Tips for Writing an Awesome Online Service
- Glossary of Terms
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.