self-hosted · single binary · mit

Your music library, self-hosted and automated

Groovearr searches, downloads, verifies, and organizes music from multiple sources through a single web UI. One static Go binary with the frontend embedded — no media server, no database server, nothing to babysit.

runtime
1 binary
database
embedded SQLite
media server
not required
Groovearr web UI: Radiohead discography in the discovery view

lean by design

Everything in one static binary

Backend and web UI ship together via go:embed. Run one file, open the browser — the only external services are the download sources you choose to connect.

Single static binary

Go backend with the web UI embedded via go:embed. One file, one process — run it and the UI is there.

No media server required

No Plex, Jellyfin, or Navidrome dependency. Point Groovearr at a folder — it scans, tags, and organizes into your library.

Small footprint

Embedded SQLite (pure Go, no CGO) and a handful of small dependencies. Comfortable on modest hardware.

the real thing

See it in action

Screenshots from the running application. Search across sources, watch downloads land in real time, browse the organized library.

Groovearr search page across multiple sources

search

One query, every configured source. Cross-source matching engine picks the right release.

Groovearr discovery: album tracklist with download button

discover

Find an album, see the exact tracklist, download it in one click.

Groovearr downloads page with live progress

downloads

Queued → downloading → import → library. Progress streamed live over SSE.

Groovearr music library with artists

library

SQLite-backed artist, album, and track catalog. Tagged, organized, browsable.

features

Everything a self-hosted download manager needs

From the first search to a fully organized, tagged library — Groovearr handles the pipeline so you don't have to.

Multi-source search

Soulseek (via slskd), Deezer, Tidal, and RuTracker — with a cross-source matching engine that finds the right release.

Download pipeline

queued → downloading → import → library, with live progress streamed to the UI via Server-Sent Events.

Plugin architecture

Add a source or metadata provider by implementing a single interface — no core changes required.

Music library

SQLite-backed artist, album, and track database with a filesystem scanner keeps your collection in sync.

Playlist import

Import Deezer playlists, sync changes over time, and auto-download the missing tracks straight into your library.

Auto-organization

Configurable folder templates like {artist}/{album} ({year}) keep every file where it belongs.

Tag writing

ID3 and FLAC metadata is written automatically on import, so your library stays clean for any player.

Cover art

Album art fetched and cached during import, so every album in your library has the right artwork.

Quality profiles

Ranked targets like FLAC → MP3 320, search modes, and an upgrade scanner that flags below-target tracks in your library.

fast by architecture

Built to not waste your time

A download manager's real cost is wasted work — the wrong release, the missing track, the manual re-order. Groovearr's architecture removes that work before it happens.

Verified before download

album_search resolves the MusicBrainz tracklist and matches the track count before grabbing — wrong releases never reach your disk.

Per-track and per-album

One queue, two paths: single tracks pull direct from Deezer, Tidal, or Soulseek — albums grab as torrents from RuTracker via qBittorrent.

Live source ordering

Reorder download sources or metadata priority in the UI — applied everywhere instantly, no restart.

Real-time progress

Server-Sent Events push download and import progress to the UI — no polling, no refresh.

A good citizen

Per-endpoint rate limiting plus exponential backoff with jitter keeps bulk operations off the bad side of the sources you connect.

Capability-based core

Every source is an isolated plugin — download, album_search, torrent, metadata — behind one interface. The core stays minimal; adding a source doesn't bloat it.

sources & metadata

Connect what you already use

Configure everything in the web UI — no config file editing. Downloads come from the sources you choose; every release is enriched with metadata from multiple providers.

Download sources

  • Soulseek — peer-to-peer via slskd daemon
  • Deezer — high-quality streaming source (ARL auth)
  • Tidal — lossless & high-res catalog
  • Prowlarr — RuTracker via Torznab, downloaded via qBittorrent

    Dedicated album_search capability — finds the release at the album level, then verifies the exact tracklist (track count + MusicBrainz) before anything downloads.

Metadata providers

  • Spotify · Deezer · Discogs · MusicBrainz
  • Cover Art Archive · Last.fm
  • Quality ranking & rate-limited by endpoint

quick start

Running in minutes

Docker for the full stack, or just the binary. Either way, you configure everything through the setup wizard and web UI.

Docker

Recommended

# full stack: Groovearr + slskd + Prowlarr + qBittorrent

$ cp .env.example .env

$ make docker-setup

$ docker compose up -d

# setup wizard → connect your sources

$ open http://localhost:8008

Single binary

# requires Go 1.26+ and Node 18+ for the UI build

$ make build

# binary at ./build/groovearr

$ ./build/groovearr

# creates config + library.db on first run

$ open http://localhost:8008

Ready to dive in?

Setup guide, architecture, API reference, and plugin development docs are all in the repository.