yandex-music-downloader

Содержание

1. О программе
2. Установка
3. Получение данных для авторизации
4. Примеры использования
5. Использование
6. Что делать при ошибке 400?
7. Спасибо
8. Дисклеймер

О программе

Загрузчик, созданный вследствие наличия фатального недостатка в проекте yandex-music-download.

Возможности

• Возможность загрузки:
  • Всех треков исполнителя
  • Всех треков из альбома
  • Всех треков из плейлиста
  • Отдельного трека
• Загрузка всех метаданных трека/альбома:
  • Номер трека
  • Номер диска
  • Название трека
  • Исполнитель
  • Дополнительные исполнители
  • Год выпуска альбома
  • Обложка альбома
  • Название альбома
  • Текст песни (при использовании флага --add-lyrics)
• Поддержка паттерна для пути сохранения музыки

Установка

Для запуска скрипта требуется Python 3.9+

pip install git+https://github.com/llistochek/yandex-music-downloader
yandex-music-downloader --help

Получение данных для авторизации

Войдите в свой Яндекс аккаунт, затем проделайте следующие шаги:

Для Google Chrome/Chromium

1. Перейдите на сайт Яндекс Музыки (https://music.yandex.ru)
2. Нажмите F12
3. Выберите вкладку Application
4. Выберите пункт Cookies->https://music.yandex.ru
5. Скопируйте значение куки (кликните на значение куки 2 раза -> Ctrl+C):
   • Куки Session_id - это аргумент --session-id

Для Firefox

1. Перейдите на сайт Яндекс Музыки (https://music.yandex.ru)
2. Нажмите F12
3. Выберите вкладку Storage
4. Выберите пункт Куки->https://music.yandex.ru
5. Скопируйте значение куки (кликните на значение куки 2 раза -> Ctrl+C):
   • Куки Session_id - это аргумент --session-id

Примеры использования

Во всех примерах замените <ID сессии> на значение куки Session_id

Скачать все треки Twenty One Pilots в высоком качестве

python3 main.py --session-id "<ID Сессии>" --hq --url "https://music.yandex.ru/artist/792433"

Скачать альбом Nevermind в высоком качестве, загружая тексты песен

python3 main.py --session-id "<ID Сессии>" --hq --add-lyrics --url "https://music.yandex.ru/album/294912"

Скачать трек Seven Nation Army

python3 main.py --session-id "<ID Сессии>" --url "https://music.yandex.ru/album/11644078/track/6705392"

Использование

usage: yandex-music-downloader [-h] [--hq] [--skip-existing] [--add-lyrics]
                               [--embed-cover]
                               [--cover-resolution <Разрешение обложки>]
                               [--delay <Задержка>] [--stick-to-artist]
                               [--only-music] [--enable-caching]
                               (--artist-id <ID исполнителя> | --album-id <ID альбома> | --track-id <ID трека> | --playlist-id <владелец плейлиста>/<тип плейлиста> | -url URL)
                               [--unsafe-path] 
                               [--dir <Папка>]
                               [--path-pattern <Паттерн>] --session-id <ID сессии> 
                               [--spravka <Spravka>]
                               [--user-agent <User-Agent>]
                               [–-logpath LogPath]

Загрузчик музыки с сервиса Яндекс.Музыка

options:
  -h, --help            show this help message and exit

Общие параметры:
  --hq                  Загружать треки в высоком качестве
  --skip-existing       Пропускать уже загруженные треки
  --add-lyrics          Загружать тексты песен
  --embed-cover         Встраивать обложку в .mp3 файл
  --cover-resolution <Разрешение обложки>
                        по умолчанию: 400
  --delay <Задержка>    Задержка между запросами, в секундах (по умолчанию: 3)
  --stick-to-artist     Загружать альбомы, созданные только данным
                        исполнителем
  --only-music          Загружать только музыкальные альбомы (пропускать
                        подкасты и аудиокниги)
  --enable-caching      Включить кэширование. Данная опция полезна при
                        нестабильном интернете. (кэш хранится в папке
                        /tmp/ymd)
  –-logpath              Сформировать лог в указанной папке

ID:
  --artist-id <ID исполнителя>
  --album-id <ID альбома>
  --track-id <ID трека>
  --playlist-id <владелец плейлиста>/<тип плейлиста>
  -u URL, --url URL     URL исполнителя/альбома/трека/плейлиста

Указание пути:
  --unsafe-path         Не очищать путь от недопустимых символов
  --dir <Папка>         Папка для загрузки музыки (по умолчанию: .)
  --path-pattern <Паттерн>
                        Поддерживает следующие заполнители: #number, #artist,
                        #album-artist, #title, #album, #year, #artist-id,
                        #album-id, #track-id (по умолчанию: #album-
                        artist/#album/#number - #title)

Авторизация:
  --session-id <ID сессии>
  --spravka <Spravka>
  --user-agent <User-Agent>
                        по умолчанию: Mozilla/5.0 (X11; Linux x86_64)
                        AppleWebKit/537.36 (KHTML, like Gecko)
                        Chrome/106.0.0.0 Safari/537.36

Ошибка 400

Ниже приведена инструкция по устранению ошибки 400. Перейдите на сайт Яндекс.Музыки, затем проделайте следующие шаги:

Для Firefox

1. Нажмите на иконку замочка слева от адреса сайта
2. Нажмите Clear cookies and site data
3. Нажмите Remove
4. Перезагрузите страницу
5. Прорешайте капчу
6. Скопируйте значение куки spravka - передайте его как аргумент --spravka

Ошибка UnicodeEncodeError под Windows

Перед запуском выполните chcp 65001

Спасибо

Разработчикам проекта yandex-music-download. Оттуда был взят код хэширования.

Дисклеймер

Данный проект является независимой разработкой и никак не связан с компанией Яндекс.