Self-hosted player, library manager, and metadata completer for music, podcasts, and audiobooks.
- Metadata completion: a matching engine, a review queue, and a full editor. New audio arrives by upload or straight from a URL.
- Podcasts and audiobooks are first-class: subscriptions, chapters, and resume are per-user and follow you across devices.
- Manual and smart playlists, internet radio, and scrobbling.
- Sonic discovery from analysis of your own files: instant mixes, similar tracks, sonic paths, and listening stats.
- Multi-device control and handoff, Chromecast, DLNA, and a jukebox.
- Public share links: hand anyone a track, playlist, book, or episode, no account needed.
- Subsonic and gpodder compatibility, so the apps you already use keep working.
- Accounts with per-library visibility and optional OIDC single sign-on; scheduled backups, an audit log, and migration from Navidrome or Audiobookshelf.
git clone https://github.com/ColeSpringer/WaxDeck.git && cd WaxDeck
make upThe first run writes deploy/.env; point WAXDECK_MUSIC and
WAXDECK_AUDIOBOOKS in it at your folders and make up again. Open
http://localhost:4420 and create the administrator. make down stops
the stack and keeps your data; your media are bind-mounted, never
copied.
Without Docker, make run (Go and Flutter, versions per CI) serves the same
thing as a single binary with the web UI embedded: originals stream
directly, and transcoding, gapless playback, and voice boost arrive
when you add the streaming engine.
Getting started covers both paths end to
end.
Without a clone, two files are the whole install:
mkdir -p waxdeck/music waxdeck/audiobooks && cd waxdeck
curl -fsSLO https://raw.githubusercontent.com/ColeSpringer/WaxDeck/main/deploy/compose.yaml
curl -fsSL https://raw.githubusercontent.com/ColeSpringer/WaxDeck/main/deploy/.env.example -o .env
chmod 600 .env
# .env: your music and audiobook folders, your uid and gid, a key (openssl rand -hex 24)
docker compose up -dThe stack is the server, the streaming engine, and WaxSeal for
full-quality YouTube; each sidecar is two lines in .env (its count
and its URL) to turn off. The
stack shares the host's network so casting works; Docker Desktop users
add the small override file from getting started.
The web app ships inside the server. The same Flutter app builds for
Android, Linux, and Windows from app/, and any Subsonic client or
gpodder podcast app can connect to the compatibility APIs.
On Android, add the F-Droid repository and each release arrives as an update (the fingerprint is part of the address):
https://colespringer.github.io/WaxDeck/repo?fingerprint=18BB5776333A744A3C0519BF9C019C09C745E0FFE5207AF5BF8F4D054D9CBE35
docs/ holds the guides: getting started, curation and metadata, podcasts and audiobooks, playlists and integrations, discovery, sharing, casting, administration, and running behind a reverse proxy.
make generate regenerates everything from the API contract and
make lint test is the gate on every change; the workflow lives in
CONTRIBUTING.md.
GPL-3.0-only (see LICENSE). Contributions are accepted under the project license with no CLA; see CONTRIBUTING.md.
