Installation

It is recommended to install yt-dlp via pip rather than using the standalone executable from the releases page.
This plugin requires yt-dlp 2023.01.02 or later, and YTSubConverter.

Option 1: Install with pipx

# python3 -m pip install --user pipx
# python3 -m pipx ensurepath
# pipx install yt-dlp
pipx inject yt-dlp secretstorage
pipx inject yt-dlp https://github.com/bsdrop/yt-dlp-assify/archive/master.zip

Option 2: Install with pip

python3 -m pip install -U https://github.com/bsdrop/yt-dlp-assify/archive/master.zip yt-dlp

See installing yt-dlp plugins for other installation methods.

Make sure YTSubConverter is available in your PATH. Linux users will also need mono:

# After installing mono, ensure ~/.local/bin is in your $PATH
mkdir -p ~/.local/YTSubConverter
cd ~/.local/YTSubConverter
curl -L https://github.com/arcusmaximus/YTSubConverter/releases/download/1.6.3/YTSubConverter-Linux.tar.xz -o ~/.local/YTSubConverter/YTSubConverter.tar.xz
tar -vxf YTSubConverter.tar.xz
echo '#!/bin/bash' > ~/.local/bin/YTSubConverter
echo 'mono ~/.local/YTSubConverter/YTSubConverter.exe "$@"' >> ~/.local/bin/YTSubConverter
chmod +x ~/.local/bin/YTSubConverter

Usage

To use plugin, simply run:

yt-dlp --embed-subs --postprocessor-args assify $YOUTUBE_URL
# Example:
yt-dlp -fba+bv --extractor-args youtube:skip=translated_subs --embed-subs --sub-lang=all,-live_chat --sub-format=srv3/ytt --use-postprocessor assify --embed-thumbnail --embed-metadata -t mkv -t sleep https://www.youtube.com/watch?v=8MImc3MxYZg

Note: Output format must be .mkv. Avoid using --merge-format=mkv, as it caused unexpected behavior in my testing.

Contributing

Pull requests and issues are welcome! Feel free to submit bug reports or feature requests.

License

This project is licensed under The Unlicense, the same license used by yt-dlp. See the LICENSE file for details.

This repository contains a plugin package for yt-dlp. See yt-dlp plugins for more details.

Development

See the Plugin Development section of the yt-dlp wiki.