Windows, macOS ve Linux için adım adım kurulum kılavuzu.
yt-dlp, binlerce web sitesinden video ve ses indirmenize olanak tanıyan güçlü bir komut satırı medya indiricidir (youtube-dl'nin aktif olarak bakımı yapılan bir çatalı). Terminalde çalıştığı için yerel grafik arayüzü yoktur.
Yüksek kaliteli videolar (1080p, 4K vb.) indirmek veya MP3 ses çıkarmak için FFmpeg kurmalısınız. Ayrıca YouTube'un hız kısıtlamasını ve bot engellerini aşmak için Deno gibi bir JavaScript çalışma zamanı kurulması şiddetle tavsiye edilir. Aşağıda bu araçları cihazınıza kurmak için tam kılavuz bulunmaktadır.
Yazılım yüklemek istemiyor musunuz? Herhangi bir komutu doğrudan bizim çevrimiçi konsol sıfır yapılandırma ile.
Windows 10 (1809+) ve Windows 11 varsayılan olarak Windows Paket Yöneticisi'ni (winget) içerir. Kurulum, yollar ve güncellemeleri otomatik yönetir.
winget install yt-dlp
Windows'ta komut satırı paket yöneticileri kullanan ileri düzey kullanıcılar için.
scoop install yt-dlp
choco install yt-dlp
Bağımsız çalıştırılabilir ikili dosyayı doğrudan indirin.
C:\yt-dlp\, ve indirilen yt-dlp.exe dosyasını içine taşıyın.
C:\yt-dlp, ardından tüm iletişim pencerelerinde OK'a tıklayın.Homebrew, macOS için standart paket yöneticisidir. Python ve FFmpeg dahil tüm bağımlılıkları otomatik olarak çözer.
brew install yt-dlp
Alternatif olarak, MacPorts paket yöneticisi ile yt-dlp kurabilirsiniz.
sudo port install yt-dlp
Derlenmiş ikili dosyayı doğrudan yerel çalıştırma yolunuza indirin.
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlp
Python'un pip yöneticisini kullanmak, video çıkarıcı scriptleri için en son güncellemeleri doğrudan almanızı sağlar.
python3 -m pip install -U yt-dlp
Linux dağıtımınızın paket yöneticisi ile yt-dlp kurun.
sudo apt update && sudo apt install yt-dlp
sudo pacman -S yt-dlp
sudo dnf install yt-dlp
Bağımsız Linux ikili dosyasını doğrudan yerel çalıştırılabilir yolunuza indirin.
sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlp
FFmpeg, yt-dlp'nin ayrı yüksek çözünürlüklü video (1080p, 4K) ve ses parçası indirmelerini birleştirmek veya sesi MP3 olarak çıkarmak için kullandığı açık kaynaklı bir medya kütüphanesidir. FFmpeg olmadan, yt-dlp yalnızca yerleşik sesli 720p veya daha düşük kaliteli akışları indirir.
Tek komutla winget ile FFmpeg kurun:
winget install Gyan.FFmpeg
Alternatif olarak, Gyan.dev adresinden derlemeleri indirin, arşivden çıkarın ve bin dizinini PATH çevre değişkeninize ekleyin.
Homebrew kullanıyorsanız otomatik olarak kurulur. Elle kurmak için:
brew install ffmpeg
Sistem paket yöneticiniz ile kurun:
Debian / Ubuntu:sudo apt install ffmpeg
sudo pacman -S ffmpeg
Deno modern bir JavaScript çalışma zamanıdır. yt-dlp, YouTube'un JavaScript tabanlı imza şifre çözme algoritmalarını çalıştırmak için arka planda Deno kullanır. Deno kurmak, YouTube'un indirme hızı kısıtlamasını ve "n-challenge" bot algılama engellerini aşmaya yardımcı olur.
Tek komutla winget ile Deno kurun:
winget install DenoLand.Deno
Alternatif olarak, Scoop kullanın: scoop install deno
Homebrew ile Deno kurun:
brew install deno
Resmi shell scripti ile Deno kurun:
curl -fsSL https://deno.land/install.sh | sh
Bu scripti çalıştırmadan önce unzip ve curl'ün kurulu olduğundan emin olun.
Kurulduktan sonra terminalinizi (PowerShell, Komut İstemi veya Terminal.app) açın ve sürüm kontrol komutunu çalıştırarak her şeyin çalıştığını doğrulayın.
Terminalinizde sürüm sorgulama komutunu çalıştırın:
yt-dlp --version
Başarıyla kurulursa, şuna benzer bir yayın tarihi sürüm numarası yazdıracaktır:
2026.06.18
"Komut bulunamadı" hatası alırsanız, terminalinizi yeniden başlattığınızdan veya yt-dlp'yi içeren klasörün sistem PATH'ine doğru şekilde eklendiğinden emin olun.
Sorunlarla mı karşılaşıyorsunuz? Windows, macOS ve Linux'taki en yaygın yt-dlp hatalarının çözümleri burada.
yt-dlp'nin sistem PATH'inizde olmadığı anlamına gelir. winget, Homebrew veya pip ile kurduysanız, sadece terminalinizi kapatıp yeniden açın — PATH yalnızca yeni oturumlar için güncellenir.
yt-dlp.exe'yi elle indirdiyseniz, klasörünü PATH ortam değişkeninize eklemeniz gerekir. Yukarıdaki ayrıntılı PATH kurulum adımlarına bakın.
yt-dlp --cookies-from-browser chrome "URL"
winget install ffmpeg
yt-dlp -U
winget upgrade yt-dlp veya brew upgrade yt-dlp).
yt-dlp -U) kullandığınızdan emin olun.
yt-dlp.exe, bir Python yorumlayıcısını tek bir çalıştırılabilir dosyaya paketleyen PyInstaller ile oluşturulmuştur. Antivirüs yazılımları PyInstaller paketlerini sık sık işaretler çünkü aynı paketleme tekniği bazı kötü amaçlı yazılımlar tarafından kullanılır — ancak yt-dlp tamamen güvenlidir.
winget install yt-dlp ile kurun (Microsoft onaylı paketler işaretlenmez).
YouTube ve diğer video platformları yayın protokollerini sık sık günceller, bu da yt-dlp'nin eski sürümlerinin çalışmayı durdurmasına neden olabilir. Çıkarma hatalarını otomatik çözmek için yerel kurulumunuzu güncel tutun.
İkili dosyayı doğrudan indirdiyseniz veya pip ile kurduysanız, terminalinizde yerleşik güncelleme komutunu çalıştırın:
yt-dlp -U
Windows (winget): winget upgrade yt-dlp
macOS (Homebrew): brew upgrade yt-dlp
Python (pip): python3 -m pip install --upgrade yt-dlp
Terminalinizde bu temel komutlarla başlayın:
| Amaç | Komut | İşlemler |
|---|---|---|
| Video İndir (En İyi Kalite) | yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
| MP3 Ses Çıkar | yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
Evet, yt-dlp güvenlidir. Unlicense altında lisanslı, GitHub'da 100.000+ yıldız ve yüzlerce aktif katkıcıyla barındırılan 100% açık kaynaklı bir projedir. Her satır kod herkese açık denetlenebilir.
winget ile kurun.Yerel olarak çalıştırılabilir dosyaları çalıştırmamayı tercih ediyorsanız, bizim çevrimiçi konsol sunucularımızda yt-dlp çalıştırır — cihazınıza hiçbir şey kurulmaz.
100K+ ⭐
GitHub'da Açık Kaynak
yt-dlp komutlarınızı doğrudan sunucumuzda çalıştırın. Oynatma listelerini indirmek, yayınları kaydetmek ve sesi anında çıkarmak için web arayüzümüzü kullanın.