Repolode
Submit
Dodelidoo-Labs

Dodelidoo-Labs/sonobarr

Self-hosted music discovery tool that pairs your Lidarr library with Last.fm recommendations and an AI-assisted web UI.

View on GitHub
Stars
382
Forks
5
Open issues
8
Last commit
2 months ago

What is it?

Sonobarr is a self-hosted web app for finding new artists based on your existing Lidarr music library. It pulls artists from Lidarr, looks up similar artists on Last.fm, and streams the results to a browser grid where you can listen to previews, read biographies, and add candidates back to Lidarr with one click.

Beyond Lidarr and Last.fm, it can draw seeds from your saved Last.fm scrobbles and ListenBrainz Weekly Exploration playlists. An optional AI assistant accepts a free-text mood or genre description and uses an OpenAI-compatible model to pick seed artists for a new session.

It is built with Flask and Socket.IO on the backend and a Bootstrap front end. Multi-user support includes role-based access, an artist request workflow with admin approval, per-user API keys, and optional OIDC single sign-on. It is deployed with Docker Compose using a configuration file and an environment file.

Key features

  • 01Syncs monitored Lidarr artists and sends selected additions back to Lidarr.
  • 02Builds discovery batches from Lidarr, Last.fm scrobbles, and ListenBrainz playlists.
  • 03AI assistant seeds sessions from a text description via OpenAI-compatible models.
  • 04Artist request workflow with admin approval and real-time Socket.IO updates.
  • 05Previews through YouTube or iTunes, plus Last.fm biographies and stats.
  • 06Supports OIDC single sign-on and per-user API keys.

Use cases

  • Finding new artists that match the taste reflected in an existing Lidarr library.
  • Sharing one self-hosted Lidarr instance among several household members with separate accounts.
  • Letting non-admin users request artists that an admin then approves for Lidarr.

Quick start

  1. 1

    Create a working directory and set its ownership to the container UID/GID

    mkdir -p sonobarr && cd sonobarr sudo chown -R 1000:1000 .
  2. 2

    Download the sample docker-compose.yml and .env configuration

    curl -L https://raw.githubusercontent.com/Dodelidoo-Labs/sonobarr/develop/docker-compose.yml -o docker-compose.yml curl -L https://raw.githubusercontent.com/Dodelidoo-Labs/sonobarr/develop/.sample-env -o .env
  3. 3

    Edit .env to set secret_key, Lidarr address and API key, and Last.fm API key and secret

  4. 4

    Start Sonobarr with Docker Compose and open http://localhost:5000

    docker compose up -d

Things to know

  • Requires a running Lidarr instance and Last.fm API key before it is useful.
  • Docker-first setup; the README gives no native non-Docker install path for end users.
  • Public API documentation is still upcoming.

In collections

Self-hosted apps

Topics

#music-discovery#lidarr#last-fm#self-hosted#flask#docker#artificial-intelligence#docker-compose#lidarr-companion

FAQ

What is sonobarr?
Self-hosted music discovery tool that pairs your Lidarr library with Last.fm recommendations and an AI-assisted web UI. Sonobarr is a self-hosted web app for finding new artists based on your existing Lidarr music library. It pulls artists from Lidarr, looks up similar artists on Last.fm, and streams the results to a browser grid where you can listen to previews, read biographies, and add candidates back to Lidarr with one click.
Is sonobarr free to use? What license does it have?
sonobarr is open source under the MIT license. Check the license terms before using it in commercial products.
Is sonobarr still maintained?
Updated within 6 months. The last commit to sonobarr was on Sep 9, 2026.
What can I use sonobarr for?
Finding new artists that match the taste reflected in an existing Lidarr library. Sharing one self-hosted Lidarr instance among several household members with separate accounts. Letting non-admin users request artists that an admin then approves for Lidarr.
How do I install sonobarr?
Create a working directory and set its ownership to the container UID/GID: mkdir -p sonobarr && cd sonobarr sudo chown -R 1000:1000 . Download the sample docker-compose.yml and .env configuration: curl -L https://raw.githubusercontent.com/Dodelidoo-Labs/sonobarr/develop/docker-compose.yml -o docker-compose.yml curl -L https://raw.githubusercontent.com/Dodelidoo-Labs/sonobarr/develop/.sample-env -o .env Edit .env to set secret_key, Lidarr address and API key, and Last.fm API key and secret Start Sonobarr with Docker Compose and open http://localhost:5000: docker compose up -d
Where can I get sonobarr?
The source code and installation instructions are on GitHub: https://github.com/Dodelidoo-Labs/sonobarr

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects