Project 01Бета · Windows

Satoru Player

Desktop Software · Music · Open Development

Satoru Player — независимый настольный музыкальный проект, который помогает объединить информацию о воспроизводимой музыке из популярных музыкальных сервисов и отображать её в Discord.

Версия0.4.1
ПлатформаWindows
Размер5,3 МБ
SHA-25683148108e0a4317a93b7dd2f5c884cf752f365c79b7f956ee3a1ba36142e3293

Что умеет Satoru Player

Приложение читает метаданные текущего трека и передаёт их в Discord. Оно не воспроизводит, не скачивает, не расшифровывает и не записывает аудио.

Discord Rich Presence

Статус «Слушает» с названием композиции, исполнителем, обложкой, временем и полосой прогресса. Значок сервиса показывается, если обложка не найдена.

Медиасессия системы

Spotify, Apple Music для Windows, приложения Yandex Music и VK Music, а также браузеры читаются через Windows SMTC и Linux MPRIS.

Расширение для веб-плееров

Необязательное расширение Chromium для SoundCloud, YouTube Music, Yandex Music, VK Music и Spotify Web добавляет точное название сайта, обложку и ссылку на трек.

Автоматический выбор источника

Приложение само выбирает самую актуальную играющую сессию. Её можно закрепить вручную; быстрые переключения гасятся задержкой.

Управление воспроизведением

Предыдущий трек, пауза и следующий трек для активной сессии, если источник принимает команды.

Обложки альбомов

Сначала обложка платформы, затем поиск в каталогах iTunes и Deezer. Обложка принимается только при совпадении названия трека.

Приватность

Режим приватности скрывает название и исполнителя. Нет аккаунтов, аналитики и телеметрии. Загрузка обложек на публичный файлообменник по умолчанию выключена и включается вручную.

Интерфейс

Четыре темы, русский и английский язык, значок в системном трее и мастер первой настройки.

Подробная инструкция по установке

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

Что понадобится

  • Windows 10 или 11 (x64). Установка идёт для текущего пользователя, права администратора не нужны.
  • Настольное приложение Discord, запущенное и с выполненным входом. Веб-версия Discord не подходит: статус передаётся через локальный клиент.
  • Источник музыки: приложение (Spotify, Apple Music, Yandex Music, VK Music) или браузер.
  • Для расширения нужен браузер на Chromium: Chrome, Edge, Brave, Opera, Opera GX, Vivaldi или Яндекс Браузер.

Какой у вас сценарий?

Выберите сценарий, и лишние шаги будут приглушены. Без выбора показаны все шаги.

  1. 01

    Скачайте установщик

    Рекомендуется установщик: он ставит приложение и содержит расширение для браузера. Если установка вам не нужна, возьмите портативную версию, обычный EXE, который запускается без установки. Скачивайте только с этой страницы.

    SatoruPlayer-Setup.exe · SHA-256 83148108e0a4317a93b7dd2f5c884cf752f365c79b7f956ee3a1ba36142e3293

    SatoruPlayer-Portable.exe · SHA-256 b4cc1f1225c9b62df6a9b330c9d7c348119145fddf888786dedda21dad7e7259

    Файлы пока не подписаны цифровой подписью, поэтому на следующем шаге Windows может показать предупреждение. Именно поэтому важно сверить контрольную сумму.

  2. 02

    Проверьте контрольную сумму

    Откройте PowerShell в папке с файлом и выполните команду. Результат должен совпасть с SHA-256 вашего файла, указанным выше, посимвольно (регистр не важен). Для портативной версии замените имя файла на SatoruPlayer-Portable.exe.

    Get-FileHash .\SatoruPlayer-Setup.exe -Algorithm SHA256

    Если значения не совпали, не запускайте файл: скачайте его заново.

  3. 03

    Установите приложение

    Запустите SatoruPlayer-Setup.exe.

    1. Если SmartScreen пишет «Windows защитила ваш компьютер», нажмите «Подробнее», затем «Выполнить в любом случае». Делайте это только после совпадения SHA-256.
    2. Выберите язык установщика, русский или английский, и завершите установку. Права администратора не требуются.
    3. Вместе с приложением устанавливается и расширение для браузера, его можно подключить позже в Настройках.
    4. Портативная версия не устанавливается: положите SatoruPlayer-Portable.exe в постоянную папку и запускайте оттуда. Папки с расширением в ней нет, поэтому для браузерных сервисов скачайте архив расширения на шаге 6.
    5. После запуска значок Satoru Player появится в системном трее рядом с часами. Запускается только одна копия приложения.
  4. 04

    Создайте приложение Discord и вставьте его ID

    Satoru Player показывает статус от имени вашего собственного приложения Discord. При первом запуске откроется мастер настройки.

    1. Откройте discord.com/developers/applications и нажмите New Application.
    2. Задайте имя. Его увидят другие пользователи в вашем статусе, поэтому выберите понятное, например название плеера.
    3. На вкладке General Information скопируйте Application ID. Это 17–20 цифр.
    4. Вставьте ID в мастер настройки Satoru Player и нажмите «Сохранить и продолжить». Позже его можно изменить в Настройках, поле Application ID.

    Application ID не является секретом. Токены, пароли и cookies вводить не нужно. Если приложение пишет, что ID неверный, проверьте, что в поле только цифры.

  5. 05

    Включите отображение активности в Discord

    В настройках Discord откройте раздел «Активность» и включите «Отображать в статусе» (Display current activity as a status message). Без этого Discord не покажет статус, даже если приложение подключено.

    Нужно один раз, во всех сценариях.

  6. 06

    Установите расширение для браузера Сценарий «Браузер на Chromium»

    Расширение добавляет точное название сайта, обложку и ссылку на трек. Оно передаёт только метаданные и подключается к приложению исключительно на 127.0.0.1, то есть на вашем компьютере. Установщик уже содержит расширение, поэтому скачивать его отдельно не нужно: в приложении есть мастер подключения.

    1. В Satoru Player откройте Настройки и найдите блок «Мост для браузерного расширения».
    2. В мастере выберите свой браузер: Chrome, Edge, Brave, Opera, Opera GX, Vivaldi или Яндекс Браузер. В списке показываются только установленные.
    3. Нажмите «Открыть страницу расширений». Браузер откроется на странице расширений. Затем нажмите «Открыть папку расширения»: откроется папка с расширением, она понадобится на следующем шаге.
    4. На странице расширений включите «Режим разработчика», нажмите «Загрузить распакованное расширение» и выберите папку, которая только что открылась (в ней лежит файл manifest.json).
    5. Вернитесь в Satoru Player, скопируйте токен моста. В браузере нажмите на значок расширения Satoru Player Bridge правой кнопкой, выберите «Параметры», вставьте токен, оставьте порт 45615 и нажмите «Сохранить».
    6. Обновите вкладки с музыкой клавишей F5, чтобы расширение подключилось к уже открытым страницам.

    SatoruPlayer-Extension.zip · SHA-256 72d35845ed2c612fc0dc40038ec8cb2f5b2b4da739ff405676f194e29fb5fff8

    Кнопка выше нужна, только если папки с расширением нет в приложении, например при портативной версии: распакуйте архив в постоянную папку и выберите её на четвёртом шаге. Токен моста работает как пароль к локальному соединению, не публикуйте его. Если токен устарел, нажмите в приложении «Создать новый токен» и вставьте новый в параметры расширения. Порт и включение моста применяются после перезапуска приложения.

  7. 07

    Проверьте работу

    Включите трек в любом источнике.

    1. Карточка трека в Satoru Player должна показать название, исполнителя и обложку.
    2. В Discord статус обновится в течение нескольких секунд: Discord принимает обновления примерно раз в 15 секунд.
    3. Полоса прогресса появляется, если источник сообщает позицию и длительность трека. Если источник их не отдаёт, полоса не показывается.
    4. Если открыто несколько плееров, Windows показывает только активную сессию. Нужный источник можно закрепить в приложении.

    Что-то не работает? Смотрите решение проблем ниже.

Поддерживаемые источники

Список составлен по исходному коду и документации приложения. Перечислены только реально реализованные источники.

ИсточникБез расширенияС расширением
Spotify (приложение)ПолностьюНе требуется
Apple Music (приложение для Windows)ПолностьюНе требуется
Yandex Music, VK Music (приложения для Windows)Распознаются по названиюНе требуется
SoundCloud в браузереБазовые данныеНазвание сайта, обложка, ссылка
YouTube Music в браузереБазовые данныеНазвание сайта, обложка, ссылка
Yandex Music в браузереБазовые данныеНазвание сайта, обложка, ссылка
VK Music в браузереБазовые данныеНазвание сайта, обложка, ссылка
Spotify WebБазовые данныеНазвание сайта, обложка, ссылка

Состояние разработки

Проект находится в активной разработке. Мы отдельно отмечаем, что уже работает, а что ещё проверяется.

ОбластьСтатус
Discord Rich Presence: название, исполнитель, источник, обложкаРаботает
Полоса прогресса в статусе «Слушает»Реализовано
Windows SMTC: Spotify, Apple Music, браузерыРеализовано
Мост с браузерным расширениемРеализовано, проверка на реальных сайтах продолжается
Linux (MPRIS)Реализовано, не проверено с реальным плеером; сборок в релизе 0.4.1 нет
macOSНе поддерживается: нет публичного API медиасессий
Подпись установщика WindowsПока не подписан, SmartScreen может предупредить

Вопросы и решение проблем

Satoru Player — настольное приложение для работы с информацией о воспроизводимой музыке и интеграции с Discord. Оно показывает название трека, исполнителя, обложку и прогресс в статусе Discord. Само приложение не воспроизводит, не скачивает и не записывает аудио.

Через медиасессию операционной системы: приложение Spotify, Apple Music для Windows, приложения Yandex Music и VK Music и браузеры. Через необязательное расширение для Chromium: SoundCloud, YouTube Music, Yandex Music, VK Music и Spotify Web. Других источников в приложении нет.

Приложение подключается к локальному клиенту Discord и обновляет Rich Presence: название, исполнитель, обложка, время и прогресс, если эти данные есть у источника. Для этого нужно настольное приложение Discord и собственный Application ID. Обновления идут не чаще примерно раза в 15 секунд, поэтому статус может немного отставать.

Не обязательно. Приложения и браузеры, которые публикуют медиасессию системы, работают без расширения, но для сайтов вы получите только базовые данные. Расширение для Chromium (Chrome, Edge, Brave, Opera, Opera GX, Vivaldi, Яндекс Браузер) добавляет точное название сайта, обложку и ссылку на трек. Оно входит в установщик, а подключить его помогает мастер в Настройках приложения. Расширение читает только метаданные и передаёт их приложению на 127.0.0.1.

В самом Satoru Player нет аккаунтов, аналитики и телеметрии. Нужен лишь собственный Discord Application ID: создайте приложение на портале Discord для разработчиков и вставьте идентификатор в настройки. Для самих музыкальных сервисов действуют их правила.

Основная платформа — Windows 10 и 11 (x64), для неё доступен установщик EXE. Адаптер Linux (MPRIS) реализован, но не проверен с реальным плеером, а сборок под Linux в релизе 0.4.1 нет. macOS не поддерживается, потому что система не даёт публичного доступа к медиасессиям других приложений. Кнопка EXE предназначена только для Windows.

Нет. Это вспомогательное приложение: оно работает рядом с вашими музыкальными источниками и использует только информацию о воспроизведении.

Да, портативная версия SatoruPlayer-Portable.exe запускается без установки, права администратора не нужны. Положите файл в постоянную папку. В неё не входит папка с расширением, поэтому для браузерных сервисов скачайте архив расширения отдельно. Проверьте SHA-256 так же, как у установщика.

Скачайте SatoruPlayer-Setup.exe, сверьте SHA-256 и запустите файл. Затем создайте приложение Discord, вставьте его Application ID в мастер настройки и включите отображение активности в Discord. Для браузерных сервисов подключите расширение через мастер в Настройках. Полная пошаговая инструкция находится выше, в разделе «Подробная инструкция по установке».

В Настройках появился мастер подключения расширения: вы выбираете установленный браузер и в один клик открываете страницу расширений и папку с расширением. Установщик теперь содержит расширение. Также исправлено: при выходе из приложения через значок в трее статус в Discord очищается.

Проверьте по порядку: запущено настольное приложение Discord и вы вошли; в настройках Discord, раздел «Активность», включено «Отображать в статусе»; в Satoru Player введён Application ID и Discord Rich Presence включён; трек играет, а не стоит на паузе. Подождите до 15 секунд: это интервал обновления Discord.

Для обычных треков обложка подбирается в каталогах iTunes и Deezer, но только при совпадении названия. Для SoundCloud, YouTube Music, Yandex Music и VK Music надёжнее установить расширение: оно берёт обложку со страницы. Если обложки нет, Discord показывает значок сервиса. Загрузка обложек на публичный файлообменник по умолчанию выключена и включается в настройках.

Полоса показывается, только если источник сообщает позицию и длительность трека. Не все плееры это делают. Для сайтов подключите расширение. Если данных нет, приложение не выдумывает прогресс.

Убедитесь, что трек играет, а не на паузе. Перезапустите Satoru Player. Закройте лишние плееры: Windows отдаёт приложению только активную сессию. Нужный источник можно закрепить в самом приложении.

Обновите вкладку с музыкой клавишей F5: расширение подключается к уже открытым страницам после перезагрузки. Проверьте, что токен в параметрах расширения совпадает с токеном в настройках приложения, а мост включён. Если токен устарел, создайте новый в приложении и вставьте в расширение.

Установщик пока не подписан цифровой подписью, поэтому Windows называет издателя неизвестным. Сверьте SHA-256 файла с указанным на странице. Если значения совпали, нажмите «Подробнее» и «Выполнить в любом случае».

Откройте Параметры Windows, Приложения, найдите Satoru Player и нажмите «Удалить». Настройки хранятся в папке %APPDATA%\satoru-player. Удалите её вручную, если нужна полная очистка.

1344 PROJECT

Другие проекты

02 Работает

Web Development · Infrastructure · Digital Solutions

WebTime.PL

Веб-разработка и цифровая инфраструктура: сайты, интерфейсы, домены, серверы и поддержка.

03 Релиз-кандидат 0.5.1

Infrastructure · Network Management · Self-hosted

1344 Network Panel

Панель управления VPS и VPN-инфраструктурой: серверы по SSH, пользователи, ссылки, маршрутизация Xray.

04 Бот запущен

Telegram Bot · Access Keys · Community

FreeNet 1344

Telegram-бот, который бесплатно выдаёт ключи доступа для WDTT, qWDTT, PWDTT и iOS VK Turn Proxy за подписку на канал.

05 Открытый код, GPL-3.0

Client · sing-box · Xray · Community project

qThrone

Клиент sing-box и Xray для компьютера и Android с поддержкой qWDTT, CSQTT, olcRTC, OpenFlux, DNSTT, SlipStream, MasterDNS и S3 Bypass.

06 Форум онлайн

Community · Forum · Web

ForumDom

Русскоязычный форум на собственном движке: разделы и темы, профили, личные сообщения, подписки и модерация.

07 Сервис онлайн

Infrastructure · DNS · Free Service

SEMQKA Domains

Бесплатные поддомены на semqka.xyz с редактором DNS и DuckDNS-совместимым обновлением IP.