Об этом проекте

scdl (Soundcloud Music Downloader) — это инструмент командной строки для загрузки музыки с SoundCloud и записи ID3-тегов в результирующие файлы. Согласно его README, начиная с версии 3 скрипт является обёрткой над yt-dlp с некоторыми настройками по умолчанию и патчами для обратной совместимости. Разработка описывается как неактивная, новые функции вряд ли будут объединены, особенно если их можно реализовать через аргументы yt-dlp; сообщения об ошибках и исправления по-прежнему приветствуются. Проект заявляет о совместимости с Windows, OS X и Linux, а также указывает Python 3 и ffmpeg в качестве системных требований. Инструкции по установке приведены в вики проекта. Файл конфигурации размещается в ~/.config/scdl/scdl.cfg. Документированные возможности включают автоматическое определение типа предоставленной ссылки, загрузку всех песен пользователя, загрузку всех песен и репостов пользователя, загрузку всех песен из одного плейлиста, загрузку всех песен из всех плейлистов пользователя, загрузку избранного пользователя, загрузку только новых треков из списка, такого как плейлист или избранное, синхронизацию плейлиста, установку тегов с помощью mutagen (название, исполнитель, альбом, обложка) и создание файлов плейлистов при загрузке плейлиста. В README приведены примеры, охватывающие загрузку треков и репостов пользователя, загрузку лайков пользователя, загрузку одного трека, загрузку одного плейлиста, загрузку только новых треков из плейлиста с использованием архива загрузок, синхронизацию плейлиста и загрузку собственных лайков с токеном аутентификации. Список опций включает ввод URL для трека, плейлиста или пользователя; поиск по запросу; флаги для загрузки всех треков, загрузок, избранного, прокомментированных треков, плейлистов или репостов пользователя; продолжение, если файл уже существует; принудительное обновление метаданных для уже загруженных треков; начало плейлиста со смещения; добавление временной метки к именам файлов (устарело в пользу опции формата имени); добавление исполнителя к имени файла; уровни журналирования отладки и ошибок; архив загрузок для пропуска уже загруженных ID треков; извлечение исполнителя из названия; скрытие прогресса и предупреждений; фильтры минимального и максимального размера; загрузка треков плейлиста в основную директорию; загрузка только mp3; пользовательский путь вывода; удаление файлов, не загруженных в текущем запуске; синхронизацию с архивным файлом; конвертацию в FLAC, если исходник без потерь; управление тегом альбома; опции оригинальной обложки, оригинального имени файла и оригинальных метаданных; опции для избегания или требования оригинальных файлов; пользовательские форматы имён для треков и плейлистов, включая stdout; идентификатор клиента и токен аутентификации; перезапись; строгий режим плейлиста; добавление описания в отдельный текстовый файл; пропуск плейлистов; предпочтение потоков opus; и передачу пользовательских аргументов в yt-dlp. Этот обзор отражает только то, что документировано в README репозитория; никаких заявлений о производительности, качестве или рейтингах не делается.