<div align="center">

YTDL-PATCHED

A command-line program to download videos from YouTube and many other video platforms

</div>

MIRRORS

~~https://github.com/Lesmiscore/ytdl-patched (passed away)~~
https://github.com/ytdl-patched/ytdl-patched (primary)
https://bitbucket.org/Lesmiscore/ytdl-patched (secondary)
https://forge.tedomum.net/Lesmiscore/ytdl-patched (secondary)
https://gitlab.com/lesmi_the_goodness/ytdl-patched (secondary)
https://gitea.com/Lesmiscore/ytdl-patched (secondary)
https://git.sr.ht/~nao20010128nao/ytdl-patched (secondary)
- manually mirrored at every git push
https://codeberg.org/Lesmiscore/ytdl-patched (secondary)
https://gitgud.io/Lesmiscore/ytdl-patched (secondary)
In my Keybase account (secondary)
- spoiler: you can clone it with git clone keybase://public/nao20010128nao/ytdl-patched
https://bookish-octo-barnacle.vercel.app/ (just for fun, no longer synced)
https://ytdl-patched.netlify.app/ (just for fun, no longer synced)

Service	Type	Note
GitHub Actions	Tests
GitHub Actions	Build and release
GitHub Actions	Merging commits from upstream	There's conflict if it fails

ytdl-patched is a youtube-dl fork based on yt-dlp.

NEW FEATURES
INSTALLATION
USAGE AND OPTIONS
CONFIGURATION
OUTPUT TEMPLATE
- Output template examples
FORMAT SELECTION
MODIFYING METADATA
- Modifying metadata examples
EXTRACTOR ARGUMENTS
PLUGINS
- Installing Plugins
- Developing Plugins
EMBEDDING YT-DLP
- Embedding examples
DEPRECATED OPTIONS
CONTRIBUTING
- Opening an Issue
- Developer Instructions
WIKI
- FAQ

Disclaimer: ytdl-patched does exist for my use, so there's no absolute warranty for anything. Use yt-dlp if you don't like it.

NEW FEATURES

NEW FEATURES IN YTDL-PATCHED

The major new features from the latest release of yt-dlp are:

Long name escaping for Unix systems: If the filename of downloaded videos can get longer than 255 bytes (in system locale), it'll prevent from exceeding its length by splitting in 255 bytes each. Note that treating splitted names requires special scripts just for that.
Generic Extractor will not return at first website match: Generic Extractor collects matched websites and return it as playlist. It creates nested playlist and may cause infinite loop.
Generic Extractor Extended
- Following URLs are resolved and redirect automatically to its destination.
  - Japanese BBS redirect: pinktower.com, jump.5ch.net, jump.megabbs.info
  - Pixiv redirect
    - Looking for test cases for char-mutated URLs
  - Firebase Dynamic Link: domains ending with .page.link
- Self-hosted service support (Mastodon, PeerTube and Misskey)
  - For supported self-hosted services, ytdl-patched contains a huge list of instances. But you can opt-in for instance checking, in case of undiscovered instance. To opt-in, use these flags: --check-mastodon-instance, --check-peertube-instance, --check-misskey-instance
NicoNico comments as subtitles: Now you can download NicoNico comments as a subtitle.
- No dependency required. Just use ytdl-patched.
- Minimum flags: --sub-format ass --write-subs
- To embed comments without problems: --sub-format ass --write-subs --embed-subs --remux-video mkv
New extractors: Following extractors have been added: (broken/imcomplete ones not listed here)
- askmona and askmona3 (just scrapes embedded YouTube videos)
- disneychris
- dnatube
- fc2:user (FC2 user-uploaded videos)
- iwara:user (Iwara user-uploaded videos)
- javhub
- peing, ask.fm, marshmallow-qa, mottohomete (scrapes Q&A section and find video URLs in it)
- mastodon, mastodon:user, mastodon:user:numeric_id
- misskey, misskey:user
- niconico:playlist, niconico:series, niconico:user
- sharevideos
- tokyomotion, tokyomotion:searches, tokyomotion:user, tokyomotion:user:favs
- niconico:live (COMMENTS ARE NOT SUPPORTED)
- 17live, 17live:clip (merged in yt-dlp)
- AbemaTV and AbemaTVTitle (merged in yt-dlp)
- NhkForSchoolBangumiIE, NhkForSchoolSubjectIE, NhkForSchoolProgramListIE (NHK for School) (merged in yt-dlp)
- Radiko, RadikoRadio (does not have 24-hours limitation!) (merged in yt-dlp)
- damtomo:video, damtomo:record (merged in yt-dlp)
- fc2:live (merged in yt-dlp)
- mirrativ, mirrativ:user (merged in yt-dlp)
- mixch, mixch:archive (merged in yt-dlp)
- openrec, openrec:capture (merged in yt-dlp)
- pixiv:sketch, pixiv:sketch:user (merged in yt-dlp)
- skeb (merged in yt-dlp)
- voicy, voicy:channel (merged in yt-dlp)
- whowatch (merged in yt-dlp)
New extractor arguments: Some extractor arguments are added. Check EXTRACTOR ARGUMENTS section for details.
Merging: MKV file is preferred for merging, but can be overriden using --merge-output-format. ytdl-patched may determine merge format from downloaded formats by using --merge-output-format auto.
Format debugger: You can debug -f FORMAT specs, by just adding -Fv. This doesn't work if specs passed to -f is malformed. You'll get DEBUG column with tokens in arguments, and list of unmatched tokens.

GOALS

keep merging with yt-dlp/yt-dlp
implement miscellaneous extractors as possible
make -U work (yes, really works)
do anything best

NOT TO DO

don't change very much from yt-dlp

NEW FEATURES IN YT-DLP

Merged with youtube-dl v2021.12.17+ commit/2dd6c6e (exceptions) and youtube-dlc v2020.11.11-3+ commit/f9401f2: You get all the features and patches of youtube-dlc in addition to the latest youtube-dl
SponsorBlock Integration: You can mark/remove sponsor sections in YouTube videos by utilizing the SponsorBlock API
Format Sorting: The default format sorting options have been changed so that higher resolution and better codecs will be now preferred instead of simply using larger bitrate. Furthermore, you can now specify the sort order using -S. This allows for much easier format selection than what is possible by simply using --format (examples)
Merged with animelover1984/youtube-dl: You get most of the features and improvements from animelover1984/youtube-dl including --write-comments, BiliBiliSearch, BilibiliChannel, Embedding thumbnail in mp4/ogg/opus, playlist infojson etc. Note that NicoNico livestreams are not available. See #31 for details.
YouTube improvements:
- Supports Clips, Stories (ytstories:<channel UCID>), Search (including filters)*, YouTube Music Search, Channel-specific search, Search prefixes (ytsearch:, ytsearchdate:)*, Mixes, and Feeds (:ytfav, :ytwatchlater, :ytsubs, :ythistory, :ytrec, :ytnotif)
- Fix for n-sig based throttling *
- Supports some (but not all) age-gated content without cookies
- Download livestreams from the start using --live-from-start (experimental)
- 255kbps audio is extracted (if available) from YouTube Music when premium cookies are given
- Channel URLs download all uploads of the channel, including shorts and live
Cookies from browser: Cookies can be automatically extracted from all major web browsers using --cookies-from-browser BROWSER[+KEYRING][:PROFILE][::CONTAINER]
Download time range: Videos can be downloaded partially based on either timestamps or chapters using --download-sections
Split video by chapters: Videos can be split into multiple files based on chapters using --split-chapters
Multi-threaded fragment downloads: Download multiple fragments of m3u8/mpd videos in parallel. Use --concurrent-fragments (-N) option to set the number of threads used
Aria2c with HLS/DASH: You can use aria2c as the external downloader for DASH(mpd) and HLS(m3u8) formats
New and fixed extractors: Many new extractors have been added and a lot of existing ones have been fixed. See the changelog or the list of supported sites
New MSOs: Philo, Spectrum, SlingTV, Cablevision, RCN etc.
Subtitle extraction from manifests: Subtitles can be extracted from streaming media manifests. See commit/be6202f for details
Multiple paths and output templates: You can give different output templates and download paths for different types of files. You can also set a temporary path where intermediary files are downloaded to using --paths (-P)
Portable Configuration: Configuration files are automatically loaded from the home and root directories. See CONFIGURATION for details
Output template improvements: Output templates can now have date-time formatting, numeric offsets, object traversal etc. See output template for details. Even more advanced operations can also be done with the help of --parse-metadata and --replace-in-metadata
Other new options: Many new options have been added such as --alias, --print, --concat-playlist, --wait-for-video, --retry-sleep, --sleep-requests, --convert-thumbnails, --force-download-archive, --force-overwrites, --break-match-filter etc
Improvements: Regex and other operators in --format/--match-filter, multiple --postprocessor-args and --downloader-args, faster archive checking, more format selection options, merge multi-video/audio, multiple --config-locations, --exec at different stages, etc
Plugins: Extractors and PostProcessors can be loaded from an external file. See plugins for details
Self updater: The releases can be updated using yt-dlp -U, and downgraded using --update-to if required
Nightly builds: Automated nightly builds can be used with --update-to nightly

See changelog or commits for the full list of changes

Features marked with a * have been back-ported to youtube-dl

Differences in default behavior

Some of yt-dlp's default options are different from that of youtube-dl and youtube-dlc: (Some of them also be reverted in ytdl-patched)

yt-dlp supports only Python 3.7+, and may remove support for more versions as they become EOL; while youtube-dl still supports Python 2.6+ and 3.2+
The options --auto-number (-A), --title (-t) and --literal (-l), no longer work. See removed options for details
avconv is not supported as an alternative to ffmpeg
yt-dlp stores config files in slightly different locations to youtube-dl. See