Claude'a Video İzletme Kiti: Kurulum + 3 Komut Reçetesi

00 · Ne değişir

Claude'a linki değil, videonun gözünü verin

Bir videoyu ChatGPT'ye yapıştırdığınızda aslında sadece altyazıyı okur — ekranı görmez. Kimse "şimdi terminale npm install yazıyorum" demez; sessizce ekrana düşen komut, koddaki değişiklik, yazısız bir grafik transcript'te yoktur. MIT çıkışlı, açık kaynak (MIT lisansı) bir araç bu kör noktayı kapatıyor: videoyu sahne sahne karelere böler, sahne değişince o kareyi yakalar ve Claude'a hem transcript'i okutur hem kareleri gösterir.

01 · Dürüst sınır

"İzliyor" ama film gibi değil — slayt gibi

Bu araç akan videoyu bizim gibi izlemez: akıllıca seçilmiş anlık kareleri görür. Yani sahne içeriğini, ekran metnini, kompozisyonu okur; ama kareler arası pürüzsüz hareketi, geçiş efektini, ritmi görmez. Aşağıda bu sınırın tam tablosu, kurulum ve 3 hazır komut reçetesi var — abartısız, kopyala-kullan.

01 · Kurulum

ffmpeg + tek pip satırı — Windows ve Mac ayrı

Araç lokal çalışır (Python 3.10+). Tek sistem bağımlılığı ffmpeg/ffprobe; onu kurduktan sonra tek pip satırı kalıyor. İşletim sistemine göre sırayla çalıştırın:

Windows

# 1) ffmpeg (sistem bağımlılığı)
$ winget install Gyan.FFmpeg
# 2) crv + Whisper (transkript için)
$ pip install "claude-real-video[whisper]"

macOS

# 1) ffmpeg
$ brew install ffmpeg
# 2) crv + Whisper
$ pip install "claude-real-video[whisper]"

PATH doğrulama — iki komut da sürüm yazdırıyorsa hazırsınız:

$ ffmpeg -version
$ crv --help
ffmpeg version ... / crv komut listesi görünür

Not: ffmpeg -version "komut bulunamadı" derse PATH'e eklenmemiştir — terminali kapatıp yeniden açın. crv, ffmpeg'i PATH'te bulamazsa kareleri çıkaramaz.

02 · Komut reçeteleri

YouTube linki, ekran kaydı, uzun video — üç hazır komut

Her komut bir klasör üretir: frames/ (seçilmiş kareler), frames.json (zaman damgası + seçilme sebebi), transcript.txt ve MANIFEST.txt. Bu klasörü Claude'a verince iş başlar (03. bölüm).

① YouTube linkini izletin — yt-dlp içeride; linki indirir, kareleri ve transkripti çıkarır:

crv "https://youtu.be/VIDEO_ID"

② Yerel ekran kaydını / tutorial'ı okutun — --scene 0.30 sahne-değişimi eşiği (piksel farkı; düşürürseniz daha çok kare, yükseltirseniz daha az):

crv tutorial.mp4 --scene 0.30

③ Uzun videoyu ucuza özetletin — dedup'ı sertleştirin + kare tabanını gevşetin, token yakmayın:

crv uzun-video.mp4 --dedup-threshold 0.12 --fps-floor 2.0

--dedup-threshold (varsayılan 0.08 = %8 değişim şartı) yükseldikçe benzer kareler daha çok elenir; --fps-floor (varsayılan 1.0 sn) büyüdükçe sahne değişmese bile üretilen taban kare azalır. İkisi birlikte uzun, sabit-ekranlı videoyu ucuzlatır.

03 · Claude'a bağlayın

Kareleri boca etmeyin — okutma sırası belli bir analiz promptu verin

crv sadece dosya üretir; değerin anahtarı Claude'un bu dosyaları doğru sırayla, doğru soruyla okuması. crv çıkışı klasörünü Claude'a (Claude Code ya da sohbet) verin ve şu promptu yapıştırın:

Sana bir crv (claude-real-video) çıkarım klasörü vereceğim. Şu sırayla oku:
1) Önce MANIFEST.txt — videonun genel özeti ve kare sayısı.
2) transcript.txt — ne konuşuldu.
3) frames/ klasöründeki kareleri frames.json'daki zaman damgası sırasıyla incele.

Sonra şu şablonda raporla:
- ÖZET
- EKRANDAN OKUNAN KOMUT / KOD (satır satır)
- YAZISIZ GÖRSELLER VE YORUMU (grafik, tablo, dashboard)
- ZAMAN DAMGALI KİLİT ANLAR

Ekranda görünen ama transcript'te OLMAYAN her şeyi ayrı bir başlıkta listele. Kareler ayrık anlık görüntülerdir; kareler arası hareketi görmüyorsun. Hareket hakkında bir çıkarım yaparsan onu "iki kare arasındaki fark" olarak etiketle.

Bu davranışı projenize kalıcı gömmek için, aşağıdaki bloğu kendi CLAUDE.md dosyanıza ekleyin — her crv çıktısında Claude aynı disiplinle çalışır:

## Video analizi (crv çıkarımı)
Bir klasörde `frames/`, `frames.json` ve `transcript.txt` birlikte görürsen bu bir crv (claude-real-video) çıkarımıdır. Şu sırayı uygula:
1. Varsa önce `MANIFEST.txt` oku.
2. `transcript.txt`'i tara.
3. `frames/` içindeki kareleri `frames.json` zaman damgası sırasıyla incele.
Rapor: özet · ekrandan okunan komut/kod · yazısız görseller · zaman damgalı kilit anlar. Ekranda olup transcript'te olmayanı ayrı listele.
Kareler ayrık anlık görüntülerdir — kareler arası hareketi/animasyonu görmediğini varsay; hareket çıkarımını "iki kare farkı" olarak etiketle.

04 · Türev görevler

Tek seferlik iki hazır görev: reçete çıkarın, grafik raporlayın

Ana prompt yerine tek işe odaklı isterseniz — aynı klasör üzerinde:

1 — Tutorial'dan komut reçetesi çıkarın

Bu crv çıkarımı bir tutorial videosuna ait. frames/ içindeki terminal ve editör karelerini zaman sırasıyla oku; ekranda yazılan her komutu ve dosya değişikliğini çıkar. Çıktıyı kopyalanabilir bir komut reçetesi olarak sırala — her komutun yanında hangi zaman damgasında göründüğünü yaz.

2 — Grafik / tablo karelerini raporlayın

Bu çıkarımdaki karelerde grafik, tablo veya dashboard ara. Bulduğun her görsel için: ne tür veri gösterdiğini, eksen/etiketleri ve okunabilen rakamları raporla. Transcript'te sözü geçmeyen görselleri ayrıca işaretle — bunlar yalnızca kareden görülüyor.

05 · Dürüst sınır

Ne görür, ne göremez — yalan yetenek vaadi yok

Bu araç frame-tabanlı bir keyframe çıkarıcıdır; kareler arası fark (optical flow, motion vector) çıkarmaz. Sınırı bilerek kullanın:

Görür ✓

• Sahne içeriği — kimin/neyin ekranda olduğu
• Ekran metni ve arayüz (ince UI değişimini yakalayan "settled-local" kanalı güçlü)
• Ekrandaki komut, kod satırı, slayttaki rakam
• Renk, kompozisyon, kadraj
• Her sahne değişimi (cut)
• Yavaş morph'un örneklenmiş kareleri (--adaptive modunda)

Göremez ✗

• Kareler arası pürüzsüz hareket (topun yayı, kamera kaydırması)
• Hızlı efekt / geçiş animasyonu — fade, wipe, morph (yalnız baş-son karesi kalır)
• Frame-rate akıcılığı (60fps mi 24fps mi ayırt edemez)
• Müziğe zamanlı kesim / ritim hissi
• İki kare arasında ne olduğu — ara-hareket
• Hareketin yön/hız olarak nicel analizi (ücretli Pro katmanı işi)

Kısacası: "Claude videoyu izliyor" = önemli kareleri görüyor + ne konuşulduğunu okuyor. "Akan hareketi/efekti görüyor" değil — o promptlarda "iki kare farkı" diye etiketlenir.

06 · Maliyet ve kontrol

Token yakmadan: kaç kare, kaç token

Her kare Claude'a görsel token olarak gider. 640×360 çözünürlükte kare başına ~307 görsel token (Anthropic'in w×h/750 formülü). Ölçek için kaynaklı aralık: 3 dakikalık tipik bir video ~180 kare çıkarır, dedup'tan sonra ~26–170 kare kalır → kabaca ~25k–52k görsel token (dedup ayarına göre). Kare tavanı clamp(150, süre×1.5, 600).

Kural basit: sabit ekranlı uzun video ucuz (dedup çoğu kareyi eler), hızlı kesimli reel pahalı. Maliyeti düşürmek için 02.③'teki dedup + fps-floor ayarlarını kullanın.

60 saniyelik kontrol

• ffmpeg -version sürüm yazdırıyor mu? → sistem bağımlılığı tamam
• crv --help komut listesini gösteriyor mu? → kurulum tamam
• Bir kısa videoda crv ... koşturun → frames/ + transcript.txt + MANIFEST.txt oluştu mu?
• Klasörü Claude'a verin + 03'teki analiz promptunu yapıştırın → rapor geldi mi?

Kalıcılık: bu hat modelden bağımsız — crv dosyaları üretir, hangi LLM'e verirseniz verin aynı kareleri görür. Yarın daha ucuz bir modelde de aynı çıktıyı okutabilirsiniz; kurulum bir kez, reçeteler her videoda.