WebX

A web player for your StreamX music server.

StreamX · StreamXBot · StreamX Project

Features

• Your library — search, albums, artists, topics, liked songs, playlists, history and most played
• Now playing — synced lyrics from LRCLIB, KuGou, Apple Music, YouTube Music and more, up next and track details
• Recaps — weekly, monthly and yearly stories from what you played
• Themes — built-in themes, colours from the playing artwork, or your own
• Playback — gapless queue, equaliser, audio quality and hi-res badges
• Integrations — Last.fm and Discord
• Installable — works as an app on desktop and phone

Screenshots

Now playing	Search
Library	Recaps
Themes and settings

Run it

Needs Node.js 20.19 or newer.

npm install
npm run dev

Set your server's address in Settings → Server & endpoints. When WebX is served from the same address as your server, it connects on its own.

Build

npm run build

The site is written to dist/. Host it anywhere that serves static files, or behind your StreamXBot server.

Command
npm run dev	Development server
npm run host	Development server on your network
npm run build	Production build
npm run preview	Preview the build
npm test	Tests
npm run lint	Lint
npm run typecheck	Type check

License

GPL-3.0