World Cup Shorts Automation

World Cup odakli TR/EN YouTube Shorts uretmek icin hazirlanmis lokal otomasyon deposu.

Bu repo fikirden videoya giden hatti kurar:

• TR ve EN production packet uretimi
• Sahne bazli metin, caption ve gorsel akisi
• Edge TTS ile ucretsiz seslendirme
• 9:16 MP4 render
• Gercek mac gorselleriyle editorial still akisi
• Upload aciklamasi ve kaynak dosyalari
• Temiz render klasor duzeni

GitHub'a Yuklenecek Paket

GitHub'a kaynak kod paketini yukle. Su klasorler bilerek pakete dahil edilmez:

• output/ - render videolari, previewler, ses cacheleri
• models/ - Piper gibi indirilen TTS modelleri
• tools/ - indirilen binary dosyalar
• voiceovers/ icindeki ses dosyalari
• assets/photos/**/*.jpg
• assets/editorial_visuals/**/*.jpg
• .env, API key, token, sifre dosyalari
• .rar veya .zip arsivleri

Bu dosyalar lokal uretim icin kalabilir ama public GitHub reposuna konmamalidir.

Kurulum

Gerekenler:

• Python 3.11+
• FFmpeg
• PowerShell

Python paketleri:

py -m pip install -r requirements.txt

FFmpeg terminalde calismali:

ffmpeg -version

Hızlı Kullanim

Matchday content packet uret:

py .\scripts\generate_matchday_content.py

TR render:

py .\scripts\render_batch.py --manifest .\output\production_packets\matchday_2026-06-11\matchday_2026-06-11_tr_manifest.json --voice tr-TR-EmelNeural --tts-rate +18%

EN render:

py .\scripts\render_batch.py --manifest .\output\production_packets\matchday_2026-06-11\matchday_2026-06-11_en_manifest.json --voice en-US-AndrewMultilingualNeural --tts-rate +18%

Render klasorunu duzenle:

py .\scripts\organize_renders.py

Cikti Klasorleri

Renderlar su yapida tutulur:

output/renders/tr/videos/
output/renders/tr/previews/
output/renders/tr/credits/
output/renders/tr/archive/

output/renders/en/videos/
output/renders/en/previews/
output/renders/en/credits/
output/renders/en/archive/

Yuklenecek final MP4 dosyalari videos/ altindadir.

YouTube aciklamasina eklenecek kaynak dosyalari credits/ altindadir.

Seslendirme

Varsayilan ucretsiz ses:

• TR: tr-TR-EmelNeural
• EN: en-US-AndrewMultilingualNeural
• Hiz: +18%

Ornek:

py .\scripts\render_batch.py --manifest .\output\production_packets\matchday_2026-06-11\matchday_2026-06-11_tr_manifest.json --voice tr-TR-EmelNeural --tts-rate +18%

Hazir ses dosyasi kullanmak icin:

py .\scripts\render_short.py --packet .\output\production_packets\matchday_2026-06-11\wcftr_md_001_dunya_kupasi_acilisinda_3_kirmizi_kart.json --audio-file .\voiceovers\tr\wcftr_md_001.mp3

Gorsel Kullanimi

Lokal gorsel klasorleri:

assets/photos/
assets/editorial_visuals/

GitHub paketine gercek JPG/PNG gorselleri dahil edilmez. Sadece README/manifest notlari dahil edilir.

Konuya ozel gorsel atmak icin:

assets/editorial_visuals/matchday_2026-06-11/

Packet icindeki visual_asset alani bu dosyalara baglanir. Gorsel yoksa render motoru lisansli/stok/fallback arka plana duser.

Ana Scriptler

• scripts/generate_matchday_content.py - gunluk mac fikrinden TR/EN packet ve schedule uretir
• scripts/render_short.py - tek packet'i MP4'e cevirir
• scripts/render_batch.py - manifestteki tum packetleri renderlar
• scripts/organize_renders.py - render klasorunu videos/previews/credits/archive olarak toparlar
• scripts/fetch_wikimedia_photos.py - lisansli Wikimedia gorsel starter seti indirir
• scripts/check_policy_gate.py - policy/kaynak kontrol raporu uretir

Paket Hazirlama

GitHub'a yuklenecek temiz zip'i olusturmak icin:

powershell -ExecutionPolicy Bypass -File .\scripts\make_github_zip.ps1

Zip cikisi:

dist/worldcup-shorts-automation-github.zip

Not

Bu proje public GitHub icin kaynak kod ve workflow olarak tasarlandi. Render videolari, indirilen modeller, ses dosyalari ve ucuncu taraf gorseller lokal tutulmalidir.