-
Searches for and fetches MP3s (via youtue-dl), adding correct ID3 tags and cover art (via discogs's open database).
-
Download single tracks or even entire albums, EPs, etc. at relatively high bitrate (200-300kbps) with just one command.
via PyPI:
$ sudo -H pip3 install orangewire
$ orangewire --user-token ********** --track-name "music is math" --artist-name "boards of canada"
N.B.: By default, this command produces no output if there are no errors or no further input required from you. To view progress, pass --verbose
. Otherwise, it will take up to 2 minutes on an average laptop before it exits (the bottleneck is youtube-dl which drives a lot of network requests and calls to ffmpeg).
$ orangewire --user-token ********** --album-name "damn" --artist-name "kendrick lamar"
You could also specify a directory to place the finished audio files with --output-directory
:
$ orangewire --user-token ********** --album-name "damn" --artist-name "kendrick lamar" --output-directory "../Kendrick Lamar - DAMN"
https://www.discogs.com/settings/developers
$HOME/.orangewire
should contain one line with only the user token obtained from discogs.com.
- Searches discogs.com's open music database for your query. This requires you to set up a free account and retrieve a "user token" in order for orangewire to work.
- You manually select which one you meant from a few candidates (e.g., of tracks or albums). (Ideally this could be automated.)
- Scrapes YouTube's search results to find the matching song (or songs in the case of albums, EPs, etc.).
- Runs youtube-dl to convert the song(s) to MP3s.
- Adds ID3 tags for artist, track name, album/cover art, etc. using the metadata from discogs.com.
orangewire is a thin convenience wrapper around youtube-dl—without youtube-dl—a completely separate project—, this program wouldn't run. In itself, orangewire does not download, transfer, host, or share any media files. It only intends to use content from a site based on user submissions (YouTube) that is considered to be compliant with IP laws. Thus this program isn't subject to DMCA or other IP laws.
The author has no liability for any copyright infringement you commit with this program.
GPL v3