TürkAnime GUI

Sürüm notları: V10.2.0 · V10.1.0 · V10.0.0

TürkAnime GUI tamamen arayüz odaklı bir anime keşif, izleme ve indirme uygulaması. Arayüz PySide6 + QtWebEngine üzerine kurulu; V10.0.0 ile CustomTkinter yığını kaldırıldı ve tek arayüz kaldı. Terminal (CLI) sürümü çalışmaya devam ediyor ama geliştirme masaüstü uygulamasına odaklı.

✨ Öne Çıkan Özellikler

• 13 kaynakta paralel arama: TürkAnime (arşiv), AnimeciX, Anizle, TRAnimeİzle, OpenAnime, Tranimaci, Animexe, AnimPow, Deokwave, Asya Animeleri, Animeler.pw, One Pace TR ve AniList aynı anda aranır. Bunlardan 12'si video sunar; AniList yalnızca meta veri ve kullanıcı listesi sağlar. turkanime.tv kapandı: TürkAnime kaynağı artık sitenin statik arşivi ve yerel kopyadan ağsız aranır. Kaynak listesi tek yerde tutulur (turkanime_api/sources/kayit.py).
• Artımlı arama: Her kaynağın sonucu o kaynak bittiği an görünür; yeni sorgu süren aramayı beklemez.
• Çevrimdışı TürkAnime arşivi: Ayarlar'dan tek tıkla indirilir (~230 MB); sonra TürkAnime araması ve bölüm listeleri internetsiz çalışır (bkz. Çevrimdışı Arşiv). Arşiv kaydında detay sayfası Türkçe özeti, türü, stüdyoyu ve puanı gösterir.
• Alakaya göre sıralama: Sonuçlar sorguya yakınlığa göre dizilir. "one piece" aramasında ilk sıra One Piece olur — "Koisuru One Piece" değil. Otomatik eşleşme eşiklidir (0,95): eşiği geçen aday yoksa kaynak bağlanmaz, eşleştirme penceresi açılır.
• Yerel kitaplık: AniList hesabı olmadan "Kitaplığım" → İzlemeye devam et, Favoriler, Geçmiş.
• Oynatma: Video oynatılamazsa sıradaki aday denenir ve bölüm "izlendi" sayılmaz; kaldığın yerden devam, "Sıradaki" bölüm, bölüm bitince izleme ilerlemesi kendiliğinden yazılır. İndirilmiş bölüm ağsız oynar.
• Gömülü Cloudflare atlatma: Uygulamanın içindeki Chromium (QtWebEngine) ayrı süreçte challenge çözüyor; uzak bir FlareSolverr olmadan da çalışır. Dikkat: yine de kutudan çıktığı hâlde flaresolverr_url ayarı BOŞ DEĞİL, projenin sunucusu (node-kyb.bariskeser.com:8191) yazılı gelir ve zincirin 3. kademesi oraya uğrar. İstemiyorsanız Ayarlar → FlareSolverr URL alanını boşaltın; zincir gömülü çözücüyle çalışmaya devam eder.
• Çok kaynaklı bölüm birleştirme: Aynı anime birden çok kaynakta varsa bölümler (sezon, bölüm) anahtarıyla tek listede birleşir.
• Gelişmiş indirme sistemi: Bölüm başına ilerleme çubukları, başka adayla yeniden deneme, tek tuşla iptal. Kuyruk diske yazılır ve açılışta geri gelir; Duraklat/Devam et, "Tümünü Duraklat". Başarısız indirme "tamamlandı" sayılmaz (dosya diskte doğrulanır), aynı bölüm iki kez kuyruğa girmez. Biten satırda "Oynat" ve "Klasörü Aç"; kuyruk bitince masaüstü bildirimi.
• Tek tıkla indirme ve oynatma: Bölümleri sıra bekletmeden indir, izlerken kaydet ("İzlerken kaydet"). Toplu seçim aralıkla ("1-12, 20-"), izlenmemişler, indirilmemişler ya da Shift+tık.
• Hata sebebi: Oynatma, indirme ve arama hataları "çalışmıyor" yerine sebebi söyler (çerez süresi, Cloudflare engeli, 403/404/429, zaman aşımı, disk dolu…).
• AniList entegrasyonu: OAuth2 ile hesabına bağlan, listelerini senkron tut. Gizli anahtar (client secret) gerekmez — bkz. AniList Girişi.
• Fansub ve kalite seçimi: Desteklenen kaynaklardan en temiz sürümü bulur. "Fansub'u kendim seçeyim" açıksa birden çok grup olan bölümde sorar; seçim seri için hatırlanır.
• Kart tabanlı arayüz: Hover efektli kartlar, batch rendering, poster galerileri.
• Discord Rich Presence: O anda ne izlediğini arkadaşlarınla paylaş.
• Çoklu platform: Windows/Linux/macOS için hazır paket, Python 3.9+ olan her platformdan pip ile çalıştır.
• Terminal sürümü tkinter istemez: klasör seçici yoksa yol terminalden sorulur; kayıtlı TRAnimeİzle çerezi ve OpenAnime jetonları CLI'da da yüklenir.
• Testler: 1.936 otomatik test (pytest + pytest-qt), ağa çıkmaz.

🧭 Uygulama Akışı

1. Keşfet: Jikan (MyAnimeList) trend ve sezon listeleri; Jikan erişilemezse AniList trendlerine düşülür.
2. Ara: 13 kaynakta paralel arama; sonuçlar kaynak kaynak gelir, yavaş kaynak aramayı çökertmez, zaman aşımına uğrayan kaynak adıyla yazılır.
3. İndir & Oynat: mpv entegrasyonu sayesinde indirme ve izleme tek pencerede.
4. İlerleme Takibi: İzlediklerin otomatik tutulur, "Kitaplığım"da görünür ve AniList'e bağlıysan oraya yansır.

📺 Ekran Görüntüleri

Anasayfa Ekranı

Anime Ekranı

🎮 Discord Rich Presence

TürkAnime GUI, Discord profilinde canlı durum gösterebilir:

• Ana sayfa gezinme
• Trend veya arama ekranları
• İndirme süreci
• İzlenilen anime ve bölüm

İpucu: Ayarlar → Discord Rich Presence bölümünden tek tuşla aç/kapat. Özellik isteğe bağlıdır; pypresence yoksa uygulama normal çalışmaya devam eder.

📥 Kurulum

1. Hazır Paket (Önerilen)

Releases sayfasından platformuna uyanı indir:

Arayüz paketi zip'tir ama içinde tek bir çalıştırılabilir dosya vardır (v10.1.0'dan itibaren; _internal/ klasörü yok). Zip'i aç, turkanime-gui.exe ile başlat. 10.0.0'dan yükseltiyorsan eski kurulumun yanındaki _internal/ klasörü artık gereksizdir, silebilirsin.

Zip kullanılmasının sebebi dosyanın bölünmesi değil, indirme sayfasının ve otomatik güncelleyicinin .zip adlarına bağlı olması.

Burada eskiden "QtWebEngine tek dosyaya sıkıştırıldığında alt-sürecini bulamıyor" yazıyordu. Ölçüldü ve doğru çıkmadı: tek dosya paketinde QtWebEngineProcess.exe açılım dizininde yerinde duruyor ve arayüz açılıyor. Tek dosyanın gerçek bedeli başka: her açılışta ~9 sn arşiv açılımı, ve Cloudflare çözücü alt-süreci kendi açılımını yaptığı için her duvarda ~9 sn daha. Ayrıntı: V10.1.0 sürüm notları.

2. PyPI Üzerinden

pip install "turkanime-gui[gui]"

turkanime-gui

turkanime-cli

[gui] ekstrası PySide6'yı (ve opsiyonel pypresence'ı) kurar. Sade pip install turkanime-gui yalnızca terminal sürümünü çalıştırır.

Cloudflare zinciri kurulum biçimine göre değişir. Hazır paket, kaynak koddan kurulum (requirements-gui.txt) ve pip install "turkanime-gui[gui]" beş kademeyle çalışır. Sade pip install turkanime-gui PySide6 kurmaz, yani QtWebEngine kademesi de yoktur: zincir 4 kademe. Her durumda FlareSolverr kademesi yalnızca flaresolverr_url doluyken vardır (bkz. Cloudflare Bypass Zinciri).

Not (düzeltildi): Burada önce "pip'te cloudscraper gelmez", sonra "her kurulum beş kademeyi de taşır" yazıyordu; ikisi de yanlıştı. cloudscraper zorunlu bağımlılık, her kurulumda var; sade pip kurulumunda eksik olan QtWebEngine.

3. Kaynak Koddan

git clone https://github.com/barkeser2002/turkanime-gui.git

Windows: Çevrimdışı arşivde (arsiv/) tam yolu 260 karakteri aşan dosyalar var; git'in uzun yol desteği kapalıysa klon "Filename too long" ile yarım kalır. Klonlarken açın: git clone -c core.longpaths=true https://github.com/barkeser2002/turkanime-gui.git Arşive ihtiyacınız yoksa onu hiç yazmadan da klonlayabilirsiniz (uygulama arşivi uzak aynalardan okur): git clone --no-checkout https://github.com/barkeser2002/turkanime-gui.git, sonra klasörde git sparse-checkout set --no-cone '/*' '!/arsiv/' ve git checkout main.

cd turkanime-gui

pip install -r requirements-gui.txt

python -m turkanime_api.gui.qt

🚀 Kullanım

1. İlk açılışta ffmpeg/mpv/aria2c/yt-dlp denetlenir; eksik varsa kurulum sihirbazı açılır (hazır pakette hepsi gömülü gelir).
2. TürkAnime'yi internetsiz kullanmak istiyorsan Ayarlar → Çevrimdışı arşiv (TürkAnime) → "Tüm arşivi indir (~230 MB)". Ayrıntı: Çevrimdışı Arşiv.
3. TRAnimeİzle kullanmak istiyorsan Ayarlar → TRAnimeİzle Cookie → "Tarayıcıdan Al" düğmesine bas. Uygulama içindeki tarayıcı açılır, bot kontrolünü çözersin, çerez kaydedilir. OpenAnime akışları 404 dönüyorsa Ayarlar → OpenAnime oturumu → Token / Refresh Token alanlarına tarayıcındaki openani.me çerezlerini gir (isteğe bağlı). Diğer kaynaklar giriş istemez.
4. FlareSolverr kullanmak istiyorsan Ayarlar → FlareSolverr URL bölümünden sunucu adresini gir (zorunlu değil).
5. Keşfet veya Ara sekmesinden anime seç.
6. Bölümü oynat ya da indir; her bölüm için ayrı ilerleme çubuğu, yeniden deneme ve iptal desteği mevcut.
7. AniList'e bağlanmak istersen Ayarlar → AniList → "AniList'e Giriş Yap"; gizli anahtar (client secret) gerekmez, ayrıntı için AniList Girişi.

📦 Çevrimdışı Arşiv (TürkAnime)

turkanime.tv kapandı (sitenin görselleri bile 503 dönüyor). Sitenin anime, bölüm ve video kayıtları AnimeDepo adlı statik JSON arşivinde yaşıyor ve uygulamadaki "TürkAnime (arşiv)" kaynağı artık bu arşiv: 6.098 anime, ~83 bin dosya. Arama, bölüm listesi ve video bağlantıları arşivden okunur; videoların kendisi yine üçüncü parti sunuculardan (ok.ru, Sibnet, Mail.ru, Google Drive…) gelir, yani izlemek ve indirmek için internet gerekir.

Arşiv bu depoda arsiv/ altında durur (GitLab'daki AnimeDepo'nun 790d9e8 commit'inin birebir kopyası). Hazır paket ve pip kurulumu arşivi içermez; internetsiz kullanmak için Ayarlar'dan indirin (aşağıda), indirmezseniz uzak aynalardan okunur.

Arşiv nereden okunur? Sırayla, içinde okunabilir bir dizin.json olan ilk konum kullanılır; geçersiz klasör atlanır ve Ayarlar'da uyarı çıkar:

1. TURKANIME_ARSIV_DIZIN ortam değişkeni, sonra Ayarlar'da "Klasör seç…" ile gösterilen klasör
2. Ayarlar'dan indirilen tam arşiv: <veri kökü>/cevrimdisi_arsiv
3. Depodan çalıştırılıyorsa depodaki arsiv/ aynası
4. Uzak aynalar: varsa özel adres (TURKANIME_ARSIV_URL), sonra GitLab, olmazsa bu deponun GitHub kopyası. Gelen her dosya <veri kökü>/arsiv_onbellek altında saklanır; aynalar düşerse oradan okunur. GitHub aynası bu deponun main dalını okur (10.2.0 ile birleşti, çalışıyor); GitLab düşerse yedek odur. Tek bir aynanın 404'ü "anime yok" sayılmaz, yalnızca bütün aynalarınki.

"Veri kökü" ~/Turkanime klasörü; uygulama bir git deposunun içinden çalıştırılıyorsa depo kökü (indirilenler bu yüzden arsiv/ değil cevrimdisi_arsiv/ adıyla durur ve .gitignore'dadır).

Ayarlar'dan indirme: Ayarlar → Çevrimdışı arşiv (TürkAnime) bölümü etkin konumu, yolunu ya da adresini, anime sayısını ve dizinin son güncelleme tarihini gösterir. Bu bilgi sayfa açılınca arka planda okunur; ağa çıkılmaz.

• "Tüm arşivi indir (~230 MB)" arşivin tamamını indirir (açılınca ~0,5 GB). İlerleme çubuğu ve "İptal" düğmesi var; GitLab'a ulaşılamazsa GitHub paketine geçilir. İndirilmiş bir kopya varsa düğmenin adı "Arşivi güncelle" olur: eski kopya, yenisi doğrulanıp yerine konana kadar silinmez; iptal ya da hata olursa yerinde kalır. İptal bağlanırken de hemen işler. Disk dolarsa ya da klasöre yazılamazsa GitHub'a geçilmez (aynı diske aynı boyutta paket inecekti); hata diski anlatır. cevrimdisi_arsiv başka bir diske sembolik bağsa arşiv bağın gösterdiği yere kurulur, bağ korunur. Eski kopya silinemezse (kilitli dosya) gizli .cevrimdisi_arsiv-eski-* klasörü burada uyarı olarak görünür.
• "Klasör seç…" elinizdeki bir kopyayı gösterir (içinde dizin.json olmalı, seçerken denetlenir). "Varsayılana dön" bu seçimi unutur.
• "İndirilen arşivi sil" onay sorar ve yalnızca cevrimdisi_arsiv klasörünü siler; seçtiğiniz klasöre ve depodaki arsiv/'e dokunmaz.

Arşiv hiçbir yerden okunamazsa (yerel kopya yok, aynalar yanıt vermiyor, önbellek boş) arama "bulunamadı" demez: arama sayfası ve CLI, TürkAnime'nin aranamadığını sebebiyle söyler.

Arşivdeki video kayıtlarının yaklaşık dörtte biri yalnızca turkanime.tv'nin kendi oynatıcısıyla açılabiliyordu; site kapandığı için bunlar ve DEAD_ işaretli oynatıcılar atlanır. Arşivde İngilizce adlar yok, romaji ile arayın ("attack on titan" değil "shingeki no kyojin").

📺 Desteklenen Kaynaklar

Video Kaynakları

Meta Veri ve Keşif

Cloudflare Bypass Zinciri

1. curl_cffi      (TLS fingerprint taklidi)
2. cloudscraper   (JS Challenge çözümü — zorunlu bağımlılık, her kurulumda var)
3. FlareSolverr   (Uzak headless browser — VARSAYILAN OLARAK DOLU gelir)
4. QtWebEngine    (Yerel gömülü Chromium, ayrı süreçte — yalnızca [gui] kurulumlarında)
5. requests       (Son çare)

Zincir, HTTP 200 dönen challenge sayfalarını da tanır ve başarı saymaz; aksi hâlde ilk adımda kısa devre olup gerçek tarayıcıya hiç ulaşılmıyordu. Selenium/undetected-chromedriver bağımlılıkları V10.0.0 ile tamamen kaldırıldı.

Video Sunucuları

TürkAnime arşivindeki bölüm kayıtlarının oynatıcıları (öncelik sırasıyla, turkanime_api/common/oynatici_onceligi.py):

Yandisk  Alucard  GDrive  Mail  PixelDrain  Amaterasu  HDVID
Odnoklassniki  Dailymotion  Sibnet  VK  Vidmoly  YourUpload
Sendvid  Myvi  Uqload

MP4upload listeden çıkarıldı: çözümlenmiş gibi görünüp oynatılamayan bağlantılar üretiyordu. Anizle, Tranimaci ve OpenAnime doğrudan mp4/HLS bağlantısı döndürür, bu listeden geçmez. Gömülü oynatıcı döndüren Asya Animeleri ve One Pace TR aynı listeyle sıralar; AnimPow ve Animeler.pw kendi sitelerinde ölçülen çalışma oranına göre sıralar.

⚠️ Bilinen Kısıtlar

Bunlar uygulamanın hataları değil, kaynak sitelerin getirdiği sınırlar:

🔧 Sistem Gereksinimleri

• Python: 3.9+ (kaynaktan/pip ile çalıştırmak için; hazır pakette gerekmez). Sınıflandırıcılarda 3.9 – 3.13; yayın kapısındaki testler 3.12 ile koşuyor. 3.11+ önerilir: yt-dlp, curl-cffi ve PySide6'nın güncel sürümleri 3.10+, rapidfuzz'unki 3.11+ istiyor; 3.9'da pip bunların eski sürümlerinde kalır.
• FFmpeg, mpv, aria2c, yt-dlp: Hazır Windows paketinde gömülü gelir; kaynaktan çalıştırıyorsan uygulama içindeki sihirbaz indirip kurar.
• FlareSolverr: Varsayılan ayarda projenin sunucusu yazılıdır, yani kurulumdan sonra 3. kademe uzak bir sunucuya gider. Alanı boşaltırsanız zincir doğrudan gömülü QtWebEngine'e düşer ve hiçbir istek dışarı çıkmaz.
• İnternet bağlantısı: Kaynaklara erişim ve AniList senkronu için.

🧪 Testler

Otomatik test paketi (ağa çıkmaz, Qt offscreen koşar):

pip install -r requirements-gui.txt

pip install pytest pytest-qt PyYAML

python -m pytest tests/

PyYAML neden gerekli: tests/test_release_workflow.py yayın workflow'unu ayrıştırıyor ve PyYAML yoksa importorskip ile sessizce atlanıyor. Kurmadan koşarsan o dosyanın tamamı hiç çalışmaz ama paket yeşil görünür. PyYAML hiçbir requirements dosyasında yer almıyor, elle kurulmalı.

Kaynak adaptörleri gerçek ağa çıkan ayrı bir betikle sınanır. Bu betik pytest'e dahil değildir:

python tests/adapters-test-all.py

python tests/adapters-test-all.py --source animecix

python tests/adapters-test-all.py --skip-streams

Betik şu an 4 kaynağı kapsıyor: animecix, anizle, tranime, animedepo (TürkAnime arşivi). OpenAnime ve Tranimaci bu betikte yok.

Gerçek ağa çıkan küçük duman testleri de pytest içinde: tests/test_ag_canli.py (arşiv aynaları ve AniList) ve altı yeni kaynağın birer uçtan uca testi (arama → bölümler → akışlar). network işaretli, varsayılan koşuda atlanır; ağ mandalını kaldırıp yalnızca onları koşmak için:

python -m pytest --network -m network

Test Kapsamı

Not: TRAnimeİzle ağ testleri geçerli bir cookie gerektirir. Cookie süresi dolmuşsa bu testler beklenen şekilde başarısız olur.

🗂️ İlgili Depolar

Sunucu tarafı V10.0.0 ile ayrı bir depoya taşındı. Kaynak adaptörlerini bu depodan yeniden kullanır; ikinci bir kazıyıcı yazılmadı.

👨‍💻 Katkıda Bulun

• Hata bildirimi veya feature isteği için Issues sekmesini kullan.
• PR göndermeden önce kısa bir açıklama ve ekran görüntüsü eklemek incelemeyi hızlandırır.
• Dokümantasyon ve çeviri katkıları da memnuniyetle kabul edilir.

Yayımlanan her dosyanın yanına .sha256 özeti eklenir; uygulama içi güncelleme de indirdiği paketi aynı özetle doğrular, uyuşmazsa dosyayı siler.

📄 Lisans

Bu proje Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International (CC BY-NC-ND 4.0) ile lisanslanmıştır.

Kullanım ve sorumluluk sınırları için DISCLAIMER dosyasını oku.

📧 İletişim

Sitenizi kullanmamamı, kaldırmamı istiyorsanız veya başka talepleriniz için:

• E-posta: info@bariskeser.com
• Discord: bariskeser