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)
Owner
null
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
An automated Comic Book downloader (cbr/cbz) for use with SABnzbd, NZBGet and torrents

Mylar Note that feature development has stopped as we have moved to Mylar3. EOL for this project is the end of 2020 and will no longer be supported. T

null 979 Dec 13, 2022
SABnzbd - The automated Usenet download tool

SABnzbd is an Open Source Binary Newsreader written in Python.

SABnzbd 1.8k Dec 30, 2022
MMDL (Mega Music Downloader) - A tool to easily download music.

mmdl - Mega Music Downloader What is mmdl ❓ TLDR: MMDL is a cli app which allows you to quickly and efficiently download one or multiple songs from Yo

techboy-coder 30 Dec 13, 2022
veez music bot is a telegram music bot project, allow you to play music on voice chat group telegram.

?? Veez Music Bot Music bot for playing music on telegram voice chat group. Requirements ?? FFmpeg NodeJS nodesource.com Python 3.7+ PyTgCalls ?? Get

levina 143 Jun 19, 2022
veez music is a telegram music bot project, allow you to play music on voice chat group telegram.

?? VEEZ MUSIC BOT Veez Music is a telegram bot project that's allow you to play music on telegram voice chat group. Requirements ?? FFmpeg NodeJS node

levina 23 Aug 29, 2021
❤️ Hi There Im Cozmo Music Bot A next gen powerful telegram group Music bot for get your Songs and music @Venuja_Sadew

?? Cozmo MUSIC ?? Cozmo Music is a Music powerfull bot for playing music on telegram voice chat groups. Requirements FFmpeg NodeJS nodesource.com Pyth

Venuja Sadew 3 Jan 8, 2022
Okaeri-Music is a telegram music bot project, allow you to play music on voice chat group telegram.

Okaeri-Music is a telegram bot project that's allow you to play music on telegram voice chat group

Wahyusaputra 1 Dec 22, 2021
Okaeri-Music is a telegram music bot project, allow you to play music on voice chat group telegram.

??️ PROJECT MUSIC,THIS IS MAINTAINED Okaeri-Music is a telegram bot project that's allow you to play music on telegram voice chat group Features ?? Th

Okaeri-Project 2 Dec 23, 2021
ELiza music is a telegram music bot project, allow you to play music on voice chat group telegram.

❤️ ?????????? ?????????? ❤️ Unmaintained. The new repo of @MrsElizaRobot is private. (It is no longer based on this source code. The completely rewrit

Team Eliza 2 Dec 8, 2022
NovaMusic is a music sharing robot. Users can get music and music lyrics using inline queries.

A music sharing telegram robot using Redis database and Telebot python library using Redis database.

Hesam Norin 7 Oct 21, 2022
YouTube-Downloader - YouTube Video Downloader made using python

YouTube-Downloader YouTube Videos Downloder made using python.

Shivam 1 Jan 16, 2022
Python-Youtube-Downloader - An Open Source Python Youtube Downloader

Python-Youtube-Downloader Hello There This Is An Open Source Python Youtube Down

Flex Tools 3 Jun 14, 2022
Youtube Downloader is a simple but highly efficient Youtube Video Downloader, made completly using Python

Youtube Downloader is a simple but highly efficient Youtube Video Downloader, made completly using Python

Arsh 2 Nov 26, 2022
Youtube-downloader-using-Python - Youtube downloader using Python

Youtube-downloader-using-Python Hii guys !! Fancy to see here Welcome! built by

Lakshmi Deepak 2 Jun 9, 2022
An automatic beatmapset downloader via txt file, suitable for tourney mappools.

Pooler Pooler is a bulk osu! mapset downloader, perfect for use with osu! Tournament Mappools. Prerequisites Python 3.10 Requests (pip install request

Thomas 0 Feb 11, 2022
Soundcloud Music Downloader

Soundcloud Music Downloader Description This script is able to download music from SoundCloud and set id3tag to the downloaded music. Compatible with

Ronan 2.6k Jan 1, 2023
A scriptable music downloader for Qobuz, Tidal, and Deezer

streamrip A scriptable stream downloader for Qobuz, Tidal, and Deezer. Features Downloads tracks, albums, playlists, discographies, and labels from Qo

null 967 Jan 3, 2023
Music and video downloader, Made with love by Bryan Herrera

Python-Mp3Mp4-Downloader Music and video downloader, Made with love by Bryan Herrera Requirements CHOCOLATELY windows command If your system does not

ርᚱ1ናተᛰ ᚻህᚥተპᚱ 104 Dec 27, 2022
music downloader written in python. (Uses jiosaavn API)

music downloader written in python. (Uses jiosaavn API)

Rohn Chatterjee 35 Jul 20, 2022