YouTube Dubbed Video Downloader
License: MIT Python 3.10+ Platform
Download YouTube videos or audio with the dub language you actually want — Japanese, French, Portuguese, and more.
This CLI wraps yt-dlp and FFmpeg with a language-first workflow: list available dubs, pick quality, and save files under language / channel / title.
- Language-first - list available dubs before you commit to a download.
- Organized output - files land under
language / channel / title. - Video or audio - merge dubbed audio into
.mkv, or save the audio stream on its own. - Sensible defaults - a short setup step stores your preferences.
- Crash-safe staging - downloads go to a temporary staging area first; interrupted runs are cleaned automatically, and finalization is atomic so half-written files never land in your library.
Requirements
Platform: Linux only for now. Windows and macOS are not supported yet.
Install these on your system PATH before using dbdvdl:
| Dependency | Purpose |
|---|---|
| FFmpeg | Merge video and audio streams |
| Node.js | YouTube JavaScript solver (via yt-dlp-ejs) |
Install
pipx install dubbed-video-downloader # recommended
# pip install dubbed-video-downloader # alternative
dbdvdl init
dbdvdl doctor
dbdvdl download "https://www.youtube.com/watch?v=VIDEO_ID"
Documentation
Full documentation lives on GitHub:
| Section | Links |
|---|---|
| Getting Started | Installation, dependencies, quickstart |
| Commands | Overview — init, doctor, langs, qualities, download, config |
| Configuration | Overview, config keys |
| Usage & FAQ | Examples, troubleshooting, FAQ |
Report an issue
Open an issue on GitHub.
Contributing
See CONTRIBUTING.md on GitHub.
Legal disclaimer
This tool is provided for educational and personal use only. Respect YouTube's Terms of Service and the rights of content creators.
License
1 maintainer
Release files for dubbed-video-downloader 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dubbed_video_downloader-0.2.0.tar.gz | 176.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dubbed_video_downloader-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 214.6 kB
Release files / dubbed_video_downloader-0.2.0.tar.gz
| Download URL | dubbed_video_downloader-0.2.0.tar.gz |
|---|---|
| Size | 176.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
398a87e3a8f09a820058c6a9383e317bf80496a63de0e37a96bae8ba89245c8b
|
|
BLAKE2b-256 checksum How to use checksums |
4fc5b5985a4675b70ca4776dc82106e58deb4741dcef73aabf7e65ffb09b2142
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / dubbed_video_downloader-0.2.0-py3-none-any.whl
| Download URL | dubbed_video_downloader-0.2.0-py3-none-any.whl |
|---|---|
| Size | 38.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c82220aad1ad3e600a43e7cfc0386140df89c0567135cf50f9e468ffe3c8db15
|
|
BLAKE2b-256 checksum How to use checksums |
d4895a943b2eaa83190f329ec1007b16c105267c63b71bb0cb3ba90d7449eefb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
