webamp/packages/webamp

Webamp NPM Module

Development

The demo site in packages/webamp-demo imports the library source directly, so you can iterate on the library with live reloading:

cd packages/webamp-demo
pnpm start

Any edits to library source files in packages/webamp/js/ are immediately reflected in the browser — no rebuild needed.

# Run tests
cd packages/webamp
pnpm test

Building

To build the library for publishing:

pnpm run build

This will write files to ./built.

Testing

pnpm test

This will run the tests the linter and the type checker.

To update snapshots run

pnpm test -u

Cutting a Release

1. Update the version number in package.json
2. Rename the "Next" title at the top of CHANGELOG.md to the new version number and ensure it is up to date
3. Update the static VERSION property of the Webamp class in webampLazy.tsx
4. Git commit
5. cd packages/webamp
6. npm publish
7. Git tag the commit (e.g. 1.4.2 or 1.4.3-beta.3)
8. Push tag to GitHub git push origin <TAG_NAME>
9. Update all the examples to use the new version:

• minimal/index.html
• minimalMilkdrop/index.html
• webpack/package.json
• webpackLazyLoad/package.json
• https://codesandbox.io/s/y0xypox60z

8. Commit and push

Reference

• skinspecs.pdf
• Skinner's Atlas 1.5 by Jellby
• Winamp Skinning Tutorial
• Sacrat Skinning tutorial parts 1, 2, 3, 4, and 5,
• Winamp Wiki

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. It has since been discontinued.