Automatic music downloader for SABnzbd

Overview

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.

Screenshots

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

License

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.

Comments
  • Select as wanted doesn't work

    Select as wanted doesn't work

    When I select a group of files as wanted, Headphones starts a search in the providers, stop when find the first file and pops a red message in the browser saying I didn't add anything.

    opened by iranssantos 0
  • Where does it get the track names from.. these dont appear anywhere

    Where does it get the track names from.. these dont appear anywhere

    Are they embedded in the mp3? Tge tracks are fine.

    2022-11-16 09:55:33WARNINGCould not identify /share/Sabdownloads/Complete/Jukebox/Jean-Michel Jarre - Téo & Téa (2007). It may not be the intended album2022-11-16 09:55:33 DEBUGTotal tracks for this album in the database: 22022-11-16 09:55:33 DEBUGTotal music files in /share/Sabdownloads/Complete/Jukebox/Jean-Michel Jarre - Téo & Téa (2007): 132022-11-16 09:55:33 DEBUGFilename check failed. Verifying album length...2022-11-16 09:55:33 DEBUGChecking if track title: teo & tea (benny benassi remix) (radio edit) is in file name: /share/sabdownloads/complete/jukebox/jean michel jarre teo & tea (2007)/06 jean michel jarre teo & tea (2007) partners in crime, pt 12022-11-16 09:55:33 DEBUGChecking if track title: teo & tea (radio edit) is in file name: /share/sabdownloads/complete/jukebox/jean michel jarre teo & tea (2007)/06 jean michel jarre teo & tea (2007) partners in crime, pt 12022-11-16 09:55:33 DEBUGChecking if track title: teo & tea (benny benassi remix) (radio edit) is in file name: /share/sabdownloads/complete/jukebox/jean michel jarre teo & tea (2007)/12 jean michel jarre teo and tea (2007) melancholic rodeo2022-11-16 09:55:33

    opened by potestus 0
  • Headphones search finds download but gets generic error and doesn't send to torrent client?

    Headphones search finds download but gets generic error and doesn't send to torrent client?

    So I updated from the python 2 version to python 3 and now I can't for some reason send torrents to my qbittorent 4.3.3 client to download. It finds the content on rutracker but then nothing happens? there is nothing in the logs to explain it I just get a generic " There was an error" in the headphones web interface.

    wtf

    opened by RgHVcN2bvs9xbP4z 5
  • search term including

    search term including "various artists" does not return results on redacted

    When setting a various artists album to wanted "various artists - " is prepended to the album title in the search term sent to the indexer. Redacted does not return results for various arists albums when the search is crafted this way, only the album title works. This has been tested on the site gui and the behavior is the same. Can you set searches toward redacted to strip the "various artists - " portion or provide a toggle for this that defaults to on, in the event that redacted changes this behavior in the future?

    opened by cinico-gmail 1
  • Pirate Bay Not Finding Results

    Pirate Bay Not Finding Results

    I have been using headphones for a while now and it has worked in the past and I've always used pirate bay as my search provider. However, it hasn't found any new music in quite a long time.

    Headphones Version: 83398cb10231087399e284daf9245dbfedbfd005 Pirate Bay Proxy URL: Tried blank (Default) and https://thepiratebay.org

    Logs (Using RHCP as example): 26-May-2022 09:29:43 - INFO :: ('CP Server Thread-11',) : Marking album: 0580e402-e6e8-4b5b-894a-399a10c63adb as wanted... 26-May-2022 09:29:43 - INFO :: ('CP Server Thread-11',) : Searching for wanted albums 26-May-2022 09:29:43 - INFO :: ('CP Server Thread-11',) : Searching for "Red Hot Chili Peppers - Unlimited Love" since it was marked as wanted 26-May-2022 09:29:43 - DEBUG :: ('CP Server Thread-11',) : Using search term: Red Hot Chili Peppers Unlimited Love 26-May-2022 09:29:43 - INFO :: ('CP Server Thread-11',) : Searching The Pirate Bay using term: Red Hot Chili Peppers Unlimited Love 26-May-2022 09:29:43 - DEBUG :: ('CP Server Thread-11',) : Requesting URL via GET method: https://thepiratebay.org/search/Red Hot Chili Peppers Unlimited Love/0/7/101 26-May-2022 09:29:45 - INFO :: ('CP Server Thread-11',) : No results found from The Pirate Bay using term: Red Hot Chili Peppers Unlimited Love 26-May-2022 09:29:45 - INFO :: ('CP Server Thread-11',) : No more results found for: Red Hot Chili Peppers - Unlimited Love

    Using the requesting URL, I see multiple results in the browser:

    image

    opened by wymangr 1
Releases(v0.6.0)
  • v0.6.0(Nov 13, 2022)

  • v0.6.0-beta.5(Feb 22, 2022)

  • v0.6.0-beta.4(Feb 14, 2022)

  • v0.6.0-beta.3(Feb 8, 2022)

  • v0.6.0-beta.1(Feb 1, 2022)

  • v0.6.0-alpha.1(Jan 18, 2022)

    What's Changed

    • Switch to python3
    • Libraries updated

    Full Changelog: https://github.com/rembo10/headphones/compare/v0.5.20...v0.6.0-alpha.1

    Source code(tar.gz)
    Source code(zip)
  • v0.5.20(Oct 15, 2021)

    Many thanks to @AdeHub for keeping the ship afloat. And to everyone who contributed during this time.

    What's Changed

    • Items from torznab are not returned when size is defined as torznab:attr by @mirwan in https://github.com/rembo10/headphones/pull/3104
    • sort Apollo.rip results by number of seeders by @nopoz in https://github.com/rembo10/headphones/pull/3124
    • fixes #3110 by @nopoz in https://github.com/rembo10/headphones/pull/3128
    • Workaround for issue #2674 by @permster in https://github.com/rembo10/headphones/pull/3151
    • fix typo by @cheese1 in https://github.com/rembo10/headphones/pull/3144
    • Replace apollo.rip with orpheus.network by @nopoz in https://github.com/rembo10/headphones/pull/3160
    • Redacted: use a FL token when available by @hypsometric in https://github.com/rembo10/headphones/pull/3165

    New Contributors

    • @mirwan made their first contribution in https://github.com/rembo10/headphones/pull/3104
    • @cheese1 made their first contribution in https://github.com/rembo10/headphones/pull/3144

    Full Changelog: https://github.com/rembo10/headphones/compare/v0.5.19...v0.5.20

    Source code(tar.gz)
    Source code(zip)
  • v0.5.19(Mar 27, 2018)

    Released 27 March 2018

    Highlights:

    • Improved: Windows encoding fixes
    • Improved: Performance enhancements
    • Improved: Many more since the last release. Check the list

    The full list of commits can be found here.

    Source code(tar.gz)
    Source code(zip)
  • v0.5.18(Dec 1, 2016)

    Released 01 December 2016

    Highlights:

    • Added: PassTheHeadphones support
    • Fixed: Special characters in password fields breaking on config page
    • Improved: Updated t411 url

    The full list of commits can be found here.

    Source code(tar.gz)
    Source code(zip)
  • v0.5.17(Nov 10, 2016)

    Released 10 November 2016

    Highlights:

    • Added: t411 support
    • Fixed: Rutracker login
    • Fixed: Deluge empty password
    • Fixed: FreeBSD init script
    • Improved: Musicbrainz searching

    The full list of commits can be found here.

    Source code(tar.gz)
    Source code(zip)
  • v0.5.16(Jun 9, 2016)

  • v0.5.15(Jun 7, 2016)

    Released 07 June 2016

    Hotfix update

    Highlights:

    • Fixed: Update vip mirror url to point to new server
    • Fixed: Update waffles url to .ch

    The full list of commits can be found here.

    Source code(tar.gz)
    Source code(zip)
  • v0.5.14(Jun 2, 2016)

    Released 02 June 2016

    Highlights:

    • Fixed: File/folder format on new installs
    • Fixed: Pep8 errors
    • Improved: Updated fontawesome
    • Improved: Reverted back to less

    The full list of commits can be found here.

    Source code(tar.gz)
    Source code(zip)
  • v0.5.13(Feb 25, 2016)

    Released 25 February 2016

    Another hotfix update

    Highlights:

    • Fixed: Saving config with non-defined options
    • Fixed: Pep8 errors

    The full list of commits can be found here.

    Source code(tar.gz)
    Source code(zip)
  • v0.5.12-1(Feb 25, 2016)

  • v0.5.12(Feb 25, 2016)

    Released 25 February 2016

    This is mostly a hotfix update

    Highlights:

    • Added: Experimental Deluge Support
    • Fixed: Some pep8 stuff
    • Improved: Use curly braces for pathrender optional variables

    The full list of commits can be found here.

    Source code(tar.gz)
    Source code(zip)
  • v0.5.11(Feb 20, 2016)

    Released 20 February 2016

    Highlights:

    • Added: Soft chroot option
    • Fixed: Post processing temporary directory fix (#2504)
    • Fixed: Ubuntu init script (#2509)
    • Fixed: Image cache uncaught exception (#2485)
    • Improved: $Date/$date variable in folder renaming
    • Improved: Reuse transmission session id

    The full list of commits can be found here.

    Source code(tar.gz)
    Source code(zip)
  • v0.5.10(Jan 29, 2016)

    Released 29 January 2016

    Highlights:

    • Added: API option to post-process single folders
    • Added: Ability to specify extension when re-encoding
    • Added: Option to stop renaming folders
    • Fixed: Utorrent torrents not being removed (#2385)
    • Fixed: Torznab to transmission
    • Fixed: Magnet folder names in history
    • Fixed: Multiple torcache fixes
    • Fixed: Updated requests & urllib3 to latest versions to fix errors with pyOpenSSL
    • Improved: Use a temporary folder during post-processing
    • Improved: Added verify_ssl_cert option
    • Improved: Fixed track matching progress
    • Improved: pylint, pep8 & pylint fixes
    • Improved: Stop JS links from scrolling to the top of the page

    The full list of commits can be found here.

    Source code(tar.gz)
    Source code(zip)
  • v0.5.9(Sep 5, 2015)

    Released 05 September 2015

    Highlights:

    • Added: Providers Strike, Jackett, custom Torznabs
    • Added: Option to stop post-processing if no good match found (#2343)
    • Fixed: Blackhole -> Magnet, limit to torcache
    • Fixed: Kat 403 flac error
    • Fixed: Last.fm errors
    • Fixed: Pushover notifications
    • Improved: Rutracker logging, switched to requests lib

    The full list of commits can be found here.

    Source code(tar.gz)
    Source code(zip)
  • v0.5.8(Jul 13, 2015)

    Highlights:

    • Added: Option to only include official extras
    • Added: Option to wait until album release date before searching
    • Fixed: NotifyMyAndroid notifications
    • Fixed: Plex Notifications
    • Fixed: Metacritic parsing
    • Fixed: Pushbullet notifications
    • Fixed: What.cd not honoring custom search term (#2279)
    • Improved: XSS Search bug
    • Improved: Config page layout
    • Improved: Set localhost as default
    • Improved: Better single artist scanning

    The full list of commits can be found here.

    Source code(tar.gz)
    Source code(zip)
  • v0.5.7(Jul 1, 2015)

    • Improved: Moved pushover to use requests lib
    • Improved: Plex tokens with Plex Home
    • Improved: Added getLogs & clearLogs to api
    • Improved: Cache MetaCritic scores. Added user-agent header to fix 403 errors
    • Improved: Specify whether to delete folders when force post-processing
    • Improved: Convert target bitrate to vbr preset for what.cd searching
    • Improved: Switched Pushover to requests lib

    The full list of commits can be found here.

    Source code(tar.gz)
    Source code(zip)
  • v0.5.6(Jun 8, 2015)

    • Added: Metacritic scores
    • Added: Series support (e.g. Cafe Del Mar, Now That's What I Call Music, etc)
    • Added: Filter out clean/edited/censored releases (#2198)
    • Added: Button on the log page to toggle verbose/debug logging
    • Fixed: Connecting to SABnzbd over https with python >= 2.7.9
    • Fixed: Email Notifications with SSL
    • Fixed: Don't limit musicbrainz results to first 100
    • Fixed: nzbget url fix
    • Fixed: OSX Notifications
    • Improved: Cuesplit, allow wav, ape to be split
    • Improved: Moved the 'freeze db' option to the advanced->misc. tab
    • Improved: Moved kickass searching to json api, so it doesn't throw 404 errors anymore when there are no results
    • Improved: SSL for headphones indexer
    • Improved: Disable update dialog box if check_github is diabled
    Source code(tar.gz)
    Source code(zip)
  • v0.5.5(May 5, 2015)

    • Added: force ID3v2.3 during post processing (#2121)
    • Added: MusicBrainz authentication (#2125)
    • Added: Email notifications (addresses #1045)
    • Fixed: Kickass url updated to kickass.to (#2119)
    • Fixed: Piratebay returning 0 bytes for all files
    • Fixed: Albums stopped automatically refreshing when adding an artist
    • Fixed: Min/max sizes for target bitrate
    • Fixed: Don't filter any results if looking for a specific download
    • Fixed: Sort by size in the specific download table
    • Fixed: Deal with beets recommendation.none correctly
    • Improved: Close dialog window automatically when choosing a specific download
    • Improved: Move some repetitive log messages to debug level
    Source code(tar.gz)
    Source code(zip)
  • v0.5.4(Feb 5, 2015)

    • Added: backported 'Scan Artist' feature from sarakha63/headphones
    • Fixed: change file permissions of cache files according to settings (#2102)
    • Fixed: hide Songkick if no regional events are available
    • Fixed: only reschedule jobs if timeout changed (#2099)
    • Fixed: limit dialog height (#2096)
    • Improved: upgraded requests to 2.5.1
    • Improved: upgraded unidecode to 0.04.17
    • Improved: upgraded tzlocal to 1.1.2
    • Improved: upgraded PyTZ to 2014.10
    • Improved: upgraded mako to 1.0.1
    • Improved: upgraded mutagen to 1.27
    • Improved: upgraded beets to 1.3.10
    Source code(tar.gz)
    Source code(zip)
  • v0.5.3(Feb 5, 2015)

  • v0.5.2(Dec 28, 2014)

    • Added: advanced option to ignore certain folders by patterns. (#2037)
    • Added: advanced option to ignore certain files by patterns (library only)
    • Added: specify optional paths to CUE splitting tools (#1938)
    • Added: experimental support for OPB (provide details yourself!)
    • Fixed: magnet to torrent conversion (#1926)
    • Fixed: new KAT URL (#2043)
    • Fixed: LMS notifications (#1564)
    • Improved: notify user of SSL-related warnings, instead of silently failing.
    • Improved: show all search results for 'Choose Specific Release'
    Source code(tar.gz)
    Source code(zip)
  • v0.5.1(Dec 28, 2014)

    • Added: allow one to disable interval tasks (#2002)
    • Added: script to downgrade Headphones to last version that started (Linux only)
    • Fixed: SSL issues in CherryPy. Self-generated certificates will be 2048 now (#1995)
    • Fixed: Transmission URL detection (#1998)
    • Fixed: missing dependencies for APScheduler and CherryPy (#2001)
    • Improved: symlink infinite recursion detection
    Source code(tar.gz)
    Source code(zip)
  • v0.5(Nov 10, 2014)

    • Added: CUE splitter
    • Added: filter search result by MusicBrainz Release Group ID
    • Added: follow symlinks while scanning library (#1953)
    • Fixed: crash during post processing (#1897)
    • Fixed: embedding lyrics (#1896)
    • Fixed: HTTP errors with older versions of Python 2.6
    • Fixed: jump back to top of page (#1948)
    • Improved: parse MusicBrainz RGID first when post processing (#1952)
    • Improved: Growl unicode characters (#1695)
    • Improved: search handling for PB and KAT
    • Improved: Last.FM API support (#1877)
    • Improved: upgraded CherryPy to version 3.6.0
    • Improved: upgraded Requests to version 2.4.1
    • Improved: upgraded APScheduler to version 3.0.1
    • Improved: lot of code refactoring
    Source code(tar.gz)
    Source code(zip)
  • v0.4(Sep 20, 2014)

    • Added: support for libav-tools (which replaces FFmpeg under Ubuntu)
    • Added: option to freeze library when post processing
    • Added: Songkick per area
    • Added: rename original NFO file (#1797)
    • Removed: removed dead search providers
    • Fixed: removed left-overs of old packages
    • Improved: rename by original folder (#1811)
    • Improved: uTorrent fixess
    • Improved: delayed loading of album art
    • Improved: search result parser
    Source code(tar.gz)
    Source code(zip)
Conference planning tool: CfP, scheduling, speaker management

pretalx is a conference planning tool focused on providing the best experience for organisers, speakers, reviewers, and attendees alike. It handles th

492 Dec 28, 2022
The open-source core of Pinry, a tiling image board system for people who want to save, tag, and share images, videos and webpages in an easy to skim through format.

The open-source core of Pinry, a tiling image board system for people who want to save, tag, and share images, videos and webpages in an easy to skim

Pinry 2.7k Jan 08, 2023
The official source code repository for the calibre ebook manager

calibre calibre is an e-book manager. It can view, convert, edit and catalog e-books in all of the major e-book formats. It can also talk to e-book re

Kovid Goyal 14.1k Dec 27, 2022
Invenio digital library framework

Invenio Framework v3 Open Source framework for large-scale digital repositories. Invenio Framework is like a Swiss Army knife of battle-tested, safe a

Invenio digital repository framework 562 Jan 07, 2023
Find duplicate files

dupeGuru dupeGuru is a cross-platform (Linux, OS X, Windows) GUI tool to find duplicate files in a system. It is written mostly in Python 3 and has th

Andrew Senetar 3.3k Jan 04, 2023
WikidPad is a single user desktop wiki

What is WikidPad? WikidPad is a Wiki-like notebook for storing your thoughts, ideas, todo lists, contacts, or anything else you can think of to write

WikidPad 176 Dec 14, 2022
Free and open-source digital preservation system designed to maintain standards-based, long-term access to collections of digital objects.

Archivematica By Artefactual Archivematica is a web- and standards-based, open-source application which allows your institution to preserve long-term

Artefactual 338 Dec 16, 2022
:mag: Ambar: Document Search Engine

🔍 Ambar: Document Search Engine Ambar is an open-source document search engine with automated crawling, OCR, tagging and instant full-text search. Am

RD17 1.9k Jan 09, 2023
A Python library to manage ACBF ebooks.

libacbf A Python library to read and edit ACBF formatted comic book files and archives. XML Specifications here: https://acbf.fandom.com/wiki/Advanced

Grafcube 0 Nov 09, 2021
This is your launchpad that comes with a variety of applications waiting to run on your kubernetes cluster with a single click

This is your launchpad that comes with a variety of applications waiting to run on your kubernetes cluster with a single click.

M. Rehan 2 Jun 26, 2022
🗃 Open source self-hosted web archiving. Takes URLs/browser history/bookmarks/Pocket/Pinboard/etc., saves HTML, JS, PDFs, media, and more...

ArchiveBox Open-source self-hosted web archiving. ▶️ Quickstart | Demo | Github | Documentation | Info & Motivation | Community | Roadmap "Your own pe

ArchiveBox 14.8k Jan 05, 2023
Indico - A feature-rich event management system, made @ CERN, the place where the Web was born.

Indico Indico is: 🗓 a general-purpose event management tool; 🌍 fully web-based; 🧩 feature-rich but also extensible through the use of plugins; ⚖️ O

Indico 1.4k Jan 09, 2023
Open source platform for the machine learning lifecycle

MLflow: A Machine Learning Lifecycle Platform MLflow is a platform to streamline machine learning development, including tracking experiments, packagi

MLflow 13.3k Jan 04, 2023
Main repository of the zim desktop wiki project

Zim - A Desktop Wiki Editor Zim is a graphical text editor used to maintain a collection of wiki pages. Each page can contain links to other pages, si

Zim Desktop Wiki 1.6k Dec 30, 2022
Fava - web interface for Beancount

Fava is a web interface for the double-entry bookkeeping software Beancount with a focus on features and usability. Check out the online demo and lear

1.5k Dec 30, 2022
Plugin-based, unopinionated membership administration software

byro is a membership administration tool for small and medium sized clubs/NGOs/associations of all kinds, with a focus on the DACH region. While it is

123 Nov 16, 2022
ProPublica's collaborative tip-gathering framework. Import and manage CSV, Google Sheets and Screendoor data with ease.

Collaborate This is a web application for managing and building stories based on tips solicited from the public. This project is meant to be easy to s

ProPublica 86 Oct 18, 2022
A collection of self-contained and well-documented issues for newcomers to start contributing with

fedora-easyfix A collection of self-contained and well-documented issues for newcomers to start contributing with How to setup the local development e

Akashdeep Dhar 8 Oct 16, 2021
Collect your thoughts and notes without leaving the command line.

jrnl To get help, submit an issue on Github. jrnl is a simple journal application for your command line. Journals are stored as human readable plain t

Manuel Ebert 31 Dec 01, 2022
cherrytree

CherryTree A hierarchical note taking application, featuring rich text and syntax highlighting, storing data in a single XML or SQLite file. The proje

Giuseppe Penone 2.7k Jan 08, 2023