Video

Video

Information Options

General options

Stream Summary Options

General options and

--audioQuality  -a highest|medium|lowest|none - audio quality preference - none for video only - default medium

--container     -C any|mp4|webm|mkv - provide your container preference - default is mkv

--mediaBitrate  -M highest|lowest - prefered bitrate when quality is equal - default: highest

--videoQuality  -v highest|1080p|720p|480p|medium|360p|240p|144p|lowest|none - video quality preference - none for audio only  
                   default: 1080p

Download Options

General options and

--audioFormat   -A number - specific audio stream number to download - default: -1 (use preference algorithm and fallback   
                   streams)

--audioQuality  -a highest|medium|lowest|none - audio quality preference - none for video only - default: medium
    
--container     -C any|mp4|webm|mkv - provide your container preference - default: any
                    * any                   - no preference between mp4 (h264 with aac) or webm (vp9 with opus) (default)
                    * mp4                   - prefers mp4 codecs to webm codecs when quality is equal
                    * webm                  - prefers webm codecs to mp4 codecs when quality is equal 
                    * mkv                   - no preference and can additionally allow mixed formats (vp9 with aac) or (mp4 with opus)
                    * mp3                   - will force audio only download and will convert aac/opus to .mp3  
                    * flac                  - will force audio only download and will convert aac/opus to lossless .flac  

--filename      -f string - supply a filename - you can use the following placeholders in your filename string, 
                   such as:
                    * ${audioCodec}         - aac, opus, mp3 or flac
                    * ${author}             - channel display name
                    * ${channel}            - channel id of video
                    * ${date}               - YYYYMMDD - published date for video
                    * ${datetime}           - YYYYMMDD HHMMSS - published date & time for video
                    * ${id}                 - video id        
                    * ${timestamp}          - unix timestamp - seconds since the epoch, published timestamp for video
                    * ${title}              - video title
                    * ${videoCodec}         - h264 or vp9
                    * ${videoQuality}       - i.e. 1080p, 360p, etc
                    * ${...}                - you can use any other video/channel/search info properties
                   The default filename is "${author}_${datetime}_${title}_${id}_${videoQuality}_${videoCodec}_${audioCodec}"

--mediaBitrate  -M highest|lowest - prefered bitrate when quality of two streams is equal - default: highest

--metadata      -m author|title|description|keywords|published|comment|key [string] - video property to embed in downloaded file  
                   one or more (i.e. -m author -m title) of  
                    * author          - reflects as AUTHOR in webm/mkv containers, as artist in mp4 containers
                    * title           - reflects as TITLE in webm/mkv containers, as title in mp4 containers
                    * description     - reflects as DESCRIPTION in webm/mkv containers, as description in mp4 containers
                    * keywords        - reflects as KEYWORDS in webm/mkv containers, as synopsis in mp4 containers
                    * published       - reflects as DATE in webm/mkv containers, as date in mp4 containers
                    * comment text    - custom text, reflects as COMMENT in webm/mkv, as comment in mp4 containers
                    * key value       - custom key, custom value. key must be a single word without spaces
                   [string] is required for a comment metadata, and if specified for any other metadata fields its value  
                   will be used to override the fetched video property. 
                   
--overwrite     -O yes|no - whether to download existing files again or not.
                    * yes - video will be downloaded again and overwrite any existing file.
                    * no - video downloading will be skipped. (default)

--path          -p string - specify the path to the download folder. Defaults to '.' the current directory

--subtitles     -b string - specify subtitle languages to download as .srt files if available. Use comma separated 
                   language codes, for example 'es,es,ja' for english, spanish and Japanese. See * link below for codes.

--videoFormat   -V number - specific video stream to download. Default: -1 (use preference algorithm and fallback streams)

--videoQuality  -v highest|1080p|720p|480p|medium|360p|240p|144p|lowest|none - video quality preference - none for audio only  
                   default 1080p

• See language codes

Examples

Download using default settings (and overwrite existing files):
The first two commands are equivalent. The third command downloads three different videos.

>ytcog-dl --download https://www.youtube.com/watch?v=UoHEvzQc0O4 --overwrite yes
>ytcog-dl UoHEvzQc0O4 -O yes
>ytcog-dl UoHEvzQc0O4 Sn_qe5zFm0k zo8tXUea9RE -O yes

Download highest quality video without audio: The first two commands are equivalent. The third command defines a custom path and filename.

>ytcog-dl --download Sn_qe5zFm0k --videoQuality highest --audioQuality none --mediaBitrate highest
>ytcog-dl Sn_qe5zFm0k -v highest -a none -M highest
>ytcog-dl Sn_qe5zFm0k -v highest -a none -M highest -p "./examples" -f "${author}__${title}__hq_video_only"

Output stream summary to console with specific quality/format preferences (in this case a low quality preview): The preferred audio and video streams should be appear at the top numbered 0 and 0. The first two commands are equivalent. The last command downloads the file using the same preferences but forcing video stream 3 and audio stream 1.

>ytcog-dl --streamInfo zo8tXUea9RE --audioQuality lowest --videoQuality 240p --container mkv --mediaBitrate lowest
>ytcog-dl -s zo8tXUea9RE -a lowest -v 240p -C mkv -M lowest
>ytcog-dl zo8tXUea9RE -a lowest -v 240p -C mkv -M lowest -V 3 -A 1