mirror of
https://gitea.com/mcereda/oam.git
synced 2026-02-09 05:44:23 +00:00
chore(kb/yt-dlp): review
This commit is contained in:
Michele Cereda
@@ -1,65 +1,95 @@
|
|||||||
# Yt-dlp
|
# Yt-dlp
|
||||||
|
|
||||||
Improved fork of [youtube-dl].
|
Improved fork of [`youtube-dl`][youtube-dl].
|
||||||
|
|
||||||
## Table of contents <!-- omit in toc -->
|
|
||||||
|
|
||||||
1. [TL;DR](#tldr)
|
1. [TL;DR](#tldr)
|
||||||
1. [Further readings](#further-readings)
|
1. [Further readings](#further-readings)
|
||||||
|
|
||||||
## TL;DR
|
## TL;DR
|
||||||
|
|
||||||
> To be able to merge multiple formats into one, you will also need to install `ffmpeg`.
|
> [!tip]
|
||||||
|
> Also install [`ffmpeg`][ffmpeg] to support merging multiple formats into one.
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>Setup</summary>
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
# Install it.
|
brew install 'yt-dlp'
|
||||||
python3 -m pip install -U --user yt-dlp
|
pipx install 'yt-dlp'
|
||||||
|
python3 -m pip install -U --user 'yt-dlp'
|
||||||
|
```
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>Usage</summary>
|
||||||
|
|
||||||
|
```sh
|
||||||
# List all available formats.
|
# List all available formats.
|
||||||
yt-dlp -F AK44wAvv2E4
|
yt-dlp -F 'AK44wAvv2E4'
|
||||||
|
yt-dlp --list-formats 'AK44wAvv2E4'
|
||||||
|
|
||||||
# See all available information from a video.
|
# See all available information from a video.
|
||||||
yt-dlp -j BaW_jenozKc
|
yt-dlp -j 'BaW_jenozKc'
|
||||||
|
yt-dlp --dump-json 'BaW_jenozKc'
|
||||||
|
|
||||||
# List available subtitiles.
|
# List available subtitiles.
|
||||||
yt-dlp --list-subs rQnNghhPw6o
|
yt-dlp --list-subs 'rQnNghhPw6o'
|
||||||
|
|
||||||
# Check what name will be used for the destination.
|
# Check what name will be used for the destination.
|
||||||
# Output templates at https://github.com/yt-dlp/yt-dlp#output-template, or use
|
# Output templates at https://github.com/yt-dlp/yt-dlp#output-template, or use
|
||||||
# '-j' to see the json file with all of them.
|
# '-j' to see the json file with all of them.
|
||||||
yt-dlp --get-filename \
|
yt-dlp --get-filename \
|
||||||
-o "%(season_number)d.%(episode_number)02d %(episode)U.%(ext)s" \
|
-o '%(season_number)d.%(episode_number)02d %(episode)U.%(ext)s' \
|
||||||
https://www.crunchyroll.com/some/good/serie
|
'https://www.crunchyroll.com/some/good/serie'
|
||||||
|
|
||||||
|
# Get a video in the best available quality.
|
||||||
|
yt-dlp -f 'bestvideo+bestaudio/best' 'https://www.youtube.com/watch?v=abc4EFG89jK'
|
||||||
|
yt-dlp --format 'bestvideo+bestaudio/best' 'https://www.youtube.com/watch?v=abc4EFG89jK'
|
||||||
|
|
||||||
# Download all videos in a YouTube channel.
|
# Download all videos in a YouTube channel.
|
||||||
yt-dlp -f "bestvideo+bestaudio/best" -ciw \
|
yt-dlp -ciw 'https://www.youtube.com/c/somechannel/videos'
|
||||||
-o "%(title)#S.%(ext)s" -v https://www.youtube.com/c/pbsspacetime/videos
|
yt-dlp --continue --ignore-errors --no-overwrites 'https://www.youtube.com/c/somechannel/videos'
|
||||||
|
```
|
||||||
|
|
||||||
# As above with improvements.
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>Real world use cases</summary>
|
||||||
|
|
||||||
|
```sh
|
||||||
|
# Get a video in the best available quality.
|
||||||
|
yt-dlp -f 'bestvideo+bestaudio/best' -ciw -o '%(title)#S.%(ext)s' 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
|
||||||
|
|
||||||
|
# Download all videos in a YouTube channel (improved).
|
||||||
# Slow down the requests to avoid issues in retrieving the data.
|
# Slow down the requests to avoid issues in retrieving the data.
|
||||||
# Include chapters, metadata and selected subtitles.
|
# Include chapters, metadata and selected subtitles.
|
||||||
# Prefix the file name with its timestamp, or upload date if it is null.
|
# Prefix the file name with its timestamp, or upload date if it is null.
|
||||||
yt-dlp -ciw \
|
yt-dlp -ciw \
|
||||||
--retry-sleep 3 --sleep-requests 0 --sleep-subtitles 3 \
|
--retry-sleep 3 --sleep-requests 0 --sleep-subtitles 3 \
|
||||||
--embed-chapters --embed-metadata --embed-subs \
|
--embed-chapters --embed-metadata --embed-subs \
|
||||||
--sub-langs "(de|en|fr|es|it|ja|nl|zh(-Han.*)?)(-en)?" \
|
--sub-langs '(de|en|fr|es|it|ja|nl|zh(-Han.*)?)(-en)?' \
|
||||||
--sub-format "ass/srt/best" --write-auto-subs \
|
--sub-format 'ass/srt/best' --write-auto-subs \
|
||||||
-f "bestvideo+bestaudio/best" \
|
-f 'bestvideo+bestaudio/best' \
|
||||||
-o "%(timestamp>%Y-%m-%d,upload_date>%Y-%m-%d)s %(title)U.%(ext)s" \
|
-o '%(timestamp>%Y-%m-%d,upload_date>%Y-%m-%d)s %(title)U.%(ext)s' \
|
||||||
https://www.youtube.com/c/becausescience/videos
|
'https://www.youtube.com/c/becausescience/videos'
|
||||||
```
|
```
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
## Further readings
|
## Further readings
|
||||||
|
|
||||||
- [GitHub]
|
- [Codebase]
|
||||||
- [youtube-dl]
|
- [`youtube-dl`][youtube-dl]
|
||||||
|
|
||||||
<!--
|
<!--
|
||||||
References
|
Reference
|
||||||
|
═╬═Time══
|
||||||
-->
|
-->
|
||||||
|
|
||||||
<!-- Upstream -->
|
|
||||||
[github]: https://github.com/yt-dlp/yt-dlp
|
|
||||||
|
|
||||||
<!-- Knowledge base -->
|
<!-- Knowledge base -->
|
||||||
|
[ffmpeg]: ffmpeg.md
|
||||||
[youtube-dl]: youtube-dl.md
|
[youtube-dl]: youtube-dl.md
|
||||||
|
|
||||||
|
<!-- Upstream -->
|
||||||
|
[Codebase]: https://github.com/yt-dlp/yt-dlp
|
||||||
|
|||||||
Reference in New Issue
Block a user