rembo10/headphones

Analysis updated 2026-07-03

★ 3,726PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

Mindmap

mindmap
  root((headphones))
    What it does
      Auto-download music
      Track new releases
      Organize library
    Download clients
      SABnzbd
      NZBget
      Transmission
      Deluge
    Web interface
      Artist overview
      Album pages
      Search function
    Setup
      Python service
      Background daemon
      GitHub wiki docs

mindmap root((headphones)) What it does Auto-download music Track new releases Organize library Download clients SABnzbd NZBget Transmission Deluge Web interface Artist overview Album pages Search function Setup Python service Background daemon GitHub wiki docs

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Set up Headphones to monitor your favorite artists and automatically download their new releases the moment they become available.

USE CASE 2

Connect Headphones to SABnzbd or a torrent client like Transmission so it queues and downloads music with no manual intervention.

USE CASE 3

Import your existing music library's artists into Headphones so it can identify and fill in missing albums automatically.

What is it built with?

Python

How does it compare?

	rembo10/headphones	orange-cyberdefense/arsenal	wwwzhouhui/dify-for-dsl
Stars	3,726	3,727	3,727
Language	Python	Python	Python
Setup difficulty	moderate	easy	easy
Complexity	3/5	2/5	2/5
Audience	general	ops devops	pm founder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires a separate NZB or torrent download client (SABnzbd, NZBget, Transmission, etc.) and a Usenet or torrent indexer subscription.

Released under GPL v3, you can use, share, and modify it freely, but any modified version you distribute must also be released as open source.

In plain English

Headphones is a Python application that automates downloading music from NZB and torrent sources. It runs as a background service and handles searching for, downloading, and organizing music without requiring manual intervention for each release. The application works with several popular download clients. For NZB-based downloading, which uses binary newsgroups, it supports SABnzbd and NZBget. For torrents it supports Transmission, uTorrent, Deluge, and a blackhole method where it drops torrent files into a folder for another client to pick up. Users set up their preferred client and Headphones communicates with it to queue downloads. The interface is web-based and includes an artist overview, album pages with track listings, artist biography information, and a search function for finding releases. Users can import their existing favorite artists and Headphones tracks new releases from those artists automatically. Installation and usage documentation lives in the project's GitHub wiki, with separate pages for installation steps, a usage guide, and a troubleshooting reference for common problems. Support is also available on IRC through the Freenode network in the #headphones channel. The project accepts bug reports and feature requests through the GitHub issue tracker, with guidelines asking users to check the log and search existing issues before posting. The software is released under the GPL v3 license, which requires that any modifications also be made open source.

Copy-paste prompts

Prompt 1

Walk me through setting up Headphones with SABnzbd so it can find and download new music releases on its own.

Prompt 2

How do I add a list of artists to Headphones and configure it to auto-download their new albums as soon as they appear?

Prompt 3

Show me how to troubleshoot Headphones when it finds a release but the download fails or gets stuck in the queue.

Prompt 4

How do I configure Headphones to use a torrent client with a blackhole folder instead of a direct API connection?

Prompt 5

What does the Headphones web interface show for each artist and how do I use it to manually trigger a search for a specific album?

Frequently asked questions

What is headphones?

A Python background service that automatically searches for, downloads, and organizes music from NZB and torrent sources, with a web interface for tracking favorite artists and getting new releases without manual effort.

What language is headphones written in?

Mainly Python. The stack also includes Python.

What license does headphones use?

Released under GPL v3, you can use, share, and modify it freely, but any modified version you distribute must also be released as open source.

How hard is headphones to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is headphones for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub rembo10 on gitmyhub

Verify against the repo before relying on details.