Music Librarian

Self-hosted, taste-driven companion app that automatically grows your Navidrome music library using your existing Soulbeet instance.

  • Downloaders
  • Media Applications
  • Tools & Utilities
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
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

50/100 Fair

Maintained
88last commit 117 days ago
Popular
00 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 20 days ago

GitHub stars
0
Open issues
0
Last commit
2026-07-27
License
MIT
Activity
unknown

Checked 6 days ago - source: GitHub (asherflynt/music-librarian)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Add your Music AI API key first Before sending any job, replace the placeholder API key in the Authorization header with your Music AI key, which is the secret code that lets your app use the service. Without it, Music AI will reject the request and your jobs will not start. source
  • Use a downloadable link for audio When creating a job, put a direct web address (URL) to the audio file in inputUrl, such as an https link from your own server or storage. If Music AI can’t download that file, the job fails with an error like “File not found.” source
  • Keep the job ID for checking results After you submit a job, save the returned job ID, which is a unique tracking number for that job. You need it later to check the status and get the links to the finished audio files. source
  • Requires existing Soulbeet and Navidrome Companion app, not a standalone downloader: it drives an existing Soulbeet instance and reads an existing Navidrome library, so both must already be set up and running first. source

Fetched 47 days ago - each note links to its source

Alternatives

No alternatives collected yet.

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.

Answers sourced from github.com

Community

Collected 49 days ago - public community threads