跳至內容
yt-dlp

SoundCloud 的 yt-dlp 指令產生器

為 SoundCloud 的單曲與 set 產生 yt-dlp 指令,標籤齊全,可以直接進音樂庫。

選填。留空的話指令會以 URL 結尾,由你自己填。

你的指令

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
基本

僅音訊會擷取聲音軌並捨棄影像串流。

影片與畫質

限制高度上限。yt-dlp 仍會挑該上限以下最好的一路串流。

把分離的影像與音訊串流合併進去的檔案類型。

進階選項(3)

會取代畫質下拉選單。給已經熟悉 format 語法的人用。

不重新編碼,只重新封裝。快而且無損。

重新編碼影片。慢而且有損 —— 只在 remux 行不通時才用。

音訊

音訊要轉換成的檔案類型。

VBR 的檔案大小與品質之比最好;固定 bitrate 比較好預估大小。

字幕

內嵌會把字幕放進影片裡;另存則在旁邊寫一個獨立的 .srt 檔。

用逗號分隔。想要所有可用語言就寫 all。

播放清單與頻道

當網址同時屬於一支影片和一份播放清單時該怎麼做。

範圍與清單都可以,例如 1-10,15,或用 -5::2 表示從尾端起每隔一項取一項。

進階選項(1)

記下已經下載過的項目,於是重新執行會跳過它們。這就是讓一個頻道保持同步的做法。

片段與章節
進階選項(2)

像 *00:01:30-00:03:00 這樣的時間範圍,或章節名稱。開頭的星號表示這是時間點。

中繼資料與封面
進階選項(3)
SponsorBlock

依 SponsorBlock 資料,把社群標記的片段直接從檔案裡剪掉。

進階選項(1)

片段保留,但會被標出來,讓你自己跳過。

檔案與資料夾

欄位名稱寫在 %(...)s 裡。斜線會建立資料夾。

進階選項(4)

檔案要寫到哪裡。搭配上面的範本可以產生子資料夾。

檔名最大長度,以字元計。

篩選
進階選項(5)

YYYYMMDD,或像 now-1month 這樣的相對日期。

YYYYMMDD,或相對日期。

跳過更小的檔案。可以寫 5M、500K 之類。

跳過更大的檔案。

停下來之前要下載的檔案數量。

網路

例如 2M 或 500K。當你需要把剩下的頻寬留給別的事情時很有用。

進階選項(5)

能加快分片串流的下載。從 4 開始比較合適。

失敗的片段要重試幾次。也可以寫 infinite。

HTTP、HTTPS 或 SOCKS proxy 的網址。

讓請求看起來來自真正的瀏覽器。突然出現 403 時,這是最常見的解法。

登入與 cookies

直接讀取你的登入工作階段。私人、年齡限制或會員專屬內容都需要它。

進階選項(1)

從瀏覽器匯出的 Netscape 格式 cookies.txt。

直播
進階選項(2)

反覆檢查直到預定的直播開始。MIN-MAX 是兩次檢查之間的秒數。

疑難排解
進階選項(3)

已淘汰,應改用 --add-headers。之所以保留,是因為很多舊教學還在用它。

已淘汰,應改用 --add-headers。

依網站區分的專用選項,例如 youtube:player_client=web。

輸出與除錯
進階選項(2)
重設

怎麼挑音訊格式

SoundCloud 通常提供 128 kbps 的 MP3,有時是 Opus。把 128 kbps 的來源轉成 320 kbps 只會得到更大但並不更好聽的檔案 —— 選「可用的最佳音訊」保留原始編碼,這才是正確的預設。

封面與中繼資料值得開啟:沒有它們,下載好的 set 就是一個裝滿無標題檔案的資料夾。set 與播放清單用整份播放清單模式即可。

SoundCloud 的大多數串流是 128 kbps 的 Opus,「Go+」曲目是 256——但只給它認定有資格的工作階段。如果一支曲目在網站上播放的音質比 yt-dlp 拿到的高,差別通常是已登入瀏覽器的 cookies:你的工作階段看得見哪一檔階梯,yt-dlp 就拿到哪一檔。-F 列表會顯示你手頭這支曲目到底有哪些格式。

下載網址不總是音訊所在之處:SoundCloud 的媒體放在短時效簽名連結後面的 CDN 上,所以從瀏覽器分頁裡抄出來的媒體網址只用一次、之後永遠失效——總是把曲目頁面交給 yt-dlp,讓它去解析。轉貼是另一個指向同一音訊的項目;封存檔案能讓整份 set 的下載不把它們取兩遍。

set(SoundCloud 對播放清單的叫法)才是真正有價值的地方。兩百首曲子的 set 會分頁,整場執行要花一陣子;封存檔案把第二次執行變成只含新增曲目的增量。出錯繼續之所以重要,是因為 set 會累積已刪除的曲目——製作人撤下一個樣本,沒有這個開關,一個 404 就會打斷其餘八十首。

關於命名:SoundCloud 的標題又長又把藝術家含在標題裡,所以預設「藝術家→標題」的範本讓重複顯形而不是沉默——兩個同名檔案,多半是同一支曲目在不同位元率下的兩次上傳。封面圖來自 artwork 網址,並按最大尺寸下載;如果圖看起來不對,它在平台上也不對。

常見問題

SoundCloud 提供什麼音質?
通常是 128 kbps 的 MP3,有時是 Opus。把 128 kbps 的來源轉成 320 kbps 的 MP3 只會讓檔案變大而不會變好 —— 選「可用的最佳音訊」保留原始編碼。
能下載 SoundCloud 的播放清單嗎?
可以。用 set 或播放清單的網址搭配整份播放清單模式,再加上紀錄檔以便重複執行。
私人或未公開的曲目可以嗎?
帶私密連結的曲目通常在你提供完整網址時可用。真正私人的曲目需要有權限帳號的 cookies。