Download YouTube videos or audio with a selected dubbed audio track.
Project description
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file dubbed_video_downloader-0.2.0.tar.gz.
File metadata
- Download URL: dubbed_video_downloader-0.2.0.tar.gz
- Upload date:
- Size: 176.3 kB
- Tags: Source
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
398a87e3a8f09a820058c6a9383e317bf80496a63de0e37a96bae8ba89245c8b
|
|
| MD5 |
3df4efc6e2535cca21784329f8de66fb
|
|
| BLAKE2b-256 |
4fc5b5985a4675b70ca4776dc82106e58deb4741dcef73aabf7e65ffb09b2142
|
File details
Details for the file dubbed_video_downloader-0.2.0-py3-none-any.whl.
File metadata
- Download URL: dubbed_video_downloader-0.2.0-py3-none-any.whl
- Upload date:
- Size: 38.3 kB
- Tags: Python 3
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c82220aad1ad3e600a43e7cfc0386140df89c0567135cf50f9e468ffe3c8db15
|
|
| MD5 |
cc515674cf1e974d2c7ed98255665e76
|
|
| BLAKE2b-256 |
d4895a943b2eaa83190f329ec1007b16c105267c63b71bb0cb3ba90d7449eefb
|