kuranikerim_tr — TikTok / YouTube Shorts ayet videoları (v3 — karanlık belgesel)

@kuranikerim_tr için otomatik, karanlık belgesel tonunda Türkçe seslendirmeli, ilahi fonlu ve sinematik animasyonlu ayet + meal videoları üretir. Videolar videos/ klasöründe tutulur. Zernio (TikTok + Instagram) ve Kervly (YouTube) bu dosyaları raw GitHub linkinden çeker.

Dosyalar

• data/ara-quransimple.json: Arapça metin (Tanzil “Quran Simple”, fawazahmed0/quran-api)
• data/tur-diyanetisleri.json: Diyanet İşleri meali (Tanzil, fawazahmed0/quran-api)
• surahs.json: sure numarası → Türkçe sure adı
• topics.json: konu listesi. Alanlar: id, tema, sure, ayet [başlangıç, bitiş], hook, kapanis, sahne, seslendirme {giris, yorum}, bg, aciklama, etiketler, kurgu {kamera, gecis} (bkz. “Kurgu”), seo {yt_baslik, ilk_satir, aciklama, anahtar} (bkz. “SEO”), sır videolarında tur: "sir" ve sir_kaynak (bkz. “Kur’an’ın sırları”)
• render.py : videoyu üretir → videos/.mp4 (1080x1920, 30 fps, seslendirmeli)
• cine.py: sinematik sahne motoru (v3): katmanlı derinlik/paralaks, hareketli sis, hacimsel ışık hüzmeleri, toz/kıvılcım, yıldız/samanyolu, dağ sırtları, yağmur/şimşek, deniz, orman, şehir, kapı, kum saati, fener… Her sahne 3 çekim: sorun → dönüşüm → sonuç
• figure.py: gerçek insan oranlarında (≈7.5 baş boyu) profil siluet karakter; arkadan ışık (rim light), ceket; pozlar: yürüme, ayakta nefes, başı önde, yukarı bakma, kollar açık, diz üstü dua, diz üstü oturuş
• scenes.py, vg.py: eski (v2) çizgi film tarzı sahneler — artık kullanılmıyor
• mcp_voice.py: ElevenLabs seslendirmesini Claude’un ElevenLabs bağlayıcısıyla (MCP) üretme akışı — plan parçaları listeler, Claude her parçayı creative_generate_speech ile üretip (eleven_v4, Seçkin Yiğit nA7C14u2DhGhE4ZLOyGF, generations_count 1) voiceovers/.json manifestine yazar; bu dosyanın push’u GitHub Actions’ta videoyu kendiliğinden üretir (fetch mp3’leri indirir; imzalı adresler 2 saat geçerli)
• voice.py: Türkçe TTS. Varsayılan MCP (KT_VOICE=mcp, yukarıdaki akış; kelime zamanları sessizlik analiziyle). Alternatif: ElevenLabs API (KT_VOICE=eleven, ses “Seçkin Yiğit”, model eleven_v4, karanlık belgesel tonu; ELEVENLABS_API_KEY gerekir). Kelime zamanları API’nin karakter hizalamasından gelir. Üretilen parçalar models/el_cache altında önbelleklenir. Yedekler: EMA Lightning (ema), Piper “dfki” (dfki)
• ilahi.py: telifsiz, yerel üretilen ilahi tarzı fon: ney (makam dizileriyle doğaçlama seyir: Hicaz, Uşşak, Hüseyni, Segâh, Rast), dem/ison koro mırıltısı, alçak sesli bendir (Sofyan), cami akustiği yankısı
• .github/workflows/render.yml: videoları GitHub Actions’ta EMA sesiyle üretir ve videos/ altına commit eder (girdi: ids, ör. v015 v016 v017). Bulut oturumundan Hugging Face’e erişilemediği için videolar burada üretilir