# Music Librarian

Music Librarian is a self-hosted downloaders app. Self-hosted, taste-driven companion app that automatically grows your Navidrome music library using your existing Soulbeet instance. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3081/music-librarian

## Description

Self-hosted, taste-driven companion app that automatically grows your Navidrome music library using your existing Soulbeet instance. It seeds from what your household actually plays (Navidrome play counts, Plex/Plexamp via Tautulli, and YouTube Music Takeout history), expands that taste through Last.fm, and downloads new releases preferring FLAC (free lossless audio codec) with a high-quality lossy fallback. It also keeps favorited artists' discographies current via MusicBrainz, can re-acquire older lossy albums as FLAC on a schedule, and tracks progress in SQLite so restarts resume exactly where they stopped. Built for homelab music stacks that want a hands-off, ever-growing library.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

50/100 (Fair), based on 3 of 4 factors.
- Maintained: 88 (last commit 117 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/music-librarian-1spoajk0gkmjn8?q=music-librarian

## Common questions

### Do I need Soulbeet and Navidrome already installed?

Yes. Music Librarian is a companion app, so it drives an existing Soulbeet instance and reads an existing Navidrome library. Both must already be running before using it.

### Which credentials and URLs must I configure?

Fill in LASTFM_API_KEY, SOULBEET_USER, and SOULBEET_PASS in secrets.env, and set SOULBEET_URL and NAVIDROME_URL to the host's LAN IP and ports. On bridge networking, do not use localhost.

### Do I need Tautulli for Plex/Plexamp play counts?

No, Tautulli is optional. You can optionally add TAUTULLI_API_KEY to use Plex/Plexamp play counts as an input.

### Can I expose the web UI behind a reverse proxy or tunnel?

No, do not put port 8730 behind a reverse proxy or tunnel. The UI is unauthenticated by design and can change download targets or delete files when upgrades are enabled.

### Does progress survive container restarts?

Yes, state is stored in SQLite, so restarts resume exactly where they left off.

---
Source: Our Local Host (https://ourlocalhost.com/app/3081/music-librarian), the self-hosted and open-source app directory.
