Przejdź do głównej zawartości

yt-dlp

Oficjalna strona projektu: yt-dlp na GitHub

Instalacja​

Ubuntu / Debian​

sudo apt update
sudo apt install yt-dlp

Najnowsza wersja z Pythona​

python3 -m pip install -U yt-dlp

Warto także zainstalować ffmpeg, aby umożliwić konwersję audio i łączenie strumieni:

sudo apt install ffmpeg

Pobieranie listy wszystkich playlist na kanale YouTube​

yt-dlp --flat-playlist --print "%(title)s" https://www.youtube.com/@NAZWA_KANALU/playlists

Opis:

  • --flat-playlist — nie pobiera zawartości, tylko strukturę.
  • --print "%(title)s" — wypisuje tytuły playlist.

Uwaga: YouTube traktuje zakładkę „Playlisty” jak stronę HTML, więc yt-dlp może nie zawsze poprawnie wykryć wszystkie listy. Najlepiej podawać bezpośrednie linki do playlist.

Pobieranie listy wszystkich filmów z danej playlisty​

yt-dlp --flat-playlist --print "%(title)s" https://www.youtube.com/playlist?list=ID_PLAYLISTY

Opis:

  • Pokazuje wszystkie tytuły filmów w podanej playliście bez pobierania plików.

Zapisywanie do pliku:

yt-dlp --flat-playlist --print "%(title)s" https://www.youtube.com/playlist?list=ID_PLAYLISTY > lista_filmow.txt

Pobieranie wszystkich filmów z danej playlisty​

yt-dlp -o "%(playlist_index)s - %(title)s.%(ext)s" https://www.youtube.com/playlist?list=ID_PLAYLISTY

Opis:

  • -o "%(playlist_index)s - %(title)s.%(ext)s" — nadaje nazwę plikom według kolejności w playliście (np. 01 - Tytuł filmu.mp4).
  • Pobrane pliki znajdą się w bieżącym katalogu.

Pobieranie tylko ścieżki MP3​

Z pojedynczego filmu:​

yt-dlp -x --audio-format mp3 https://www.youtube.com/watch?v=ID_FILMU

Z całej playlisty:​

yt-dlp -x --audio-format mp3 -o "%(playlist_index)s - %(title)s.%(ext)s" https://www.youtube.com/playlist?list=ID_PLAYLISTY

Opis:

  • -x — wyodrębnij ścieżkę audio,
  • --audio-format mp3 — przekonwertuj do MP3,
  • -o — ustawia nazwę pliku według numeru w playliście i tytułu.

Uwaga: Do konwersji wymagany jest ffmpeg.

Dodatkowe przydatne komendy​

Pobieranie najlepszego wideo + audio w najwyższej jakości​

yt-dlp -f bestvideo+bestaudio https://www.youtube.com/watch?v=ID_FILMU

Pobieranie tylko audio w formacie bezstratnym (np. FLAC)​

yt-dlp -x --audio-format flac https://www.youtube.com/watch?v=ID_FILMU

Pobieranie filmu w określonej rozdzielczości (np. max 720p)​

yt-dlp -f "bestvideo[height<=720]+bestaudio/best[height<=720]" https://www.youtube.com/watch?v=ID_FILMU

Pobieranie miniatury razem z plikiem MP3​

yt-dlp -x --audio-format mp3 --embed-thumbnail https://www.youtube.com/watch?v=ID_FILMU

pobieranie bez cookies, ale z android client​

yt-dlp --extractor-args "youtube:player_client=android" https://www.youtube.com/watch?v=ID_FILMU

Archiwizacja​

yt-dlp \
  --restrict-filenames \
  --write-info-json \
  --write-thumbnail \
  --embed-metadata \
  --embed-thumbnail \
  -o "%(channel)s/%(upload_date)s_%(id)s_%(title)s.%(ext)s" \
  URL

Ważne opcje​

OpcjaOpis
-xWyodrębnij ścieżkę audio
--audio-format FORMATPrzekonwertuj ścieżkę audio (mp3, m4a, flac, opus)
-f FORMATWybór formatu wideo/audio
-o SZABLONWłasny schemat nazw plików
--embed-thumbnailDodaj miniaturę do pliku MP3
--add-metadataDodaj metadane (tytuł, autor) do plików audio
--no-playlistPobierz tylko pojedynczy film

Poste przycinanie​

# od 1:30 do 1:45 (15 sekund)
ffmpeg -i video.mp4 -ss 00:01:30 -to 00:01:45 -c copy wycinek.mp4
# lub podając czas trwania (-t)
ffmpeg -i video.mp4 -ss 00:01:30 -t 15 -c copy wycinek.mp4