YandexMusicModClient

[!CAUTION]

Проект заархивирован в пользу слияния с PulseSync.

Несмотря на то, что репозиторий будет оставаться доступным, он больше не будет поддерживаться и обновляться. Рекомендуется перейти на PulseSync для получения новых функций и улучшений.

Это модификация для настольного приложения Яндекс Музыка, главная задача которой — добавить недостающие ванильному клиенту функции.

[!CAUTION]

Данная модификация НЕ даёт возможность пользоваться сервисом БЕЗ подписки Яндекс Плюс!

Установка

Загрузите последнюю версию клиента Яндекс музыки с официального сайта https://music.yandex.com/download/.
Скачайте и установите Патчер из репозитория https://github.com/TheKing-OfTime/YandexMusicModPatcher следуя его порядку установки.
Нажмите в нём кнопку Patch.
Дождитесь окончания установки.
Готово!

Если из функций модификации вам нужны только разблокированные DevTools,
то в настройках патчера выберите Канал релизов "Только Девтулзы".

Преимущество в том, что эта версия собирается полностью автоматически и всегда использует последнюю версию ЯМ (Не спуфится как полная модификация).

Возможности

Discord Статус

<details> <summary>Подробнее</summary>

Добавляет поддержку отображения текущего трека как статуса в Discord.

</details>

Управление плеером с других устройств

<details> <summary>Подробнее</summary>

Добавляет поддержку управления воспроизведением настольного клиента с других устройств.

<div> <img width="250" alt="Список устройств для воспроизведения" src="https://github.com/user-attachments/assets/17196b75-85c4-42f0-af81-ab62123fde5c"> <img width="250" alt="Управление воспроизведение с телефона на ПК клиенте" src="https://github.com/user-attachments/assets/305a94f9-4908-4c47-9d75-c0838dbad805"> </div> <div> <img width="504" alt="DiscordCanary_q3lSyzS2R9" src="https://github.com/user-attachments/assets/ebd7a0c0-db68-4c26-b0f9-481e1ea9e57b" /> <br/> <img width="504" alt="Яндекс_Музыка_1AZwtDf0Tz" src="https://github.com/user-attachments/assets/ec3cba2f-9b58-4a07-bc60-1920fc94b759" /> </div> <details> <summary>Настройки</summary>

Можно выключить в настройках внутри приложения:

</details> </details>

Скробблинг Last.FM

<details> <summary>Подробнее</summary>

Добавляет поддержку скробблинга в Last.FM. Трек заскробблится, если вы прослушаете хотя бы его половину (но при этом запрос скроббла отправиться при смене трека).

<img width="550" alt="Страница пользователя Last.FM с заскроббленными треками" src="https://github.com/user-attachments/assets/9a47a37b-b895-4a06-8538-fb94eb009290"> <details> <summary>Настройки</summary>

Авторизоваться в Last.FM, а также включить/выключить функцию можно в соответствующем меню в настройках приложения:

<details> <summary>Процесс авторизации</summary>

https://github.com/user-attachments/assets/079f8b38-ca6b-4fef-b6a2-efa853fd583f

</details> </details> </details>

Мини-плеер

<details> <summary>Подробнее</summary>

Добавляет миниплеер. Отдельное окно которое отображает текущий трек и даёт возможность удобно управлять воспроизведением.

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

Настраиваемая папка кеша

<details> <summary>Подробнее</summary>

В ванильной версии весь кеш (в том числе скачанные вами треки для офлайн-прослушивания) хранится по пути %appdata%/YandexMusic/.

Данная функция позволяет использовать для кеша другой путь, например, чтобы 10 гигабайт скаченной вами музыки не тратили место на системном диске.

</details>

Глобальные хоткеи

<details> <summary>Подробнее</summary>

Добавляет поддержку глобальных хоткеев.

<details> <summary>Настройки</summary>

json
{
  "globalShortcuts": {
    "TOGGLE_PLAY": "Ctrl+/",
    "MOVE_FORWARD": "Ctrl+,",
    "MOVE_BACKWARD": "Ctrl+.",
    "TOGGLE_SHUFFLE": "Ctrl+'",
    "REPEAT_NONE": "",
    "REPEAT_CONTEXT": "",
    "TOGGLE_LIKE": "",
    "TOGGLE_DISLIKE": ""
  }
}

</details> </details>

Улучшение превью панели задач

<details> <summary>Подробнее</summary>

Добавляет поддержку расширений панели задач (Taskbar Extensions).

browser_Y2f5KiyCYN

</details>

Повтор трека в Моей Волне

<details> <summary>Подробнее</summary>

Добавляет возможность включить повтор трека когда играет Моя Волна.

Отображение качества трека

<details> <summary>Подробнее</summary>

Отображает качество либо кодек текущего трека.

</details>

Улучшенная анимация Моей Волны

<details> <summary>Подробнее</summary>

Улучшает поведение анимации Моей Волны. Она начинает лучше адаптироваться к музыке. Также позволяет настраивать частоту кадров в секунду при рендеринге анимации.

До:

https://github.com/user-attachments/assets/23a8da4d-3d6a-43c6-a5f5-965e065ed912

После:

https://github.com/user-attachments/assets/b062a3ee-d05e-4cf3-8e03-b6f8bf66525c

</details>

Поиск при добавлении трека в плейлист

<details> <summary>Подробнее</summary>

Добавляет строку поиска в контекстное меню выбора плейлиста.

Информация о скачанных треках

<details> <summary>Подробнее</summary>

Добавляет информацию о скачанных треках на страницу настроек (количество скачанных треков и используемое хранилище для скачанных треков).

</details>

Скачивание треков в файл

<details> <summary>Подробнее</summary>

Позволяет скачать любой трек, альбом, плейлист, подкаст, аудиокнигу вам на ПК.

Произвольный масштаб приложения

<details> <summary>Подробнее</summary>

Вы можете менять масштаб приложения сочетанием клавиш Ctrl+= и Ctrl+-.

Диапазон масштабов: 75% - 200%.

Сбросить масштаб до 100% можно с помощью Ctrl+0.

</details>

Исправления багов ванильного клиента

<details> <summary>Подробнее</summary>

В ванильном клиенте есть набор багов, которые довольно сильно ухудшают опыт использования. Некоторые из них исправлены в моде. Например:

Клиент больше не теряет чёткость, если занимает нечётное количество пикселей по высоте или ширине.
Клиент больше не теряет медиаконтекст (ака медиаклавиши), когда включён кроссфейд.
Воспроизведение AAC треков не застревает, если перемотать ровно на 1:00.
Модальные окна в настройках имеют одинаковый бекдроп. Кроме того он появляется плавно.
Исправлен css темы для компонента слайдеров.
Кнопки на панели плеера лучше адаптируются к размеру окна приложения. Кроме того делается это плавно.
В рамках улучшения анимации Моей Волны обновлены неверные параметры анализатора (если точнее правильно настроены fftSize и smoothingTimeConstant).
Исправлена проблема из-за которой не за весь тайтл бар можно было перемещать окно приложения по экрану.

</details>

Эксперименты

<details> <summary>Подробнее</summary>

Позволяет включать/выключать эксперименты. Для этого вам нужно включить Режим разработчика.

</details>

Devtools & Панель Разработчика

<details> <summary>Подробнее</summary>

electron_L6SeZLnSAH

electron_y6aOeckPLH

</details>

Настройки

Настройки можно найти в %appdata%\YandexMusic\config.json.

Настройки внутри приложения:

Сборка проекта из исходников

Убедитесь что Яндекс Музыка и node.js уже установлены.
Склонируйте проект:

cmd
git clone https://github.com/TheKing-OfTime/YandexMusicModClient.git

Установите зависимости:

cmd
npm install

Учтите, что зависимости вам нужно устанавливать в корневой папке проекта, а не в /src/.

Для удобства сборки в проекте есть cli скрипт toolset.js, он позволяет быстро и просто распаковать, упаковать, опубликовать, спуфнуть, или пропатчить код.

Собрать проект:

cmd
node toolset.js build -d -m

Эта команда автоматически оптимизирует код (минифицирует его), а после запакует его по пути Яндекс Музыки по умолчанию %localappdata%/Programs/YandexMusic/resources/app.asar.