nhodges / yt-dlv

What is yt-dlv?

yt-dlv is a command-line YouTube downloader written in Rust that re-implements yt-dlp's architecture from scratch. It handles format selection, downloading, and post-processing entirely in code you compile yourself — no Python dependencies, no wrapper scripts. The tool reads video information, picks formats using yt-dlp's familiar selector syntax, downloads audio/video separately when needed, and merges streams with ffmpeg. It also extracts subtitles, thumbnails, and metadata as sidecar files.

Why is it gaining traction?

The standout design is a built-in JavaScript engine (QuickJS) that executes YouTube's player code directly inside the binary, descrambling signatures and n-parameters without requiring Node, Deno, or any external runtime. You can swap in an external engine if you prefer, but the default zero-dependency setup works out of the box. The format selection language mirrors yt-dlp exactly — `bv*+ba/b` gets you adaptive video+audio merged, bracket filters like `[height<=720]` let you cap resolution, and explicit itags like `137+140` let you grab exact formats. Playlists, subtitles, and browser cookie import (for authenticated requests) are all wired in. The project treats itself as honest early-stage work — it documents exactly where YouTube's BotGuard and PO-token defenses currently block progress.

Who should use this?

Rust developers building download tooling who want a working reference implementation of the yt-dlp download pipeline. Anyone who prefers a single compiled binary over a Python environment. Power users who want fine-grained format selection and are comfortable with `--cookies-from-browser firefox` and similar flags. Not yet suitable as a drop-in replacement if you need guaranteed downloads from flagged IPs or complex playlists — the project says this honestly upfront.

Verdict

The credibility score of 0.699% and low star count reflect a very young, honest WIP rather than an abandoned project. The architecture is clean, the code is well-tested against fixtures, and the embedded JS engine is a genuinely interesting approach. If you want to study how video downloaders work or contribute to the space, this is a solid starting point. If you need reliable YouTube downloads today, stick with yt-dlp — this tracks the same frontier but has more ground to cover before it matches that maturity.