Newly Purchased Memories
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    webamppublic

    Travis Codecov Discord

    Webamp

    A reimplementation of Winamp 2.9 in HTML5 and JavaScript.

    As seen on TechCrunch, Motherboard, Gizmodo, Hacker News (1, 2, 3), and elsewhere.

    Give it a try!

    Screenshot of Webamp

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

    Features

    Check out this Twitter thread for an illustrated list of features: https://twitter.com/captbaritone/status/961274714013319168

    Use Webamp in your own project

    I've tried to make it possible to include Webamp in your own project.

    See the usage documentation for more information.

    Development

    yarn
    # Or: npm install
    npm start
    

    Open http://localhost:8080/webpack-dev-server/ in your browser.

    # Run tests and lint checks
    npm test
    

    Building

    npm install
    npm run build
    npm run serve
    

    Open the local ip/port that is output to the console in your browser.

    Deploying

    Travis runs the build and then pushes the contents of ./built to the gh-pages branch of this repository. GitHub Pages then serve that directory as https://webamp.org. CloudFlare sits in front of GitHub pages to provide the SSL certificate.

    In short, deploying should be as simple as pushing a commit to master which builds, lints and passes all tests.

    Advanced Usage

    There are some "feature flags" which you can manipulate by passing a specially crafted URL hash. Simply supply a JSON blob after the # of the URL to change these settings:

    • skinUrl (string) Url of the default skin to use. Note, this file must be served with the correct Allows Origin header.
    • audioUrl (string) Url of the default audio file to use. Note, this file must be served with the correct Allows Origin header.
    • hideAbout (boolean) Selectively hide the byline and GitHub link at the bottom of the page. Useful for taking screenshots.
    • initialState (object) Override the initial Redux state. Values from this object will be recursively merged into the actual default state.

    Note: These are intended mostly as development tools and are subject to change at any time.

    Reference

    Predecessors

    • Webamp2x An impressive implementation from 2002(!).

    • JsAmp An implementation from 2005 by @twm (via Hacker News).

    • LlamaCloud Comp From 2011 by Lee Martin (via Twitter)

    • 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 emphasis 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
    • Beta feedback, catching many small UI inconsistencies: LuigiHann
    • Beta feedback and insider answers to obscure Winamp questions: Darren Owen

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

    License

    While the Winamp name, interface, and, sample audio file are 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.

    install

    npm i webamp

    Downloadsweekly downloads

    37

    version

    1.0.0

    license

    MIT

    repository

    github.com

    last publish

    collaborators

    • avatar