Skip to content

rasne-dev/yt-dlp-gui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

yt-dlp GUI

A simple desktop app for downloading videos and audio with yt-dlp.

This is an independent graphical interface for yt-dlp. It is not the official yt-dlp project.

Features

  • Download videos or audio from YouTube and many other yt-dlp supported sites
  • Fetch available formats and choose quality
  • Download or export a selected time range
  • Three cut modes: direct cut, full download + cut, full download + re-encode
  • Re-encode to h264/h265 for better compatibility
  • Optional re-encode resolution: original, 1080p, 720p, 480p
  • MP4, MKV, WEBM, MOV, AVI, MP3, AAC, OGG, M4A, FLAC and WAV output options
  • Progress bar, status text, estimated remaining time and log view
  • Turkish and English interface

Requirements

  • Python 3.8 or newer
  • yt-dlp
  • ffmpeg

Windows Setup

Open PowerShell or Command Prompt and run:

python --version
pip --version
pip install -U yt-dlp

If python is not recognized, install Python from https://www.python.org/downloads/. During installation, enable Add python.exe to PATH.

Install ffmpeg with winget:

winget install Gyan.FFmpeg

Close and reopen PowerShell, then check:

ffmpeg -version
yt-dlp --version

If winget is not available, install ffmpeg manually:

  1. Download a Windows build from https://www.gyan.dev/ffmpeg/builds/.
  2. Extract the ZIP file, for example to C:\ffmpeg.
  3. Make sure this file exists: C:\ffmpeg\bin\ffmpeg.exe.
  4. Open Start Menu → Edit the system environment variables.
  5. Click Environment Variables.
  6. Under User variables, select Path, then click Edit.
  7. Click New and add:
C:\ffmpeg\bin
  1. Click OK on all windows.
  2. Close and reopen PowerShell.
  3. Check:
ffmpeg -version

macOS Setup

brew install python ffmpeg
python3 -m pip install -U yt-dlp

Linux Setup

Debian/Ubuntu:

sudo apt update
sudo apt install python3 python3-pip ffmpeg
python3 -m pip install -U yt-dlp

Run From Source

python ytdlp_gui.py

Run the Ready EXE

If you downloaded a ready-to-use package, open the dist folder and run:

dist/ytdlp_gui.exe

You do not need to run Python commands for the EXE version. However, yt-dlp and ffmpeg still need to be installed and available on your system.

Some packages may include yt-dlp.exe and ffmpeg.exe next to ytdlp_gui.exe. In that case, the app can use those bundled files directly. If downloads, cutting, merging or re-encoding start failing, these bundled tools may be outdated. Download the latest versions of yt-dlp and ffmpeg and replace the old .exe files.

Build an EXE

pyinstaller --noconfirm --clean --onefile --windowed ytdlp_gui.py

The EXE file will be created in:

dist/ytdlp_gui.exe

How To Use

  1. Paste a video URL.
  2. Click Fetch Formats.
  3. Choose the video or audio format.
  4. Optional: enter start and end times, for example 31:23 and 33:00.
  5. Choose the output format.
  6. If you use re-encode mode, choose codec and resolution.
  7. Click Download.

Cut Modes

Direct cut is the fastest option. It asks yt-dlp to download only the selected section. On some videos, the start point may shift slightly because video files are cut around keyframes.

Full download → cut downloads the whole file first and cuts without re-encoding. It is usually fast, but the first second can freeze on some videos if the cut does not start on a keyframe.

Full download → re-encode downloads the whole file first and creates a new encoded clip. This is slower, but usually gives the most accurate and compatible result. For Twitter/X and general sharing, MP4 + h264 is recommended.

Re-Encode Resolution

Use Original for maximum quality.

Use 720p or 480p when you want faster processing and smaller files. 720p usually takes much less time than 1080p because it processes fewer pixels.

Notes

  • If YouTube shows a JavaScript runtime warning, downloads may still work, but some formats can be missing.
  • Re-encoding is CPU-heavy and can take several minutes on long or high-resolution videos.
  • If the app is open, Windows may block overwriting dist/ytdlp_gui.exe. Close the app before rebuilding.
  • The build folder is only a temporary PyInstaller folder. It is not required for users.
  • Bundled yt-dlp.exe and ffmpeg.exe files can become outdated. Updating them often fixes download or conversion errors.

License

This project is released under the Unlicense.

yt-dlp is a separate project and follows its own license: https://github.com/yt-dlp/yt-dlp/blob/master/LICENSE


yt-dlp GUI Türkçe

yt-dlp ile video ve ses indirmek için basit bir masaüstü uygulaması.

Bu proje yt-dlp için hazırlanmış bağımsız bir grafik arayüzdür. Resmi yt-dlp projesi değildir.

Özellikler

  • YouTube ve yt-dlp'nin desteklediği birçok siteden video veya ses indirme
  • Mevcut formatları getirip kalite seçme
  • Belirli bir zaman aralığını indirme veya dışa aktarma
  • Üç kesme modu: direkt kes, tam indir + kes, tam indir + yeniden kodla
  • Daha iyi uyumluluk için h264/h265 yeniden kodlama
  • Yeniden kodlama çözünürlüğü seçimi: orijinal, 1080p, 720p, 480p
  • MP4, MKV, WEBM, MOV, AVI, MP3, AAC, OGG, M4A, FLAC ve WAV çıktı seçenekleri
  • İlerleme çubuğu, durum yazısı, tahmini kalan süre ve log ekranı
  • Türkçe ve İngilizce arayüz

Gereksinimler

  • Python 3.8 veya üzeri
  • yt-dlp
  • ffmpeg

Windows Kurulumu

PowerShell veya Komut İstemi açıp şunları çalıştırın:

python --version
pip --version
pip install -U yt-dlp

python tanınmıyorsa Python'u https://www.python.org/downloads/ adresinden kurun. Kurulum ekranında Add python.exe to PATH seçeneğini işaretleyin.

ffmpeg'i winget ile kurun:

winget install Gyan.FFmpeg

PowerShell'i kapatıp tekrar açın, sonra kontrol edin:

ffmpeg -version
yt-dlp --version

winget yoksa ffmpeg'i elle kurun:

  1. Windows sürümünü https://www.gyan.dev/ffmpeg/builds/ adresinden indirin.
  2. ZIP dosyasını çıkarın, örneğin C:\ffmpeg klasörüne.
  3. Şu dosyanın var olduğundan emin olun: C:\ffmpeg\bin\ffmpeg.exe.
  4. Başlat Menüsü → Sistem ortam değişkenlerini düzenle ekranını açın.
  5. Ortam Değişkenleri butonuna tıklayın.
  6. Kullanıcı değişkenleri altında Path seçip Düzenle butonuna tıklayın.
  7. Yeni butonuna tıklayıp şunu ekleyin:
C:\ffmpeg\bin
  1. Tüm pencerelerde Tamam butonuna basın.
  2. PowerShell'i kapatıp tekrar açın.
  3. Kontrol edin:
ffmpeg -version

macOS Kurulumu

brew install python ffmpeg
python3 -m pip install -U yt-dlp

Linux Kurulumu

Debian/Ubuntu:

sudo apt update
sudo apt install python3 python3-pip ffmpeg
python3 -m pip install -U yt-dlp

Kaynak Koddan Çalıştırma

python ytdlp_gui.py

Hazır EXE ile Çalıştırma

Hazır paket indirdiyseniz dist klasörünü açıp şu dosyayı çalıştırın:

dist/ytdlp_gui.exe

EXE sürümünü kullanmak için Python komutları çalıştırmanız gerekmez. Ancak yt-dlp ve ffmpeg yine sistemde kurulu ve erişilebilir olmalıdır.

Bazı paketlerde ytdlp_gui.exe yanında yt-dlp.exe ve ffmpeg.exe dosyaları bulunabilir. Bu durumda uygulama bu dosyaları doğrudan kullanabilir. İndirme, kesme, birleştirme veya yeniden kodlama hata vermeye başlarsa bu paketli araçlar eski kalmış olabilir. yt-dlp ve ffmpeg'in güncel sürümlerini indirip eski .exe dosyalarının yerine koyun.

EXE Oluşturma

pyinstaller --noconfirm --clean --onefile --windowed ytdlp_gui.py

EXE dosyası şu klasörde oluşur:

dist/ytdlp_gui.exe

Kullanım

  1. Video URL'sini yapıştırın.
  2. Formatları Getir butonuna tıklayın.
  3. Video veya ses formatını seçin.
  4. İsteğe bağlı: başlangıç ve bitiş zamanı girin, örneğin 31:23 ve 33:00.
  5. Çıktı formatını seçin.
  6. Yeniden kodlama modunu kullanıyorsanız codec ve çözünürlük seçin.
  7. İndir butonuna tıklayın.

Kesme Modları

Direkt kes en hızlı seçenektir. yt-dlp'den sadece seçilen aralığı indirmesini ister. Bazı videolarda başlangıç noktası keyframe yüzünden biraz kayabilir.

Tam indir → kes önce tüm dosyayı indirir, sonra yeniden kodlama yapmadan keser. Genelde hızlıdır; ancak kesme noktası keyframe'e denk gelmezse bazı videolarda ilk saniyede görüntü donabilir.

Tam indir → yeniden kodla önce tüm dosyayı indirir ve seçilen aralığı yeni bir dosya olarak kodlar. Daha yavaştır, ama genelde en doğru ve en uyumlu sonucu verir. Twitter/X ve genel paylaşım için MP4 + h264 önerilir.

Yeniden Kodlama Çözünürlüğü

En yüksek kalite için Orijinal seçeneğini kullanın.

Daha hızlı işlem ve daha küçük dosya için 720p veya 480p seçin. 720p, 1080p'ye göre daha az piksel işlediği için genelde belirgin şekilde daha hızlıdır.

Notlar

  • YouTube JavaScript runtime uyarısı gösterirse indirme yine çalışabilir, ancak bazı formatlar eksik görünebilir.
  • Yeniden kodlama işlemciyi yoğun kullanır ve uzun veya yüksek çözünürlüklü videolarda birkaç dakika sürebilir.
  • Uygulama açıksa Windows dist/ytdlp_gui.exe dosyasının üzerine yazmayı engelleyebilir. Yeniden paketlemeden önce uygulamayı kapatın.
  • build klasörü sadece PyInstaller'ın geçici çalışma klasörüdür. Kullanıcılar için gerekli değildir.
  • Paket içindeki yt-dlp.exe ve ffmpeg.exe zamanla eski kalabilir. Bu dosyaları güncellemek indirme veya dönüştürme hatalarını çoğu zaman çözer.

Lisans

Bu proje Unlicense ile yayınlanmıştır.

yt-dlp ayrı bir projedir ve kendi lisansına tabidir: https://github.com/yt-dlp/yt-dlp/blob/master/LICENSE

About

Unofficial desktop GUI wrapper for yt-dlp

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages