mirror of https://github.com/captbaritone/webamp.git synced 2026-07-23 01:57:29 +00:00

No description

html5 javascript port reimplementation webaudio-api winamp

Find a file

Jordan Eldredge 0d53884fde Migrate from yarn to pnpm This comprehensive migration includes: ### Configuration Updates - Updated root package.json with pnpm workspace configuration - Added packageManager field and pnpm overrides for graphql version - Updated GitHub Actions workflows (.github/workflows/ci.yml, code-size.yml) - Updated Netlify configuration (netlify.toml) - Updated deployment script (deploy.sh) ### Documentation Updates - Updated all README files to use pnpm instead of yarn - Updated installation and build instructions across packages: - packages/webamp/README.md - packages/webamp-modern/README.md - packages/webamp-docs/README.md - packages/ani-cursor/README.md - packages/webamp/demo/readme.md ### Lock File Migration - Removed yarn.lock - Generated pnpm-lock.yaml preserving exact dependency versions - Moved resolutions from skin-database package.json to root pnpm overrides - Created pnpm-workspace.yaml for optimized workspace configuration ### CI/CD Updates - Updated all yarn commands to use pnpm equivalents - Changed yarn workspace commands to pnpm --filter syntax - Updated cache keys to use pnpm-lock.yaml instead of yarn.lock - Added pnpm/action-setup for GitHub Actions ### Validation - Tested builds for webamp, webamp-modern, ani-cursor, webamp-docs - Tested installation and linting for skin-database - Verified dependency resolution consistency - Confirmed all scripts work with pnpm All package versions remain identical to yarn.lock, ensuring no breaking changes.		2025-07-06 13:20:28 -07:00
.github/workflows	Migrate from yarn to pnpm	2025-07-06 13:20:28 -07:00
.yarn/releases	Try locking Yarn version (#1066 )	2021-02-13 19:50:09 -08:00
config	Get Jest tests passing	2024-03-01 15:30:09 -08:00
examples	Update example to use new /butterchurn entrypoint	2025-07-04 17:29:31 -07:00
packages	Migrate from yarn to pnpm	2025-07-06 13:20:28 -07:00
.editorconfig	Format css according to prettier default config	2018-10-20 10:12:19 -07:00
.eslintignore	Try harder to use monorepo version	2022-09-20 22:07:45 -07:00
.eslintrc	Upgrade eslint	2022-05-07 12:35:48 -07:00
.gitattributes	Update .gitattributes	2023-03-27 20:26:22 -07:00
.gitignore	First attempt at adopting Parcel (#1186 )	2023-01-20 11:15:39 -08:00
.parcelrc	First attempt at adopting Parcel (#1186 )	2023-01-20 11:15:39 -08:00
.prettierignore	Fix prettier ignore	2024-03-01 23:50:31 -08:00
.yarnrc	Try locking Yarn version (#1066 )	2021-02-13 19:50:09 -08:00
deploy.sh	Migrate from yarn to pnpm	2025-07-06 13:20:28 -07:00
LICENSE.txt	Fix links in root README	2020-07-03 22:02:09 -07:00
netlify.toml	Migrate from yarn to pnpm	2025-07-06 13:20:28 -07:00
package.json	Migrate from yarn to pnpm	2025-07-06 13:20:28 -07:00
pnpm-lock.yaml	Migrate from yarn to pnpm	2025-07-06 13:20:28 -07:00
pnpm-workspace.yaml	Migrate from yarn to pnpm	2025-07-06 13:20:28 -07:00
README.md	Remove internet archive integration tests	2025-07-06 10:01:04 -07:00

README.md

Webamp

A reimplementation of Winamp in HTML5 and JavaScript with full skin support. As seen on TechCrunch, Motherboard, Gizmodo, Hacker News (1, 2, 3, 4), and elsewhere.

Check out this Twitter thread for an illustrated list of features. Works in modern versions of Edge, Firefox, Safari and Chrome. IE is not supported.

Read the docs

The Webamp Documentation site contains detailed instructions showing how to add Webamp to your site and customize it to meet your needs.

About This Repository

Webamp uses a monorepo approach, so in addition to the Webamp NPM module, this repository contains code for a few closely related projects and some pieces of Webamp which are published as standalone modules:

packages/webamp: The Webamp NPM module
packages/webamp/demo: The demo site which lives at webamp.org
packages/ani-cursor: An NPM module for rendering animiated .ani cursors as CSS animations
packages/skin-database: The server component of https://skins.webamp.org which also runs our Twitter bot, and a Discord bot for our community chat
packages/skin-museum-client: The front-end component of https://skins.webamp.org.
packages/winamp-eqf: An NPM module for parsing and constructing Winamp equalizer preset files (.eqf)
packages/webamp-modern: A prototype exploring rendering "modern" Winamp skins in the browser
examples: A few examples showing how to use the NPM module

Community

Join our community chat on Discord: https://discord.gg/fBTDMqR

Related communites:

Winamp Community Update Pack - "New plug-ins to add additional features to Winamp as well as replacement plug-ins to provide better implementations of some of the plug-ins natively included with Winamp". (Forum / Discord server)

In the Wild

An incomplete list of websites using Webamp:

Internet Archive - The Internet Archive lets you preview winamp skins and listen to audio tracks using Webamp
Winampify.io - An online Spotify client using Webamp
Webamp Desktop - An Electron app version of Webamp
98.js.org - A Windows 98 clone in JavaScript (GitHub)
winxp.now.sh - A Windows XP clone in JavaScript with React (GitHub)
Try Andy's Desk - A quirky Windows themed desktop experience.
www.dkdomino.zone - Someone's personal music player

Thanks

Butterchurn, the amazing Milkdrop 2 WebGL implementation. Built and integrated into Webamp by: jberg
Research and feature prototyping: @PAEz
Beta feedback, catching many small UI inconsistencies: LuigiHann
Beta feedback and insider answers to obscure Winamp questions: Darren Owen
Donating the webamp NPM module name: Dave Eddy

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.