YouTube в MP3 с помощью yt-dlp

Соберите команду yt-dlp, которая превращает видео с YouTube в MP3 с тегами и обложкой.

URL видео, плейлиста или канала

Необязательно. Если оставить пустым, команда закончится словом URL, которое вы подставите сами.

Ваша команда

yt-dlp -x --audio-format mp3 --audio-quality 0 --no-playlist --embed-thumbnail --embed-metadata -o '%(artist,uploader)s - %(title)s.%(ext)s' 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'

Основное

Что вам нужно

Видео Только звук

Только звук извлекает звуковую дорожку и отбрасывает видео.

Видео и качество

Максимальное качество -f

Ограничивает высоту. yt-dlp всё равно выберет лучшую дорожку в пределах этого ограничения.

Container --merge-output-format нужен ffmpeg

Тип файла, в который объединяются раздельные видео- и аудиодорожки.

Дополнительные опции (3)

Свой format selector -f

Заменяет выбор качества. Для тех, кто уже знает синтаксис форматов.

Remux в --remux-video нужен ffmpeg

Перепаковывает дорожки без перекодирования. Быстро и без потерь.

Перекодировать в --recode-video нужен ffmpeg

Перекодирует видео. Медленно и с потерями — только если remux не подходит.

Аудио

Формат аудио --audio-format нужен ffmpeg

Файл, в который конвертируется звук.

Качество звука --audio-quality нужен ffmpeg

VBR даёт лучшее соотношение размера и качества; фиксированный bitrate предсказуемее по размеру.

Субтитры

Встраивание помещает субтитры внутрь видео; сохранение пишет рядом отдельный файл .srt.

Языки субтитров --sub-langs

Через запятую. Если нужны все доступные языки, напишите all.

Автоматические субтитры --write-auto-subs Включать машинные субтитры, когда человеческих нет.

Плейлисты и каналы

Обработка плейлиста

Что делать, когда URL относится и к видео, и к плейлисту.

Какие элементы -I

Работают и диапазоны, и списки — например 1-10,15 или -5::2, чтобы брать каждый второй с конца.

Дополнительные опции (1)

Файл учёта --download-archive

Записывает уже скачанное, поэтому повторный запуск это пропустит. Именно так канал держат синхронизированным.

Фрагменты и главы

Дополнительные опции (2)

Скачать только часть --download-sections нужен ffmpeg

Диапазон времени вида *00:01:30-00:03:00 или название главы. Звёздочка в начале означает, что это метка времени.

Разбить по главам --split-chapters нужен ffmpeg Пишет по файлу на главу вместо одного длинного.

Метаданные и обложка

Встроить обложку --embed-thumbnail нужен ffmpeg Использует превью видео как обложку.

Встроить метаданные --embed-metadata нужен ffmpeg Записывает название, автора и дату внутрь самого файла.

Встроить главы --embed-chapters нужен ffmpeg Добавляет метки глав, по которым плеер умеет перескакивать.

Дополнительные опции (3)

Сохранить файл обложки --write-thumbnail Пишет картинку обложки рядом с видео.

Сохранить описание --write-description Пишет описание в файл .description.

Сохранить метаданные в JSON --write-info-json Пишет всё, что yt-dlp знает о видео, в файл .info.json.

SponsorBlock

Удалить фрагменты --sponsorblock-remove нужен ffmpeg

Вырезает из файла фрагменты, отмеченные сообществом, по данным SponsorBlock.

Дополнительные опции (1)

Отметить фрагменты главами --sponsorblock-mark

Оставляет фрагменты, но помечает их, чтобы вы пропускали их сами.

Файлы и папки

Шаблон имени файла -o

Названия полей пишутся внутри %(...)s. Слэши создают папки.

Безопасные имена (только ASCII) --restrict-filenames Убирает диакритику, пробелы и любые символы, которые может отвергнуть придирчивая файловая система.

Перезаписывать существующие файлы --force-overwrites Заменяет файлы, которые уже есть.

Продолжать незавершённые загрузки -c Продолжает с того места, где загрузка прервалась.

Дополнительные опции (4)

Папка для загрузки -P

Куда писать файлы. В сочетании с шаблоном выше можно получить подпапки.

Имена, безопасные для Windows --windows-filenames Убирает символы, которые Windows не принимает, даже если вы работаете в другой системе.

Обрезать имена до --trim-filenames

Максимальная длина имени файла в символах.

Никогда не перезаписывать -w Пропускает всё, что уже скачано.

Фильтры

Дополнительные опции (5)

Загружено после --dateafter

ГГГГММДД или относительная дата вида now-1month.

Загружено до --datebefore

ГГГГММДД или относительная дата.

Минимальный размер --min-filesize

Пропускает всё, что меньше. Принимает 5M, 500K и подобное.

Максимальный размер --max-filesize

Пропускает всё, что больше.

Остановиться после --max-downloads

Сколько файлов скачать, прежде чем остановиться.

Сеть

Ограничение скорости -r

Например 2M или 500K. Полезно, когда остальная полоса нужна для другого.

Дополнительные опции (5)

Параллельных fragment -N

Ускоряет фрагментированные потоки. Четыре — разумное начало.

Повторные попытки -R

Сколько раз повторять неудавшуюся часть. Можно указать infinite.

Proxy --proxy

Адрес HTTP, HTTPS или SOCKS proxy.

Обход региональной блокировки --geo-bypass Подменяет источник запроса. На части сайтов работает, но не на всех.

Притворяться браузером --impersonate

Делает запросы похожими на настоящий браузер. Обычное решение, когда внезапно начинается 403.

Вход и cookies

Cookies из браузера --cookies-from-browser

Читает вашу авторизованную сессию напрямую. Нужно для приватного, возрастного и доступного только участникам содержимого.

Дополнительные опции (1)

Файл cookies --cookies

Файл cookies.txt в формате Netscape, выгруженный из вашего браузера.

Прямые трансляции

Дополнительные опции (2)

Записывать с начала --live-from-start Начинает запись трансляции с начала, а не с текущего момента.

Ждать начала трансляции --wait-for-video

Опрашивает, пока запланированная трансляция не начнётся. MIN-MAX — интервал между проверками в секундах.

Обходные пути

Дополнительные опции (3)

User agent --user-agent устарело

Устарело в пользу --add-headers. Оставлено потому, что множество старых руководств всё ещё это используют.

Referer --referer устарело

Устарело в пользу --add-headers.

Аргументы extractor --extractor-args

Опции для конкретного сайта, например youtube:player_client=web.

Вывод и отладка

Только показать форматы -F Печатает доступные форматы и завершает работу без скачивания.

Дополнительные опции (2)

Продолжать при ошибках -i Пропускает неудавшиеся элементы вместо остановки. Для больших плейлистов это обязательно.

Пробный прогон -s Делает всё, кроме записи файла.

Сбросить

Опции, которые здесь важны

Формат аудио --audio-format Файл, в который конвертируется звук.
Качество звука --audio-quality VBR даёт лучшее соотношение размера и качества; фиксированный bitrate предсказуемее по размеру.
Встроить обложку --embed-thumbnail Использует превью видео как обложку.
Встроить метаданные --embed-metadata Записывает название, автора и дату внутрь самого файла.

Как получить пригодный MP3

Извлечение звука — это конвертация, поэтому ffmpeg обязателен: именно из-за него команда падает на свежей установке. Лучшее (VBR) — правильное значение по умолчанию: соотношение размера и качества у него лучшее, а более высокий фиксированный bitrate не добавит того качества, которого в источнике никогда не было.

Обложка и метаданные превращают папку безымянных файлов в то, что музыкальный плеер способен разложить по полкам. Шаблон имени здесь ставит исполнителя первым, а если тега исполнителя нет — берёт автора загрузки.

Частые вопросы

› Какое качество MP3 выбрать?

В большинстве случаев лучшее (VBR) — у него лучшее соотношение размера и качества. 320 кбит/с оправданы только если что-то дальше по цепочке требует фиксированный bitrate. Ни то, ни другое не добавит качества, которого не было в источнике.

› Почему извлечение MP3 не срабатывает?

Конвертация звука требует ffmpeg. Установите его и проверьте через ffmpeg -version.

› VBR или фиксированный bitrate?

VBR тратит биты там, где они нужны, и при том же слышимом качестве получается меньше. Фиксированный bitrate — только когда устройство или программа этого требует.

› Можно ли перевести весь плейлист в MP3?

Да — вывод в звук плюс режим «весь плейлист». Добавьте файл учёта, чтобы повторный запуск не переделывал конвертации.