turkanime-client/docs/V9.4.0.md

# TürkAnime İndirici v9.4.0 Release Notes

## Genel Bakış
v9.4.0 sürümü Anizle kaynağının tam entegrasyonunu getiriyor. Cloudflare bypass sistemini güçlendirdik, performansı ciddi ölçüde iyileştirdik ve paralel işleme desteği ekledik. Anizle API'si baştan yazıldı ve GUI'ye eklendi.

## Sürüm Bilgileri
- Sürüm: 9.4.0
- Tarih: 16 Aralık 2025
- Tip: Major Feature Release
- Önceki Sürüm: 9.4.0

## ✨ Yeni Özellikler ve İyileştirmeler

### 🌐 Anizle Kaynağı Tam Entegrasyonu
#### + Eklenen Özellikler:
- **Anizle API Keşfi**: anizm.pro ve anizle.org API'leri tamamen analiz edildi
- **JavaScript Unpacker**: Dean Edwards' packed JS decoder implementasyonu
- **FirePlayer Entegrasyonu**: anizmplayer.com üzerinden HLS stream çıkarma
- **Paralel Stream İşleme**: ThreadPoolExecutor ile 8 worker paralel işlem
- **GUI Entegrasyonu**: Anizle artık GUI'de kaynak olarak görünüyor

#### ~ İyileştirilen Özellikler:
- **Stream Getirme Hızı**: 30+ saniyeden ~13 saniyeye düşürüldü
- **HTTP Timeout**: 60 saniyeden 10 saniyeye optimize edildi
- **Sessiz Hatalar**: Gereksiz log mesajları kaldırıldı

### 🔐 Cloudflare Bypass İyileştirmeleri
#### + Eklenen Özellikler:
- **curl_cffi Entegrasyonu**: Chrome 110 tarayıcı taklit desteği
- **Cookie Yönetimi**: Otomatik CF cookie kaydetme ve yükleme
- **Impersonate Desteği**: Gelişmiş tarayıcı parmak izi

#### ~ İyileştirilen Özellikler:
- **AnimeCix Bypass**: CF korumalı sayfalara erişim iyileştirildi
- **Referer Header**: API isteklerinde doğru Referer kullanımı

### 🎬 Video Oynatma İyileştirmeleri
#### + Eklenen Özellikler:
- **MPV Fallback**: bin/mpv.exe uyumsuzsa sistem MPV kullanımı
- **Binary Uyumluluk Kontrolü**: WinError 216 otomatik yakalama
- **AdapterVideo.oynat()**: Yeni video oynatma metodu

#### ~ İyileştirilen Özellikler:
- **Hata Yönetimi**: proc is None kontrolü eklendi
- **User-Agent**: HLS stream'ler için doğru header

### 🎨 Frontend/GUI Değişiklikleri
#### + Eklenen Özellikler:
- **Anizle Kaynak Desteği**: GUI'de Anizle bölümleri görüntüleme
- **display_sources Güncelleme**: Anizle filtreye eklendi

#### ~ İyileştirilen Özellikler:
- **Kaynak Durumu**: Anizle için başarı/hata mesajları
- **Temiz Loglar**: Sadece önemli bilgiler gösteriliyor

### 📁 Dosya Yapısı Değişiklikleri
#### ~ Güncellenen Dosyalar:
- `turkanime_api/sources/anizle.py` - Tamamen yeniden yazıldı
- `turkanime_api/sources/adapter.py` - oynat() metodu eklendi
- `turkanime_api/common/utils.py` - BIN_PATH eklendi
- `turkanime_api/gui/main.py` - Anizle GUI entegrasyonu
- `turkanime_api/cli/__main__.py` - proc None kontrolü

### 🔒 Güvenlik ve Kalite
#### + Eklenen Özellikler:
- **Paralel İşlem Güvenliği**: Thread-safe video işleme
- **Timeout Yönetimi**: Her istek için 10 saniye limit
- **Graceful Fallback**: Hata durumunda uzak sunucu desteği

### 📝 API Akışı Dokümantasyonu
```
1. anizm.pro/getAnimeListForSearch → Anime veritabanı (4506 anime)
2. anizle.org/episode/{ID}/translator/{ID} → Fansub video listesi
3. anizle.org/video/{ID} → Player iframe URL
4. anizle.org/player/{ID} → Packed JS (FirePlayer ID içerir)
5. anizmplayer.com/player/index.php?data={ID}&do=getVideo → HLS stream
```

## 🐛 Düzeltilen Hatalar
### Kritik Hatalar
- ✅ **AttributeError: 'AdapterVideo' has no attribute 'oynat'** - oynat() metodu eklendi
- ✅ **ImportError: cannot import name 'BIN_PATH'** - utils.py'ye BIN_PATH eklendi
- ✅ **AttributeError: 'NoneType' has no attribute 'returncode'** - None kontrolü eklendi
- ✅ **WinError 216: Uyumsuz binary** - Sistem MPV fallback eklendi

### Performans Sorunları
- ✅ **Yavaş Stream Getirme**: Paralel işleme ile 3x hızlandı
- ✅ **Uzun Timeout'lar**: 60s → 10s optimize edildi
- ✅ **Gereksiz Loglar**: HTTP hata mesajları sessizleştirildi

### GUI Sorunları
- ✅ **Anizle Görünmüyor**: display_sources filtresine Anizle eklendi
- ✅ **Eksik Kaynak Durumu**: failed_sources listesine Anizle eklendi

## 📈 Performans ve Kalite Metrikleri
- **Stream Getirme Hızı**: ~30s → ~13s (%57 iyileşme)
- **Paralel Worker Sayısı**: 8 eşzamanlı işlem
- **Desteklenen Anime Sayısı**: 4506 anime (Anizle veritabanı)
- **Yeni Özellik Sayısı**: 15+ yeni özellik
- **Düzeltilen Hata Sayısı**: 7 kritik hata

## 🔄 Geçiş ve Uyumluluk
### ⚠️ Breaking Changes
- **Yok**: Bu sürüm tamamen geriye uyumlu

### Yeni Bağımlılıklar
```toml
curl_cffi = "^0.5.0"  # Cloudflare bypass için
```

### Önerilen Güncelleme Adımları
```bash
# Güncelleme için
pip install --upgrade turkanime-gui

# Veya kaynak koddan
git pull origin main
pip install curl_cffi
poetry install
poetry build
```


## 📋 Teknik Detaylar
### Değiştirilen Dosyalar
```
turkanime_api/sources/anizle.py        # +Tamamen yeniden yazıldı
turkanime_api/sources/adapter.py       # +oynat() metodu
turkanime_api/common/utils.py          # +BIN_PATH tanımı
turkanime_api/gui/main.py              # ~Anizle GUI entegrasyonu
turkanime_api/cli/__main__.py          # ~proc None kontrolü
```

### Yeni Fonksiyonlar
```python
# anizle.py
_unpack_js(packed_code)                # Dean Edwards unpacker
_extract_fireplayer_id(html)           # FirePlayer ID çıkarma
_get_video_stream_from_player(id)      # HLS stream alma
_process_single_video(video_info)      # Paralel video işleme
get_episode_streams(slug, timeout)     # Ana stream fonksiyonu

# adapter.py
AdapterVideo.oynat(dakika_hatirla)     # Video oynatma

# utils.py
BIN_PATH                               # bin/ klasör yolu
```




## 📞 Destek ve Geri Bildirim
- **GitHub Issues**: [Sorun Bildir](https://github.com/barkeser2002/turkanime-gui/issues)
- **Discussions**: [Genel Tartışmalar](https://github.com/barkeser2002/turkanime-gui/discussions)
- **Discord**: [Topluluk Sunucusu](https://discord.gg/tiky)

## 🔗 İlgili Bağlantılar
- **GitHub Repository**: https://github.com/barkeser2002/turkanime-gui
- **PyPI Package**: https://pypi.org/project/turkanime-gui/
- **Releases**: https://github.com/barkeser2002/turkanime-gui/releases

**Not**: Bu sürüm, TürkAnime İndirici'nin en büyük kaynak güncellemelerinden biridir. Anizle kaynağının tam entegrasyonu ile kullanıcılar artık 4500+ anime içeriğine hızlı ve güvenilir şekilde erişebilir.

🇹🇷 **Proudly made in Turkey** 🇹🇷