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)
SENAITE Meta Package

SENAITE LIMS Meta Installation Package What does SENAITE mean? SENAITE is a beautiful trigonal, oil-green to greenish black crystal, with almost the h

SENAITE 135 Dec 14, 2022
Automatic Video Library Manager for TV Shows. It watches for new episodes of your favorite shows, and when they are posted it does its magic.

Automatic Video Library Manager for TV Shows. It watches for new episodes of your favorite shows, and when they are posted it does its magic. Exclusiv

pyMedusa 1.5k Dec 30, 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
One webpage for every book ever published!

Open Library Open Library is an open, editable library catalog, building towards a web page for every book ever published. Are you looking to get star

Internet Archive 4k Jan 08, 2023
Agile project management platform. Built on top of Django and AngularJS

Taiga Backend Documentation Currently, we have authored three main documentation hubs: API: Our API documentation and reference for developing from Ta

Taiga.io 5.8k Jan 05, 2023
🗃 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
🦉Data Version Control | Git for Data & Models

Website • Docs • Blog • Twitter • Chat (Community & Support) • Tutorial • Mailing List Data Version Control or DVC is an open-source tool for data sci

Iterative 10.9k Jan 05, 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
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
A time tracking application

GTimeLog GTimeLog is a simple app for keeping track of time. Contents Installing Documentation Resources Credits Installing GTimeLog is packaged for D

GTimeLog developers 224 Nov 28, 2022
Automatic Movie Downloading via NZBs & Torrents

CouchPotato CouchPotato (CP) is an automatic NZB and torrent downloader. You can keep a "movies I want"-list and it will search for NZBs/torrents of t

CouchPotato 3.9k Jan 04, 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
115原码播放服务Kodi插件

115proxy-for-kodi 115原码播放服务Kodi插件,需要kodi 18以上版本,需配合 https://github.com/feelfar/115-for-kodi 使用 安装 由于release包尚未释出,可直接下载源代码zip包安装。 20210202:由于正调试kodi19兼

92 Jan 01, 2023
:books: Web app for browsing, reading and downloading eBooks stored in a Calibre database

About Calibre-Web is a web app providing a clean interface for browsing, reading and downloading eBooks using an existing Calibre database. This softw

Jan B 8.2k Jan 02, 2023
Small and highly customizable twin-panel file manager for Linux with support for plugins.

Note: Prefered repository hosting is GitLab. If you don't have an account there and don't wish to make one interacting with one on GitHub is fine. Sun

Mladen Mijatov 407 Dec 29, 2022
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
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
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
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