Metadata-Version: 2.4
Name: dubbed-video-downloader
Version: 0.2.0
Summary: Download YouTube videos or audio with a selected dubbed audio track.
Project-URL: Homepage, https://github.com/Bedirhandd/dubbed-video-downloader
Project-URL: Documentation, https://github.com/Bedirhandd/dubbed-video-downloader/tree/main/docs
Project-URL: Repository, https://github.com/Bedirhandd/dubbed-video-downloader
Project-URL: Issues, https://github.com/Bedirhandd/dubbed-video-downloader/issues
Project-URL: Changelog, https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/CHANGELOG.md
Project-URL: Security, https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/SECURITY.md
Author-email: Bedirhan <bedirhandedelec0@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: cli,download,dub,youtube,yt-dlp
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Video
Requires-Python: >=3.10
Requires-Dist: langcodes==3.5.1
Requires-Dist: pyyaml==6.0.3
Requires-Dist: rich==15.0.0
Requires-Dist: typer==0.25.1
Requires-Dist: yt-dlp-ejs==0.8.0
Requires-Dist: yt-dlp==2026.6.9
Description-Content-Type: text/markdown

# YouTube Dubbed Video Downloader

[License: MIT](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/LICENSE)
[Python 3.10+](https://www.python.org/)
[Platform](https://github.com/Bedirhandd/dubbed-video-downloader#quick-start)

Download YouTube videos or audio with the **dub language you actually want** — Japanese, French, Portuguese, and more.

This CLI wraps [yt-dlp](https://github.com/yt-dlp/yt-dlp) and [FFmpeg](https://ffmpeg.org/) 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](https://ffmpeg.org/)  | Merge video and audio streams              |
| [Node.js](https://nodejs.org/) | YouTube JavaScript solver (via yt-dlp-ejs) |


## Install

```bash
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](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/getting-started/installation.md), [dependencies](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/getting-started/dependencies.md), [quickstart](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/getting-started/quickstart.md)                                                                                                                                                                                                                                                                                                                                                                 |
| Commands        | [Overview](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/commands/overview.md) — [init](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/commands/init.md), [doctor](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/commands/doctor.md), [langs](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/commands/langs.md), [qualities](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/commands/qualities.md), [download](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/commands/download.md), [config](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/commands/config.md) |
| Configuration   | [Overview](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/configuration/overview.md), [config keys](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/configuration/config-keys.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Usage & FAQ     | [Examples](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/usage-examples/index.md), [troubleshooting](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/usage-examples/troubleshooting.md), [FAQ](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/faq/general.md)                                                                                                                                                                                                                                                                                                                                                                                              |


[Index of all docs](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/docs/index.md)

## Report an issue

[Open an issue](https://github.com/Bedirhandd/dubbed-video-downloader/issues) on GitHub.

## Contributing

See [CONTRIBUTING.md](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/CONTRIBUTING.md) on GitHub.

## Legal disclaimer

This tool is provided for **educational and personal use only**. Respect [YouTube's Terms of Service](https://www.youtube.com/static?template=terms) and the rights of content creators.

## License

[MIT License](https://github.com/Bedirhandd/dubbed-video-downloader/blob/main/LICENSE)