docs(plugins): add Yandex Alice plugin page#651
Open
trudenboy wants to merge 5 commits intomusic-assistant:betafrom
Open
docs(plugins): add Yandex Alice plugin page#651trudenboy wants to merge 5 commits intomusic-assistant:betafrom
trudenboy wants to merge 5 commits intomusic-assistant:betafrom
Conversation
Adds a documentation page for the Yandex Alice plugin, which exposes
Music Assistant playback to Alice via a Yandex Dialogs custom skill
("aliceSkill" / «Навык») — the voice-skill side of the integration,
extracted from the Yandex Smart Home plugin into its own provider so
voice-only and device-bridge users can configure independently.
Covers v1.1.0:
- Free-form Russian voice playback («Алиса, попроси <name> ...»):
search-and-play, transport, queue, multi-room, now-playing, voice-
first disambiguation, Russian NLU (verb stripping, inflection-aware
player matching).
- Automatic skill creation via OAuth Device Flow at ya.ru/device + the
undocumented Yandex Dialogs developer-console API. Self-resuming
state machine: same button doubles as 'Confirm and continue' /
'Resume' / 'Re-create' / 'Retry' depending on persisted state, so
HTTP / proxy timeouts can't strand the flow.
- Cached x_token reuse: long-lived token from first Device Flow is
reused on subsequent rename / re-create within token lifetime
(months). Silently dropped on 401.
- Rename action: PATCH draft + re-deploy via cached x_token, with
drift detection LABEL when MA-side Skill name differs from
last_known_name in artifacts.
- Manual setup remains the supported fallback when the undocumented
Yandex Dialogs API breaks.
Page follows the style of the Yandex Smart Home page (CAUTION /
WARNING / NOTE callouts, voice commands table, settings list, known
issues / notes) and cross-links between the two.
Sidebar entry added to astro.config.mjs under Plugins.
Related links:
- Provider source: https://github.com/trudenboy/ma-provider-yandex-alice
- Provider release v1.1.0:
https://github.com/trudenboy/ma-provider-yandex-alice/releases/tag/v1.1.0
- Full plugin documentation (RU/EN):
https://trudenboy.github.io/ma-provider-yandex-alice/
- Sibling plugin (Smart Home device bridge):
https://github.com/trudenboy/ma-provider-yandex-smarthome
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
✅ Deploy Preview for ohf-music-assistant ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Aligns the page with the airplay-receiver / plex-connect template and addresses the review feedback from music-assistant#623 (Yandex Smart Home docs PR): drop the voice-commands table, the deep-dive on the auto-create state machine + cached x_token + rename / drift / manual fallback, the explicit Settings list, and the standalone Multi-room / Disambiguation / Security sections — they were rephrasing details already covered in Features or in the source-repo guide. All Russian phrases translated or rephrased in English. Net change: 149 → 41 lines. The page now hands users off to the source-repo full setup guide for step-by-step configuration. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a documentation page for the Yandex Alice plugin — voice control of Music Assistant via a Yandex Dialogs custom skill. This is the voice-control side of the Yandex integration; the device-bridge (volume, on/off, playlists as input sources) lives in the Yandex Smart Home plugin and the two can run side by side.
Changes
src/content/docs/plugins/yandex-alice.mdastro.config.mjsunder PluginsThe page follows the airplay-receiver / plex-connect house style (CAUTION / WARNING / NOTE callouts, bulleted Features / Known Issues, brief Configuration). Step-by-step setup, troubleshooting and full FAQ are deferred to the source-repo guide at https://trudenboy.github.io/ma-provider-yandex-alice/.
Related
Test plan
/plugins/yandex-alice/