Convenient command line and library wrapper for youtube-dl.

Latest release 20200521: Initial PyPI release.

The youtube-dl tool and associated youtube_dl Python module are very useful for downloading media from various websites. However, as an end user who almost never streams because of my soggy internet link, I find fetching several items is quite serial and visually noisy.

This module provides a command line tool ydl which:

• runs multiple downloads in parallel with progress bars
• prints the downloaded filename as each completes

Interactively, I keep this shell function:

ydl(){
  ( set -ue
    dldir=${DL:-$HOME/dl}/v
    [ -d "$dldir" ] || set-x mkdir "$dldir"
    cd "$dldir"
    command ydl ${1+"$@"}
  )
}

which runs the downloader in my preferred download area without tedious manual cding.

Function main(argv=None, cmd=None)

Main command line.

Class YDL

Manager for a download process.

Method YDL.__init__(self, url, *, fstags, upd=None, tick=None, **kw_opts)

Initialise the manager.

Parameters:

• url: the URL to download
• fstags: mandatory keyword argument, a cs.fstags.FSTags instance
• upd: optional cs.upd.Upd instance for progress reporting
• tick: optional callback to indicate state change
• kw_opts: other keyword arguments are used to initialise the options for the underlying YoutubeDL instance

Class YDLCommand(cs.cmdutils.BaseCommand)

ydl command line implementation.

Release Log

Release 20200521: Initial PyPI release.