YMRPC Next — приложение для Windows, которое показывает музыку из Яндекс Музыки или любого плеера в статусе Discord. Полностью новая реализация на Python + PySide6: собственный Discord IPC-клиент, захват Windows SMTC, синхронизированные тексты, мини-плеер, статистика и оверлей для OBS.
Версия 0.1.1 — ранняя, но рабочая. Интерфейс и документация на русском, English UI тоже доступен.
Скачать готовую сборку: GitHub Releases — portable YMRPC-Next.exe и ZIP-архив.
- Discord Rich Presence без bot-токена — через локальный Discord IPC.
- Два источника музыки с авторежимом:
- Windows SMTC — работает с Яндекс Музыкой, Spotify, VLC, AIMP, браузерами и любым плеером, который отдаёт медиасессию.
- Ynison — состояние Яндекс Музыки с других устройств (телефон, веб), требует входа в аккаунт.
- Автоматически — локальная музыка в приоритете, трек с телефона подхватывается, когда на компьютере тишина.
- Правила по приложениям — игнорировать ненужные источники или поднимать приоритет нужного.
- Шаблоны статуса с живым предпросмотром карточки Discord.
- Синхронизированные тексты из LRCLIB с запасным вариантом из Яндекс Музыки; отдельное окно караоке и вывод строки в статус.
- Мини-плеер поверх всех окон: обложка, управление, перемотка, перетаскивание.
- Глобальные горячие клавиши (Ctrl+Alt+…).
- Оверлей для OBS и локальный HTTP/SSE API на
127.0.0.1. - Статистика прослушиваний в SQLite: день/неделя/месяц/всё время, топы, график, экспорт CSV.
- Автообновление из GitHub Releases с прогрессом загрузки и проверкой SHA-256.
- Трей, автозапуск, тёмная тема, английский язык, single instance.
- Windows 10 1809+ или Windows 11.
- Discord для отображения статуса (не обязателен для остальных функций).
- Для сборки из исходников: Python 3.11–3.13 (проверено на 3.13.2).
- Для OBS-оверлея: OBS Studio с Browser Source.
git clone https://github.com/Memovoff/YMRPC-Next.git
cd ymrpc-next
py -3.13 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -U pip
.\.venv\Scripts\python.exe -m pip install -e ".[dev]"
.\.venv\Scripts\python.exe run.pyБез консольного окна:
.\.venv\Scripts\pythonw.exe run.pywПолезные аргументы:
| Аргумент | Действие |
|---|---|
--minimized |
запустить сразу свёрнутым в трей |
--version |
показать версию и выйти |
Второй экземпляр приложения не запускается — он просто показывает уже открытое окно.
.\build.ps1Скрипт прогоняет ruff и pytest, собирает portable .exe через PyInstaller и кладёт в dist/:
YMRPC-Next.exe— один файл, ничего устанавливать не нужно;YMRPC-Next-<версия>-win64.zip— архив для раздачи;SHA256SUMS.txt— контрольная сумма.
Варианты:
.\build.ps1 -SkipChecks # без тестов и линтера
.\build.ps1 -NoWebEngine # компактная сборка без встроенного предпросмотра оверлеяБез Qt WebEngine предпросмотр оверлея в приложении показывает заглушку, но сам оверлей и OBS работают как обычно. Сборка не подписана — SmartScreen может предупредить при первом запуске.
- Запустите приложение и откройте «Приложение» → «Аккаунт».
- Нажмите «Войти» — откроется страница OAuth Яндекса.
- После входа браузер перенаправит на адрес с
#access_token=.... - Скопируйте весь адрес или сам токен и вставьте в поле. Кнопка «Вставить» умеет доставать токен из ссылки.
- Нажмите «Войти».
Токен нужен для:
- источника Ynison (музыка с других устройств);
- обогащения треков: обложки, ссылки, годы, точные названия;
- текстов песен из Яндекс Музыки.
Токен хранится зашифрованным через Windows DPAPI в %LOCALAPPDATA%\YMRPC-Next\token.bin и привязан к текущему пользователю Windows. В открытом виде он нигде не сохраняется. Если DPAPI недоступен или запись не удалась, приложение не переходит на незашифрованное хранение: вход отменяется с сообщением об ошибке.
Без входа приложение продолжает работать через Windows SMTC, но обложки и ссылки могут быть менее точными.
Приложение читает обе подсистемы: Windows SMTC и Ynison. Локальная музыка из Windows всегда в приоритете — если в плеере на компьютере что-то играет, показывается этот трек. Когда на компьютере тишина, подхватывается трек с телефона или веба из аккаунта Яндекс Музыки. Это избавляет от ситуации «включил музыку, а статус пустой».
Приложение читает системные медиасессии (GlobalSystemMediaTransportControlsSessionManager) и показывает текущий трек. Поддерживаются Яндекс Музыка, Spotify, VLC, AIMP, foobar2000, MusicBee, браузеры, Telegram и другие плееры.
На странице «Источники» можно:
- выбрать конкретную сессию вручную (по умолчанию — автоматически);
- добавить правила
ignore— приложение не будет учитывать этот источник; - добавить правила
preferс приоритетом — нужный источник выиграет у остальных.
Правила сравниваются с ID и именем приложения без учёта регистра. Например, chrome отключит Google Chrome, а spotify с приоритетом 50 заставит выбрать Spotify.
Режим для тех, кто слушает Яндекс Музыку на телефоне или в вебе и не хочет, чтобы локальные плееры перебивали статус. Приложение подключается к Ynison по WebSocket, используя ваш токен, и показывает трек с другого устройства. Требуется вход в аккаунт. Если на других устройствах ничего не играет, интерфейс останется пустым — это ожидаемое поведение режима.
Статус обновляется автоматически при смене трека, паузе и возобновлении. Discord должен быть запущен — приложение само найдёт его IPC-канал и переподключится после перезапуска Discord.
На странице «Discord» доступны:
- тип активности «Слушает» или «Играет»;
- кнопки «Открыть в браузере», «Открыть в приложении», обе или ни одной;
- таймаут паузы и опция «Показывать паузу»;
- вывод текущей строки текста в статус;
- шаблоны
details,stateиlarge_text.
| Плейсхолдер | Значение |
|---|---|
{title}, {track} |
название трека |
{artist} |
исполнитель |
{album} |
альбом |
{year} |
год |
{source}, {app} |
имя источника |
{device} |
устройство |
{progress} |
текущая позиция, 1:12 |
{duration} |
длительность, 3:34 |
{remaining} |
осталось, 2:22 |
{progress_pct} |
процент, 34 |
{url} |
ссылка на трек |
{lyric} |
текущая строка текста |
Пример: details = "{title}", state = "{artist} · {album}", large_text = "{progress} / {duration}".
Если шаблон пуст или даёт пустую строку, используется название трека или исполнитель. Одиночный символ дополняется невидимым символом, чтобы Discord не отбрасывал поле.
Мини-плеер открывается из обзора, трея или по горячей клавише. Он всегда поверх окон, перетаскивается за карточку, запоминает позицию и умеет перематывать трек.
| Комбинация | Действие |
|---|---|
Ctrl+Alt+M |
показать/скрыть мини-плеер |
Ctrl+Alt+L |
окно текста песни |
Ctrl+Alt+P |
пауза/воспроизведение |
Ctrl+Alt+→ |
следующий трек |
Ctrl+Alt+← |
предыдущий трек |
Ctrl+Alt+H |
скрыть/показать статус Discord |
Горячие клавиши можно отключить на странице «Приложение». Если комбинация занята другой программой, приложение покажет предупреждение и продолжит работать без неё.
Включите оверлей на странице «Оверлей». Сервер слушает только 127.0.0.1 (порт по умолчанию 8765).
В OBS добавьте Browser Source и укажите ссылку:
http://127.0.0.1:8765/?theme=dark&accent=%23ffcc00
Рекомендуемый размер — около 520×180, фон прозрачный. Компактный вид для угла экрана:
http://127.0.0.1:8765/widget?theme=dark&accent=%23ffcc00&compact=1
Параметры ссылки:
| Параметр | Значение |
|---|---|
theme |
dark или light |
accent |
цвет акцента в URL-кодировке, например %23ffcc00 |
hide |
скрыть блоки: album,source,progress,time,cover |
compact |
1 — компактная карточка |
idle |
show — показывать карточку-заглушку, когда ничего не играет |
Страница оверлея сама формирует готовые ссылки с текущими настройками и умеет копировать их в буфер обмена.
| Метод | Назначение |
|---|---|
GET / |
HTML-оверлей |
GET /widget |
компактный HTML-оверлей |
GET /api/now-playing |
текущее состояние в JSON |
GET /api/stats?period=day|week|month|all |
агрегаты статистики |
GET /api/art |
обложка текущего трека |
GET /events |
SSE-поток обновлений (раз в секунду) |
GET /health |
проверка сервера |
Пример /api/now-playing:
{
"has_track": true,
"status": "playing",
"title": "Пыяла",
"artist": "АИГЕЛ",
"album": "Пыяла",
"position": 72.4,
"duration": 214.0,
"progress": 0.3383,
"source": "Яндекс Музыка",
"art_url": "/api/art?v=1712345678",
"version": 42,
"updated_at": 1712345678.12
}API отдаёт Access-Control-Allow-Origin только для loopback-origin (например, http://127.0.0.1:8765), а запросы с чужим заголовком Host отклоняются с кодом 421. HTML-страницы получают CSP и X-Content-Type-Options: nosniff; /api/art отдаёт файлы только из каталога кэша обложек, а абсолютный путь к обложке не попадает в JSON. Это защищает локальный API от DNS rebinding и чтения посторонними страницами.
Статистика включается на странице «Приложение». Данные пишутся в SQLite:
- прослушивание засчитывается как трек, если набрано 30 секунд;
- учитывается фактическое время воспроизведения, паузы не считаются;
- доступны периоды день / неделя / месяц / всё время;
- на странице есть график за 14 дней, топ треков и исполнителей, последние прослушивания;
- экспорт в CSV: разделитель
;, кодировка UTF-8 с BOM — открывается в Excel без настройки.
База: %LOCALAPPDATA%\YMRPC-Next\stats.db. При отключении статистики новые записи не создаются.
Приложение проверяет последний релиз GitHub через API:
https://api.github.com/repos/<owner>/<repo>/releases/latest
Репозиторий задаётся на странице «Приложение» в поле owner/repo (по умолчанию Memovoff/YMRPC-Next; если ваши релизы лежат в другом месте, укажите свой репозиторий). Проверка выполняется при запуске (если включено автообновление) и вручную кнопкой.
Запросы к GitHub идут только на api.github.com, а файлы — только с хостов GitHub Releases. Редиректы проверяются отдельно, поэтому обновление не может увести загрузку на посторонний или локальный адрес.
Как выбирается файл:
.exeсsetup,installилиymrpcв имени;- иначе самый большой
.exe; - если
.exeнет —.zip.
Файл релиза обязан иметь SHA-256 digest (поле digest в GitHub API, формат sha256:<64 hex>). Ассеты без digest игнорируются: если подходящего файла нет, обновление будет показано, но кнопка установки не появится. После скачивания SHA-256 проверяется ещё раз; при несовпадении файл удаляется и не запускается.
После скачивания:
- установщик (
*setup*.exe,*install*.exe) запускается, приложение закрывается; - portable-сборка обновляет себя сама: ждёт выхода процесса, копирует новый
.exeповерх старого и запускает его; - zip открывается в Проводнике для ручной распаковки.
Скачанный файл должен находиться в отдельном временном каталоге, созданном приложением; запуск произвольного .exe или .zip из другого места заблокирован.
Для публикации обновления создайте GitHub Release с тегом версии (например, v0.2.0) и приложите новый YMRPC-Next.exe или установщик. GitHub автоматически добавляет digest к загруженным ассетам; без него автообновление этот файл не примет.
Всё хранится локально в %LOCALAPPDATA%\YMRPC-Next:
| Путь | Содержимое |
|---|---|
config.json |
настройки |
token.bin |
OAuth-токен, зашифрованный DPAPI |
stats.db |
история прослушиваний (SQLite WAL) |
cache\art\ |
кэш обложек |
logs\ |
логи приложения |
- Оверлей и API доступны только с
127.0.0.1. Сервер проверяет заголовокHost, отдаёт CORS только loopback-origin, добавляет CSP/nosniffи не раскрывает пути к файлам. - Токен шифруется Windows DPAPI. Если DPAPI недоступен или сохранение не удалось, приложение не пишет токен в открытом виде и откатывает вход.
- Обложки скачиваются только по HTTPS с публичных адресов; локальные, приватные и link-local адреса блокируются, редиректы проверяются, MIME и магические байты изображений валидируются.
- Discord получает только публичные HTTPS-ссылки;
yandexmusic://преобразуется в HTTPS. Внешние ссылки интерфейса открываются после проверки allowlist. - Экспорт CSV экранирует формулы (
=,+,-,@, tab, CR), чтобы Excel не выполнял содержимое ячеек. - Обновления принимаются только с GitHub, требуют SHA-256 digest и проверяются перед запуском.
- Телеметрии и отправки данных на сторонние серверы нет.
- Наружу уходят только запросы, необходимые для работы: Discord IPC (локально), Яндекс API, LRCLIB, iTunes/Deezer для поиска обложек и GitHub для обновлений.
- Автозапуск прописывается в
HKCU\Software\Microsoft\Windows\CurrentVersion\Runи удаляется при отключении.
Сбросить всё можно, удалив папку %LOCALAPPDATA%\YMRPC-Next при закрытом приложении.
ymrpc-next/
├─ run.py, run.pyw запуск из исходников
├─ build.ps1 сборка portable-версии
├─ ymrpc-next.spec конфигурация PyInstaller
├─ src/ymrpc/
│ ├─ app.py QApplication, single instance, перезапуск
│ ├─ engine.py главный цикл: источник → трек → Discord/UI/оверлей
│ ├─ bridge.py сигналы Qt между asyncio-движком и UI
│ ├─ runtime.py отдельный поток с asyncio-циклом
│ ├─ discord_ipc.py Discord IPC и переподключение
│ ├─ presence.py шаблоны и payload Rich Presence
│ ├─ models.py, config.py модели и настройки
│ ├─ sources/ SMTC, Ynison, правила приложений
│ ├─ services/ Яндекс, каталоги, тексты, статистика, оверлей, обновления
│ └─ ui/ главное окно, страницы, мини-плеер, трей
├─ src/ymrpc/assets/ иконки и overlay/index.html (HTML/CSS/JS одним файлом)
├─ tests/ pytest
└─ tools/make_icon.py генерация иконок
.\.venv\Scripts\python.exe -m pytest -q
.\.venv\Scripts\python.exe -m ruff check src tests toolsТесты не требуют сети и Discord. GUI-тесты можно запускать без экрана:
$env:QT_QPA_PLATFORM = "offscreen"
$env:YMRPC_NO_WEBENGINE = "1"Пересоздать иконки:
.\.venv\Scripts\python.exe tools\make_icon.py- Приложение только для Windows: SMTC, DPAPI,
RegisterHotKeyи автозапуск используют Win32 API. - Управление воспроизведением работает для треков Windows SMTC; Ynison — только чтение.
- Оверлей не является частью видеопотока — его добавляют в OBS как Browser Source.
- Portable-обновление копирует
.exeповерх текущего; если папка защищена от записи, обновление не установится. - Сборка не подписана, поэтому SmartScreen может показывать предупреждение.
Идея и вдохновение — FozerG/WinYandexMusicRPC (MIT): программа показывает текущий трек из Яндекс Музыки и других плееров в Discord Rich Presence.
YMRPC Next — самостоятельная реализация на Python + PySide6. Код написан с нуля, но концепция, набор функций и картинки статусов Playing/Paused взяты из оригинального проекта. Спасибо автору.
MIT. См. LICENSE.