# Headphones

Headphones is an automated music downloader for NZB and torrent sources, written in Python. It is open source and self-hosted, installable on ZimaOS, Proxmox, Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/356/headphones

## Description

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, ZimaOS, Proxmox.

## Health score

40/100 (Fair), based on 4 of 5 factors.
- Maintained: 22 (last commit 508 days ago)
- Popular: 71 (3,754 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 41 (no serious findings, 9 minor, tests, OpenSSF Scorecard 2.1/10)

## Links

- ZimaOS: https://github.com/WisdomSky/CasaOS-LinuxServer-AppStore/tree/master/Apps/Headphones
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts/headphones/
- GitHub: https://github.com/rembo10/headphones
- Docker Hub: https://hub.docker.com/r/linuxserver/headphones
- Unraid: https://ca.unraid.net/apps/headphones-07ezhw10angqqt?q=headphones

## 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.

## Alternatives

- 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!

---
Source: Our Local Host (https://ourlocalhost.com/app/356/headphones), the self-hosted and open-source app directory.