Skip to content
rodyatotuPublic

About

soundya — SoundCloud на рутованной Яндекс Станции (Лайт, Мини 1 и 2, Станция 2) голосом Алисы: веб-панель, приложение в строке меню Mac, пульт ТВ, планы, будильник, AirPlay. Неофициальный проект на Rust.

Topics

Resources

Stars

30 stars

Watchers

0 watching

Forks

Repository files navigation

soundya 0.6.0 — SoundCloud на Яндекс Станции: голосом Алисы, с телефона и из строки меню Mac

soundya

SoundCloud на Яндекс Станции — голосом Алисы, без телефона и компьютера

Станция Лайт: работает Станция Мини 1: работает Станция Мини 2: работает Яндекс Станция 2: работает Rust, armv7 MIT Работает на колонках Версия 0.6.1 Сообщество в Telegram


soundya — небольшая программа, которая живёт прямо на рутованной Яндекс Станции и играет музыку из SoundCloud. Говорите «Алиса, включи Bonobo» — и колонка сама находит трек и включает его. Управлять можно и с телефона: у колонки появляется своя веб-страница.

Панель soundya на телефоне: главная, ваша музыка, планы и пульт для телевизора

Что нового в 0.6.0

Что нового в soundya 0.6.0

  • Несколько команд одной фразой — «Алиса, включи проектор, открой впн и потом найди на рутубе фильм Дюна»: всё по порядку, устройство называть заново не нужно.
  • Алиса реже отвечает вместо soundya — понимаются «вруби», «выруби», «можешь включить», «давай открой» и другие живые формулировки.
  • Bluetooth голосом — «переключись на блютуз», «вернись на колонку», «подключись к новому устройству блютуз». Устройство запоминается и подключается за пару секунд, его кнопки переключают треки, длинные треки больше не заикаются. Подробнее.
  • soundya на Windows — то же приложение, что на Mac: значок, окно с плеером, подключение компьютера. Подробнее.
  • Список задач поверх окон на Mac и Windows; в «Планы» можно загрузить расписание текстом или файлом.
  • Сценарии — устройство у каждого шага, шаги для компьютера: программа, текст, клавиша, клик мышью.
  • Telegram — упоминания из группы становятся задачами, команды боту /task, /call, /urgent.

Скачать — в последнем релизе, все изменения по версиям — в CHANGELOG.md.

Что умеет

Своя волна

  • Голос. «Алиса, включи …», «пауза», «дальше», «перемешай», «включи мои лайки», «включи рекомендации», «что сейчас играет» — Алиса не уходит в Яндекс Музыку.
  • Ваш аккаунт SoundCloud. Лайки, свои и сохранённые плейлисты, подборки SoundCloud.
  • Рекомендации. «Волна» из треков, похожих на ваши лайки. Подбирается заранее, включается сразу.
  • Поиск без slowed и reverb. «Искать оригиналы» в настройках убирает замедленные, ускоренные и «с ревербом» версии, ремиксы ставит после оригиналов.
  • Веб-панель по адресу http://soundya.local:8765: плеер с перемоткой (нажмите на полосу), поиск, очередь, настройки.
  • Перемешивание, повтор, «похожее», автопродолжение похожими треками в конце очереди.
  • Прокси (SOCKS5/HTTP) для мест, где SoundCloud недоступен, и индикатор соединения — видно, когда всё тормозит из-за сети.
  • Ambilight — кольцо светится под музыку: ровный цвет, пульс, эквалайзер, волна, радуга, дыхание, бегущий огонь, огонь, вспышки на бас и спектр. Цвета и скорость — в «Настройки» → «Ambilight».
  • Будильник soundya — «Алиса, разбуди меня в 7 под мои лайки»: сначала музыка, потом Алиса; выключается только словами «Алиса, я проснулся» и ответом на пример.
  • soundya на Mac и Windows — значок и окно с плеером без браузера.
  • AirPlay: колонка появляется в списке AirPlay на iPhone, iPad и Mac — играйте на неё что угодно с телефона.
  • Компьютер голосом (Windows и Mac): включить, выключить, усыпить, открыть или закрыть программу; на Windows ещё заметки, документы и сообщения в Telegram.
  • Bluetooth и «Где играет» — музыка в наушники, в Bluetooth-колонку или прямо в браузер телефона / окно на Mac и Windows. Переключается и голосом, а кнопки на самом устройстве листают треки.
  • Несколько команд одной фразой — «включи проектор, открой впн и найди фильм».
  • Список задач поверх окон на Mac и Windows.
  • Устойчивость к плохой сети: трек скачивается заранее, при обрыве дозагружается и продолжается с того же места.

Голосовые команды

Алиса, включи…

Сказать Что произойдёт
«Алиса, включи Bonobo» / «включи песню …» поиск и воспроизведение
«Алиса, включи саундклауд» продолжить или включить ваши лайки
«включи мои лайки» / «включи мой плейлист осень» ваша музыка (нужен вход)
«включи рекомендации» / «включи что-нибудь новое» подборка по вашему вкусу
«включи плейлист …» сначала среди ваших, потом в SoundCloud
«включи альбом OK Computer» альбом целиком
«включи Bonobo в яндекс музыке» / «… в яндексе» остаётся Алисе (Яндекс Музыка), SoundCloud встаёт на паузу
«пауза», «стоп», «продолжи», «дальше», «назад» управление
«перемешай» / «играй по порядку» перемешивание
«поставь на повтор» / «выключи повтор» / «включи заново» повтор
«включи похожее» треки, похожие на текущий
«что сейчас играет?» Алиса скажет название
«перемотай на 30 секунд» / «перемотай вперёд на минуту» / «отмотай назад на 10 секунд» перемотка
кнопка ▶‖ на колонке пауза / продолжить SoundCloud
«включи проектор, открой впн и потом найди на рутубе фильм Дюна» несколько команд подряд
«переключись на блютуз» / «вернись на колонку» / «подключись к новому устройству блютуз» Bluetooth
«включи на колонке» / «играй в браузере» «Где играет» голосом: звук на Станцию или в открытую страницу / окно приложения
«выполни буду смотреть кино» ваш сценарий с таким названием
«включи компьютер» / «выключи компьютер» / «усыпи компьютер» компьютер с Windows
«открой телеграм на компьютере» / «закрой хром на компе» программы на компьютере
«включи проектор» / «открой ютуб на телевизоре» / «найди фильм дюна на проекторе» Android TV и проекторы
«Алиса, разбуди меня в 7 под мои лайки» / «Алиса, я проснулся» будильник soundya
«какие у меня сегодня планы» / «что мне сегодня нужно сделать» / «добавь задачу …» планировщик

Команды управления (пауза, «что играет» и т. п.) soundya перехватывает только пока сам играет — в остальное время, и пока SoundCloud на паузе, Алиса работает как обычно. В «Настройки» → «Колонка» → «Музыка по умолчанию» можно выбрать Яндекс Музыку: тогда «включи Bonobo» и «включи мои лайки» остаются Алисе, а «включи Bonobo в саундклауде» — soundya. Плейлист дня, подкасты, аудиокниги, радио и всё с «… в яндекс музыке» Алиса оставляет себе в любом режиме. Полная таблица — docs/voice-priority.md.

Несколько команд одной фразой

«Алиса, включи проектор, открой впн и потом найди на рутубе фильм Дюна» — soundya разберёт фразу на команды и выполнит их по порядку. Команды можно разделять словами «потом», «затем», «после этого», «а ещё», союзом «и» или просто говорить подряд. Устройство называется один раз: после «включи проектор» следующие команды идут на проектор, после команды компьютеру — на компьютер. Между шагами колонка ждёт, пока телевизор проснётся или приложение откроется. В конце Алиса скажет, что сделано; если шаг не получился — какой именно, и остановится.

Цепочка срабатывает, только когда soundya понимает каждую её часть. Если хоть одна — не её («…и расскажи анекдот»), фраза обрабатывается как обычно.

Живые формулировки. «Вруби», «выруби», «погаси», «отыщи», «запускай», «можешь включить», «давай откроем», «сначала…», «ну-ка…» понимаются так же, как «включи», «выключи», «найди», «открой».

Если непонятно, где выполнять. «Сделай громче» или «открой ютуб» подходят и телевизору, и компьютеру. soundya спросит «На каком устройстве?» — ответьте «Алиса, на проекторе». В «Настройки» → «Устройства» → «Куда отправлять команды» можно выбрать устройство заранее, чтобы она не спрашивала.

Обновления: когда выходит новая версия, на странице колонки появляется оранжевая плашка, а в «Настройках» → «Обновления» — кнопка «Установить обновление». Колонка сама скачает новую версию с GitHub (через прокси из настроек, если он задан) и установит её, музыка прервётся на полминуты. Перед установкой колонка сохраняет копию программы и настроек в /data/opt/soundya/backup/; если новая версия не запустится, вернётся прежняя вместе с настройками, а в «Обновления» будет написано, что случилось.

Сценарии («Настройки» → «Устройства»): своя фраза для Алисы запускает цепочку — разбудить телевизор, подождать, открыть приложение, включить музыку, команду компьютеру. У каждого шага выбирается устройство (какой телевизор, какой компьютер). Шаги для компьютера: открыть или закрыть программу, напечатать текст, нажать клавишу, кликнуть мышью (точку можно взять прямо с компьютера); для Bluetooth — включить или выключить вывод. Сценарий запускается и словами «Алиса, выполни …».

Автозапуск (там же): сценарии, которые soundya запускает сама после включения колонки — по порядку и с паузами. По умолчанию ничего. Переключатель «Продолжить музыку после перезагрузки»: если колонка перезагрузилась или soundya обновилась, а музыка играла меньше 20 минут назад, она продолжится с того же места.

Будильник

«Алиса, разбуди меня в 7 под мои лайки» (или «… под плейлист утро», «… по будням»). В панели будильник ставится на главной, «под что» — лайки, рекомендации, плейлист или ссылка SoundCloud на трек или плейлист. Сначала играет музыка, потом Алиса будит голосом; выключить можно только словами «Алиса, я проснулся» и ответом на простой пример — «стоп» и пауза его не выключают, «ещё 5 минут» откладывает. В «Настройки» → «Колонка» → «Будильник»: громкость, с которой он начинает, и «Становиться громче, если не встаю». Там же можно вернуть обычный будильник Алисы.

Планировщик

Вкладка «Планы» (по умолчанию выключен): «Алиса, напомни через 10 минут выключить плиту», «какие у меня сегодня планы», «что мне сегодня нужно сделать», «что у меня дальше», «какие дедлайны», «добавь задачу сдать отчёт завтра до 18:00», «добавь в календарь встречу завтра в 15». За 30 минут до срока колонка предупредит. В меню «Сводка» — утренняя сводка по времени или по фразе «Алиса, доброе утро»: сначала задачи со сроками, потом встречи.

Загрузить список («Планы»): вставьте расписание или список дел текстом либо файлом (.txt, .md, .docx, .csv, .ics, .json) — колонка разложит его на задачи со сроками. Чтобы ИИ сразу писал список в нужном виде, там же есть кнопка «Скопировать промт для ИИ».

Задачи поверх окон (приложение soundya на Mac и Windows, меню значка): небольшое окно со списком дел, которое остаётся над остальными. Задача закрывается нажатием на точку, новую можно дописать внизу, файл со списком — перетащить в окно.

Google Календарь и Задачи («Планы» → «Google»): в обе стороны — колонка читает события и задачи, добавляет новые и отмечает выполненные. Нужен свой бесплатный ключ Google: пошаговая инструкция прямо в панели.

Telegram («Настройки» → «Устройства»): создайте своего бота у @BotFather и вставьте токен — колонка будет читать сообщения от разрешённых людей; «Алиса, ответь …» отправит ответ после «да». Есть тихие часы. Упоминания в группе: добавьте бота в рабочий чат и укажите свой ник — сообщения, где вас упомянули, колонка разберёт сама: задачи положит в «Планы», остальное скажет в рабочие часы. Команды боту в чате: /task (задача), /call (созвон), /urgent (срочно — сразу вам в личку и на колонку), /tasks, /done. Если Telegram у вашего провайдера закрыт, боту можно задать свой прокси («Прокси для Telegram»).

Календарь (вкладка «Планы»): вставьте «Секретный адрес в формате iCal» из настроек Google Календаря — колонка будет называть события в «какие планы на сегодня» и напоминать перед началом. Входить в Google не нужно.

Возможности колонки («Настройки» → «Колонка» → «Проверить»): что в прошивке вашей модели есть для Bluetooth-звука, AirPlay 2 и мультирума. Пришлите результат кнопкой «Отправить автору» — так появится поддержка для вашей модели.

Экран-часы (Мини 3 и др. с часами): по очереди время, температура компьютера, погода по городу.

Приглушение при звонках: пока на компьютере с soundya-pc идёт звонок (приложение занимает микрофон), музыка soundya тише и потом возвращается. Колонка ничего не слушает и не записывает, громкость Алисы не меняется. Голосом: «приглуши звук», «верни громкость». Свои устройства могут сообщать о событиях: POST http://<колонка>:8765/api/duck {"source":"phone","kind":"call","state":"start"} и "state":"end".

Точка у плеера: зелёная — всё хорошо, жёлтая — есть на что посмотреть (медленная сеть, обновление), красная — что-то сломалось. Наведите — увидите что, нажмите — откроются сервисы и устройства.

PIN для панели («Настройки» → «Обновления»): без него управлять колонкой может любой в вашем Wi-Fi. Забыли PIN: adb shell soundya pin off.

Нашли ошибку? Кнопка «Сообщить об ошибке» есть в каждом разделе. В отчёте есть поле «Модель колонки»: колонка подставит её сама, если знает, — поправьте, если ошиблась, или впишите, если поле пустое. Перед отправкой видно всё, что уйдёт автору; токены, ключи, пароль прокси и контакты из журнала вырезаются. Если сервер недоступен, отчёт отправится позже сам.

Удалить: «Настройки» → «Удалить soundya с колонки» (или adb shell sh /data/opt/soundya/uninstall.sh). Уберёт программу, AirPlay и все настройки; root и отключённые обновления останутся.

Как это работает

Схема: Алиса распознаёт фразу, soundya ищет в SoundCloud, играет через динамик и светит кольцом

soundya подключается к локальному интерфейсу Алисы на самой колонке (127.0.0.1:9875), получает распознанный текст фразы, отменяет ответ Алисы и сам ищет и проигрывает музыку. Звук идёт через штатный микшер колонки, поэтому Алиса может говорить поверх музыки — музыка в это время приглушается.

Что нужно

  • Яндекс Станция Лайт (1-го поколения), Мини 1, Мини 2 или Станция 2. Лайт проверена на прошивке 0.369.1.46.
  • Root-доступ по ADB и отключённые обновления (см. шаг 1).
  • Компьютер с adb — только для установки. Дальше колонка работает сама.
  • Если SoundCloud у вас недоступен — SOCKS5- или HTTP-прокси.

Установка

Tip

Проще всего — графический установщик (колонка уже с root, шаг 1 ниже): Mac: откройте soundya.dmg и перетащите soundya в «Программы», затем запустите её из «Программ» (Intel и Apple Silicon, macOS 11+). Установка идёт в окне приложения, без браузера. Windows: soundya-setup-windows.exe (Windows 10/11). Установщик сам найдёт колонку в сети, установит soundya (с копией настроек и откатом), спросит, что включить и какую музыку играть по умолчанию, а на Windows и Mac подключит и сам компьютер. adb ставить не нужно. Собрать: sh scripts/build-installer.sh. Раздавать можно только DMG, собранный или доработанный на Mac: образ с Linux — черновик (скачанный, он не монтируется без предупреждения); на Mac его доводит sh scripts/mac-dmg/sign-on-mac.sh dist/soundya.dmg. Приложения не подписаны сертификатом разработчика: Windows покажет «Windows защитила ваш компьютер» → «Подробнее» → «Выполнить в любом случае»; на Mac первый запуск macOS заблокирует: закройте это сообщение (не в Корзину), откройте «Системные настройки» → «Конфиденциальность и безопасность», внизу у сообщения про soundya нажмите «Открыть всё равно» и подтвердите. Дальше soundya запускается как обычно. Разрешите доступ к локальной сети, когда macOS спросит, — без него колонку не найти.

Tip

Уже стоят YAM и Luna? Тогда всё ставится одной командой на колонке:

yam install rodyatotu/soundya

Потом в Luna включите бинарные плагины и пакет rodyatotu.soundya. В Luna soundya становится плеером «SoundCloud» (пауза, продолжить, следующий трек) и светит кольцом через неё. Обновления — тоже через YAM. Пакет есть для Станции Лайт, Мини 1, Мини 2 и Станции 2. Обычная soundya и пакет для Luna вместе не работают: перед установкой пакета удалите обычную («Настройки → Удалить soundya»).

Без YAM — по шагам ниже.

1. Root и отключение обновлений

Если на колонке уже есть root и обновления отключены — переходите к шагу 2.

Пошаговый гайд: root через DNS и отключение обновлений (нажмите, чтобы раскрыть)

[!WARNING] Сброс колонки стирает все её настройки, колонку придётся заново привязать к аккаунту. Ошибка в процессе может сломать колонку. Всё делаете на свой риск.

[!IMPORTANT] DNS-метод работает только на прошивках до обновления 20–21 октября 2026. Проверено на Станции Лайт 1 с прошивкой 0.369.1.46 (сборка от 13 октября 2026). Сброс до заводских настроек (шаг 1.1) откатывает колонку на заводскую прошивку, поэтому важна версия, которая стоит после сброса: её видно в приложении «Дом с Алисой» в настройках колонки. Актуальный статус смотрите на hackalice.me.

Гайд пересказывает hackalice.me — шаг 1 и шаг 2. Если что-то не сходится, верьте им: там гайд обновляют.

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

  • роутер, в котором можно поменять DNS (Keenetic, ASUS, TP-Link, OpenWrt, MikroTik). Если нельзя, подойдёт второй Android-телефон в режиме точки доступа с приложением DNS Changer;
  • компьютер в той же сети с adb: на Mac brew install android-platform-tools, на Windows и Linux — Platform Tools;
  • телефон с приложением «Дом с Алисой».

1.1. Сбросьте колонку

Выньте кабель питания. Зажмите кнопку выключения микрофона и, не отпуская её, вставьте кабель обратно. Держите 10–15 секунд, пока кольцо не замигает и Алиса не скажет про сброс.

Сброс стирает все настройки и откатывает колонку на заводскую прошивку: всё, что она успела скачать с обновлениями, пропадает.

1.2. Начните привязку и остановитесь на Wi-Fi

На телефоне включите Bluetooth и геолокацию. В «Доме с Алисой»: «+» → «Устройство с Алисой» → дойдите до экрана с паролем от Wi-Fi.

Пока не нажимайте «Подключиться». Если поменять DNS раньше этого экрана, привязка сломается.

1.3. Поменяйте DNS в роутере

Поставьте первым DNS-сервером для домашней сети (DHCP) адрес 179.254.167.126, второй оставьте пустым.

  • Keenetic: «Сетевые правила» → «Домашняя сеть» → «Параметры IP и DHCP» → DNS 1 → «Сохранить».
  • ASUS: «ЛВС» → «DHCP-сервер» → «DNS-сервер 1».
  • TP-Link: «Дополнительные настройки» → «Сеть» → «DHCP-сервер» → «Основной DNS».
  • OpenWrt (меняет DNS только для нужных доменов, остальная сеть не затронута — лучший вариант):
    uci add_list dhcp.@dnsmasq[0].server='/quasar.yandex.net/179.254.167.126'
    uci add_list dhcp.@dnsmasq[0].server='/quasar.yandex.ru/179.254.167.126'
    uci add_list dhcp.@dnsmasq[0].server='/scbh.yandex.net/179.254.167.126'
    uci commit dhcp && /etc/init.d/dnsmasq reload

DNS нужно менять именно для домашней сети (DHCP). Настройка DNS для интернет-подключения (WAN) не поможет.

179.254.167.126 — сервер сообщества, не ваш. Если не хотите от него зависеть, запустите такой же стенд у себя на Mac (lite-kit, инструкция в его README) и укажите в роутере IP вашего компьютера.

1.4. Подключите колонку

Вернитесь в приложение и нажмите «Подключиться». Колонка подключится к Wi-Fi, помигает и издаст звук готовности.

1.5. Зайдите по ADB

Найдите IP колонки в списке устройств роутера и выполните на компьютере:

adb connect <IP-колонки>:5555
adb shell id

Если в ответе есть uid=0(root), root получен.

1.6. Отключите обновления — сразу, пока DNS не вернули

Иначе Яндекс пришлёт новую прошивку, и root пропадёт. Скрипт берём из yandex-station-extended:

git clone https://github.com/Marker284/yandex-station-extended && cd yandex-station-extended
adb shell 'mkdir -p /data/quasar && touch /data/quasar/activate_adb_quasmodrom /data/quasar/activate_network_adb && chattr +i /data/quasar/activate_adb_quasmodrom /data/quasar/activate_network_adb'
adb shell mkdir -p /data/opt
adb push contrib/yandex-noupdate.sh /data/opt/yandex-noupdate.sh
adb shell sh /data/opt/yandex-noupdate.sh

Первая команда adb shell оставляет ADB по сети включённым после перезагрузки. Скрипт yandex-noupdate.sh выключает обновления.

1.7. Верните DNS и перезагрузите колонку

Уберите 179.254.167.126 из настроек роутера и верните как было. Для OpenWrt:

uci -q del_list dhcp.@dnsmasq[0].server='/quasar.yandex.net/179.254.167.126'
uci -q del_list dhcp.@dnsmasq[0].server='/quasar.yandex.ru/179.254.167.126'
uci -q del_list dhcp.@dnsmasq[0].server='/scbh.yandex.net/179.254.167.126'
uci commit dhcp && /etc/init.d/dnsmasq reload

Затем:

adb shell reboot
# подождите минуту
adb connect <IP-колонки>:5555
adb shell sh /data/opt/yandex-noupdate.sh status

В ответе должно быть: updatesd убран, заглушён, подменён. Root остаётся и с обычным DNS.

Если на каком-то шаге не получилось
  • «Не удалось подключиться к Wi-Fi» в приложении — DNS поменяли слишком рано. Уберите его, сбросьте колонку и начните с 1.1.
  • adb connect пишет refused на порт 5555 — выключите в роутере фильтрацию DNS (Яндекс.DNS, AdGuard) и передёрните питание колонки.
  • unable to connect — компьютер и колонка должны быть в одной сети. Гостевая сеть с изоляцией клиентов не подойдёт.

2. Закрепите IP колонки в роутере

Чтобы колонка не меняла адрес после перезагрузки, закрепите его за ней в DHCP роутера:

  • TP-Link: Advanced → Network → DHCP Server → Address Reservation → Add
  • Keenetic: Список устройств → колонка → «Постоянный IP-адрес»
  • ASUS: ЛВС → DHCP-сервер → «Список назначенных вручную IP-адресов»

Веб-панель и так доступна по имени soundya.local (mDNS), но закреплённый IP пригодится для adb и для устройств, которые не понимают .local.

3. Получите soundya

Готовая сборка: скачайте soundya-armv7.tar со страницы Releases.

Или соберите сами (macOS или Linux):

curl https://sh.rustup.rs -sSf | sh -s -- -y && source ~/.cargo/env
rustup target add armv7-unknown-linux-gnueabihf
brew install zig cargo-zigbuild          # на Linux: pip install ziglang && cargo install cargo-zigbuild
git clone https://github.com/rodyatotu/soundya && cd soundya
sh scripts/build-mac.sh                  # → dist/soundya-armv7.tar

4. Установите на колонку

С Windows: скачайте проект (зелёная кнопка Code → Download ZIP), распакуйте и дважды щёлкните install-windows.cmd. Он сам скачает adb, найдёт колонку в сети, возьмёт готовую сборку из Releases, установит её и откроет веб-панель.

С Mac или Linux, из папки проекта:

sh scripts/deploy.sh <IP-колонки>

Или вручную, если скачали готовую сборку:

adb connect <IP-колонки>:5555
adb push soundya-armv7.tar /tmp/
adb shell "cd /tmp && tar -xf soundya-armv7.tar && sh /tmp/soundya/install.sh"

Установщик кладёт всё в /data/opt/soundya, добавляет автозапуск и команду soundya. Настройки при обновлении сохраняются.

5. Настройте

Пульт в телефоне: новая панель soundya на телефоне

Откройте http://soundya.local:8765 (или http://<IP-колонки>:8765) → Настройки:

  1. Прокси — если SoundCloud у вас открывается только через него. Кнопка «Проверить прокси» покажет, работает ли он. Или без прокси: кнопка «Подобрать и включить обход» — колонка, как zapret, прячет от провайдера имя сайта в соединении (режет TLS-приветствие на части) и сама подбирает рабочий способ. Помогает при блокировке по имени сайта; если заблокированы сами адреса SoundCloud, честно скажет, что нужен прокси.
  2. Аккаунт SoundCloud — для лайков, плейлистов и рекомендаций. SoundCloud не даёт сторонним приложениям вход по паролю, поэтому вход берётся из браузера: войдите на soundcloud.com (лучше в приватном окне) → инструменты разработчика (Cmd+Option+I / F12) → Application → Cookies → https://soundcloud.com → значения oauth_token и oauth_refresh_token, оба — в «Настройки» → «Аккаунт». С oauth_refresh_token колонка сама продлевает вход каждый день. Это как пароль: никому не отправляйте.

Всё. Скажите: «Алиса, включи рекомендации».

AirPlay

Колонка видна в списке AirPlay на iPhone, iPad и Mac как «Яндекс Станция»: Пункт управления → значок AirPlay, или кнопка AirPlay в Apple Music, Spotify, YouTube и других приложениях. Звук идёт с телефона на колонку по домашнему Wi-Fi, громкость меняется кнопками телефона.

  • Пока играет AirPlay, SoundCloud стоит на паузе, а кольцо горит оранжевым. Скажете «Алиса, включи …» — SoundCloud заберёт колонку обратно, а AirPlay отключится.
  • Когда Алиса слушает или отвечает, музыка с AirPlay становится тише, как и SoundCloud.
  • Название меняется на странице колонки: «Настройки» → «AirPlay». Там же AirPlay выключается.
  • Ставить на паузу и переключать треки нужно на телефоне: Алиса командует только SoundCloud.

Это классический AirPlay (как у колонок с AirPort Express): он работает со всеми iPhone и Mac, но колонку нельзя объединить в группу с HomePod. Если колонка не появляется в списке, телефон и колонка должны быть в одной сети без изоляции клиентов, а в роутере не должен быть выключен multicast (mDNS).

Bluetooth

Музыку soundya можно отправить в Bluetooth-наушники или колонку: «Настройки» → «Устройства» → «Bluetooth» → «Найти», выберите устройство. Работает на моделях, где в прошивке есть нужные части (Лайт, Мини 2); что есть у вашей — покажет «Настройки» → «Колонка» → «Проверить».

Сказать Что произойдёт
«Алиса, переключись на блютуз» / «включи музыку в наушниках» музыка пойдёт в сохранённое устройство
«вернись на колонку» / «верни звук на колонку» / «отключи блютуз колонку» музыка снова из Станции, устройство отпущено — его можно подключить к телефону
«подключись к новому устройству блютуз» / «найди блютуз устройства» колонка поищет устройства рядом, назовёт их и спросит, какое подключить — ответьте «Алиса, первое» или названием
  • Устройство запоминается. Первый раз оно должно быть в режиме сопряжения; дальше подключается за пару секунд.
  • Кнопки на устройстве — следующий и предыдущий трек, пауза — управляют soundya.
  • Голос Алисы остаётся в самой Станции: в Bluetooth идёт только музыка soundya.
  • Если звук заикается — поставьте устройство ближе к Станции: Wi-Fi и Bluetooth в ней делят одну антенну, и при слабом сигнале звук не успевает уходить. Сам звук идёт с умеренным битрейтом, а длинные треки докачиваются порциями, чтобы не мешать ему.
  • «Включи блютуз» и «выключи блютуз» без других слов остаются Алисе: это её режим «Станция как Bluetooth-колонка для телефона».

Телевизор голосом (Android TV)

Колонка управляет телевизором, приставкой или проектором на Android TV в той же сети (проверяется на Xiaomi L1 Pro):

Сказать Что произойдёт
«включи проектор» / «выключи телевизор» разбудить / усыпить
«открой ютуб на проекторе» / «запусти кинопоиск на телевизоре» открыть приложение
«найди фильм дюна на проекторе» / «включи сериал друзья на телевизоре» включит ТВ и найдёт в выбранном приложении (Кинопоиск, ivi, Okko…), иначе — общий поиск
«включи на ютубе котиков на проекторе» поиск на YouTube
«пауза / продолжи на проекторе», «следующая серия на телевизоре» управление воспроизведением
«сделай громче / тише на проекторе», «выключи звук на телевизоре» громкость
«домой на телевизоре», «назад на проекторе» кнопки пульта

Устройство называется любым из слов: телевизор, телек, тв, проектор, приставка. Если телевизоров несколько — у каждого своё имя: «выключи телевизор в спальне». Приложение для поиска фильмов выбирается у каждого телевизора: «Телевизор / проектор» → «Поиск фильмов».

Настройка, один раз:

  1. На телевизоре: «Настройки» → «Об устройстве» → 7 раз нажмите на «Сборка». Появятся «Для разработчиков».
  2. «Настройки» → «Для разработчиков» → включите «Отладку по USB» (и «Отладку по сети» / «ADB по сети», если такой пункт есть).
  3. Узнайте IP телевизора («Настройки» → «Сеть» → ваша сеть) и закрепите его в роутере.
  4. На странице колонки → «Настройки» → «Телевизор / проектор» впишите IP и нажмите «Сохранить и подключить». На экране телевизора появится «Разрешить отладку по USB?» — отметьте «Всегда разрешать с этого компьютера» и нажмите «Разрешить».

Колонка подключается к телевизору как adb по порту 5555 (ключ создаётся на колонке, /data/opt/soundya/adbkey). Выключенный «в розетку» телевизор по сети не включить: «включи проектор» работает из режима ожидания.

Компьютер голосом (Windows)

Колонка может управлять компьютером с Windows в той же домашней сети:

Сказать Что произойдёт
«Алиса, включи компьютер» включит компьютер по сети (нужен кабель, см. ниже)
«выключи компьютер» / «перезагрузи компьютер» выключит / перезагрузит через 3 секунды
«усыпи компьютер» / «переведи компьютер в спящий режим» спящий режим
«заблокируй компьютер» экран блокировки
«открой телеграм» / «открой стим на компьютере» / «запусти на компе дискорд» откроет программу
«закрой хром» / «выключи дискорд на компьютере» закроет программу
«открой ютуб в профиле работа» / «открой в браузере профиль учёба» Chrome с нужным профилем и сайтом
«найди в гугле как приготовить плов» / «загугли курс доллара» поиск в Google
«найди на ютубе как установить виндоус» поиск на YouTube
«запиши купить молоко» / «открой блокнот и запиши …» заметка: отдельный файл в «Документы\Заметки»
«допиши в блокнот купить хлеб» строка в последнюю заметку
«создай документ отчёт с текстом …» документ Word с текстом
«напиши контакту в телеграм привет» / «отправь саше сообщение …» сообщение в Telegram (контакты задаются в настройках)
«подключи впн» / «отключи впн» открывает / закрывает приложение VPN
«создай папку проекты на рабочем столе» новая папка

Программы ищутся по ярлыкам в меню «Пуск», на рабочем столе и в библиотеке Steam, так что подойдёт почти всё установленное. Если программа уже открыта, «открой …» переключает на её окно. «Открой …», «запиши …», «найди в гугле …» работают и без слов «на компьютере».

Умный дом остаётся Алисе. «Закрой окно», «открой шторы», «выключи свет» без слов «на компьютере» soundya не трогает — это ваш Home Assistant или устройства Алисы. В «Настройки» → «Устройства» → «Компьютер» можно выбрать, какие команды выполняет soundya: питание, программы, Telegram, поиск и заметки, фразы без «на компьютере», — и вписать слова, которые всегда оставлять Алисе. Русские названия популярных программ (телеграм, хром, стим, дискорд, ворд, блокнот…) уже знакомы. Свои названия добавляются в %LOCALAPPDATA%\soundya-pc\config.json:

"apps": { "моя игра": "C:\\Games\\Game\\game.exe", "почта": "Outlook" },
"sites": { "джира": "https://jira.example.com" }

Приложение soundya для Windows

soundya-setup-windows.exe из последнего релиза — это и установщик на колонку, и сама soundya на компьютере, как soundya.app на Mac. Windows 10 или 11, 64 бита.

  • Первый запуск — мастер: поставить soundya на колонку или подключить этот компьютер к уже настроенной. Права администратора спросит один раз — для правила брандмауэра и включения по сети.
  • Дальше — значок в области уведомлений: клик открывает окно с панелью колонки без браузера (плеер, громкость, «Где играет», планы), правый клик — пауза, следующий трек, «Задачи поверх окон». Запускается вместе с Windows.
  • Команды колонки («открой телеграм», «усыпи компьютер») выполняет то же приложение. Скрипт pc\install.cmd из прежних версий больше не нужен: если компьютер был подключён им, приложение возьмёт тот же ключ и уберёт старый автозапуск.
  • Компьютер с запущенным приложением сам появляется на странице колонки в «Устройства» — нажмите «Добавить».

Установка на компьютер скриптом (прежний способ)

  1. На компьютере откройте эту страницу → зелёная кнопка Code → Download ZIP. Распакуйте архив: правой кнопкой → «Извлечь всё».
  2. В распакованной папке откройте pc и дважды щёлкните install.cmd. Windows спросит разрешение администратора — согласитесь. Если появится «Windows защитила ваш компьютер» — «Подробнее» → «Выполнить в любом случае».
  3. Установщик покажет адрес компьютера, ключ и MAC-адрес. Впишите их на http://soundya.local:8765 → «Настройки» → «Компьютер» и нажмите «Проверить связь». Должно появиться «Компьютер … на связи».
  4. Закрепите за компьютером IP в роутере, как для колонки (шаг 2 установки), иначе адрес однажды сменится.

Программа запускается сама при входе в Windows. Возле часов появляется оранжевый значок колонки с точкой: зелёная — колонка на связи (при наведении видна задержка в мс), красная — колонка не отвечает, серая — программа не запущена. По правой кнопке на значке: что играет и пауза / следующий трек, последняя команда, данные для колонки (IP, ключ, MAC — с копированием), проверка связи, перезапуск, лог и настройки. Если колонка не находится сама, впишите её адрес в config.json: "speaker": "192.168.0.112".

Программа принимает команды только из домашней сети и только с правильным ключом, открывать умеет только программы, а не произвольные команды. Удалить — pc\uninstall.cmd.

Чтобы «включи компьютер» работало

Включение по сети (Wake-on-LAN) работает, только если компьютер подключён к роутеру кабелем: по Wi-Fi компьютер в выключенном состоянии сигнал не слышит.

  1. Установщик уже включил пробуждение в настройках сетевой карты и выключил «быстрый запуск» Windows (с ним большинство компьютеров после «Завершения работы» по сети не включаются).
  2. В BIOS/UEFI (при включении жмите Del или F2) найдите и включите пункт с названием вроде Wake on LAN, Power On By PCI-E, Resume by LAN или Network Stack. Если есть ErP Ready или Deep Sleep — выключите.
  3. Проверьте: выключите компьютер через «Пуск» и скажите «Алиса, включи компьютер».

Если не включается из выключенного состояния, обычно помогает «усыпить» вместо «выключить»: из сна компьютер просыпается по сети почти всегда.

soundya на Mac

soundya в строке меню Mac: значок и стеклянное окно с плеером

Перетащите soundya из soundya.dmg в «Программы», откройте её оттуда и нажмите «Подключить этот компьютер» (дальше soundya.app открывает уже не установщик, а окно soundya; установщик — в меню значка) (или правый клик по значку → «Подключить этот Mac к колонке»). Права администратора не нужны, soundya запускается при входе в macOS.

  • Значок в строке меню. Клик открывает soundya в стеклянном окне — плеер, громкость, «Где играет», сценарии, пульт ТВ, планы. Что показывать, выбираете шестерёнкой в окне; выключенное не грузится с колонки. Окно тянется за край и запоминает размер, клик мимо — прячется.
  • Правый клик — пауза, следующий трек, размер окна, большое окно, данные для колонки, лог.
  • Музыка прямо на Mac — «Где играет» → окно: колонка затихнет, звук пойдёт из Mac.
  • Второй компьютер. Если к колонке уже подключён Windows, Mac добавится вторым: «Алиса, усыпи мак», «открой телеграм на маке».

Компьютер голосом (Mac)

Сказать Что произойдёт
«усыпи компьютер» сон
«заблокируй компьютер» гасит экран; Mac заблокирован, если в «Экран блокировки» пароль требуется сразу (так по умолчанию)
«выключи компьютер» / «перезагрузи компьютер» как в меню Apple — программы могут попросить сохранить файлы
«открой телеграм» / «закрой хром» открывает / закрывает (как ⌘Q, без принудительного завершения) программу из «Программ»
«найди в гугле …» / «найди на ютубе …» / «открой github.com» браузер по умолчанию
«какая загрузка процессора» / «запущен ли телеграм» загрузка процессора и памяти (температуру macOS без прав администратора не отдаёт)
«включи компьютер» только из сна, если включено «Системные настройки» → «Аккумулятор/Энергосбережение» → «Пробуждение для доступа к сети»

Заметки, документы Word, Telegram-сообщения, VPN и приглушение при звонках есть только на Windows; на Mac Алиса ответит «пока не умею».

Разрешения macOS. Выключение, перезагрузка и «закрой …» идут через Apple Events: при первой такой команде macOS спросит «soundya хочет управлять …». Если отказать, команда не выполнится, а Алиса скажет, где это разрешить: «Системные настройки» → «Конфиденциальность и безопасность» → «Автоматизация» → soundya. Если включён брандмауэр macOS, разрешите soundya входящие подключения. Микрофон, камеру, экран и файлы программа не использует.

Безопасность. Принимаются только подписанные команды (HMAC-SHA256 с меткой времени, не старше 2 минут, каждая один раз) и только из домашней сети; ключ открытым текстом не принимается. Сразу после перезапуска программы перехваченную команду можно повторить в течение 2 минут (список использованных подписей хранится в памяти) — как и на Windows.

Свои названия программ и сайтов — в ~/Library/Application Support/soundya-pc/config.json ("apps", "sites", как на Windows). Журнал — ~/Library/Logs/soundya-pc.log (окна в строке меню — ~/Library/Logs/soundya-tray.log). Удалить — кнопка «Удалить с этого Mac» на том же шаге установщика.

Настройки на колонке

Файл /data/opt/soundya/soundya.env (после правки — /etc/init.d/S99soundya restart):

Переменная По умолчанию Что делает
SOUNDYA_WEB_PORT 8765 порт веб-панели, 0 — выключить
SOUNDYA_NAME soundya имя в сети: http://<имя>.local:8765
SOUNDYA_DEVICE default ALSA-устройство вывода
SOUNDYA_DNS — свои DNS-серверы, если системный DNS колонки не работает
SOUNDYA_WEB_HOSTS — свои имена колонки через запятую, если открываете панель не по IP, .local, .lan или .home
SOUNDYA_REPORT_URL сервер статистики куда отправлять отчёты об ошибках

Прокси, вход, «Музыка по умолчанию» и подсветка настраиваются на странице и хранятся в /data/opt/soundya/config.json (рядом — config.json.bak, последняя хорошая копия).

Команды на колонке

soundya play <запрос | ссылка>   soundya playlist <запрос>   soundya likes   soundya recs
soundya pause | resume | toggle | next | prev | stop
soundya shuffle on|off           soundya repeat on|off       soundya similar
soundya status | queue            soundya pc wake|sleep|shutdown|open <программа>
/etc/init.d/S99soundya start | stop | restart

Лог: /tmp/soundya.log.

Если что-то не так

Алиса отвечает «нужна подписка на Яндекс Музыку»

Значит, фразу забрала Алиса. Посмотрите в логе строки voice: …: там видно, что soundya услышал и почему отдал Алисе. Команды управления («дальше», «пауза») перехватываются, только пока играет SoundCloud.

Долго грузится, Алиса долго «думает»

Откройте «Настройки» → «Соединение с SoundCloud». Если пинг больше ~500 мс или скорость меньше ~600 кбит/с — тормозит прокси или сеть. Попробуйте другой прокси.

Трек «играет», но звука нет (время стоит на 0:00)

adb shell 'grep -E "^(player|alsa)" /tmp/soundya.log | tail'. Если звуковая карта не запускается — перезагрузите колонку (adb shell reboot): это сбрасывает общий звуковой микшер.

Колонка зависла: не отвечает ни на голос, ни на кнопки

Иногда звуковая карта колонки застревает, и тогда не может играть никто, даже сама Алиса. soundya следит за этим: через полторы минуты перезапускает звуковой сервис Алисы, а если не помогло — перезагружает колонку (не чаще раза в час). Если колонка всё равно висит — выньте питание на 10 секунд.

Что было перед зависанием, видно и после выключения питания:

adb shell 'cat /data/opt/soundya/guard.log; tail -40 /data/opt/soundya/previous.log'
Страница по адресу soundya.local не открывается

Откройте по IP колонки (http://<IP>:8765). Некоторые старые Android-устройства не понимают адреса .local.

Почему нельзя ставить лайки и добавлять в плейлисты из soundya

SoundCloud отвечает на такие запросы капчей своей антибот-защиты — изменения он разрешает только из браузера или приложения. Кнопка «↗» в плеере открывает текущий трек на SoundCloud, где лайк ставится в одно нажатие. Читать лайки и плейлисты это не мешает.

Ограничения

  • Треки Go+ без подписки и часть лицензированных треков SoundCloud отдаёт только 30-секундным превью — такие пропускаются.
  • Используется неофициальный API сайта SoundCloud: если они его поменяют, понадобится обновление.
  • Работает на Станции Лайт 1-го поколения, Мини 1, Мини 2 и Станции 2. Другие модели не проверялись.
  • AirPlay — только классический (AirPlay 1): без мультирума с HomePod и без паузы голосом.

Благодарности

  • spotiya (MIT) — протокол локального интерфейса Алисы, на котором держится голосовое управление.
  • yandex-station-extended и hackalice.me — гайды по руту, скрипт отключения обновлений, описание озвучки через Алису.
  • lite-kit — стенд для получения root.
  • symphonia, ureq, serde.
  • zapret (MIT) — nfqws для обхода блокировок; файл из официального релиза, см. packaging/NFQWS.md.
  • shairport-sync — приёмник AirPlay. Собран статически с musl, Mbed TLS (Apache-2.0), libconfig (LGPL-2.1) и popt скриптом scripts/build-shairport.sh: исходники и точные версии — там, пересобрать можно им же.

Анонимная статистика

Чтобы знать, на скольких колонках работает soundya (значок «работает на N колонках» вверху), колонка раз в день отправляет на сервер автора только случайный номер установки (его придумывает сама колонка, он не связан ни с ней, ни с аккаунтом), версию soundya, модель колонки и включены ли AirPlay и управление компьютером. IP-адреса сервер не хранит, треки, токены и голосовые команды никуда не уходят. Код сервера — server/stats.py.

Выключается галочкой «Анонимная статистика» на странице колонки → «Настройки».

Важно

soundya — неофициальный любительский проект для личного использования и совместимости. Он никак не связан с Яндексом и SoundCloud и не является их продуктом.

  • Root и изменение прошивки колонки вы делаете самостоятельно и на свой риск; это может лишить гарантии. Проект лишь использует уже существующий публичный доступ к устройству, которым вы владеете.
  • SoundCloud — используйте в рамках его правил; soundya ничего не раздаёт и не хранит, а воспроизводит то, к чему у вас есть доступ под вашим аккаунтом.
  • «Обход блокировок» — опциональная функция, выключенная по умолчанию. Она использует сторонний открытый компонент zapret (лицензия MIT, автор bol-van), входящий в официальный релиз без изменений. soundya лишь запускает его для доступа к SoundCloud. Включать эту функцию и отвечать за соответствие законам своей страны — решение и ответственность пользователя.
  • Программа предоставляется «как есть», без каких-либо гарантий (см. LICENSE и DISCLAIMER). Автор не несёт ответственности за последствия использования.

Лицензия

MIT

soundya

About

soundya — SoundCloud на рутованной Яндекс Станции (Лайт, Мини 1 и 2, Станция 2) голосом Алисы: веб-панель, приложение в строке меню Mac, пульт ТВ, планы, будильник, AirPlay. Неофициальный проект на Rust.

Topics

Resources

Stars

30 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages