beets-ydl 0.0.3

Download audio from youtube-dl sources and import into beets

beets ydl

Download audio from youtube-dl sources and import into beets, it will also split tracks from albums:

# 101 Bands -- Short Music for Short People
$ beet ydl "https://www.youtube.com/watch?v=wW6ykueIhX8"

$ beet ls short music for short people

59 Times the Pain - Short Music for Short People - We Want the Kids
7 Seconds - Short Music for Short People - F.O.F.O.D.
88 Fingers Louie - Short Music for Short People - All My Friends Are in Popular Bands
Adrenalin O.D. - Short Music for Short People - Your Kung Fu Is Old... And Now You Must Die!
Aerobitch - Short Music for Short People - Steamroller Blues
[...]

Installation

pip install beets-ydl

And enable ydl plugin on your config.yaml file.

Configuration

Available options on config.yaml:

• download: will download files from sources after getting information, defaults to True

• split_files: will try to split album files into separate tracks, defaults to True

• import: will import files on youtube-dl after downloading and splitting, defaults to True

• urls: a list of default urls to download when no arguments are provided, you can provide a playlist to get checked every time

• youtubedl_options is a dictionary of a lot of youtube-dl options available

Example:

plugins: ydl

ydl:
    split_files: true
    urls:
        - url1
        - url2
        - url3
    youtubedl_options:
        postprocessors:
            key': 'SomeOtherExtractor',
            preferredcodec: 'ogg'

Tips

Use a .netrc file

Security discussions apart, you can create a ~/.netrc with credentials for youtube-dl to read.

machine youtube login [e-mail] password somepassword

Check this entry on youtube-dl docs for more information.

Like this, you can download private playlists or your subscriptions:

beet ydl "https://www.youtube.com/feed/subscriptions"

Download and import later

To download and split files without importing into beets:

beet ydl "<source>" --keep-files --no-import

And later, to import:

beet ydl "<source>" --no-download --no-split-files

Like this, you can download a big playlist and then run the beets import routine, which requires manual intervention.

(possibly) enhance audio quality

beets-ydl uses a proposed 192kbps extractor 'bestaudio' format because it is more likely that it will find separate audio files on sources. Some high quality videos might have better audio quality embedded, so it can also make sense to set a higher quality extractor:

ydl:
    youtubedl_options:
        format: 'best',
        postprocessors:
            key: 'FFmpegExtractAudio'
            preferredcodec: 'mp3'
            preferredquality: '320'
            nopostoverwrites: True

This can, however, end-up with unnecessarily big files that have 320kbps as a merely nominal quality. See this discussion.

Development

To setup a development instance:

virtualenv env
pip install -r requirements.txt
source env/bin/activate

You can also use -v option for printing processing information