YTDLP-GUI | Supports Polish language only!

Nowoczesny graficzny interfejs użytkownika dla yt-dlp, oparty o Fluent Design

Pobieraj filmy i muzykę z YouTube, CDA.pl i setek innych platform w kilku kliknięciach! Nie jest ważne czy film w CDA jest premium, czy nie! Pobierzesz dosłownie każdy plik wideo :)

Spis treści

• Funkcje
• Interfejs
• Zrzuty ekranu
• Szybki start
• Instalacja
  • Windows
  • Linux
• Użytkowanie
• Konfiguracja
• Wsparcie
• Licencja

Funkcje

Główne możliwości

• Pobieranie wideo - obsługa YouTube, Vimeo, Dailymotion i setek innych platform (silnik yt-dlp)
• Ekstraktowanie audio - konwersja do MP3, AAC, FLAC, OGG, M4A, OPUS z wyborem jakości
• Obsługa playlist - pobieranie całych playlist z filtrowaniem zakresu i kolejności
• CDA Premium - pełne wsparcie dla kont CDA Premium z weryfikacją statusu logowania
• System kolejki - dodawanie wielu linków naraz, pobieranie wsadowe, obsługa ponowień po błędach
• Historia pobrań - osobny rejestr z tytułem, rozmiarem i adresem URL każdej pobranej pozycji
• Motywy wizualne - ciemny (domyślny) i jasny motyw w stylu Fluent Design

Zaawansowane opcje

• Wybór jakości - od 144p do najlepszej dostępnej, z automatycznym doborem
• Formaty wideo - MP4, MKV, WEBM, AVI, FLV z różnymi kodekami
• Formaty audio - MP3, AAC, FLAC, OGG, M4A, OPUS, WAV
• Metadane - automatyczne dodawanie tytułów, miniaturek i napisów do plików
• Napisy - pobieranie napisów oraz auto-napisów w wielu językach
• Proxy i sieć - obsługa proxy, limit prędkości, wymuszanie IPv4/IPv6
• Auto-pobieranie zależności - yt-dlp, FFmpeg i Deno pobierane, jeśli ich brakuje; gotowy Windows EXE zawiera je już w środku

Interfejs użytkownika

• Nawigacja boczna - siedem czytelnie rozdzielonych stron zamiast gęstych zakładek
• Monitoring postępu - numerowana kolejka z miniaturką, tytułem, statusem, prędkością i ETA na bieżąco
• Schowek - automatyczne wykrywanie i dodawanie linków ze schowka
• Zapamiętywanie ustawień i kolejki - wznowienie pracy po ponownym uruchomieniu aplikacji
• Podgląd informacji - tytuł, miniaturka i szacowany rozmiar przed pobraniem
• Spolszczone okna systemowe - dialogi wyboru plików/folderów również z polskimi przyciskami

Interfejs

Aplikacja jest zbudowana na bibliotece PyQt6-Fluent-Widgets (Fluent Design) z menu nawigacyjnym po lewej stronie zamiast tradycyjnych zakładek:

Strona	Do czego służy
Panel główny	Wklejenie URL, szybki wybór trybu (wideo+audio / tylko audio / tylko wideo), jakości, playlisty vs pojedynczego filmu oraz start/stop pobierania z podglądem konsoli
Kolejka	Numerowana lista pozycji do pobrania: miniaturka, tytuł, URL, status i pasek postępu (prędkość + ETA + %) dla aktualnie pobieranej pozycji. Obsługuje przeciąganie, edycję i menu kontekstowe
Historia	Tabela wcześniej pobranych pozycji (tytuł / rozmiar / URL), niezależna od pliku archiwum yt-dlp
Playlista	Zakres pozycji, kolejność pobierania, konfiguracja pliku archiwum
Zaawansowane	Plik wyjściowy i kodeki, sieć, uwierzytelnianie, przetwarzanie FFmpeg, własne argumenty yt-dlp
Ustawienia	Domyślne ścieżki i szablon nazwy, motyw, ścieżki do narzędzi (yt-dlp/FFmpeg), konto CDA Premium
O programie	Wersje narzędzi, linki do projektu i sprawdzanie aktualizacji

Zrzuty ekranu

Kliknij, aby zobaczyć interfejs

Panel główny

Wklejenie URL, szybki wybór trybu i jakości oraz sterowanie pobieraniem z podglądem konsoli

Kolejka

Numerowana lista pozycji do pobrania z miniaturką, tytułem, statusem i postępem na żywo

Playlista

Zakres pozycji, kolejność pobierania i konfiguracja pliku archiwum

Zaawansowane

Plik wyjściowy i kodeki, opcje sieciowe oraz uwierzytelnianie

Szybki start

1. Pobierz i uruchom aplikację zgodnie z instrukcjami dla Twojego systemu
2. Na Panelu głównym wklej link do filmu YouTube/CDA w pole URL
3. Wybierz tryb (wideo+audio / tylko audio / tylko wideo) i jakość
4. Kliknij "Pobierz i rozpocznij kolejkę" i ciesz się rezultatem!

Instalacja

Windows

Pojedynczy plik EXE (zalecane)

Uruchom YTDLP-GUI-<wersja>-Windows.exe pobrany z GitHub Releases lub zbudowany lokalnie. Plik zawiera aplikację, biblioteki Python/Qt oraz yt-dlp, FFmpeg/ffprobe i Deno. Nie wymaga instalacji Pythona ani rozpakowywania ZIP-a.

Przy uruchomieniu biblioteki są rozpakowywane do katalogu tymczasowego. Dołączone narzędzia są kopiowane do %APPDATA%/VideoDownloader/libs/, jeśli jeszcze ich tam nie ma. Aktualizacje narzędzi pozostają w profilu użytkownika. Logi i cache znajdują się w %APPDATA%/VideoDownloader/, a ustawienia zapisuje Qt w profilu Windows.

Budowanie pojedynczego EXE

Na Linuksie z Wine:

./build-win.sh

Na Windows:

.\build.bat

Wynik: dist/YTDLP-GUI-<wersja>-Windows.exe. Szczegóły i wymagania buildera znajdziesz w BUILD_GUIDE.md.

Uruchomienie ze źródeł

git clone https://github.com/PaffcioStudio/YTDLP-GUI.git
cd YTDLP-GUI
python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt
python main.py

W wersji źródłowej brakujące narzędzia są pobierane przez aplikację.

Linux

Metoda 1: Skrypt budowania build.sh (zalecane)

# 1. Sklonuj repozytorium
git clone https://github.com/PaffcioStudio/YTDLP-GUI.git
cd YTDLP-GUI

# 2. Nadaj uprawnienia i uruchom skrypt
chmod +x build.sh
./build.sh

Skrypt zapyta, co zbudować:

1. Pakiet DEB (Ubuntu/Debian)
2. AppImage
3. Linux Executable
4. Wszystko Linux (DEB + AppImage + Executable za jednym razem)
5. Windows EXE (pojedynczy plik z narzędziami, lokalnie przez Wine)
6. Anuluj

Na TUXEDO OS uruchom ./build-win.sh albo wybierz opcję 5. Źródła pozostają lokalne. Wymagania Wine i opis cache znajdują się w BUILD_GUIDE.md.

Gotowe pliki trafiają do folderu dist/.

Metoda 2: Uruchomienie ze źródeł (środowisko wirtualne)

# 1. Zainstaluj wymagane pakiety systemowe
sudo apt update
sudo apt install python3 python3-venv python3-full

# 2. Sklonuj repozytorium
git clone https://github.com/PaffcioStudio/YTDLP-GUI.git
cd YTDLP-GUI

# 3. Utwórz i aktywuj środowisko wirtualne
python3 -m venv venv
source venv/bin/activate

# 4. Zainstaluj zależności i uruchom
pip install -r requirements.txt
python3 main.py
# yt-dlp i FFmpeg zostaną pobrane automatycznie przy pierwszym uruchomieniu

# 5. Deaktywuj środowisko (po zakończeniu)
deactivate

Instalacja pakietu .deb

sudo dpkg -i ytdlp-gui_*_amd64.deb
# W przypadku problemów z zależnościami:
sudo apt-get install -f

# Uruchomienie:
ytdlp-gui
# lub z menu aplikacji: Multimedia - YTDLP-GUI

# Odinstalowanie:
sudo apt remove ytdlp-gui

Uruchomienie AppImage

chmod +x YTDLP-GUI-*.AppImage
./YTDLP-GUI-*.AppImage

Wymagania systemowe

Windows

• System: Windows 10/11 (64-bit)
• Python: 3.10+ (opcjonalnie, jeśli uruchamiasz ze źródeł)
• Zależności: gotowy Windows EXE zawiera yt-dlp, FFmpeg/ffprobe i Deno

Linux

• System: Ubuntu 20.04+, Debian 11+, Linux Mint 20+ i pochodne (KDE Plasma zalecane dla pełnej integracji dialogów systemowych)
• Python: 3.10+
• Biblioteki systemowe (do budowania): python3-venv, python3-full, libxcb-cursor0, libxcb-cursor-dev, qt6-base-dev (instalowane automatycznie przez build.sh)
• Zależności: yt-dlp i FFmpeg pobierane automatycznie przy pierwszym uruchomieniu

Użytkowanie

Pobieranie wideo lub audio

1. Na Panelu głównym wklej link w pole "URL wideo lub playlisty"
2. Wybierz "Tylko to wideo" lub "Cała playlista"
3. Wybierz tryb: Wideo + audio / Tylko audio / Tylko wideo
4. Ustaw jakość i format wideo lub audio
5. Kliknij "Pobierz i rozpocznij kolejkę"

Szczegółowe opcje formatu wyjściowego, kodeków i przetwarzania FFmpeg znajdziesz na stronie Zaawansowane.

Praca z playlistami

1. Przejdź do strony "Playlista"
2. Ustaw zakres pozycji (np. od 1 do 10) lub wpisz konkretne pozycje (np. 1,3,5-8)
3. Wybierz opcję odwrotnej lub losowej kolejności pobierania
4. Skonfiguruj plik archiwum, aby pominąć już pobrane pozycje (domyślnie włączony)

Konfiguracja CDA Premium

1. Przejdź do strony "Ustawienia" - zakładka "Konta"
2. Wprowadź email i hasło konta CDA
3. Kliknij "Sprawdź status", aby zweryfikować dane

System kolejki

1. Przejdź do strony "Kolejka"
2. Dodaj linki przez:
   • "Wklej i dodaj" na Panelu głównym - dodanie ze schowka jednym kliknięciem
   • "Dodaj URL" w Kolejce - ręczne wprowadzenie
   • "Dodaj wiele..." - wklejenie wielu linków naraz
3. Zarządzaj kolejką:
   • Przenoszenie: przeciągnij pozycje lub użyj strzałek góra/dół
   • Edycja: zmiana URL zaznaczonej pozycji
   • Usuwanie: pojedynczych pozycji lub wszystkich oznaczonych jako nieudane
4. Obsługa nieudanych pobierań:
   • nieudane pozycje są oznaczone na czerwono ze statusem "Błąd"
   • aplikacja automatycznie ponawia próby (konfigurowalny limit w ustawieniach zaawansowanych)
   • kolejka jest zapisywana i wznawiana automatycznie po restarcie aplikacji

Przeglądanie historii

Strona "Historia" pokazuje tabelę wszystkich pobranych pozycji z tytułem, rozmiarem i adresem URL. Pozycję można skopiować z menu kontekstowego (prawy przycisk myszy). Historię można wyczyścić przyciskiem "Wyczyść historię" - usuwa to zarówno rejestr, jak i plik archiwum yt-dlp.

Konfiguracja

Ustawienia zaawansowane

Ścieżki aplikacji (strona Ustawienia - Narzędzia)

• yt-dlp: ścieżka do pliku wykonywalnego (auto-pobieranie dostępne)
• FFmpeg: ścieżka do FFmpeg (auto-pobieranie dostępne)
• Katalog wyjściowy: domyślny folder dla pobranych plików (strona Zaawansowane)

Opcje sieciowe (strona Zaawansowane)

• Proxy: np. socks5://user:pass@127.0.0.1:1080/
• Ograniczenie prędkości: np. 50K lub 4.2M
• Ponowne próby: liczba prób yt-dlp w przypadku błędu pojedynczego żądania
• Force IPv4/IPv6: wymuszenie konkretnej wersji protokołu IP

Szablon nazwy pliku

%(playlist_title|)s/%(title)s.%(ext)s     # domyślny - podfolder z nazwą playlisty (jeśli dotyczy)
%(title)s.%(ext)s                          # sam tytuł
%(uploader)s - %(title)s.%(ext)s           # Autor - Tytuł

Personalizacja

• Motyw: Ciemny (domyślny) / Jasny
• Automatyczne dodawanie do kolejki: wklejone ze schowka linki dodawane od razu
• Sprawdzanie aktualizacji: automatyczne sprawdzanie nowych wersji yt-dlp i YTDLP-GUI przy starcie

Zarządzanie zależnościami

Aplikacja automatycznie zarządza wymaganymi narzędziami zewnętrznymi (przechowywanymi w katalogu danych aplikacji, np. ~/VideoDownloader/tools/ na Linuksie):

yt-dlp

• dołączony do Windows EXE; w pozostałych wariantach pobierany, jeśli go brakuje
• Aktualizacje: automatyczne sprawdzanie i pobieranie najnowszej wersji przy starcie (opcjonalne)

FFmpeg

• pobierany automatycznie, jeśli nie zostanie znaleziony w systemie
• Linux: wykorzystywana zostanie też systemowa instalacja (ffmpeg w PATH), jeśli jest dostępna

Wsparcie

Zgłaszanie błędów

Jeśli napotkasz problem:

1. Sprawdź logi aplikacji w katalogu VideoDownloader/logs/app.log (w katalogu domowym użytkownika)
2. Zgłoś błąd na GitHub Issues
3. Dołącz informacje o systemie, wersji aplikacji (strona "O programie") i kroki do reprodukcji

Pomoc i wsparcie

• GitHub Discussions: pytania i dyskusje
• Email: paffciostudio@gmail.com

Problemy i rozwiązania

"Nie można znaleźć yt-dlp" / "Błąd FFmpeg"

# Aplikacja pobiera oba narzędzia automatycznie przy pierwszym uruchomieniu.
# Jeśli auto-pobieranie zawiedzie (np. przez limit API GitHub), zainstaluj ręcznie:

# Linux:
sudo apt install ffmpeg
pip3 install yt-dlp
# lub wskaż istniejącą instalację w Ustawienia - Narzędzia

# Windows EXE: narzędzia są dołączone i kopiowane do profilu użytkownika

Problemy z CDA Premium

• sprawdź poprawność danych logowania
• upewnij się, że konto jest aktywne
• użyj przycisku "Sprawdź status" na stronie Ustawienia - Konta

"externally-managed-environment" (Ubuntu 23.04+, Debian 12+)

# Błąd przy pip install poza środowiskiem wirtualnym - użyj venv:
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Brak uprawnień do build.sh

chmod +x build.sh
./build.sh

Problemy z pakietem .deb

# Brak zależności po instalacji .deb:
sudo apt-get install -f

# Sprawdzenie poprawności pakietu:
dpkg -l | grep ytdlp-gui
dpkg -s ytdlp-gui

Folder pobrań nie otwiera się (Linux, KDE)

Jeśli przycisk "Otwórz folder" nie działa w wersji spakowanej przez PyInstaller, upewnij się że korzystasz z aktualnej wersji - starsze buildy mogły przekazywać zmienną LD_LIBRARY_PATH bootloadera PyInstallera do zewnętrznych programów (xdg-open), co bywało niekompatybilne z niektórymi konfiguracjami KDE/KIO.

Licencja

Ten projekt jest udostępniony na licencji MIT. Zobacz plik LICENSE.md dla szczegółów.

---

Jeśli YTDLP-GUI jest przydatne, zostaw gwiazdkę na GitHub!

Stworzone przez Paffcio

Powrót na górę