mirror of
https://github.com/captbaritone/webamp.git
synced 2026-01-23 10:15:31 +00:00
121 lines
6.8 KiB
Markdown
Executable file
121 lines
6.8 KiB
Markdown
Executable file
[](https://bundlephobia.com/result?p=webamp)
|
|
[](https://webamp.org/chat)
|
|
|
|
# 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](./packages/webamp/docs/press.md).
|
|
|
|
[](https://webamp.org)
|
|
|
|
Check out this [Twitter thread](https://twitter.com/captbaritone/status/961274714013319168) for an illustrated list of features. Works in modern versions of Edge, Firefox, Safari and Chrome. IE is [not supported](http://caniuse.com/#feat=audio-api).
|
|
|
|
## Read the docs
|
|
|
|
**The [Webamp Documentation](https://docs.webamp.org) 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](https://en.wikipedia.org/wiki/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`](https://github.com/captbaritone/webamp/tree/master/packages/webamp): The [Webamp NPM module](https://www.npmjs.com/package/webamp)
|
|
- [`packages/webamp/demo`](https://github.com/captbaritone/webamp/tree/master/packages/webamp/demo): The demo site which lives at [webamp.org](https://webamp.org)
|
|
- [`packages/webamp-docs`](https://github.com/captbaritone/webamp/tree/master/packages/webamp-docs): The documentation site for Webamp the NPM library which lives at [docs.webamp.org](https://docs.webamp.org)
|
|
- [`packages/ani-cursor`](https://github.com/captbaritone/webamp/tree/master/packages/ani-cursor): An NPM module for rendering animiated `.ani` cursors as CSS animations
|
|
- [`packages/skin-database`](https://github.com/captbaritone/webamp/tree/master/packages/skin-database): The server component of https://skins.webamp.org which also runs our [Twitter bot](https://twitter.com/winampskins), and a Discord bot for our community chat
|
|
- [`packages/winamp-eqf`](https://github.com/captbaritone/webamp/tree/master/packages/winamp-eqf): An NPM module for parsing and constructing Winamp equalizer preset files (`.eqf`)
|
|
- [`packages/webamp-modern`](https://github.com/captbaritone/webamp/tree/master/packages/webamp-modern): A prototype exploring rendering "modern" Winamp skins in the browser
|
|
- [`examples`](https://github.com/captbaritone/webamp/tree/master/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](https://getwacup.com/community/) / [Discord server](https://discord.gg/5pVTdbj))
|
|
|
|
## In the Wild
|
|
|
|
An incomplete list of websites using Webamp:
|
|
|
|
- [Internet Archive](https://blog.archive.org/2018/10/02/dont-click-on-the-llama/) - The Internet Archive lets you preview winamp skins and listen to audio tracks using Webamp
|
|
- [Winampify.io](https://winampify.io/) - An online Spotify client using Webamp
|
|
- [Webamp Desktop](https://desktop.webamp.org/) - An Electron app version of Webamp
|
|
- [98.js.org](https://98.js.org/) - A Windows 98 clone in JavaScript ([GitHub](https://github.com/1j01/98))
|
|
- [winxp.now.sh](https://winxp.now.sh/) - A Windows XP clone in JavaScript with React ([GitHub](https://github.com/ShizukuIchi))
|
|
- [Try Andy's Desk](https://desk.glitchy.website/) - A quirky Windows themed desktop experience.
|
|
- [www.dkdomino.zone](https://www.dkdomino.zone/album.html) - Someone's personal music player
|
|
|
|
## Thanks
|
|
|
|
- [Butterchurn](https://github.com/jberg/butterchurn), the amazing Milkdrop 2 WebGL implementation. Built and integrated into Webamp by: [jberg](https://github.com/jberg)
|
|
- Research and feature prototyping: @PAEz
|
|
- Beta feedback, catching many small UI inconsistencies: [LuigiHann](https://twitter.com/LuigiHann)
|
|
- Beta feedback and insider answers to obscure Winamp questions: [Darren Owen](https://twitter.com/The_DoctorO)
|
|
- Donating the `webamp` NPM module name: [Dave Eddy](http://daveeddy.com/)
|
|
|
|
Thank you to [Justin Frankel](http://www.1014.org/) 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](LICENSE.txt). That being said, if you do anything interesting with
|
|
this code, please let me know. I'd love to see it.
|
|
|
|
## Development
|
|
|
|
This repository uses [Turborepo](https://turbo.build/) for efficient monorepo management. Turborepo provides intelligent caching and parallel execution of tasks across all packages.
|
|
|
|
### Quick Start
|
|
|
|
```bash
|
|
# Install dependencies
|
|
pnpm install
|
|
|
|
# Build all packages (automatically handles dependencies)
|
|
npx turbo build
|
|
|
|
# Build library bundles for packages that need them
|
|
npx turbo build-library
|
|
|
|
# Run all tests
|
|
npx turbo test
|
|
|
|
# Lint and type-check all packages
|
|
npx turbo lint type-check
|
|
|
|
# Work on a specific package and its dependencies
|
|
npx turbo dev --filter="webamp"
|
|
```
|
|
|
|
### Package Dependencies
|
|
|
|
The monorepo dependency graph is automatically managed by Turborepo:
|
|
|
|
- `ani-cursor` and `winamp-eqf` are standalone packages built with TypeScript
|
|
- `webamp` depends on both `ani-cursor` and `winamp-eqf` for workspace linking
|
|
- All packages are built in the correct topological order
|
|
- Builds are cached and only rebuild what has changed
|
|
|
|
### Available Tasks
|
|
|
|
- `build` - Main build output (Vite for demos, TypeScript compilation for libraries)
|
|
- `build-library` - Library bundles for NPM publishing (only applies to `webamp`)
|
|
- `test` - Run unit tests with Jest
|
|
- `type-check` - TypeScript type checking without emitting files
|
|
- `lint` - ESLint code quality checks
|
|
- `dev` - Development server (for packages that support it)
|
|
|
|
For more details on individual packages, see their respective README files.
|
|
|
|
[techcrunch]: https://techcrunch.com/2018/02/09/whip-the-llamas-ass-with-this-javascript-winamp-emulator/
|
|
[motherboard]: https://motherboard.vice.com/en_us/article/qvebbv/winamp-2-mp3-music-player-emulator
|
|
[gizmodo]: https://gizmodo.com/winamp-2-has-been-immortalized-in-html5-for-your-pleasu-1655373653
|
|
[1]: https://news.ycombinator.com/item?id=8565665
|
|
[2]: https://news.ycombinator.com/item?id=15314629
|
|
[3]: https://news.ycombinator.com/item?id=16333550
|
|
[4]: https://news.ycombinator.com/item?id=17583997
|
|
[winamp community update pack]: https://getwacup.com/
|