Skip to content
DroppedNeedle
FeaturesEngineDocsAPI
Deploy
Documentation
Overview Getting Started Features Native Engine slskd Setup Usenet Setup Configuration FAQ API Reference

Docs

Overview Getting Started Features Native Engine slskd Setup Usenet Setup Configuration FAQ API Reference

▸ Documentation

Run it your way.

Everything you need to deploy, wire up and operate DroppedNeedle, from a one-container start to the native engine internals and the full REST API.

Getting Started

Install and run DroppedNeedle with Docker in minutes.

Read

Features

Everything DroppedNeedle does, end to end.

Read

Native Engine

How the engine identifies, downloads, tags and imports.

Read

slskd Setup

Wire up your own slskd over its local HTTP API.

Read

Usenet Setup

Download from Usenet with SABnzbd and Newznab indexers.

Read

Configuration

Sources, scrobbling, auth and security settings.

Read

FAQ

Common questions and troubleshooting.

Read

API Reference

The DroppedNeedle REST API (OpenAPI 3.1).

Read
DroppedNeedle

Self-hosted music requests and discovery, with a native library and download engine.

DroppedNeedle drives download clients you run, slskd or SABnzbd, over their local APIs. It never joins or distributes on the Soulseek network itself.

Product

FeaturesNative engineScreenshotsQuick start

Docs

Getting StartedFeaturesNative Engineslskd SetupUsenet SetupConfigurationFAQ API Reference

Community

GitHubDiscordKo-fiIssues

Powered by

  • MusicBrainz
  • AcoustID
  • Cover Art Archive
  • TheAudioDB
  • Wikidata
  • ListenBrainz
  • Last.fm
  • Spotify
  • Deezer
  • iTunes
  • Ticketmaster
  • Skiddle
  • slskd
  • SABnzbd

AGPL-3.0 · © 2025 Harvey Bragg

Built with SvelteKit · Space Grotesk & Hanken Grotesk