Metadata-Version: 2.4
Name: VidLingua
Version: 0.1.0a1
Summary: A command-line tool that automates the translation and dubbing of YouTube videos.
Home-page: https://github.com/vprayag2005/VidLingua
Author: vprayag2005
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Multimedia :: Video
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: yt-dlp
Requires-Dist: faster-whisper
Requires-Dist: deep-translator
Requires-Dist: edge-tts
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# VidLingua

VidLingua is a command-line tool that automates the translation and dubbing of YouTube videos. It downloads the original video, transcribes the audio, translates the text into a target language, generates a new voiceover using neural text-to-speech, and merges the new audio back into the video file.

## Dependencies

- **Python 3.8+**
- **FFmpeg**: Must be installed and accessible in your system's `PATH`.

## Installation

1. Clone or download this repository.
2. Navigate to the `VidLingua` directory.
3. Install the package using `pip`:

```bash
pip install -e .
```

## Usage

```bash
Vidlingua run --yt-url <URL> --translate-to <LANG_CODE> [OPTIONS]
```

### Options

| Option | Description | Default |
| :--- | :--- | :--- |
| `--yt-url` | **(Required)** The YouTube video URL. | |
| `--translate-to` | **(Required)** The target language code (e.g., `en`, `hi`, `ml`). | |
| `--destination` | Directory to save the final video. | `~/Downloads` |

### Examples

Translate to English and save to the default Downloads folder:
```bash
Vidlingua run --yt-url "https://youtube.com/watch?v=..." --translate-to "en"
```

Translate to Hindi and save to a specific directory:
```bash
Vidlingua run --yt-url "https://youtube.com/watch?v=..." --translate-to "hi" --destination "./my_videos"
```

## Supported Languages

VidLingua maps high-quality Neural TTS voices to the following language codes. Other language codes supported by Google Translate will fall back to a default voice.

| Code | Language |
| :--- | :--- |
| `en` | English |
| `hi` | Hindi |
| `ml` | Malayalam |
| `ta` | Tamil |
| `kn` | Kannada |
| `te` | Telugu |
