Headphones

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

  • Downloaders
  • 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 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (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.

39/100 Low

Maintained
19last commit 537 days ago
Popular
723,761 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
41no serious findings, 9 minor, tests, OpenSSF Scorecard 2.1/10

Based on 4 of 5 factors.

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

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

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

Resources & Compatibility

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

Checked 54 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 46 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 51 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 49 days ago - public community threads