selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Musicseerr logo

Self-host Musicseerr

v3.0.0

Music request engine with native download pipeline

ReleaseOpen SourceAGPL-3.0
Updatedyesterday
LanguageRust
Setup difficultyModerate
Stars
1 561
Port
8688 (Web UI and API)
Docker
droppedneedle/droppedneedle
Install with Docker Compose
Home dashboard with trending artists, popular albums, and personalized recommendationsDiscover page with personalized album recommendationsLibrary overview with statistics and recent additionsListening Room with local files library stats and playerSettings and configuration page

What is Musicseerr?

DroppedNeedle is a self-hosted music request and discovery application. Users search the MusicBrainz database and request albums or individual tracks. The software then controls your personal slskd or SABnzbd instance to retrieve files. Every downloaded file is verified using AcoustID fingerprinting, tagged with MusicBrainz metadata, and organized into your collection. A built-in web player offers playback queue, shuffle, a 10-band equalizer, and real-time now-playing updates. Discovery features include personalized recommendations based on ListenBrainz and Last.fm history, automatic tracking of new releases with optional downloading, and concert notifications from Ticketmaster and Skiddle. Multi-user access uses Admin, Trusted, and User roles with authentication options including local accounts, Jellyfin, Plex, or any OIDC identity provider. The library streams to several media servers and local files, while any OpenSubsonic or Jellyfin-compatible client can connect directly. Deployment is a single Docker container configured through the web interface. Licensed under AGPL-3.0 with no paid tiers or telemetry.

Should you self-host Musicseerr?

Musicseerr scores 64/100 on selfhost.directory (how scoring works) and ranks #8 of 59 in Music Streaming. It has 1 561 GitHub stars, +83 in the last 30 days.

It shipped 35 stable releases in the past year. The latest, v3.0.0, came out on 14 November 2026. New versions land roughly every 1 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Rust.

Its closest alternative on selfhost.directory is Mediarium (60/100, 321 stars). Musicseerr scores higher overall. See Musicseerr vs Mediarium side by side.

Features

  • Built-in web player
  • Cross-source playlists
  • Discovery and recommendations
  • Drop imports
  • Free music from Internet Archive
  • Gig alerts
  • Library management with Picard-style tags
  • Multi-user with roles
  • MusicBrainz catalogue search
  • Native download pipeline
  • New-release radar
  • OIDC Authentication
  • OpenSubsonic/Jellyfin API
  • Quality floors and upgrades
  • Wanted watcher with auto-retry

Musicseerr README

DroppedNeedle

Request music. Own everything.

DroppedNeedle is a self-hosted music request and discovery app for you and the people you share a server with. Search MusicBrainz, request an album or a single track, and it fetches it through your own slskd or SABnzbd, checks every file and files it in your library. Then play it in the browser, or in Symfonium, Finamp, Feishin and other Subsonic or Jellyfin apps.

One container. No Lidarr.

CI License: AGPL-3.0 GitHub Stars Docker Hub Discord Docs

Docs | Website | Discord | Issues | Sponsor


Home page with your library, drop imports and popular albums

How to install Musicseerr

Install Musicseerr with Docker Compose

Environment variables
PUID, PGID, UMASK, PORT, BIND_HOST, TRUSTED_PROXY_IPS, TZ, SLSKD_DOWNLOADS_PATH

services: droppedneedle: image: droppedneedle/droppedneedle:latest container_name: droppedneedle environment: - PUID=1000 # run id on your host to find your user/group ID - PGID=1000 - UMASK=027 # secure default; 002 for trusted group-writable media - PORT=8688 - TZ=Etc/UTC # e.g. Europe/London, America/New_York - SLSKD_DOWNLOADS_PATH=/data/slskd/complete ports: - "8688:8688" volumes: - ./config:/app/config - ./cache:/app/cache - ./plugins:/app/plugins # omit and installed plugins vanish on recreate # One shared parent mount keeps the library and completed downloads on one # boundary so imports move fast. Do not nest extra binds under /data. - /path/to/media:/data:rw restart: unless-stopped healthcheck: test: ["CMD", "curl", "-f", "http://localhost:8688/health"] interval: 30s timeout: 10s start_period: 10m

Requires a music library path and a download client (slskd or SABnzbd) configured via web UI after first run.

Musicseerr releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Is it really free?

Yes. Open source under AGPL-3.0, with no paywall, lock-in or telemetry.

Can more than one person use it?

Yes. Admin, trusted and standard roles, with login via username, Jellyfin, Plex or any OIDC provider.

Can I point my own music app at it?

Yes. DroppedNeedle speaks the OpenSubsonic and Jellyfin APIs, so clients like Symfonium, Finamp or Feishin can play your library directly. Turn it on in Settings > Connect Apps and create a revocable app-password.

Where can I play and scrobble?

Stream from Jellyfin, Navidrome, Plex or local files, with YouTube previews for what you haven't downloaded. Scrobble to ListenBrainz and Last.fm, per user.

Can it follow artists and find gigs?

Follow an artist and DroppedNeedle watches for new releases, with the option to auto-download them as they land. Connect Ticketmaster and Skiddle, pick your cities, and it lists upcoming concerts for the artists you follow.

Does it manage quality and disk space?

Yes. Set a minimum quality per format and anything below it is rejected. When a better copy of an album you own turns up, the engine swaps it in and keeps the originals in a recycle bin. A global storage cap and per-user quotas stop the library filling the disk.

Why must slskd's downloads folder share a filesystem with my library?

Imports are atomic moves. A cross-filesystem mount can't be renamed in place, so bind-mount slskd's downloads directory read-write on the same filesystem as your music.

What do I need to run it?

Docker, a music folder, and at least one download client you run: slskd (0.25.0 or newer) with a shared folder and an API key, or SABnzbd with Newznab indexers. Everything else is configured from the web UI.

Can I use Usenet instead of slskd?

Yes. DroppedNeedle downloads from Usenet through SABnzbd with Newznab indexers, from your own slskd, or from both at once. A source-priority setting decides which is tried first.

Do I still need Lidarr?

No. The native engine replaces it entirely: scanning, identification, downloading, fingerprinting, tagging and organising are all built in.

Does DroppedNeedle download from Soulseek?

No. It talks to your own running slskd over slskd's local HTTP API and imports the results. It has no Soulseek protocol code itself. You run, and are responsible for, slskd and its shared folders.

More in Music Streaming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…