← Directory

Headphones

Headphones is an automated music downloader for NZB and torrent sources, written in Python.

  • Media Applications
  • Media Servers
  • Tools & Utilities
Headphones is an automated music downloader for NZB and torrent sources, written in Python. It works with SABnzbd, NZBget, Transmission, µTorrent, Deluge and Blackhole, making it easy to grab new music and keep your library up to date.

Platform availability

Available on 3 of 9 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

40/100 Fair

Maintained
23last commit 498 days ago
Popular
713,754 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 14 days ago

GitHub stars
3,754
Open issues
532
Last commit
2025-06-01
Latest release
v0.6.4
License
GPL-3.0
Activity
stale

Checked 4 days ago - source: GitHub (rembo10/headphones)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 15 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install Python 3 and Git first Before running Headphones from source, make sure Git and Python 3 are installed, then clone the app and run Headphones.py. If those tools are missing, the install steps and startup will fail. source
  • Let other devices reach the web UI If you want to open Headphones from another computer or phone, change the network address in config.ini from localhost to 0.0.0.0. Without that, only the machine running Headphones can see it. source
  • Set up user, folders, and permissions For Linux service installs, create the service user and set ownership on the Headphones folder and config file before starting it. Wrong permissions can stop the service from starting or from saving your settings. source

Fetched 7 days ago - each note links to its source

Alternatives (5)

  • Free Music Downloader - Free Music Downloader MP3 for Windows XP/Vista/7/8 and MAC OS The most lightweight mp3 downloader compatible with Windows.
  • Lacey - Download your favorite music and video for free.
  • Lidarr - Lidarr is a music collection manager for Usenet and BitTorrent users.
  • MP3base
  • Mp3jam - Search for favorite music and download full albums with one click!

Checked 12 days ago - source: AlternativeTo

Common questions

Which download clients does Headphones support?

It supports SABnzbd, NZBget, Transmission, µTorrent, and Blackhole.

Where can I find installation, usage, and troubleshooting help?

The installation page shows how to install Headphones, the usage guide introduces you to it, and the troubleshooting page in the wiki can help with common problems.

How should I report issues?

Issues can be reported on the GitHub issue tracker, and you should analyze your log first because it may contain the solution.

What folder-access issue do self-hosters report with Docker?

Users report that, in a Docker setup, Headphones can fail to see the download folders or music folders.

Answers sourced from github.com, www.reddit.com

Community

Collected 10 days ago - public community threads