mirror of https://github.com/captbaritone/webamp.git synced 2026-08-02 06:52:19 +00:00

No description

html5 javascript port reimplementation webaudio-api winamp

Find a file

Jordan Eldredge 6a71878a98 First attempt at adopting Parcel (#1186 ) * Upgrade sharp * First attempt at adopting Parcel * Get multiple targets working for Parcel * Use lts node for Netlify deploy * Update deploy script to reflect new demo site dir * Inline css into library bundles * More updates * Remove uri optimization * Upgrade parcel * Fix butterchurn logo import for Parcel * Add browser build * List browser build * Prefer jest-swc to babel * Preserve old build artifact location * Ignore dist * Minify library bundles * Switch to postcss to use uri optimization plugin * Serve from the correct location * Clarifying comments * Ignore bundle reports in git * Refine Parcel builds * Try to be more explicit with port * Use relative path to create build dir * Try to force supporting chrome 76 * Update the location of the test skin in integration test to work with Parcel		2023-01-20 11:15:39 -08:00
.github/workflows	First attempt at adopting Parcel (#1186 )	2023-01-20 11:15:39 -08:00
.yarn/releases	Try locking Yarn version (#1066 )	2021-02-13 19:50:09 -08:00
config	First attempt at adopting Parcel (#1186 )	2023-01-20 11:15:39 -08:00
examples	Enable top-level lint	2022-03-06 23:05:11 -08:00
packages	First attempt at adopting Parcel (#1186 )	2023-01-20 11:15:39 -08: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	Move skin stuff to their own packages	2020-05-17 22:24:35 -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	First attempt at adopting Parcel (#1186 )	2023-01-20 11:15:39 -08:00
.yarnrc	Try locking Yarn version (#1066 )	2021-02-13 19:50:09 -08:00
deploy.sh	First attempt at adopting Parcel (#1186 )	2023-01-20 11:15:39 -08:00
LICENSE.txt	Fix links in root README	2020-07-03 22:02:09 -07:00
netlify.toml	First attempt at adopting Parcel (#1186 )	2023-01-20 11:15:39 -08:00
package.json	First attempt at adopting Parcel (#1186 )	2023-01-20 11:15:39 -08:00
README.md	Remove reference to modern2	2022-09-21 20:14:55 -07:00
yarn.lock	First attempt at adopting Parcel (#1186 )	2023-01-20 11:15:39 -08:00

README.md

Webamp

A reimplementation of Winamp 2.9 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.

Add Webamp to Your Site

Here is the most minimal example of adding Webamp to a page:

<div id="app"></div>
<script src="https://unpkg.com/webamp"></script>
<script>
    const app = document.getElementById("app")
    const webamp = new Webamp();
    webamp.renderWhenReady(app);
</script>

For more examples, including how to add audio files, check out examples/ directory and the API documentation.

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/archive-org-webamp-integration-tests: An integration that confirms that archive.org's Webamp integration is working as expected
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 Mikdrop 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.