Tek bir senaryo (YAML) dosyasıyla anlatım, altyazı ve BGM eklenmiş video üreten bir araç yaptım

Video düzenlemeye yeni başladığım için tek bir video yarım günümü alıyordu; bu yüzden düzenleme sürecini kodla otomatikleştirdim.

Girdi olarak gereken tek şey, sahne bazında narration / visual / callout yazılmış bir YAML dosyası.
python3 src/pipeline.py scenario.yaml config.yaml şeklinde tek satırla tamamlanmış bir mp4 üretiliyor.

Pipeline (Python):

• Senaryo → TTS anlatımı (say / Supertone / ElevenLabs değiştirilebilir, sonuçlar önbelleğe alınır)
• Altyazı zamanlamasını anlatım uzunluğuna göre otomatik dağıtma; anlatım=altyazı aynı
• Altyazı ve callout’ları PNG olarak render edip overlay etme (bu ffmpeg derlemesinde libass/drawtext olmadığı için seçtiğim yöntem — Korece dış çizgi ve konum için piksel kontrolü aksine daha kolay)
• Dikey çekilmiş telefon videolarında arka plan blur padding ile en-boy oranını otomatik düzeltme (config’te tek satırla 16:9 ↔ 9:16 Shorts)
• Anlatımı concat etme + BGM mix (videonun sonuna göre BGM’i otomatik kesme + fade → “siyah kuyruk” önleme)
• Render sonunda süre kayması ve son kare parlaklığı otomatik kontrolü

Faceless altyazılı videolar için özel olarak tasarlandı ve ben de kendi YouTube kanalımın videolarını gerçekten bu araçla çıkarıyorum.

Sınırlamalar: Altyazılar kelime bazında senkron değil, sahne bazında (karakter sayısına orantılı dağıtım).
Ayrıca bu ortamdaki ffmpeg’de libass olmadığı varsayımıyla yapıldığı için varsayılan yöntem PNG overlay.

Amaç kusursuz bir editörün yerini almak değil; “senaryo → ilk taslak video” süresini fiilen 0 saniyeye indirerek tekrar üretim maliyetini ortadan kaldırmak.

Smoke test (anahtar olmadan macOS say sesiyle tüm pipeline’ı kontrol etme):
python3 -m pip install -r requirements.txt
python3 demo/make_placeholders.py
python3 src/pipeline.py demo/scenario.yaml demo/config.yaml

MIT. Geri bildirimlere açığım.