User:Wilfredor/webamp

🎵 Webamp on Commons – listen to audio files in a classic Winamp-style player

Hi all,

I've put together a small user script that brings Webamp (a faithful in-browser recreation of Winamp 2 by Jordan Eldredge) to Commons. It lets you:

  • Open a Winamp-style player on top of any Commons page (the page itself stays fully visible and usable).
  • Play every audio file in the current category as a playlist with one click — handy for browsing musical recordings, oral histories, bird songs, spoken Wikipedia articles, etc.
  • Define your own playlists in JSON on a user subpage and switch between them from inside the player's File menu.
  • The player remembers your last playlist between sessions, so reopening it continues where you left off.

How to install

Add this single line to your Special:MyPage/common.js:

importScript( 'User:Wilfredor/webamp.js' );

Save and do a hard refresh (Ctrl+F5 / Cmd+Shift+R). You will see:

  • A floating 🎵 button in the bottom-right corner of every page (and an entry in your personal menu).
  • On any audio category page, a 🎵 ▶ Reproducir esta categoría button next to the title.

Optional: your own playlists

Create Special:MyPage/webamp-playlists.json with content like:

[
  {
    "name": "Bach · Preludes",
    "tracks": [
      {
        "file": "File:Bach Cello Suite 1 Prelude (BWV 1007) Played by Chris.ogg",
        "title": "Cello Suite No. 1 — Prelude",
        "artist": "J. S. Bach"
      }
    ]
  }
]

Each playlist appears as an entry inside Webamp's File menu (right-click on the main window).

Notes & limitations

  • The script loads Webamp from unpkg.com on demand, only when you click the 🎵 button — no overhead on regular browsing.
  • Plays anything the browser's <audio> element supports: OGG Vorbis, FLAC, WAV, Opus, MP3.
  • Audio playback does not survive a full page navigation in the same tab — that is a hard browser limitation when the player lives in the page itself, not in a popup. Opening a new Commons page reopens the player with the same playlist on demand.
  • Source: User:Wilfredor/webamp.js · upstream project: github.com/captbaritone/webamp · license: MIT.

Feedback, bug reports and ideas welcome below. Wilfredor (talk) 14:53, 18 April 2026 (UTC)

  • See also: Wikiradio (maybe these two could be combined or integrate with each other?)
Category:Commons tools Category:Wikimedia projects and audio
Category:Commons tools Category:Wikimedia projects and audio