Generator poleceń yt-dlp dla SoundCloud

Złóż polecenie yt-dlp dla utworów i setów z SoundCloud, z tagami i gotowe do biblioteki muzycznej.

Adres filmu, playlisty albo kanału

Opcjonalne. Zostaw puste i polecenie skończy się słowem URL, które wpiszesz sam.

Twoje polecenie

yt-dlp -x --audio-format mp3 --audio-quality 0 --embed-thumbnail --embed-metadata -o '%(uploader)s - %(title)s.%(ext)s' https://soundcloud.com/artist/track

Podstawy

Czego chcesz

Wideo Tylko dźwięk

Tylko dźwięk wyciąga ścieżkę audio i porzuca obraz.

Wideo i jakość

Maksymalna jakość -f

Ogranicza wysokość. yt-dlp i tak wybierze najlepszą ścieżkę na tym poziomie lub niżej.

Container --merge-output-format wymaga ffmpeg

Typ pliku, w którym scalane są osobne ścieżki obrazu i dźwięku.

Opcje zaawansowane (3)

Własny format selector -f

Zastępuje listę jakości. Dla tych, którzy znają już składnię formatów.

Remux na --remux-video wymaga ffmpeg

Przepakowuje ścieżki bez przekodowania. Szybko i bez straty.

Przekoduj na --recode-video wymaga ffmpeg

Przekodowuje obraz. Wolno i ze stratą — tylko gdy remux nie wystarcza.

Dźwięk

Format dźwięku --audio-format wymaga ffmpeg

Plik, na który konwertowany jest dźwięk.

Jakość dźwięku --audio-quality wymaga ffmpeg

VBR daje najlepszy stosunek rozmiaru do jakości; stały bitrate jest bardziej przewidywalny.

Napisy

Wtopienie umieszcza je w pliku wideo; zapis tworzy obok osobny plik .srt.

Języki napisów --sub-langs

Rozdzielone przecinkami. Wpisz all, żeby wziąć wszystkie dostępne języki.

Napisy generowane automatycznie --write-auto-subs Bierze napisy maszynowe, gdy nie ma napisów zrobionych przez człowieka.

Playlisty i kanały

Obsługa playlisty

Co zrobić, gdy adres należy zarazem do filmu i do playlisty.

Które pozycje -I

Działają zakresy i listy, na przykład 1-10,15 albo -5::2, żeby brać co drugą pozycję od końca.

Opcje zaawansowane (1)

Plik rejestru --download-archive

Zapisuje, co już pobrano, więc kolejne uruchomienie to pomija. Tak utrzymuje się kanał w zgodzie ze źródłem.

Fragmenty i rozdziały

Opcje zaawansowane (2)

Pobierz tylko fragment --download-sections wymaga ffmpeg

Zakres czasu w postaci *00:01:30-00:03:00 albo nazwa rozdziału. Gwiazdka na początku oznacza, że to znacznik czasu.

Podziel na rozdziały --split-chapters wymaga ffmpeg Tworzy po jednym pliku na rozdział, zamiast jednego długiego.

Metadane i okładka

Wtop miniaturę --embed-thumbnail wymaga ffmpeg Używa miniatury filmu jako okładki.

Wtop metadane --embed-metadata wymaga ffmpeg Zapisuje tytuł, autora i datę w samym pliku.

Wtop rozdziały --embed-chapters wymaga ffmpeg Dodaje znaczniki rozdziałów, po których odtwarzacz umie skakać.

Opcje zaawansowane (3)

Zapisz plik miniatury --write-thumbnail Zapisuje obrazek okładki obok filmu.

Zapisz opis --write-description Zapisuje opis do pliku .description.

Zapisz metadane w JSON --write-info-json Zapisuje wszystko, co yt-dlp wie o filmie, do pliku .info.json.

SponsorBlock

Usuń fragmenty --sponsorblock-remove wymaga ffmpeg

Wycina z pliku fragmenty oznaczone przez społeczność, na podstawie danych SponsorBlock.

Opcje zaawansowane (1)

Oznacz fragmenty jako rozdziały --sponsorblock-mark

Zostawia fragmenty, ale je oznacza, żebyś sam je przeskakiwał.

Pliki i foldery

Wzór nazwy pliku -o

Nazwy pól wpisuje się w %(...)s. Ukośniki tworzą foldery.

Bezpieczne nazwy plików (tylko ASCII) --restrict-filenames Usuwa znaki diakrytyczne, spacje i wszystko, co wybredny system plików mógłby odrzucić.

Nadpisuj istniejące pliki --force-overwrites Zamienia pliki, które już tam są.

Wznawiaj przerwane pobierania -c Kontynuuje od miejsca, w którym pobieranie się zatrzymało.

Opcje zaawansowane (4)

Folder docelowy -P

Gdzie zapisywać pliki. W połączeniu ze wzorem powyżej daje podfoldery.

Nazwy zgodne z Windows --windows-filenames Usuwa znaki, których Windows nie przyjmuje, nawet jeśli pracujesz na innym systemie.

Skróć nazwy do --trim-filenames

Maksymalna długość nazwy pliku w znakach.

Nigdy nie nadpisuj -w Pomija wszystko, co już pobrane.

Filtry

Opcje zaawansowane (5)

Dodane po --dateafter

RRRRMMDD albo data względna, na przykład now-1month.

Dodane przed --datebefore

RRRRMMDD albo data względna.

Minimalny rozmiar --min-filesize

Pomija wszystko mniejsze. Przyjmuje 5M, 500K i podobne.

Maksymalny rozmiar --max-filesize

Pomija wszystko większe.

Zatrzymaj się po --max-downloads

Ile plików pobrać, zanim proces się zakończy.

Sieć

Ograniczenie prędkości -r

Na przykład 2M albo 500K. Przydatne, gdy resztę pasma potrzebujesz na coś innego.

Opcje zaawansowane (5)

Równoległe fragmenty -N

Przyspiesza strumienie dzielone na fragmenty. Cztery to sensowny początek.

Ponowne próby -R

Ile razy powtarzać nieudany fragment. Można wpisać infinite.

Proxy --proxy

Adres proxy HTTP, HTTPS albo SOCKS.

Omiń blokadę regionalną --geo-bypass Udaje inne pochodzenie żądania. Na części stron działa, nie na wszystkich.

Udawaj przeglądarkę --impersonate

Sprawia, że żądania wyglądają jak z prawdziwej przeglądarki. To zwykłe lekarstwo na nagłe 403.

Logowanie i cookies

Cookies z przeglądarki --cookies-from-browser

Czyta wprost twoją zalogowaną sesję. Potrzebne przy treściach prywatnych, z ograniczeniem wieku albo tylko dla członków.

Opcje zaawansowane (1)

Plik cookies --cookies

Plik cookies.txt w formacie Netscape wyeksportowany z przeglądarki.

Transmisje na żywo

Opcje zaawansowane (2)

Nagrywaj od początku --live-from-start Zaczyna nagrywanie transmisji od jej początku, a nie od bieżącej chwili.

Czekaj na transmisję --wait-for-video

Odpytuje, dopóki zaplanowana transmisja się nie zacznie. MIN-MAX to sekundy między sprawdzeniami.

Obejścia

Opcje zaawansowane (3)

User agent --user-agent przestarzałe

Przestarzałe na rzecz --add-headers. Zostało, bo wiele starszych poradników nadal tego używa.

Referer --referer przestarzałe

Przestarzałe na rzecz --add-headers.

Argumenty extractora --extractor-args

Opcje właściwe danej stronie, na przykład youtube:player_client=web.

Wyjście i diagnostyka

Tylko wypisz formaty -F Wypisuje dostępne formaty i kończy działanie bez pobierania.

Opcje zaawansowane (2)

Kontynuuj mimo błędów -i Pomija pozycje, które się nie udały, zamiast przerywać. Przy dużych playlistach niezbędne.

Symuluj -s Robi wszystko poza zapisaniem pliku.

Wyczyść

Opcje, które mają tu znaczenie

Format dźwięku --audio-format Plik, na który konwertowany jest dźwięk.
Jakość dźwięku --audio-quality VBR daje najlepszy stosunek rozmiaru do jakości; stały bitrate jest bardziej przewidywalny.
Wtop miniaturę --embed-thumbnail Używa miniatury filmu jako okładki.

Nie masz jeszcze yt-dlp?

To darmowy program, który uruchamiasz na własnym komputerze. Instalacja zajmuje około minuty.

Jak wybrać format dźwięku

SoundCloud zwykle podaje MP3 128 kb/s, czasem Opus. Przekonwertowanie źródła 128 na 320 daje większy plik, który nie brzmi lepiej — „najlepszy dostępny" zachowuje oryginał i to jest właściwy wybór.

Okładkę i metadane warto włączyć: bez nich pobrany set przychodzi jako folder plików bez tytułów. Sety i playlisty działają w trybie całej playlisty.

SoundCloud serwuje większość strumieni jako Opus 128 kb/s, a „Go+" w 256 — ale tylko sesjom, które uznaje za uprawnione. Jeśli utwór gra na stronie w wyższej jakości niż ta, którą przynosi yt-dlp, różnicą są zwykle cookies zalogowanej przeglądarki: drabina, którą widzi twoja sesja, to drabina, którą dostaje yt-dlp. Wypis -F pokazuje, które formaty istnieją dla utworu, na którym jesteś.

Adres pobierania nie zawsze jest tam, gdzie mieszka dźwięk: SoundCloud podaje media z CDN-a za krótkotrwałymi podpisanymi linkami, więc adres mediów skopiowany z karty przeglądarki działa raz i nigdy więcej — zawsze dawaj yt-dlp stronę utworu i pozwól mu ją rozwinąć. Udostępnienia ponowne to osobna pozycja wskazująca ten sam dźwięk; plik rejestru sprawia, że pobranie seta nie weźmie ich dwa razy.

Sety (SoundCloudowa nazwa playlist) to tam, gdzie leży prawdziwa wartość. Set z dwustu utworami ma stronicowanie i przebieg trwa chwilę; plik rejestru czyni drugi przebieg deltą z samych nowo dodanych utworów. Kontynuowanie mimo błędów ma znaczenie, bo w setach gromadzą się utwory usunięte — producent wycofuje samplę, a bez tego przełącznika jeden 404 urywa pozostałe osiemdziesiąt.

O nazwach: tytuły SoundCloud są długie i niosą wykonawcę w tytule, więc domyślny wzór wykonawca-potem-tytuł czyni duplikaty widocznymi, nie cichymi — dwa pliki o tej samej nazwie to zwykle dwie wgrywki tego samego utworu w różnych przepływnościach. Okładka pochodzi z adresu artwork i pobiera się w największym rozmiarze; jeśli okładka wygląda źle, źle wyglądała też na platformie.

Częste pytania

› Jaką jakość dźwięku daje SoundCloud?

Zwykle MP3 128 kb/s, czasem Opus. Przekonwertowanie źródła 128 na MP3 320 powiększa plik, ale go nie poprawia — wybierz „najlepszy dostępny", żeby zachować oryginał.

› Czy mogę pobrać playlistę z SoundCloud?

Tak. Użyj adresu setu albo playlisty w trybie całej playlisty, plus plik rejestru na powtarzane uruchomienia.

› Czy prywatne albo nieopublikowane utwory działają?

Utwory z tajnym linkiem zwykle działają, jeśli podasz pełny adres. Naprawdę prywatne wymagają cookies konta z dostępem.