---

Ne yapar

Keşfet	Film, dizi, kişi, yıl veya IMDb kodu ile arama. Tümü / Film / Dizi süzgeci. Sonuç çıkmazsa sorgu kademeli gevşetilir. Sonuçlar sayfalanır, altındaki düğmeyle uzar.
Listelerim	İzlediklerim, Favoriler, İzleyeceklerim. Puan, kişisel not, dizilerde sezon-bölüm takibi.
Öneriler	Zevk profiline göre skorlanmış öneriler. İlgilenmediğini X ile gizle, bir daha önerilmez. İstersen sadece abone olduğun platformlardan.
AI	Google Gemini zevk profilini okuyup gerekçeli öneri yapar ve seni tanıyan bir hafıza tutar.
Analiz	Tür, yönetmen, on yıl dağılımı, ekran süresi ve yıl özeti (Wrapped).

Telefonda adresi aç, tarayıcı menüsünden Ana ekrana ekle de. Uygulama gibi açılır, çevrimdışı çalışır.

Android: Google Play'de kapalı test aşamasında (Eylül 2026'dan beri). Android uygulaması aynı siteyi yükler, bu yüzden web sürümüyle her zaman eşittir.

Hızlı başlangıç

1. izlence.web.app adresini aç.
2. TMDB üzerinden ücretsiz bir API anahtarı al (Settings → API → Create → Developer, onay anında gelir).
3. Uygulamada Ayarlar → TMDB API anahtarı alanına yapıştır ve kaydet.
4. En az üç film ekle. Öneriler ve analiz bundan sonra anlamlı çalışır.
5. İstersen Google AI Studio anahtarını da ekleyip AI sekmesini aç.

Anahtarlar yalnızca senin cihazında localStorage içinde durur. Depoda hiçbir anahtar yoktur, bu yüzden statik yayın güvenlidir.

Öneri motoru

Her filme zevk profilinde bir ağırlık verilir.

Sinyal	Ağırlık
Favori	3
İzlendi	2
İzlenecek	1
Senin puanın	çarpan 0.5x – 1.4x

Ağırlıklar tür, yönetmen, başrol ve on yıl bazında toplanır. Aday havuzu, en ağırlıklı beş filmin TMDB benzer film sonuçları ile zevk profilinin ilk üç türüne göre yapılan keşif sorgusundan oluşur. Skor tür uyumu, TMDB puanı ve dönem uyumundan gelir. Az oylanan yapımlar cezalandırılır, birden fazla kaynakta çıkanlar ödüllendirilir. Listende olanlar elenir.

Ayarlardan izleme platformlarını işaretlersen keşif sorgularına platform ve bölge filtresi eklenir, öneriler yalnızca o platformlarda izlenebilenlerden gelir.

AI önerileri

Klasik motor anahtarsız çalışır. Google AI Studio anahtarı eklersen AI sekmesi açılır.

Zevk profilin metne çevrilip modele gönderilir. Model yapılandırılmış JSON döner: film adı, yıl, Türkçe gerekçe ve ruh hali etiketi. Her öneri TMDB'de aranıp afiş ve puanla eşleştirilir. Model ayrıca bir hafıza notu yazar, bu not cihazında saklanır ve sonraki isteklerde geri verilir, böylece zamanla seni daha iyi tanır.

Model seçimi otomatik ve yetenek öncelikli. Model adı koda sabitlenmez. Uygulama Google'ın model listesini çekip anahtarının erişebildiği modelleri sıralar: önce en yeni sürüm, aynı sürüm içinde en güçlü kademe. Zincir şöyle oluşur.

gemini-3.8-pro
gemini-3.8-flash
gemini-3-pro-preview
gemini-2.5-pro
gemini-2.5-flash
gemini-2.0-flash

Bu liste yalnızca örnektir ve koda sabitlenmiş değildir. Google yeni bir sürüm çıkardığında uygulama onu kendiliğinden en üste alır; kod güncellemesi gerekmez.

Model bulunamazsa, kota dolarsa veya sunucu hatası gelirse bir alttakine geçer, en fazla sekiz deneme yapar. Anahtar hatasında denemeye devam etmez, doğrudan uyarır. Liste on iki saatte bir tazelenir. İstersen Ayarlar'dan tek bir modeli sabitleyebilirsin.

Öneriler ekranında bir kartın X düğmesine basarsan o yapım bir daha önerilmez. Gizlenenler yedeğe girer; öneri başlığının altındaki Sıfırla ile hepsi geri gelir.

Sürüm ve güncelleme

Uygulama her açılışta ve arka plandan öne geldiğinde sunucudaki sürüm dosyasını okur. Yeni sürüm varsa üstte bir bant çıkar, dokununca tüm önbellek temizlenip uygulama yeniden yüklenir. Ayarlar sekmesinden elle de denetleyebilirsin.

Sürüm numarası üç yerde birlikte yükseltilir: app.js içindeki uygulama sabiti, service worker önbellek adı ve version.json. Üçü aynı olmazsa güncelleme bandı ya hiç çıkmaz ya da hep açık kalır. Bunu elle yapma, depodaki betik üçünü birden günceller.

node bump.mjs              # yama sürümü
node bump.mjs minor        # ara sürüm
node bump.mjs 1.9.3 "not"  # belirli sürüm ve sürüm notu

iOS'ta ana ekrana eklenen sürümde görüntü alanı etiketi kritiktir. viewport-fit=cover, maximum-scale veya user-scalable=no eklemek alt menüyü ekranın altından koparır. Etiket sade tutulmalı, yakınlaştırma engelleme dokunma davranışı ve jest olaylarıyla yapılır.

Arama

Arama tek bir TMDB çağrısı değil, kademeli genişleyen bir zincir: IMDb kodu → yıl filtreli başlık → seçili dilde başlık → orijinal başlık → seri/koleksiyon → kişi → konu/anahtar kelime. İlk dolu gelen kademe kazanır.

Arama kutusunun altındaki Tümü / Film / Dizi süzgeci başlık aramasında doğrudan film ya da dizi aramasına gider, böylece sayfalama da seçilen türde devam eder. Kişi, seri, konu ve trend sonuçlarında ise gelen liste ekranda süzülür. Seçim hatırlanır.

Sorgu bir kişinin adıyla birebir eşleşiyorsa (örneğin Tom Hardy), aynı adı taşıyan birkaç rastgele başlık yerine doğrudan o kişinin filmografisi listelenir. Uzun sonuç kümeleri kırpılmaz; altındaki Daha fazla göster düğmesi başlık ve konu aramasında sonraki TMDB sayfasını çeker, filmografide kırkar kırkar açar.

Yol haritası

Google Play. Android sürümü kapalı testte. Capacitor kabuğu siteyi doğrudan izlence.web.app adresinden yükler; web'e çıkan her sürüm test kullanıcılarına da anında ulaşır. Sıradaki adım test geri bildirimlerini toplayıp açık teste, ardından üretime geçmek.

Google ile giriş ve cihazlar arası senkron. Şu an her şey cihazda duruyor ve tek koruma elle alınan yedek. iOS'ta tarayıcı depolamasının silinebilmesi bunu kırılgan kılıyor, bu yüzden isteğe bağlı bir hesap katmanı eklenecek: giriş yapan kullanıcının verisi buluta yedeklenir ve cihazlar arasında senkronlanır. Giriş zorunlu olmayacak — hesapsız kullanım bugünkü gibi çalışmaya devam edecek, yerel depolama birincil kaynak olarak kalacak.

Veri ve gizlilik

Tüm veriler cihazının localStorage alanında durur. Hesap, sunucu ve analitik yoktur.

Depolama sınırı

Kayıtlar tek bir localStorage anahtarında durur ve tarayıcı kotası dardır: Chrome ve Firefox'ta ~10 MB, Safari ve iOS'ta ~5 MB. Bu yüzden yalnızca yeniden üretilemeyen veriler saklanır. Özet metni (overview) hiç yazılmaz, oyuncu listesi öneri motorunun kullandığı ilk üç isimle sınırlanır; detay ekranı bunları o an TMDB'den tazeler. Kayıt başına ~0,5 KB düşer, yani pratik tavan iOS'ta ~5.000, masaüstünde ~10.000 yapım.

Kota yine de dolarsa uygulama çökmez: bir uyarı gösterir, verin bellekte sağlam kalır ve IMDb içe aktarımı kaçıncı satırda durduğunu bildirip temiz şekilde çıkar. Bu durumda yedek alıp bazı kayıtları silmen yeterli.

iOS'ta ayrı bir risk var: Safari, uzun süre açılmayan sitelerin depolamasını yedi gün sonra silebiliyor. Ana ekrana eklenmiş PWA'da bu risk düşer ama sıfırlanmaz — asıl koruma düzenli yedek.

Ayarlar → JSON dışa aktar ile yedek al, başka cihazda içe aktar. Listende on yapımdan fazlası varsa ve otuz gündür yedek almadıysan uygulama seni uyarır. Yedeğe API anahtarlarını da ekleyen bir seçenek var, varsayılan olarak kapalıdır. Anahtarlı yedek düz metindir, sadece kendi cihazların arasında taşı.

IMDb hesabından indirdiğin ratings.csv dosyasını Ayarlar → IMDb puanlarını içe aktar ile yükleyebilirsin. Puanların ve puanlama tarihlerin taşınır, film ve dizi ikisi de desteklenir.

Tarayıcı verisini temizlersen listeler silinir. Düzenli yedek al.

Ayrıntılı gizlilik politikası ayrı bir sayfada.

---