/winamp2-js

A reimplementation of Winamp 2.9 in HTML5 and Javascript

Primary LanguageJavaScriptMIT LicenseMIT

Winamp2-js

A reimplementation of Winamp 2.9 in HTML5 and Javascript.

Works in modern versions of Firefox, Safari and Chrome. IE is not supported.

Features

  • Decodes the actual skin file in your browser so you can load your favorite Winamp 2 skins!
  • Load local audio or skin files via drag-and-drop, eject button, or "options" button (upper left-hand corner)
  • Both visualization modes: oscilloscope and spectrum
  • Hotkeys
  • "Shade" mini-mode
  • "Doubled" mode, where the main window is twice as large: Ctrl-D

Embed Winamp2-js in your web page

If you would like to embed Winamp2-js into your web page, simply paste this HTML snippet where you would like the player to appear:

<script async src="https://jordaneldredge.com/winamp2-js.js"></script>

You can set the default audio file by adding the following attribute to the <script> tag:

data-media="https://example.com/dj-llama.mp3"

Note: The audio file must be hosted on the same domain as your web page

If Winamp2-js cannot run in a user's browser, it will fall back to a simple <audio> tag.

Running locally vs. Production

Running Winamp2-js locally is as simple as cloning this repository and opening index.html in your browser, but you will need to have a local web server to run it on. You can run r.js -o build.js in the js/ directory to build the production version which reduces the number of http requests.

Reference

Predecessors

  • Webamp2x An impressive implementation from 2002(!). Doesn't seem to work/play in my modern browsers.

  • Winamp em HTML5 e Javascript In 2010 a developer named Danilo posted one of his HTML5 experiments: "an audio player simulating good old Winamp". You will have to download the zip file.

  • JuicyDrop An HTML5 implementation with less empasis on being true to the skin, but fully featured visualizations. @cggaurav is keeping it alive on GitHub

  • Spotiamp The folks at Spotify reimplemented Winamp as a frontend for Spotify. Not in a browser, and only runs on Windows.

Thanks

  • Research and feature prototyping: @PAEz

Thank you to Justin Frankel and everyone at Nullsoft for Winamp which inspired so many of us.

License

While the Winamp name, interface, sample audio file and surely property of Nullsoft, the code within this project is released under the MIT License. That being said, if you do anything interesting with this code, please let me know. I'd love to see it.