Headphones Logo Headphones

Build Status Build Status

Headphones is an automated music downloader for NZB and Torrent, written in Python. It supports SABnzbd, NZBget, Transmission, ĀµTorrent, Deluge and Blackhole.

Support & Discuss

You are free to join the Headphones support community on IRC where you can ask questions, hang around and discuss anything related to HP.

  1. Use any IRC client and connect to the Freenode server, irc.freenode.net.
  2. Join the #headphones channel.

Installation and Notes

Issues can be reported on the GitHub issue tracker considering these rules:

  1. Analyze your log, you just might find the solution yourself!
  2. You read the wiki and searched existing issues, but this is not solving your problem.
  3. Post the issue with a clear title, description and the HP log and use proper markdown syntax to structure your text (code/log in code blocks).
  4. Close your issue when it’s solved! If you found the solution yourself, please comment so that others benefit from it.

Feature requests can be reported on the GitHub issue tracker too:

  1. Search for similar existing ‘issues’, feature requests can be recognized by the label ‘Request’.
  2. If a similar Request exists, post a comment (+1, or add a new idea to the existing request), otherwise you can create a new one.

If you comply with these rules you can post your request/issue.

Support the project by implementing new features, solving support tickets and provide bug fixes.


Homepage (Artist Overview):

preview thumb

One of the many settings pages:

preview thumb

It might even know you better than you know yourself:

preview thumb

Import Your Favorite Artists:

preview thumb

Search Results:

preview thumb

Artist Page with Bio & Album Overview:

preview thumb

Album Page with track overview:

preview thumb


This is free software under the GPL v3 open source license. Feel free to do with it what you wish, but any modification must be open sourced. A copy of the license is included.