Yandex Music — Stream Deck / OpenDeck

Управляй Яндекс Музыкой прямо с деки
Play · Обложка · Бегущая строка · Запуск приложения одной кнопкой

Форк Yandex Music Ajazz Plugin (whxtelxs) · идея CDP — Judd1zzz/yandex-music-streamdeck

---

Возможности

Кнопки

Action	Что делает
Плей / Пауза	Воспроизведение и пауза, иконка меняется по состоянию
Следующий / Предыдущий	Переключение треков
Лайк / Дизлайк	Оценка трека, состояние на кнопке
Выключить звук	Mute / unmute
Обложка трека	Живая обложка + запуск / перезапуск Яндекс Музыки с debug-портом
Название трека	Бегущая строка «Артист — Название»
Время трека	Текущее / общее время

Кнопка «Обложка» — не только картинка

Это лаунчер приложения:

• Яндекс Музыка не запущена → плагин стартует её с --remote-debugging-port=9222
• Запущена без debug-порта → перезапуск с правильными параметрами
• Уже всё ок → обновляет обложку и CDP-соединение

Работает на Linux, Windows и macOS.

---

Совместимость

Платформы

Платформа	Хост	Статус
Linux	OpenDeck	✅ основной кейс форка
Windows	OpenDeck, StreamDock, Elgato*	✅
macOS	OpenDeck, StreamDock	✅

* Elgato Stream Deck — через совместимый SDK, полный тест не гарантируется.

Устройства

Ajazz AKP153 · Mirabox N4 · Elgato Stream Deck · другие keypad-устройства с Stream Deck SDK / OpenDeck.

Яндекс Музыка

Десктоп-клиент (Electron) с флагом:

--remote-debugging-port=9222

Без него плагин не подключится к приложению.

---

Установка

1. Скачай плагин

Releases → ru.yandex.music.sdPlugin.zip

Release уже содержит node_modules — npm install не нужен.

Windows — OpenDeck / StreamDock

Распакуй ru.yandex.music.sdPlugin в:

%APPDATA%\opendeck\plugins\

или для StreamDock / Ajazz:

%APPDATA%\HotSpot\StreamDock\plugins\

Перезапусти OpenDeck / StreamDock.

Linux — OpenDeck

# из Release
unzip ru.yandex.music.sdPlugin.zip -d ~/.config/opendeck/plugins/

# или reload, если уже стоит
opendeck --reload-plugin ru.yandex.music.sdPlugin

macOS — OpenDeck / StreamDock

~/Library/Application Support/opendeck/plugins/

или StreamDock:

~/Library/Application Support/HotSpot/StreamDock/plugins/

Клон из git (для разработки)

git clone https://github.com/qwertyonek/yamusic-streamdeck-plugin.git
cd yamusic-streamdeck-plugin/plugin && npm install

---

Запуск Яндекс Музыки

Плагин управляет клиентом через Chrome DevTools Protocol. Нужен процесс с debug-портом (по умолчанию 9222, меняется в Property Inspector).

Способ 1 — кнопка «Обложка» (рекомендуется)

Нажми action «Обложка трека» на деке — плагин сам запустит или перезапустит Яндекс Музыку.

Способ 2 — debug-ярлык (Linux)

При первом запуске плагина создаётся файл:

~/.local/share/applications/yandexmusic-debug.desktop

В меню приложений появится Yandex Music (Debug). При смене порта в Property Inspector ярлык обновляется автоматически.

Способ 3 — ярлык / команда вручную

Linux

/opt/yandex-music/yandexmusic --remote-debugging-port=9222 --gtk-version=3

Путь к бинарю зависит от способа установки (AUR, .deb, /opt/…).

Windows

Создай ярлык и в поле «Объект» добавь в конец:

--remote-debugging-port=9222

Пример:

"C:\Users\ИМЯ\AppData\Local\Programs\YandexMusic\Яндекс Музыка.exe" --remote-debugging-port=9222

Запускай музыку только через этот ярлык, иначе CDP не подключится.

macOS

open -a "Яндекс Музыка" --args --remote-debugging-port=9222

Проверка соединения

1. Повесь любую кнопку плагина на деку
2. Открой Property Inspector
3. Нажми «Проверить соединение» → статус «Подключено»

---

Настройки

В Property Inspector любой кнопки:

Параметр	Описание
Порт отладки	По умолчанию 9222. Должен совпадать с флагом запуска Яндекс Музыки
Проверить соединение	Тест CDP-подключения к клиенту

---

OpenDeck: иконки

В manifest.json пути к картинкам без расширения (imgs/ym-play). OpenDeck дописывает .png.

Файлы лежат в imgs/*.png (300×300). На StreamDock пути могут отличаться — при проблемах с иконками перевесь кнопки заново.

---

Отличия от upstream

	whxtelxs v1.5	Этот форк
OpenDeck + Linux	❌	✅
Авто debug-ярлык (Linux)	❌	✅
Запуск YM с кнопки обложки	play/pause	лаунcher + debug-порт
Shuffle / repeat / volume / энкодеры	✅	пока нет
UUID actions	com.whxtelxs…	ru.yandex.music.*

---

Проблемы?

Симптом	Решение
Кнопки не реагируют	Яндекс Музыка запущена с --remote-debugging-port=9222?
Восклицательный знак на иконке	OpenDeck: перевесь action или reload плагина; проверь imgs/*.png
«Не подключено» в PI	Закрой YM без debug-порта → запусти через обложку / debug-ярлык
Обложка не обновляется	Проверь CDP; нажми обложку для переподключения
Порт занят	Смени порт в PI и в ярлыке / команде запуска

---

Разработка

cd plugin
npm install
node test-connection.js

Логи: log/ и plugin/log/.

---

Авторы

Maintainer	qwertyonek · GitHub
Original plugin	whxtelxs · Yandex-Music-Ajazz-Plugin
CDP reference	Judd1zzz/yandex-music-streamdeck

---

_{Не аффилирован с Яндексом. Используй на свой страх и риск.}