what it does sharing setup guide github ↗

What areyou listeningto?

Midnight Drive · Neon Harbor
logged from Navidrome · in your library

WAYL answers that for you. It runs on your own server, logs everything you play on Plex or Navidrome, and streams your own music in the browser. Your listening history stays on your machine.

what it does

A log of everything you play.

WAYL runs next to the music server you already have. Keep using your usual player, and WAYL keeps the record.

  • Logs plays on its ownPlays on Plex and Navidrome are logged automatically. Any player that can scrobble to ListenBrainz can send its plays to WAYL too.
  • Finds any songSearch uses the open MusicBrainz and ListenBrainz databases. You don't need an API key or a catalog of your own.
  • Plays your own filesSongs on your server play right in the browser. The audio passes through WAYL, so your server's address and login stay hidden.
  • Keeps playlists in syncMake playlists in WAYL, or mirror the ones on your server and keep them up to date.
  • Shows your top songsYour most played songs and artists for the last week, month, year, or any range you pick.
  • Stays on your machineEverything lives in one SQLite file on your server, and server logins are stored encrypted. There's no tracking and no cloud account.

getting started

Running in about five minutes.

If your machine runs Docker, it can run WAYL.

full setup guide ↗

  1. Start it

    Clone the repo and run docker compose up -d. That starts the app and a small worker that keeps it in sync.

  2. Connect your server

    Add Navidrome with its address and login, or sign in with Plex. WAYL indexes your library and starts logging.

  3. Listen as usual

    WAYL logs every play, marks the songs you own and builds your stats as you go.

in development

Share playlists between servers.

Your WAYL can publish a read-only link to a playlist. A friend pastes it into their own WAYL and sees which songs they already have. They play those from their own server and can copy the playlist into theirs.

Only song details are shared, never audio. You can turn any link off or reset it, and your recent listens stay private unless you choose to share them.

questions

Before you install.

Do I need Plex or Navidrome?

No. Without a server you can still search, log songs by hand, make playlists and see your stats. Connecting a server adds automatic logging, owned marks and streaming.

What about Jellyfin or other servers?

WAYL connects directly to Navidrome and other Subsonic-compatible servers, and to Plex. Any player that can send plays to a custom ListenBrainz server can also log to WAYL, using a token from Settings.

Can I use it from my phone?

Yes, as long as your phone can reach your WAYL: through a reverse proxy with HTTPS, or a private network like Tailscale. The setup guide covers both. A mobile app is planned.

Can my household share one install?

Yes. Everyone makes their own account, and each person's servers, plays and playlists stay separate.

Does it convert audio formats?

Not yet. Files play as they are, so your browser needs to support the format. MP3, AAC, FLAC, Ogg and Opus all work in current browsers. ALAC usually doesn't.

What does it cost?

Nothing. It runs on your own hardware, and the song data comes from free, open databases.

Start your music log.

All you need is a machine that runs Docker.