TürkAnime GUI

Sürüm notları: 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

• 8 kaynakta paralel arama: TürkAnime, AnimeciX, Anizle, TRAnimeİzle, OpenAnime, Tranimaci, AnimeDepo ve AniList aynı anda aranır. Bunlardan 7'si video sunar; AniList yalnızca meta veri ve kullanıcı listesi sağlar.
• 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.
• Gömülü Cloudflare atlatma: Uzak bir FlareSolverr'a bağımlı kalmadan, uygulamanın içindeki Chromium (QtWebEngine) ayrı süreçte challenge çözüyor. FlareSolverr adresi isteyen için ayarlarda duruyor.
• Ç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ı, otomatik yeniden deneme, tek tuşla iptal, renkli durum göstergesi.
• Tek tıkla indirme ve oynatma: Bölümleri sıra bekletmeden indir, izlerken otomatik kaydet.
• 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.
• 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.
• Testler: 723 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: 8 kaynakta paralel arama; yavaş kaynak aramayı çökertmez, zaman aşımına uğrayan kaynak boş döner.
3. İndir & Oynat: mpv entegrasyonu sayesinde indirme ve izleme tek pencerede.
4. İlerleme Takibi: İzlediklerin otomatik tutulur, AniList'e 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 (tek exe değil): QtWebEngine bir Chromium çalışma zamanı taşıyor ve tek dosyaya sıkıştırıldığında alt-süreci bulamıyor. Zip'i bir klasöre çıkar, turkanime-gui.exe ile başlat.

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.

Not: pip ile kurulan sürümde cloudscraper gelmez; Cloudflare zinciri 5 yerine 4 kademeyle çalışır (bkz. Cloudflare Bypass Zinciri). Beş kademenin tamamı için hazır paketi ya da kaynaktan kurulumu kullan.

3. Kaynak Koddan

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

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. 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.
3. FlareSolverr kullanmak istiyorsan Ayarlar → FlareSolverr URL bölümünden sunucu adresini gir (zorunlu değil).
4. Keşfet veya Ara sekmesinden anime seç.
5. Bölümü oynat ya da indir; her bölüm için ayrı ilerleme çubuğu, yeniden deneme ve iptal desteği mevcut.
6. AniList'e bağlanmak istersen Ayarlar → AniList → "AniList'e Giriş Yap"; gizli anahtar (client secret) gerekmez, ayrıntı için AniList Girişi.

📺 Desteklenen Kaynaklar

Video Kaynakları

Meta Veri ve Keşif

Cloudflare Bypass Zinciri

1. curl_cffi      (TLS fingerprint taklidi)
2. cloudscraper   (JS Challenge çözümü — pip kurulumunda gelmez)
3. FlareSolverr   (Uzak headless browser — opsiyonel, tanımlıysa)
4. QtWebEngine    (Yerel gömülü Chromium, ayrı süreçte)
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 embed'lerinde desteklenen oynatıcılar (öncelik sırasıyla, turkanime_api/objects.py::SUPPORTED):

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. Diğer kaynaklar (Anizle, Tranimaci, AnimeDepo, OpenAnime) doğrudan mp4/HLS bağlantısı döndürür, bu listeden geçmez.

⚠️ 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). Test edilen sürümler: 3.9 – 3.13.
• 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: Opsiyonel — tanımlı değilse zincir gömülü QtWebEngine'e düşer.
• İ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 15 test hiç çalışmaz ama paket yine 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. OpenAnime, Tranimaci ve TürkAnime bu betikte yok.

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