Metadata-Version: 2.1
Name: beets-ydl
Version: 0.0.2
Summary: Download audio from youtube-dl soures and import into beets
Home-page: https://github.com/vmassuchetto/beets-ydl
Author: Vinicius Massuchetto
License: UNKNOWN
Description: # beets ydl
        
        Download audio from youtube-dl sources and import into beets
        
            $ 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 https://github.com/vmassuchetto/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](https://git.io/fN0c7)
        
        Example:
        
        ```yaml
        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 somelogin@gmail.com password somepassword
        
        Check [this entry](https://git.io/fN2TD) 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'](https://git.io/fN2mJ)
        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:
        
        ```yaml
        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](https://askubuntu.com/q/634584).
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.6
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
