# DroppedNeedle/DroppedNeedle

Repository: https://github.com/DroppedNeedle/DroppedNeedle
Canonical: https://ross.abutalabs.com/products/droppedneedle
Homepage: https://droppedneedle.com/
Language: Python
License: AGPL-3.0
License Family: copyleft
Topics: homelab, listenbrainz, music, musicbrainz, selfhosted
Last push: 2026-09-03T01:36:04+00:00

## Health v2 (maintenance only)
Score: 85/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 100, release rhythm 100, longevity 23
- inputs: {"age_days": 327, "days_push": 0, "days_rel": 0, "gap_med": 0, "n_releases_24m": 30}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1229, forks 61 (observed 2026-09-03T02:15:05.660979+00:00)

## What it is
DroppedNeedle is a self-hosted music request and discovery application with a built-in library and download engine that replaces Lidarr. It searches MusicBrainz, drives user-provided slskd or SABnzbd/Usenet clients, fingerprints and tags downloads with AcoustID and mutagen, and streams from Jellyfin, Navidrome, Plex, or local files while scrobbling to ListenBrainz and Last.fm.

## Use cases
- self-hosted lidarr alternative for downloading albums
- request music albums and tracks through a web UI
- automatically tag and organize downloaded music files
- search musicbrainz and download via slskd or usenet
- stream my music library from jellyfin or navidrome
- get music recommendations from my listening history
- scrobble to listenbrainz and last.fm
- identify and fingerprint music files with acoustid

## When to choose
- you want a single-container Lidarr replacement with a native download engine
- you already run slskd or SABnzbd and want automated album/track requests and imports
- you want a self-hosted music discovery and streaming front-end for Jellyfin, Navidrome, or Plex
- you need automatic fingerprinting, tagging, and file organization for a music library

## When to avoid
- you want the software itself to connect to the Soulseek P2P network - it only drives your own slskd instance
- you don't use Docker or don't want to run separate download clients
- you need a native desktop music player rather than a web-based server
- you want to download from sources other than slskd or Usenet

## Facets
- artifact type: application
- maturity: active
- function: search-engine, http-client, http-server, web-framework, api-framework, workflow-automation, file-system, audio-processing, nlp
- domain: self-hosted, audio, media, web-development, apis
- platform: self-hosted, python
- tags: music-downloader, lidarr-alternative, musicbrainz, slskd, soulseek, usenet, sabnzbd, listenbrainz, lastfm, jellyfin, navidrome, plex, opensubsonic, acoustid, audio-fingerprinting, music-library, homelab, arr-stack, scrobbling, music-discovery, automation, docker, web-server, linux

## Member repositories
- DroppedNeedle/DroppedNeedle (main) score 85

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:05.660979+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:21:07.888401+00:00, confidence not recorded.
  - readme: https://github.com/DroppedNeedle/DroppedNeedle (fetched 2026-09-03T02:15:05.660979+00:00, sha e0c8111b5ff7)
  - homepage: https://droppedneedle.com/ (fetched 2026-08-29T12:28:40.554945+00:00, sha 343902f231a7)
  - site_page: https://droppedneedle.com/docs (fetched 2026-08-29T12:28:40.557664+00:00, sha 152b6d301104)
  - site_page: https://droppedneedle.com/docs/api (fetched 2026-08-29T12:28:40.559295+00:00, sha a8cdb2faa2c1)
  - site_page: https://droppedneedle.com/docs/slskd-setup (fetched 2026-08-29T12:28:40.560916+00:00, sha 4ba1416e43e0)
  - site_page: https://droppedneedle.com/docs/getting-started (fetched 2026-08-29T12:28:40.562695+00:00, sha 7031085fc2e0)
  - site_page: https://droppedneedle.com/docs/features (fetched 2026-08-29T12:28:40.564308+00:00, sha 79b5b2a87725)
  - site_page: https://droppedneedle.com/docs/native-engine (fetched 2026-08-29T12:28:40.566215+00:00, sha 08b64c51dabb)
  - site_page: https://droppedneedle.com/docs/usenet-setup (fetched 2026-08-29T12:28:40.568081+00:00, sha 3f7c9ada62d3)
  - site_page: https://droppedneedle.com/docs/configuration (fetched 2026-08-29T12:28:40.569755+00:00, sha acfc7747820a)
- Data as of 2026-08-30T08:39:29.467469+00:00.