Skip to main content

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 Overviewinit, doctor, langs, qualities, download, config
Configuration Overview, config keys
Usage & FAQ Examples, troubleshooting, FAQ

Index of all docs

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

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dubbed_video_downloader-0.2.0.tar.gz (176.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dubbed_video_downloader-0.2.0-py3-none-any.whl (38.3 kB view details)

Uploaded Python 3

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

Hashes for dubbed_video_downloader-0.2.0.tar.gz
Algorithm Hash digest
SHA256 398a87e3a8f09a820058c6a9383e317bf80496a63de0e37a96bae8ba89245c8b
MD5 3df4efc6e2535cca21784329f8de66fb
BLAKE2b-256 4fc5b5985a4675b70ca4776dc82106e58deb4741dcef73aabf7e65ffb09b2142

See more details on using hashes here.

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

Hashes for dubbed_video_downloader-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c82220aad1ad3e600a43e7cfc0386140df89c0567135cf50f9e468ffe3c8db15
MD5 cc515674cf1e974d2c7ed98255665e76
BLAKE2b-256 d4895a943b2eaa83190f329ec1007b16c105267c63b71bb0cb3ba90d7449eefb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page