YouTube, TikTok, Instagram ve yt-dlp'nin desteklediği 1000+ siteden video indiren, Windows için masaüstü uygulaması. Flask + pywebview ile yazıldı, tek bir kurulum dosyası olarak dağıtılır.
Releases sayfasından Video Downloader Kurulum.exe
dosyasını indirip çalıştırın. Yönetici izni gerekmez; kendi kullanıcı
klasörünüze kurulur.
İlk kurulumda "Windows bilgisayarınızı korudu" uyarısı çıkar. Daha fazla bilgi → Yine de çalıştır ile geçebilirsiniz.
Bu uyarı yalnızca bir kez, ilk kurulumda görünür. Sonrasındaki otomatik güncellemelerde çıkmaz: uyarıyı tetikleyen şey dosyanın Mark-of-the-Web işaretidir, bunu tarayıcılar indirirken ekler. Uygulamanın kendi güncelleyicisi dosyayı doğrudan indirdiği için o işaret konmaz.
Uyarının sebebi kodun imzasız olması. İmzalamak için ücretli bir sertifika gerekiyor ve Microsoft'un ucuz seçeneği (Artifact Signing, ~$10/ay) bireysel geliştiriciler için yalnızca ABD ve Kanada'da açık. Bu yüzden şimdilik imzasız dağıtılıyor.
Her yayında kurulum dosyasının SHA256 toplamını içeren SHA256SUMS.txt var.
Karşılaştırmak için:
Get-FileHash "Video Downloader Kurulum.exe" -Algorithm SHA256Uygulamanın otomatik güncellemesi bu doğrulamayı kendiliğinden yapar ve toplam uyuşmazsa kurulumu başlatmaz.
- Video + ses, yalnızca video ya da yalnızca ses indirme
- Ses formatları: MP3, M4A, WAV, OPUS, FLAC
- Kalite seçimi (1080p'ye kadar veya kaynağın en iyisi)
- Başlangıç/bitiş zamanı vererek kırpma
- Oynatma listesi desteği
- Uygulama içi giriş penceresi (Instagram gibi oturum isteyen siteler için)
- Tepsiye küçültme, koyu/açık tema
Uygulamanın iki ayrı güncelleme kanalı vardır:
| Kanal | Boyut | Ne zaman | Nasıl |
|---|---|---|---|
| yt-dlp | ~3 MB | Günde bir kez (açılışta) + indirme bozulduğu an | Sessiz, otomatik |
| Uygulama | ~70 MB | Yeni sürüm çıktığında | Arka planda iner, bir sonraki açılışta sessizce kurulur |
Uygulama kanalı artık hiçbir şey sormaz: siz indirme yaparken yeni sürümün
kurulum dosyası arka planda (boş bir anda) %LOCALAPPDATA%\Video Downloader\updates
altına iner. Uygulamayı bir dahaki açışınızda açılış ekranı "Güncelleme
kuruluyor" der, kurulum sessizce (/VERYSILENT) yapılır ve uygulama kendini
yeniden açar. Toplam gecikme birkaç saniyedir.
Kurulum iki kez denenip de sürüm değişmezse otomatik kurulumdan vazgeçilir (açılış döngüsüne girmemek için) ve güncelleme Ayarlar → Güncelleme'den elle kurulabilir halde bekler. Otomatik güncellemeyi Ayarlar → Otomatik Güncelleme ile kapatabilirsiniz.
yt-dlp kanalı önemlidir: YouTube ve TikTok çıkarım yöntemlerini ayda birkaç
kez değiştirir ve eski bir yt-dlp HTTP Error 403 ya da
Unexpected response from webpage request vermeye başlar. Bu yüzden yt-dlp
uygulamanın içine gömülmez; %LOCALAPPDATA%\Video Downloader\runtime
altından yüklenir ve oradan güncellenir — yani indirme motorunu güncellemek
için uygulamayı yeniden kurmanız gerekmez.
Güncelleme tek başına yetmez, çünkü HTTP Error 403'ün çoğu geçicidir:
YouTube'un verdiği imzalı indirme bağlantısı geçersizleşir. Aynı bağlantıyı
tekrar istemek işe yaramaz — yeniden çıkarım gerekir, yani taze bir
bağlantı almak. Uygulama bunu kendiliğinden yapıyor: böyle bir hatada
indirmeyi en fazla iki kez, artan beklemeyle yeniden dener. Kalıcı hatalarda
(video kaldırılmış vb.) boşa deneme yapmaz.
Üç deneme de 403 verirse bu artık gerçekten eskimiş bir yt-dlp'ye işaret eder. Böyle bir durumda güncelleme artık bir sonraki açılış beklenmeden o anda arka planda indirilir; yeni sürüm bir sonraki açılışta devreye girer. Ayarlar → Güncelleme → Denetle ile elle de tetikleyebilirsiniz.
[SSL: INVALID_SESSION_ID] invalid session id gibi hatalar sunucuyla
bilgisayar arasına giren bir şeyden (antivirüsün HTTPS taraması, VPN, okul/iş
ağı, ISS filtresi) gelir. yt-dlp aynı bağlantı yoluyla 10 kez dener ve hep aynı
yerde düşer; tekrar denemek değil yolu değiştirmek gerekir. Uygulama böyle
bir hatada sırayla şunları dener:
- curl_cffi ile bağlan: Python'un OpenSSL'i yerine Chrome'un TLS kütüphanesi (BoringSSL). Araya giren yazılım Chrome trafiğini zaten geçirdiği için çoğunlukla bu çözer.
- Tek bağlantı + IPv4: paralel parça indirmeyi kapatır, IPv4'e zorlar.
Tutan yol hatırlanır ve o oturumdaki sonraki indirmelerde baştan kullanılır. İkisi de tutmazsa kullanıcıya antivirüsün HTTPS taramasını kapatmasını ya da başka ağdan denemesini söyleyen bir mesaj gösterilir.
Not: TikTok ve Instagram'ın web çıkarımı
curl_cffiile yapılan tarayıcı taklidine (impersonation) ihtiyaç duyar. Bu paket eksikse yt-dlp güncel olsa bile TikTokUnexpected response from webpage requestverir ve uygulama bunu "giriş gerekiyor" sanırdı. Artık pakete dahil ediliyor.
Kullanıcıların aldığı hatalar tek tek ekran görüntüsüyle gelmesin diye uygulama, kullanıcının elinde olmayan hataları kendiliğinden toplar:
uygulama ──(anonim rapor)──> report-relay (Vercel) ──(token)──> GitHub issue
│ 2+ kurulumda görüldüyse
▼
auto-fix etiketi → Claude → draft PR
- Ne gönderilir: temizlenmiş hata mesajı, denenen yollar (çerezsiz,
çerez dosyası, ssl…), sitenin alan adı (
youtube.com), uygulama / yt-dlp / Python / Windows sürümü ve rastgele bir kurulum kimliğinin hash'i. Video linki, dosya yolundaki kullanıcı adı, e-posta gönderilmez. - Ne gönderilmez: kullanıcının çözebileceği ya da uygulamanın
düzeltemeyeceği hatalar (gizli/kaldırılmış video, giriş gerekiyor, bölge
engeli, internet yok…). Liste
error_reporter.py→_IGNORE. - Aynı hata aynı bilgisayardan günde en fazla bir kez gider.
- Aynı hata (parmak izi) tek issue'da toplanır; issue'daki tablo rapor sayısını, etkilenen kurulum sayısını, sürümleri ve siteleri gösterir.
- Hata en az 2 farklı kurulumda görüldüğünde ya da yakalanmamış bir
Python istisnasıysa issue'ya
auto-fixetiketi eklenir;.github/workflows/auto-fix.ymlClaude'u çalıştırır ve Claude draft PR açar. Birleştirmek senin kararın. - Kapatılmış bir hata daha yeni bir sürümden tekrar gelirse issue kendiliğinden yeniden açılır (düzeltme tutmamış). Eski sürümden gelirse açılmaz, o kişi henüz güncellememiştir.
- Kullanıcı Ayarlar → Hata Raporlarını Gönder ile kapatabilir.
- GitHub token: GitHub → Settings → Developer settings → Fine-grained tokens → yeni token. Repository access: yalnızca bu depo. Permissions: Issues: Read and write. Başka izin verme.
- Röleyi yayınla: vercel.com/new → bu depoyu
içe aktar → Root Directory:
report-relay→ Environment Variables'aGITHUB_TOKENolarak 1. adımdaki token'ı ekle → Deploy. Adresinhttps://<proje>.vercel.app/api/reportolur; tarayıcıda açınca{"ok":true}görmelisin. - Adresi uygulamaya ver: GitHub → bu depo → Settings → Secrets and
variables → Actions → Variables →
REPORT_URL=https://<proje>.vercel.app/api/report. Release workflow'u bunu derleme sırasındaerror_reporter.py'ye yazar. Tanımlı değilse uygulama hiç rapor göndermez ve Ayarlar'da anahtar görünmez. - Otomatik düzeltme (isteğe bağlı): depo Secrets'a
CLAUDE_CODE_OAUTH_TOKEN(yereldeclaude setup-token) ya daANTHROPIC_API_KEYekle. Eklemezsen issue'lar yine açılır, sadece Claude çalışmaz.
Yerelde denemek için: VD_REPORT_URL=https://... python launcher.pyw.
Rölenin testleri: cd report-relay && npm test.
Issue'lardaki hata metni kullanıcıdan gelen veridir. Röle
@etiketlerini, kod bloklarını ve HTML'i etkisizleştirir; auto-fix workflow'u da Claude'a bu metni talimat değil veri olarak okumasını söyler ve yalnızca draft PR açabilir.
Derleme artık kendi bilgisayarınızda yapılmak zorunda değil.
.github/workflows/release.yml Windows runner'da her şeyi yapar: bağımlılıkları
kurar, ffmpeg'i indirir, PyInstaller ile derler, curl_cffi'nin pakete girdiğini
doğrular, Inno Setup ile kurulum paketini üretir, SHA256SUMS.txt hesaplar ve
ikisini birlikte GitHub Release olarak yayınlar.
Uygulamanın otomatik güncellemesi tam da bu Release'e baktığı için (updater.py
→ /releases/latest) yeni sürüm yayınlandığı anda kurulu uygulamalar kendini
günceller. SHA256 dosyası şart: uygulama indirdiği kurulumu doğrulayamazsa
güncellemeyi yapmaz.
İki şekilde tetiklenir:
git tag v1.3.1 && git push origin v1.3.1- GitHub → Actions → Release → Run workflow → sürüm numarasını yazın
Sürüm numarası etiketten alınır ve derleme sırasında updater.py ile
installer.iss içine yazılır — iki dosyayı elle güncellemeyi unutma derdi yok.
pip install -r requirements.txt
python launcher.pyw
ffmpeg/ klasörü depoya dahil değildir (161 MB). Derlemeden önce
BtbN FFmpeg-Builds
sayfasından ffmpeg-master-latest-win64-gpl-shared.zip indirin ve
arşivdeki bin/ içeriğini — ffplay.exe hariç — ffmpeg/ klasörüne kopyalayın.
Sonra:
build_exe.bat
Bu betik PyInstaller ile uygulamayı derler, ffmpeg'i yanına kopyalar ve
Inno Setup ile dist\Video Downloader Kurulum.exe paketini üretir.
- yt-dlp PYZ'ye gömülmez.
Video Downloader.specyt-dlp'yi normal şekilde analiz ettirir (bağımlılıkları doğru toplansın diye), ancak modülleriniPYZoluşturulmadan hemen önce ayıklar ve kaynağıruntime/altına düz dosya olarak koyar. PyInstaller'ınFrozenImporter'ısys.meta_path'tesys.path'ten önce geldiği için, gömülü kalsaydı çalışma zamanında güncellenmesi imkânsız olurdu. - ffmpeg PyInstaller ile paketlenmez. "shared" build'in DLL'leri
datasile eklendiğinde PyInstaller onlarıbinaries'e taşıyıp_internalköküne de kopyalıyor, yani 161 MB iki kere yazılıyordu. Bunun yerine ffmpeg derlemeden sonra çıktının yanına kopyalanır.
Bu uygulama yt-dlp (Unlicense) ve FFmpeg (GPL) kullanır. FFmpeg'in GPL derlemesi paketlendiği için dağıtılan ikili GPL şartlarına tabidir.