nest/k3s
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions
k3s/documentation/user-facing/media-and-entertainment/droppedneedle.md
KnightArtorias d3e8ce1978 Correct mistakes regarding media requests
2026-07-24 08:13:10 -04:00

2.8 KiB
Raw Blame History

DroppedNeedle — Music Discovery & Streaming

DroppedNeedle is a music discovery and streaming service that searches multiple sources (including Usenet and Soulseek) to find and play music. Think of it as a personal Spotify powered by community-shared libraries.

Access

Features

  • Search across multiple music sources simultaneously
  • Stream found tracks directly in the browser or mobile app
  • Automatic FLAC-to-Opus transcoding for storage efficiency
  • Library management and playlist creation
  • Integration with slskd for Soulseek P2P searches

Getting Started

  1. Open https://heron.mynest.love in your browser or mobile app.
  2. Click Sign In and choose Sign in with The Nest.
  3. Use the search bar to find a song, album, or artist.
  4. Click play — DroppedNeedle will locate and stream the best available source.

How Music Requests Work

DroppedNeedle lets you discover and request music yourself — no admin intervention needed. Here's how it works:

  1. Search for a song, album, or artist using the search bar.
  2. DroppedNeedle queries multiple sources simultaneously:
    • Usenet indexers for high-quality releases
    • slskd for Soulseek peer shares
    • Local library for music already stored on The Nest
  3. Browse the results and click Play to stream immediately, or Download to add it to your library.
  4. If a source isn't available, DroppedNeedle can queue a request — the media automation pipeline will handle downloading it when possible.

Tip

Music requests are handled by you directly through DroppedNeedle's interface. Just search and play!

How It Finds Music

DroppedNeedle queries multiple backends:

  • Usenet: Searches indexed Usenet groups for high-quality releases (requires working indexer configuration).
  • Soulseek: Queries the slskd instance running in The Nest for peer-shared files.
  • Local library: Plays music already stored on The Nest's NFS share.

Tips

  • Search tips: Use specific album or artist names for better results. DroppedNeedle prioritizes higher-bitrate sources.
  • Transcoding: FLAC files are automatically transcoded to Opus (160 kbps) when streamed. Originals remain on disk.
  • Mobile streaming: Use the DroppedNeedle mobile app (if available) or your device's built-in browser for the best experience.

Related Services

  • slskd — Soulseek P2P client that feeds DroppedNeedle searches
  • Sonarr/Radarr — Automated movie/TV downloads (not music)

TODO: Add screenshot of DroppedNeedle search results page.