yt - fine-tuning the use of youtube-dl / yt-dlp

Download music or video from e.g. YouTube, Soundcloud, Instagram, Facebook. For a full list of supported sites and services, see https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md.

Description

yt is a pure-bash command-line tool that optimizes the use of yt-dlp for audio and videophiles with comprehensive and customizable presets, empirically tested on multiple streams. Maintains a download archive, to prevent duplicates when periodically downloading YouTube playlists or Soundcloud sets. Parses title ("%(artist)s - %(title)s") and retrieves a thumbnail, and injects these into file metadata. Adds the url id of the source to the filename, attempts to bypass geographical restrictions, and more.

Features include, but are not limited to:

Parallel downloads
Audio mode (default)
Video mode (MKV -vcodec copy | MP4 AV1 | MP4 AVC)
HDR video (MKV)
Playlist mode (currently each playlist is download sequentially)
Custom audio bitrate, video resolution, destination folder
Embedded subtitle tracks
Embedded metadata like chapter information and description

The audio streams in converted (video) files from yt will generally be of higher quality compared to online alternatives, while maintaining a comparable file size. This is achieved by preferring WAV/OPUS source streams, and by converting using the Fraunhofer FDK AAC codec library or when available the Mac OS Audiotoolbox (even better) at a bitrate of 256kbit/s (sufficient to encode a full 44.1kHz stream without losing detail at higher frequencies, see benchmark here).

Installation

Dependencies are installations of yt-dlp, atomicparsley, and ffmpeg preferably compiled using --enable-audiotoolbox on Mac and --with-fdk-aac on other operating systems. Note that fdk-aac is GPL-incompatible, so this will produce an unredistributable distribution.

OSX

To install yt and its dependencies:

brew install ddelange/brewformulae/yt

Or manually (if you wish to avoid Homebrew, and install the dependencies yourself):

Compile ffmpeg including --with-fdk-aac.
Install yt-dlp.
Install atomicparsley.

Put yt in your path:

git clone https://github.com/ddelange/yt.git ./yt
cd ./yt && bash ./install.sh
yt --help  # check that all is well

Debian/Ubuntu

On Linux, you can use Homebrew as well:

brew install ddelange/brewformulae/yt

Or manually (if you wish to avoid Homebrew, and install the dependencies yourself):

Compile ffmpeg including --with-fdk-aac. See example instructions, pick your favorite: [1] [2]
Install yt-dlp.
Install atomicparsley.

Put yt in your path:

git clone https://github.com/ddelange/yt.git ./yt
cd ./yt && bash ./install.sh
yt --help  # check that all is well

Windows

Easiest would be using the Windows Subsystem for Linux (WSL), and using instructions above. But since yt-dlp has dedicated Windows distributions available, you could try the following:

[untested, assumes you're running Bash for Windows]

Compile ffmpeg including the non-free tools (which will contain libfdk-aac).
Install yt-dlp:
- [either] Assuming python / python3 and pip / pip3 are installed, run sudo pip3 install yt-dlp or sudo pip3 install yt-dlp respectively.
- [or] Download yt-dlp.exe and place it in any location on your PATH.
Make sure yt-dlp is recognized by your shell by typing yt-dlp --version.
Put yt in your path.

Usage

tl;dr:

Type yt to download m4a audio files for the (space separated) URL(s) fetched from clipboard (see also -c).
Type yt -vmM to download video into mp4, up to 1080p, preferably with AVC codec for better compatibility.
Type yt -vHP 2160 to download best quality video into mkv, up to 4K HDR if available.

NAME
      yt  -  fine-tuning the use of youtube-dl / yt-dlp. Download music or video from e.g.
      YouTube,  Soundcloud,  Instagram,  Facebook.  For a full list of supported sites and
      services, see https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md.

SYNOPSIS
      yt [OPTIONS] -- [URL] [URL...]

DESCRIPTION
      yt is a bash function that  optimizes the use of  yt-dlp  for audio and  videophiles
      with comprehensive and customizable presets, empirically tested on multiple streams.
      Maintains a  download archive,  to prevent duplicates when  periodically downloading
      YouTube playlists or Soundcloud sets.  Parses title  ("%(artist)s - %(title)s")  and
      retrieves a thumbnail, and injects these into file metadata.  Adds the url id of the
      source to the filename, and attempts to bypass geographical restrictions.

OPTIONS
      -h, --help
            Print this help text and exit.

      -s
            Enable silent mode (send stdout to /dev/null).

      -S
            Enable sequential mode.  Default behaviour: parallel mode.  The MAXPROCS (env)
            var sets parallelism  (default 4).  To download YouTube playlists in parallel,
            use e.g. "yt -v -- $(yt-dlp --get-id --flat-playlist <playlist-url>)".

      -f
            Force download, even when already recorded in --download-archive.

      -v
            Enable video mode. Defaults to audio mode. Only mono and stereo are supported.

      -c
            Fetch space separated  URLs from clipboard,  additional to the manually passed
            URLs. Auto-enables when no URLs are manually passed.

      -D POSIX_PATH
            Set the destination path.  Used for both the (intermediate) output and for the
            download archive. Defaults to  "~/Music/yt"  and  "~/Movies/yt"  for audio and
            video mode respectively. Override defaults with YT_MUSIC_DIR and YT_VIDEO_DIR.

      -p
            Enable playlist mode. When a video URL contains a reference to a playlist, the
            whole playlist will be  downloaded.  Will only download URLs that have not yet
            been recorded in the download archive.

      -k
            Keep original audio additionally.  In most cases, this will keep e.g. OPUS for
            YouTube, or LAME MP3 / WAV for Soundcloud URLs.  Ignored when -v is specified.

      -a KBITS_PER_SECOND
            Set the output audio bitrate. Defaults to 256kbit/s.

      -r HERTZ
            Set the output audio sampling rate. Defaults to 44100Hz.

      -P PIXELS
            Set the maximum pixels of the video output.  Ignored when -v is not specified.
            Defaults to 1920px. Constraint is dropped when no formats comply. For portrait
            and landscape videos,  this corresponds to the  height and width respectively.

      -F FRAMES
            Set the maximum framerate in frames per second. Defaults to 42. Ignored when
            -v is not specified. Constraint is dropped when no formats comply.

      -m
            Use MP4 when merging audio/video streams, keeping video codecs if possible and
            converting audio to 256kbit/s AAC (resolving full 44.1KHz stream). If no merge
            is needed,  the (single) source file is kept  and no conversion is  performed.
            Default behaviour:  copy downloaded audio/video streams into an MKV container,
            using OPUS audio codec and  VP9 video codec for small filesizes.  Ignored when
            -v is not specified. For YouTube this will yield a maximum resolution of 1080.
            Sometimes,  AV1 streams will only be available up to a certain resolution.  In
            this case, specifying -M might yield higher resolution.

      -M
            Prefer the older AVC codec over AV1. Results in bigger file-sizes, but  better
            playback compatibility. Ignored when -v and -m are not specified.

      -H
            Prefer HDR streams. Tested on YouTube videos. Overrides -m.

      -A
            Embed all available audio streams. Ignored when -v is not specified.

BSD 3-Clause License

Copyright (c) 2019, ddelange
All rights reserved.

ddelange / yt Goto Github PK

yt's Introduction

yt - fine-tuning the use of youtube-dl / yt-dlp

Description

Features include, but are not limited to:

Installation

OSX

Debian/Ubuntu

Windows

Usage

yt's People

Contributors

Stargazers

Watchers

Forkers

yt's Issues

Recommend Projects

Recommend Topics

Recommend Org