AutoDub — Автоматический перевод видео с озвучкой

Это инструмент с искусственным интеллектом, который автоматически:

Распознаёт речь из видео
Переводит её на другой язык
Создаёт озвучку голосом
Накладывает всё это обратно на видео

Подходит для IT-видеокурсов, обучения и создания переведённого контента без знания английского.

🔍 Основные возможности

Автоматическая обработка видео : скачивает YouTube-видео и извлекает аудио
Распознавание речи : использует Whisper AI для перевода речи в текст
Перевод текста : Google Translate / DeepL API
Озвучка : генерирует голосовые дорожки через gTTS или XTTS v2
Синхронизация с видео : регулирует скорость видео, чтобы совпадать с речью
Мультиязычная поддержка : можно выбирать язык перевода

🧰 Требования

Python 3.8+
FFmpeg установлен и добавлен в системный PATH
Git
Интернет-соединение (Google Translate API или DeepL API)

🔽 Установка

Шаг 1: Установите зависимости

sudo apt update
sudo apt install python3-pip ffmpeg git python3-venv

Шаг 2: Клонируйте репозиторий

git clone git@github.com:cranberis/AutoDub.git
cd AutoDub

Шаг 3: Создайте виртуальное окружение

python3 -m venv venv
source venv/bin/activate

Шаг 4: Установите зависимости

pip install -r requirements.txt

Если нужен DeepL вместо Google Translate — зарегистрируй API-ключ и добавь его в конфиг

Как использовать

Запусти программу:

python main.py --file ~/Videos/lesson_1.mp4 --lang ru

✅ После выполнения вы получите:

~/Videos/lesson_1_translated.mp4 — видео с русской озвучкой
~/Videos/lesson_1.srt — файл субтитров (если понадобится)

📁 Структура проекта

AutoDub/
├── LICENSE               # Лицензия проекта
├── main.py               # Главный файл программы
├── README.md             # Английская документация
├── README.ru.md          # Эта инструкция (на русском)
├── requirements.txt      # Зависимости Python
└── tools/                # Вспомогательные модули
    ├── audio_synthesis.py
    ├── transcriber.py
    ├── video_editing.py
    ├── video_downloader.py
    └── ...

⚠️ Известные ограничения

Качество зависит от исходного видео
Для некоторых языков возможны артефакты в звуке
Обработка занимает много времени (особенно для длинных видео)
Без GPU процесс может быть очень медленным

💡 Поддерживаемые технологии

Whisper AI  — распознавание речи
gTTS / XTTS v2  — синтез речи
Google Translate / DeepL  — перевод текста
FFmpeg  — работа с видео и аудио
yt-dlp  — загрузка видео с YouTube

🤝 Помощь и развитие

Если ты нашёл баг, хочешь предложить улучшение или помочь с кодом — открой Issue или Pull Request в своём репозитории.