Kodla yazılmış filmler.
Kısa filmler, uzun YouTube videoları, reklamlar, açıklayıcılar ve müzik videoları. Fikri ve zevki sen getirirsin; bir yapay zekâ kodlama ajanı senaryoyu yazar, her kareyi kodla kurar, sesi tasarlar ve sana bitmiş bir MP4 verir.

English · 简体中文 · 日本語 · Kurulum · Hızlı başlangıç · SSS

_{cinecode ile yapılmış filmlerden 30 saniye. Her kare başsız Chrome'da koddan üretildi.}

Kendi bilgisayarında, Claude Code (masaüstü uygulaması, VS Code eklentisi, terminal) ya da Cursor içinde çalışır. Ücretli bir servis gerekmez; dış ses, yalnızca istersen, kendi Gemini anahtarını (ücretsiz kotası var), ElevenLabs'i ya da ücretsiz bir Türkçe sesi kullanır.

Neler yapabilirsin

Kodla yapılmış kısa filmler

Aklındakini tek cümleyle yaz; gerisini birlikte kurarsınız.

• Sıradan fikirde kalmaz. Ajan fikrini, dünyadan rastgele çekilen gerçek bir şeyle buluşturur: bir müze eseri, bir hayvan, uzaydan bir fotoğraf, eski bir icat, tarihî bir yer, bir zanaat. Böylece sana herkesin aklına ilk gelen filmi değil, fikrinin senin bile düşünmediğin yorumlarını getirir.
• Kendini tekrar etmez. Her öneri senin daha önce yaptığın filmlerle karşılaştırılır; aynı filmi sana ikinci kez önermez.
• Son söz hep senin. Filmin neyden yapılacağını sen seçersin: gerçek ışıklı 3B, 2B animasyon, boya, mürekkep, kâğıt, kil, hareketli grafik ya da piksel. Görünümü gerçek filmlerden karelerle kurulmuş bir panodan seçersin; film bütünüyle kurulmadan önce ilk iki sahneyi görüp onaylarsın.

Uzun YouTube videoları

On dakikayı aşan belgeseller, açıklayıcılar ve video denemeleri; Film modunda perdeler ve bölümler hâlinde kurulur:

• gerçek bir kişi ya da olay hakkındaki her iddianın kaynağıyla yazıldığı, araştırılmış bir metin;
• ilk dakikada kurulan açık bir soru ve izleyiciyi sona kadar tutan bir merak haritası;
• senin dilinde bir anlatıcı (Türkçe ve İngilizce sesler, ücretsiz Türkçe sesler dahil), çiğ motor sesiyle değil, filme ait bir ses işlemesiyle;
• açık arşivlerden fotoğraflar, haritalar, belgeler ve görüntüler; resmi olmayan yerde kod: kendini çizen haritalar, sayaçlar, şemalar, yeniden kurulan mekânlar;
• biçim isterse bölüm kartları, her perde için kulakla seçilen müzik, −14 LUFS mastering ve video açıklaman için bir künye dosyası.

Reklam ve ürün filmleri

Ürünün, renklerin, fontların, logon ve çağrı cümlen. Ürün ayrıntısıyla kurulur ve stüdyo çekimi gibi aydınlatılır; yazılım için arayüz kahraman planları; özgüllük testi filmin başka bir markaya uymasını önler; 9:16, 1:1 ve 16:9 sürümleri güvenli alanlarıyla gelir.

Sosyal medya için açıklayıcılar

30–60 saniyelik dikey filmler: ilk saniyede bir soru, açık lisanslı ve Türkçesi denenmiş bir font eşleşmesiyle kinetik yazı, çizgi çizgi kurulan şemalar, telefonda okunan sözcükler.

Müzik videoları

Şarkını getir: vuruş ızgarası ölçülür, kesmeler ölçülere, vurgular vuruşlara oturur, her söz satırına bir görüntü.

Ve dahası

• Sevdiğin bir video gibi ama farklı: biçimi ölçülür (kesmeler, tempo, ışık, renk), film o biçimle yeniden yapılır, onun karelerinden asla.
• Kendi çekimlerinin kurgusu: konuşan kafa ya da ekran kaydı, kelime zamanlı bir dökümden kesilir; duraklamalar kırpılır, grafikler sözcüklere oturur.
• Tek formatta seri: bir filmin formatını kaydedip sonraki bölümü o formatta yaparsın.

15 saniyelik bir klipten on dakikayı aşan filmlere kadar. Hızlı mod yaklaşık 3 dakikaya kadar bir filmi tek oturumda yapar; Film modu daha uzun filmleri onaylı adımlarla götürür. Film uzadıkça daha çok zaman ve kullanım ister.

cinecode ile yapılanlar

Motor · donmuş anlar · 90 sn	The Mail Train · linol baskı bir yolculuk · 25 sn	İlk Tik · bir saat reklamı · 50 sn
Atlama Programı · minyatür bir saygı duruşu · 50 sn	Boş Koltuk · kendini kuran bir film seti · 80 sn	Yüz Köpek · bir veri belgeseli · 90 sn
Titanik, Son Saatler · bir belgesel · 5 dk	cinecode · pop-art bir tanıtım · 60 sn	Fener · animasyon bir masal · 60 sn
Gökyüzü neden mavi? · bir açıklayıcı · 45 sn, 9:16	Kuzguncuk Fırın · bir fırın reklamı · 15 sn, 9:16	Tek Kibrit · grafik bir kısa film · 63 sn, 9:16

Nasıl çalışır

1. Fikri söylersin. Bir cümle yeter; eksiksiz bir brief doğrudan işe koyulur.
2. Birkaç soru sorar (fikrin okumaları, filmin neyden yapılacağı, süre ve format, görünüm, ses ve müzik); her birinde önerilen cevap ★ ile işaretli.
3. Planı gösterir: saniye saniye vuruşlar ve satır satır değiştirebileceğin bir yönetmen kartı. Sonra gerisi kurulmadan önce iki sahne, kare olarak.
4. Taslağı render eder, denetler (ilk kareden hareket, ses yüksekliği, okunurluk, tekrarlar), sana gösterir; bağımsız bir izleyici de onu soğuk gözle izler. Notların yalnızca dokundukları yeri değiştirir.
5. Final: tam boyut, −14 LUFS mastering ve video açıklaman için künye.

İki mod

Ajan önce bunu sorar ve hedefine göre birini önerir.

	Hızlı mod	Film modu
Tek satırda	tek dosyada tüm film, birkaç soru, düşük çözünürlüklü taslak, 1–2 revizyon	önce yol haritası ve senaryonun tamamı onaylanır; üretim ya aşama aşama senin onayınla ya da tek seferde taslağa kadar; araştırma, katmanlı ses
En uygun	bir dakikanın altındaki her iş, marka ve müşteri işleri dahil; sosyal medya klipleri, anlatım videoları, reklamlar, yaklaşık 3 dakikaya kadar işler; kısa bir filmin ilk taslağı dakikalar içinde, yaklaşık 3 onay	birden çok sahneli, araştırmalı ya da arşiv malzemeli uzun filmler: belgeseller, dış sesli işler, festival kısaları; aşama aşama yaklaşık 6–8 onay, tek seferde yaklaşık 3 onay
Nasıl	birkaç soru (biçim, dış ses, müzik ve referanslar dahil) → isteğe bağlı araştırma (filmine benzeyen filmlerden kareler, konu gerçekse gerçek şekiller) → plan metin olarak (vuruşlar, yönetmen kartı, referans panosu) → iki sahne kare olarak senin onayına gelir, sonra gerisi → düşük çözünürlüklü taslak → taslak üzerinde en fazla 2 revizyon turu → final render	6 soru → yol haritası → senaryo → stil karesi → animatik → render; aşama aşama her biri senin onayınla ya da senaryodan sonra doğrudan taslak
Görüntü	tek, kendi kendine yeten film.html: zamanın fonksiyonu olarak sahneler, Canvas 2D ya da three.js / WebGL, ekran yazısı	sekiz görünüm ön ayarlı three.js sahneleri, plan plan render
Ses	ilk sürümden itibaren tasarlanmış, aynı dosyada (Web Audio, çevrimdışı render): her sahneye bir ortam sesi, görüntünün işaret tablosuna kilitli efektler, ortak bir yankı, düzenleme tablosundan müzik	tasarlanmış ses kimliği: katmanlı fonlar, efekt, doruk anları, anlatıcı ve müzik
Ajanlar	tek ana sohbet kurar, render alır ve revize eder (hızlı); araştırma arka planda, yardımcılar yalnızca tahmin testi, tekrar kontrolü, dış ses denemeleri ve her taslağın bağımsız izleyicisi için	ana sohbet bağlamına sahip olduğu işi kendisi kurar; yardımcılar bağımsız parçaları paralel alır (ses, dış ses, araştırma, denetim) ve uzun filmin bölümlerini

Hızlı modda başlayıp bir filmi sonra Film moduna taşıyabilirsin: vuruşlar yol haritası olur.

İki amaç

Modla birlikte sorulur: mod işin ne kadar derin gideceğini, amaç nasıl bir film olacağını belirler. Sonrasındaki her şey (soruların önerileri, referanslar, onay noktaları, kontroller) amaca göre ilerler.

	Sinematik film	Reklam & ürün (marka, lansman, tanıtım, explainer)
Hedef	çekilmiş gibi görünen, render gibi durmayan bir hikâye, his ya da sanat işi	tek bir özneye ait, kimin olduğunu ve sonra ne yapılacağını net söyleyen bir film
Görüntü	sinematik geçiş: sığ alan derinliği ve lens karakteri, gren, operatör ataleti; istersen (varsayılan kapalı) hızlı hareketlerde 180° hareket bulanıklığı, kitin kendi baskı eğrisiyle film tonu ve gate weave; her plan için seçilen kamera hareketleri	özgüllük ve rakip testi, ekranda isim etiketleri (alt üçte bir), yazılım için arayüz kahraman planları, markanın renkleri ve yazı tipleri (açık yazı tipleri Fontsource'tan; kendi marka yazı tipin yerelde kalır), harekete çağrılı kapanış kartı
Ses	ortam sesi önde, bir imza ses, müzik senin seçimin	varsayılan: dış ses + müzik
Teslim	seçtiğin format	güvenli alanlarıyla 9:16, 1:1 ve 16:9 sürümler
Ek	—	isteğe bağlı: kendi çekimin ya da ekran kayıtların, kelime saatli dökümden kurgulanır (Whisper gerekir): duraklama kırpma, senin onayladığın kekeleme ve tekrar işaretleri, kelimelere bağlı grafikler

Ayrıntılar: references/purpose-cinematic.md, references/purpose-ad.md, references/footage-edit.md. Hareket, kamera dili, yazı tipleri, ses senkronu, kanca, plan başına tek eylem ve kontroller ikisinde ortaktır.

Neler var

• Zekice, kısa, nokta atışı senaryolar için yazım sistemi (iki modda da): önce çoğalt sonra seç, hikâyenin bir dönüşü varsa net bir dönüş, sonu önce yaz, anlatma göster, kelime bütçesi, İngilizce ve Türkçe yasaklı klişe listesi, sesli okuma ve %30 kısaltma turu, ilk kez izleyen gözüyle kontrol.
• Adlandırılmış kamera ve geçiş sözlüğü (references/camera-moves.md): kamera hareketleri, odak hareketleri ve geçişler (dolly in, orbit, dolly zoom, FPV, omuz kamerası, hız rampası, odak kaydırma, eşleşme kesmesi, whip pan, J-cut…); her birinin izleyicide uyandırdığı his, varsayılan süre, hız ve yumuşatma. Her planın kamerası tek satırdır: "dolly in, 3 s, slow ease-in-out, toward the figure". İki motor da bunları zamanın saf fonksiyonları olarak uygular (film.html 2.5B kamera, three.js için starter/camera.mjs).
• Hızlı mod başlangıç dosyası: deterministik zaman çizelgesi, derinlik katmanlı 2.5B kamera, geçişler, görüntü ve ses için ortak işaret tablosu, tohumlu rastgelelik (tohumlu veriler için tembel önbellek), yazı yardımcıları ve aksanlı harflere pay bırakan isim etiketleri, küçük Web Audio sesleri (pad, kick, tick, hit, riser, whoosh, pluck, yumuşak lead, efekt, ortam sesleri, üretilmiş ortak yankı) ve her renderdan önce denetlenen bir düzenleme tablosu içeren film.html. Tarayıcıda tıklayınca görüntü ve ses birlikte oynar.
• Film modu görüşmesi (üç kısa turda altı soru, aralarında yön panosu) ve sekiz görünüm ön ayarı (sinematik gerçekçi, anime/cel, pastel masal kitabı, claymation, kâğıt kesik/kolaj, retro/synthwave/VHS, parlak reklam, el yapımı mürekkep); ayrıca kendi referans görsellerinden özel görünüm çıkarma yolu. Aynı sekiz aile Hızlı modda da çalışır (renk düzeltmesi, doku, çizgi film gölgelemesi, saniyede 12 çizim).
• Filme ait bir ses: dış ses asla çiğ motor sesiyle çıkmaz. Her film sesinin neyin içinden geldiğini (yakın, bant kaydı, radyo, koro, su altı, makine…) ve nerede durduğunu (oda, salon, taş bir mekân, açık hava) kendisi seçer; ses filmin imza sesini içinde taşıyabilir; her satır aynı konuşma seviyesine iner.
• Bunun gibi ama …: beğendiğin bir videoyu refs/ içine bırak ve neyi değiştirmek istediğini söyle. Biçimi ölçülür (kesmeler ve plan süreleri, tempo, palet ve ışık, BPM, kesmelerin vuruşa oturması), istediğini değiştirirsin, film o biçim üzerine yeniden yapılır; karelerinden ya da müziğinden hiçbir şey alınmaz.
• Kendi şarkın: bir şarkı ya da parça getir, film onun vuruş ızgarasına oturur: tempo şarkının tamamından ölçülür, klip ölçü başından kesilir, kesmeler ve vurgular ölçü ve vuruşlara düşer, her söz satırına bir görsel; müzik dış sesin altında kendiliğinden kısılır.
• Yön panosu (Film modu): fikrini söyleyince üç görsel yön tek görselde gösterilir; her biri bir stil ve o havayı taşıyan iki üç gerçek filmden kareler (FilmGrab, yalnızca ruh hali referansı) ve ölçülmüş paletinden oluşur; seçtiğin yön ölçülüp filmin ışığına ve rengine aktarılır, stil karesi de ona göre kontrol edilir.
• Her fikre bulunan görünüş: gerçek sinemadan yönler (filmlerden, görüntü yönetmenlerinden ve fotoğrafçılardan kareler, yalnızca ilham için) ve söz dağarcığı olarak bir stil tarifleri rafı (ağaç baskı, ukiyo-e, gölge oyunu, risograf, sessiz film ve dahası; çoğu LemoLab'in, bkz. Emeği geçenler); yalnızca seçilen okunur.
• Tasarımcı düzeyinde tipografi (references/typography.md): bağımsız açık dökümhanelerden ve Fontsource'tan lisansı temiz, Türkçesi doğrulanmış fontlar ve eşleşmeler; her film için üç eşleşme filmin kendi görünümünde örnek kartlarla sunulur; Fonts In Use, Art of the Title, Typewolf, Are.na ve refs/type/ klasörüne bıraktığın kendi ekran görüntülerinden (Instagram kaydettiklerin dahil) tipografi referansları ölçülüp yöne dönüşür; seçimlerini filmden filme öğrenen bir zevk günlüğü; telefon boyutunda okunurluk, kontrast ve aksan kontrolleri; isteğe bağlı, kelimeye kilitli konuşan-kafa altyazıları.
• Ses tasarımının temelleri: her film için hafif bir ses kimliği, katmanlı fon sesleri, test edilmiş ffmpeg tarifleri, −14 LUFS mastering.
• Küçük, bağımlılıksız araçlar: kare yakalama (doğrudan MP4'e ve sayfanın film sesini WAV'a da), animatik, miks, mastering, kalite kontrolleri (ölçülen kanca kontrolü, kamera hareketi çıkarıldıktan sonra sahne başına özne eylemi, sahne başına ses yüksekliği ve sertlik dahil), lisans kaydı tutan açık lisanslı varlık arama.

Gereksinimler

• Bilgisayarında araç çalıştırabilen bir yapay zekâ kodlama ajanı: Claude Code (masaüstü uygulaması, VS Code eklentisi ya da terminal) ya da Cursor. claude.ai'deki normal sohbet bilgisayarında araç çalıştıramaz; Claude Code çalıştırır (ffmpeg, Chrome, betikler).
• Node.js 22+, Python 3.9+, ffmpeg ve Google Chrome (ya da Chromium / Edge); eksik olanı ajan senin onayınla kurar. Başka bir şey gerekmez, Windows'ta da: kit Claude Code'un kendi PowerShell'inde çalışır, bash istemez; Git yalnızca kiti kurmak ve güncellemek için kullanılır, film üretiminde değil. Kitin bekçisi bir Claude Code oturumunda çalışmıyorsa filmin kurulumu GUARD OFF der (testler her gönderimde Windows ve Linux'ta, her değişiklikten önce macOS'ta çalışır; Windows'ta baştan sona bir film henüz denenmedi). Kancalar güncel bir Claude Code ister (exec biçimli kancalar ve onFailure, 2.1.295 ve sonrası); daha eski bir sürümde bekçi devreye girmeyebilir, film yine çalışır.
• Chrome'un kullanabildiği bir GPU (güncel her Mac ya da sürücüsü çalışan bir PC).
• Disk alanı: Hızlı mod kareleri doğrudan MP4'e aktardığı için birkaç yüz MB yeterli; Film modu render sırasında film başına birkaç GB ister.

Biri eksik mi? Yine de başla: ajan önce bilgisayarı kontrol eder ve eksik olanı kurmayı önerir (bir şey kurmadan önce sorar). Başka hiçbir şey kurulmaz: betikler yalnızca yerleşik modülleri kullanır, three.js sabitlenmiş kütüphane sürümlerini CDN'den yükler.

İstersen bedava Türkçe sesler (kit hiçbirini kurmaz; anlatım aksi halde senin anahtarınla Gemini TTS'ten, yoksa geçici olarak sistem sesinden gelir):

• Canberk Aslan'ın EMA Lightning modeli (Apache 2.0): tek, net bir ses, internetsiz ve işlemcide çalışır, PyTorch ile yaklaşık 800 MB. Kurulduktan sonra kit kullanabilir: python3 tools/tts.py --install ema, ardından --engine ema.
• VoxCPM2 Türkçe ses tasarımı (Apache 2.0): sesi tarif ederek tasarlarsın, yedi hazır anlatıcı var (belgesel sesi, derin anlatıcı, haber spikeri); Apple Silicon ya da NVIDIA ekran kartı, yaklaşık 3,7 GB.
• Özgür Güler'in Ahenk projesi: soru tonlaması, duygular ve gülme (büyük model, NVIDIA ekran kartı) ve Ahenk Cep (küçük, işlemcide); ağırlıklar CC BY 4.0 olduğu için onları kullanan film Ahenk'e kredi verir.

Kurulum

Claude Code'u aç (masaüstü uygulamasında Code sekmesi, VS Code eklentisi ya da terminal) ve şunu yaz:

cinecode skill'ini https://github.com/sarpstar/cinecode adresinden kur

Kiti GitHub'dan git ile ~/.claude/skills/cinecode klasörüne çeker (Windows: %USERPROFILE%\.claude\skills\cinecode); git'i olmayan bir Windows bilgisayarda önce senin onayınla git'i kurar (winget install --id Git.Git -e). Sonra yeni bir sohbet aç. Daha sonra "cinecode'u güncelle" demen en yeni sürümü getirir. Yalnızca tek bir yere kur; ajan iki kopya görmesin.

Elle, tek satırda aynısı:

git clone https://github.com/sarpstar/cinecode.git ~/.claude/skills/cinecode

Beceri gündelik film, animasyon ve reklam cümleleriyle başlar ("kısa film", "animasyon", "reklam filmi", "ürün videosu", "tanıtım videosu", "make a short film", "product video", "ad").

1. Claude masaüstü uygulaması (Code)

Claude masaüstü uygulamasını aç, Code'a geç, filmin için boş bir klasör seç ve "Kısa film yapmak istiyorum" yaz (İngilizcesi: "I want to make a short film").

2. VS Code eklentisi (Claude Code)

Claude Code eklentisini kur, boş bir klasör aç, Claude Code panelini aç ve aynı cümleyi yaz.

3. Terminal

mkdir filmim && cd filmim && claude

Sonra aynı cümleyi yaz.

4. Cursor

Cursor'ın Agent sohbetinde aynı kurulumu ~/.cursor/skills/cinecode klasörüne iste, ya da:

git clone https://github.com/sarpstar/cinecode.git ~/.cursor/skills/cinecode

Cursor'da boş bir klasör aç, Agent sohbetini aç ve aynı cümleyi yaz. Kitin kendi kontrolleri (make.py, qc.py) aynı çalışır; bazı hataları anında durduran bekçi kancaları (gösterilmeden sorulan senaryo, gösterilmeyen taslak, onaydan hemen sonra durma) yalnızca Claude Code'da çalışır.

Hızlı başlangıç

1. Ajanında boş bir klasör aç (bkz. Kurulum).

2. Fikrini yaz. Tek zorunlu şey fikir; gerisini bilmiyorsan boş bırak, ajan sorar:

   cinecode ile bir film yapalım: <ne anlatsın, bir iki cümle>.
   
   (İstersen ekle, bilmiyorsan boş bırak; kit eksik olanı sorar:)
   Süre: <15 sn / 1 dk / 5 dk…>
   Nerede gösterilecek: <Instagram dikey / YouTube yatay…>
   Ses: <dış ses olsun / olmasın / kendi şarkım: dosya>
   Görünüş: <aklındaki bir film, fotoğraf, ressam ya da "sen öner">
   

   Modu yazma: ajan işin büyüklüğüne göre önerir. Ne kadar az yazarsan o kadar çok sorar; her şeyi eksiksiz yazarsan (vuruşlar, metin, süre, biçim) soru sormadan taslağa geçer.

3. Modu ve amacı seç (sinematik film ya da reklam & ürün), soruları bir iki kısa turda yanıtla (önerilen seçenek ★ ile işaretlidir).

4. Her kontrol noktasında onayla ya da değiştir. Bitmiş film, film klasörünün en üstüne <başlık>.mp4 olarak gelir.

Hızlı mod, adım adım

#	Adım	Sen ne yaparsın
1	Birkaç soru: fikrin, biçim (filmin neyden yapılacağı), süre ve format, stil ve his, ses (dış ses + müzik, yalnızca müzik ve efekt ya da ekran yazısı + müzik; dış seste ses tipi ve dil de sorulur), müzik ayrı bir soru olarak (kulağınla seçtiğin gerçek bir kayıt, kendi parçan, kodla yazılmış ya da müziksiz), referanslar (ara, sadece benimkiler ya da atla); ses kimliği tek satırla önerilir	yanıtla ya da "tamam"
1b	Hafif araştırma, seçtiysen: konunun ana öğeleri için açık lisanslı referanslar; film uzadıkça artar (15–30 sn için 2–3, 60 sn için 3–5, sonrasında bölüm başına 2; artı senin refs/ klasörün)	—
2	Plan (tek metin kapısı): tek cümlelik özet, dönüş, kamera satırlarıyla saniye saniye vuruş tablosu (uzun filmlerde tek akış, iç bölümlere göre gruplu), yazılar ya da replikler; araştırma yapıldıysa referans panosu; satır satır değiştirebileceğin kısa bir yönetmen kartı (stil, kamera, hareket, tempo, geçişler, font, ses, bitiş)	tamam, referans değiştir, tek not ya da daha fazla referans iste
3	Önce iki sahne: görünüm ve iki sahne (açılış ve ona en az benzeyen) kare olarak, gerisi kurulmadan önce	devam ya da tek not
4	Yapım ve taslak: görüntü ve sesiyle tek film.html, yarım boyutta, bitiş efektleri kapalı bir taslak, −14 LUFS mastering, kanca kontrolü	izle, sonra onay ya da not
5	Taslak üzerinde revizyonlar: en fazla iki tur hedefli düzeltme, her biri yeni bir taslak olarak	notlarını tek seferde gönder
6	Final render: tam boyut, açtığın bitiş efektleriyle (hareket bulanıklığı, baskı rengi, film titremesi; hepsi varsayılan olarak kapalı), kontroller yeniden	izle

Film modu, altı adım

#	Adım	Sen ne yaparsın
1	Görüşme: üç kısa turda altı soru, aralarında yön panosu	yanıtla ya da ★ seçenekleri seç
2	Yol haritası: konsept, süreleriyle planlar (süre ne kadar gerektiriyorsa: 30 sn için 4–8, uzun filmlerde bölüm ve perdelere gruplu), görünüm, ses kimliği, kanca, riskler	onayla ya da satır değiştir
3	Senaryo ve metin: açı, dönüş, replikler (ya da sözsüz), ekran yazıları; senaryonun tamamı tek seferde gösterilir	onayla ya da değiştir; üretimin nasıl ilerleyeceğini seç: aşama aşama ya da hepsi birden taslağa kadar
4	Stil karesi: son kalitede tek bir kare; sonraki her karenin çıtası	onayla ya da not ver
5	Animatik: düşük çözünürlüklü, zamanlanmış, geçici sesli video	tempo doğru mu?
6	Render, ses, final: önce miksajlı yarım boy bir taslak kurgu, sonra tam boy görüntü, mastering, kontroller, teslim	izle, notlarını tek seferde gönder

Notlar yalnızca dokundukları planlara, repliklere ya da ses katmanlarına uygulanır; her tur yeni bir sürümdür. Finali onaylayınca ajan taslakların ve ara dosyaların temizlenip temizlenmeyeceğini sorar; teslim edilen film, referansların, varlıkların, ses kaynakların ve notların her zaman kalır.

Yerleşik kurallar (iki modda da): ilk 2 saniye ilk kareden itibaren hareketlidir (ölçülür); her kare zamanın saf bir fonksiyonudur (yeniden render birebir aynıdır); dışarıdan gelen her dosya indirildiği anda lisans satırı alır; uzun renderlar durum dosyasıyla arka planda çalışır; ajan tam boy kareler yerine küçük temas sayfalarına bakar, bu da maliyeti düşük tutar.

İşi kim yapar (Film modu): ana sohbet, bağlamı elinde olan işi kendisi kurar; proje dosyalarından brif alan ve modeli belirtilen yeni bir yardımcı ajan, paralel yürüyebilen bağımsız bir parçayı (ses, dış ses denemeleri, araştırma, bağımsız izleyici) ya da uzun bir filmin bir bölümünü üstlenir; notların notes/round-N.md dosyasına aynen kaydedilir ve yalnızca dokundukları planlar ele alınır; bir hata, bir şey yeniden yapılmadan önce birkaç test karesiyle teşhis edilir. Kontrol noktalarında ajan yeni bir sohbet önerebilir: Claude masaüstü uygulamasında senin onayınla kendiliğinden açılır; başka yerlerde yeni bir sohbet açıp tek satır yapıştırırsın: "STATE.md'den devam et" (İngilizce: "Continue from STATE.md"). Ayrıntılar: references/context-protocol.md. Sohbetteki her adım bütün sohbeti yeniden okur; bir filmi ucuz tutan şey kısa sohbettir: her yardımcı işinin gerektirdiği modelde başlar (zevk ve yargı gerektiren iş senin sohbetinin modelinde, dosya işleri ve kaynak arama daha hafif modellerde), renderlar dört satırla cevap verir (tools/make.py), görseller küçük kalır. Claude Code'da skill bunu kitin bekçisini başlatan üç kancayla uygular; denetimlerinden bazıları: sohbet büyüyünce hatırlatma, sohbete büyük görsel girmemesi, yardımcı başına 25 adım sınırı, kullanıcının görmediği bir şeyin sorulmaması, anahtar dosyasının kapalı kalması.

İçinde ne var

cinecode/
├── SKILL.md              beceri: akış, sorular ve kesin kurallar; her film sohbeti bununla başlar
├── AGENTS.md             AGENTS.md okuyan ajanlar için giriş
├── references/           zanaat rehberleri
│   ├── quick-mode.md     Hızlı mod, adım adım
│   ├── film-mode.md      Film modu: altı onaylı adım
│   ├── writing.md        senaryo, kanca, tahmin testi, çakışma kontrolü
│   ├── looks.md          görünüm, ışık, doku; craft.md ve finish.md ile
│   ├── camera-moves.md   kamera dili; motion.md ve motion-design.md ile hareket
│   ├── typography.md     yazı; sound.md ses, music-video.md kendi şarkın
│   └── purpose-*.md      sinematik film ya da reklam ve ürün
├── scripts/              araçlar (Python standart kütüphanesi ve Node)
│   ├── init_film.py      film klasörünü kurar
│   ├── make.py           kareler, taslak ve final tek komutla
│   ├── capture.mjs       başsız Chrome'da kare kare render
│   ├── deal.py, dice.py  kıvılcımlar ve dış zar
│   ├── direction.py      stil panosu; styles.py, asset_search.py, fonts.py ile
│   ├── mix.py            miks; master_audio.py (−14 LUFS), tts.py (anlatıcı), beat_grid.py
│   ├── qc.py             kalite kontrolleri; scene_check.py, words_check.py ile
│   └── guard.py          bekçi: kuralları anında uygular (hook.cjs ile, Claude Code)
├── templates/            yeni bir filmin dosyaları ve Hızlı mod başlangıç sayfası
├── starter/              three.js sahnesi: sekiz görünüm, adlandırılmış kamera hareketleri, yazı katmanı
├── styles/               58 stil tarifi (51'i lemo-opuscar, MIT; 7'si kitin kendi)
├── docs/                 README görselleri ve font kütüphanesi
└── tests/                her gönderimde Windows ve Linux'ta çalışan test takımı

Kitin kurduğu bir film klasörü:

filmim/
├── <başlık>.mp4          bitmiş film
├── STATE.md              filmin durumu; her yeni sohbet buradan devam eder
├── film.html             Hızlı mod: filmin kendisi, tek sayfa kod
├── ROADMAP.md, SCRIPT.md Film modu: yol haritası ve senaryo; sahneler engine/ içinde
├── refs/, research/      referansların ve araştırma
├── audio/, assets/       ses ve indirilen malzeme; lisansları LICENSES.csv'de
├── review/, renders/     kontrol kareleri ve taslaklar
└── tools/                kitin araçlarının bu filme ait kopyası

Dosyalar nerede durur: her film kendi klasörüdür (bitmiş film en üstte <başlık>.mp4 olarak durur). Filmden filme taşınanlar ~/.cinecode/ içindedir: API anahtarların (keys.env, bir kez girilir), kayıtlı formatlar, zevk günlüğü ve indirme önbellekleri. Kitin kendi klasörüne hiçbir şey yazılmaz.

SSS

Yalnızca kod mu, hibrit mi? Esas olan kod: görüntüler kodla üretilir, model maliyeti yoktur. Film uzadıkça ve gerçek olaylara dayandıkça, kodun gösteremediği yerlere gerçek malzeme girer: ajanın açık arşivlerde (Wikimedia Commons, Internet Archive, NASA, müzeler) kendi bulduğu görüntüler ve fotoğraflar, Pixabay'den stok fotoğraf ve videolar (ücretsiz anahtarın, bir kez sorulur); her biri lisansıyla kaydedilir ve kredisi yazılır. Ses için kit kayıt bir müzik ve hazır ses efektleri önerir (ücretsiz CC0 kütüphaneler); tamamen kodla üretilmiş ses de seçebileceğin bir tercih. Kendi çekimlerini, fotoğraflarını ve kayıtlarını ekleyebilirsin. Bir görsel ya da video üreticiyi (Higgsfield, fal ya da başka biri) kendin bağlarsan, ajan onu yalnızca sen istediğinde, son çare olarak kullanır; hiçbir zaman önermez. Yakın planda yüzler en iyi stilize ya da siluet olarak çalışır.

API anahtarımı her film için girmem mi gerekiyor? Hayır. Dış ses ilk kez gerektiğinde bir kez girersin: ajan anahtar dosyasını metin düzenleyicinde boş bir GEMINI_API_KEY= satırıyla açar; anahtarı = işaretinden sonra yapıştırıp kaydedersin (ya da terminalde python3 tools/keys.py set GEMINI_API_KEY, yazarken görünmez). Sonraki bütün filmler onu kullanır. Eski bir filmin .env dosyasına koyduğun anahtarlar keys.py import ile oraya taşınır. Anahtarlar asla bir film klasörüne ya da repoya girmez.

Neler yapabildiğini nasıl öğrenirim? Sor: "neler yapabilirsin?". Kısa bir menü gelir: kısa film, reklam ya da ürün videosu, kendi şarkına müzik videosu, bir videoya benzeyen film, kendi çekiminin kurgusu, kayıtlı formatla yeni film, stillere göz atmak. Ya da doğrudan ne istediğini söyle ("bu şarkıya klip yap"); ajan doğru yoldan ilerler.

Hangi modu seçmeliyim? Bugün bitmiş bir film istiyorsan ya da sık paylaşıyorsan Hızlı mod; tek bir iş olabildiğince iyi olmalıysa Film modu. Ajan hedefine göre birini önerir.

Bir film ne kadar sürer? Hızlı modda 30 saniyelik bir film kısa bir oturumdur: birkaç soru, bir plan, bakılacak iki sahne, hızlı bir taslak, sonra final render (her biri saniyelerle dakikalar arası). Film modunda 30 saniyelik bir film genellikle birkaç oturumdur: görüşme ve yol haritası dakikalar sürer, senaryo ve stil karesi bir oturum, 30 saniyelik filmin renderı güncel bir GPU'da dakikalar alır. Zamanın çoğu senin notlarına gider; amaç da bu.

Güçlü bir GPU gerekir mi? Güncel her Mac (Apple silicon) ya da sürücüsü çalışan bir PC yeterli. Ajan bunu başta kontrol eder (capture.mjs --probe). Başsız Chrome'da GPU yoksa render CPU'ya düşer: test için yeterli, tüm film için yavaş.

Kendi referanslarımı kullanabilir miyim? Evet: görselleri refs/ içine, linkleri ya da film adı + dakikayı refs/links.txt içine bırak. Telif hakkı olan referanslar yalnızca hava/ton için kullanılır, karelere asla girmez.

Filmlerimi ticari olarak kullanabilir miyim (reklam, müşteri işi, para kazanan kanal)? Kit açısından evet. Kitin dağıttığı ya da bulduğu her font, ticari kullanıma izin veren ve ekranda ya da açıklamada hiçbir atıf istemeyen bir lisansla gelir (SIL OFL, Apache, MIT, Ubuntu Font Licence, CC0); font görüntüde kullanılır, dosya olarak satılmaz ya da paylaşılmaz. Seçilmiş fontlardan dördü Fontshare'den gelir (ITF Free Font License): ticari iş için de ücretsizdir, ama dosyalarını kendin indirirsin ve başkasına vermezsin; kit bütün font dosyalarını git'in dışında tutar. Ajanın bulduğu referanslar yalnızca his ve biçim içindir; bir görsel ya da ses filme yalnızca izin veren bir lisansla girer ve LICENSES.csv'ye yazılır. Kendi logoların, marka fontların, çekimlerin ve şarkıların senin sorumluluğundadır. Açık müzik ve görseller: kit yalnızca kamu malı, CC0 ve CC BY malzeme, görsellerde CC BY-SA da alır (müzikte önce CC0), her lisansı kaydeder ve her finalin yanına video açıklaması için krediyi yazar; yayınlamadan önce bir eserin kaynak sayfasına bak ve kredi dosyasını filmle sakla (CC BY bir parçaya gelen YouTube Content ID talebine cevabı odur). Filmi yayınlayan, lisanslarından sorumludur; kit olduğu gibi sunulur (MIT lisansı). Bu bir hukuki tavsiye değildir.

Kredileri nereye yazarım? Videonun açıklamasına (YouTube) ya da gönderi metnine (Instagram, TikTok, X); görüntünün üstüne hiçbir yere değil. Her final filmin yanına <film adı>-credits.txt bırakır: olduğu gibi yapıştır. Kamu malı ve CC0 malzeme satır gerektirmez (dosya yine de kısaca yazar); CC BY ve CC BY-SA malzemenin satırı gerekir, dosya lisans linkiyle birlikte yazar. Bir platform bir parçaya ya da görsele itiraz ederse cevabın da bu dosyadır.

Filmlerim nereye gidiyor? Ajanı başlattığın klasöre: o klasör boşsa ya da yalnızca filmlerden oluşuyorsa her film orada kendi alt klasörünü alır; değilse (ev klasörün, masaüstü, bir kod projesi) ajan orada bir kez Filmler klasörü açar ve bütün filmleri onda toplar. Ajan sana yolu söyler. Bir dahakine ajanı aynı yerde başlat; "devam et" dediğinde filmlerin adlarıyla listelenir. Klasör seçmeden başlarsan (Claude uygulamasında klasörsüz bir sohbet), filmler ev klasöründeki Filmler klasörüne gider ve ajan sohbeti o filmin klasörüne taşır; böylece kareler, müzik ve taslak sohbette görünür.

Filmim nerede? Git bilmem gerekir mi? Bitmiş film, film klasörüne <başlık>.mp4 olarak kopyalanır ve ajan sana o yolu verir; ihtiyacın olan tek dosya odur. Git'e hiç dokunman gerekmez: kuruluysa ajan filmin metin dosyalarının yerel bir geçmişini tutar (kötü bir düzeltme geri alınabilsin diye). Hiçbir yere yüklenmez, videolar da bu geçmişe girmez.

Bir filmi beğendim, sonraki aynı formatta olabilir mi? Evet. Finalden sonra "formatı kaydet" de; sonraki seferde "aynı formatta" de. Görünüm, font, ses, kamera dili ve ritim korunur, yalnızca fikir sorulur; sahneler ve sözler yeni fikre göre baştan yapılır. Formatlar senin bilgisayarında kalır (~/.cinecode/formats).

Ne kadar token harcar, nasıl görürüm? Bir film, ajanın kod yazıp render edip kontrol ettiği uzun bir sohbettir: Hızlı modda 30–60 saniyelik bir film genellikle 100–250 adım sürer. Her adım bütün sohbeti yeniden okur; bunun çoğu önbellekten gelir ve ucuzdur, ama sohbet uzadıkça her adım büyür. Bu yüzden kit, bir aşama bitip sohbet büyüdüğünde yeni bir sohbette devam etmeyi önerir; film dosyalarında yaşadığı için hiçbir şey kaybolmaz. Film klasöründe python3 tools/usage.py her sohbetin token dökümünü gösterir (Claude Code). Her sohbet ayrıca kurulu her skill'in kısa açıklamasıyla ve bağlı her eklenti ile bağlayıcının araç tanımlarıyla başlar (bir skill'in tam talimatları yalnızca kullanıldığında yüklenir); filmin ihtiyaç duymadıklarını kapatmak her adımı ucuzlatır.

Hangi diller? Ajan senin dilinde yanıt verir. Altyazı sen istemezsen kapalıdır (en fazla iki dil, alt alta).

Çevrimdışı? Render, miks ve kontroller çevrimdışı çalışır; Hızlı mod başlangıç dosyası da öyle (Canvas 2D, Web Audio). Aramalar ağ ister (referanslar, müzik, ilk font ve stil indirmeleri; sonra önbellekte kalır). three.js sahnesi kütüphaneleri için bir kez ağa ihtiyaç duyar (ya da yerel bir kopya, bkz. references/looks.md §6); starter/index.html hiçbir şeye ihtiyaç duymaz.

Testler

Kit klasöründe python3 -m unittest discover -s tests çalıştır; gerçek Chrome ve ffmpeg testleri için başına CINECODE_BROWSER_TESTS=1 ekle. Test takımı her gönderimde Windows'ta (Git ve bash ile de, onlarsız da) ve Ubuntu'da da çalışır. Bir sorun görürsen GitHub'da bildir.

Emeği geçenler

Sarp Yıldız (@sarpstar) tarafından, Claude ile birlikte Claude Code ve Cursor içinde yapıldı. MIT lisansı, bkz. LICENSE. three.js (MIT) ve pmndrs/postprocessing (Zlib) üzerine kuruludur; render sırasında yüklenir, pakete dahil edilmez. Bazı fikirler Leonxlnx/taste-skill (MIT) projesinden ilham aldı. Karakter kiti (references/characters.md) John Heibel'in ClaudeAnimationBase projesinden, klişe ve renk kontrolleri yihui-dev/awesome-opus5-5-videos koleksiyonundaki filmlerin incelenmesinden ilham aldı. Yalnızca fikir: ikisinden de kod, prompt ya da kare alınmadı. Vuruş ızgarası yöntemi ve müzik videosu, geçiş sesleri ve kinetik tipografi dersleri tuzhechen2005/opus-video-skills (MIT) projesinden alınıp bu kit için yeniden yazıldı. Stil kütüphanesi (styles/), LemoLab'in lemomo-ai/lemo-opuscar projesindeki stil tarifleridir (MIT, styles/LICENSE-lemo-opuscar) ve tek bir commit'e sabitlenmiştir; demo filmleri ve motoru bağlantı olarak verilir, pakete dahil değildir. vox-explainer tarifi kitin kendisinindir; plan tipleri ve inceleme dersleri charlie947/motion-graphics-skills (MIT) projesini izler. Bu kit için yeniden yazılanlar da (hepsi MIT): ürün filmi plan kataloğu AbubakrChan/product-launch-motion; vuruş tipleri ve kesme gerekçeleri cth9191/animate; kesme dikişi kuralları, tek kare parlama ve döngü kontrolleri, yalnızca hareket eden yerde bulanıklık, sessiz tek cümle testi ve sosyal medya kapak karesi howseen-ai/claude-motion-design; ışık ve lens sözlüğü showheyohtaki/motion-prompt. Hareket ilkeleri (references/motion.md) LottieFiles/motion-design-skill (MIT) ve whaleyxbt/claude-motion (MIT) fikirlerinden; arayüz kahraman planı dili (references/craft.md §8) 1weiho/cinematic-shot (MIT) fikirlerinden; kareye tam oturan tempolar cth9191/animate (MIT) fikrinden; ham kayıt kurgusu (references/footage-edit.md) duraklama ve tekrar eşikleri ile kelimeye bağlı vuruşlarda nateherkai/herk-edit-kit (MIT), konuşmaya bağlı grafik yoğunluğunda Barty-Bart/motion-graphics (MIT) fikirlerinden yararlanır. Kayıtlı enstrümanlar (scripts/samples.py), Vincentwei1021/mg-styles-15 (MIT) tarafından paketlenmiş CC0 Versilian Community Sample Library örnekleridir; gerektiğinde indirilir, pakete dahil değildir. line-boil, liquid-motion, shape-morph, sticker-explainer ve variety-captions tarifleri ile jüri kontrolü, aynı reponun stil notlarını ve değerlendirme döngüsünü bu kit için yeniden yazar. Filmin kelimelerine yapılan kontroller (scripts/words_check.py) blader/humanizer (MIT) ve Wikipedia'nın Signs of AI writing sayfasındaki kalıp ailelerini Türkçe karşılıklarıyla izler. lemo-opuscar tarifleri dışında (MIT lisanslarıyla birlikte dahil edildi) hepsi kendi cümlelerimizle yazıldı; kod ya da metin kopyalanmadı. İsteğe bağlı yazı tipleri Fontsource'tan gelir (kod MIT; her yazı tipi kendi lisansındadır, çoğu SIL OFL 1.1) ve render sırasında yüklenir. fonts.py çalışırken Fontsource API'sini ve google/fonts'un herkese açık etiket listesini okur; ikisi de pakete dahil değildir. Kayıtlı enstrümanlar CC0'dır: Versilian Community Sample Library ve Versilian Studios Chamber Orchestra 2 Community Edition; yalnızca bir film kullandığında küçük parçalar halinde indirilir. Hazır ses efektleri Kenney'nin ses paketleridir (CC0); bir film ilk ihtiyaç duyduğunda bir kez indirilir. Gereksinimler bölümünde önerilen bedava Türkçe sesler: EMA Lightning (Canberk Aslan), VoxCPM2 Türkçe ses tasarımı (alexturkey) ve Ahenk (Özgür Güler); yapanlarına teşekkürler. Depo: github.com/sarpstar/cinecode