Yuriy Panov 24aa41e8fb refactor: drop the dead REST play-queue sync
POST /queues answers every create with the placeholder id 000000000000000000000000
and GET /queues lists nothing, so publishing the queue never reached another
device. Remove create_queue/update_queue_position, QueueContext, the
QueueStarted/QueueMoved effects and the app's server_queue state.

Yandex's apps sync through Ynison instead, but Ynison answers this account
with 503 "temporary unavailable" (code 500140000) and the phone app offers no
device handoff, so there is no working replacement yet.
2026-10-15 21:55:24 +06:00
2026-10-15 18:15:27 +06:00

Musyx

A desktop player for Yandex Music, written in Rust with iced.

Musyx is an unofficial client. It talks to the same undocumented API the official apps use, and it isn't affiliated with or endorsed by Yandex.

Layout

  • crates/ym-api: the Yandex Music API client, with no UI dependencies.
  • crates/musyx: the iced app (screens, widgets, player, theme).
  • design/mockup.html: the approved design. DESIGN.md records its tokens.

Run

cargo run -p musyx

Sign-in

Musyx signs in with Yandex's device flow. It shows a code, you confirm it at the page Yandex names (or scan the QR code), and the app picks up the token on its own. You can also paste an existing OAuth token. The token is kept in the system keychain (service musyx, account yandex-music) and refreshed when it is within a week of expiring. Signing out deletes it.

Sign-in uses the public OAuth client id of the official Android app (through yamuse), because the music API doesn't accept third-party apps. On macOS an unsigned dev build may ask for keychain access again after each rebuild, because the keychain ties access to the binary's signature.

Install on macOS

tool/bundle-macos.sh --install

This builds a release Musyx.app into target/release/bundle/, signed with the Developer ID Application certificate of team H33L24BGUH and the hardened runtime. With --install, it also copies the app to /Applications. The icon comes from crates/musyx/assets/icon/musyx.png, which tool/make_icon.py draws. Set MUSYX_SIGN_IDENTITY to sign with another identity, or to - for an ad-hoc signature (each ad-hoc build is a new code identity, so macOS asks again for keychain access).

Settings

Settings (streaming quality, appearance, volume) are kept in ~/Library/Application Support/Musyx/settings.json. Covers are cached under ~/Library/Caches/Musyx/covers and can be cleared from Settings.

Streaming quality Lossless asks Yandex for FLAC (through the signed /get-file-info endpoint, decrypting its AES-CTR stream in memory). Yandex decides what to grant by subscription, region and track. When there's no FLAC, it answers with the best lossy file it allows, and Musyx plays that. The badge in the player bar shows what was actually served, and turns accent-coloured for FLAC.

Check

cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace

Snapshot mode renders one screen to a PNG through iced's own screenshot, so it needs no screen-recording permission:

MUSYX_SNAPSHOT=design/shots/home.png MUSYX_SNAPSHOT_ROUTE=home MUSYX_SNAPSHOT_THEME=dark \
  cargo run -p musyx --features snapshot

MUSYX_SNAPSHOT_ROUTE takes home, wave, search, collection, podcasts, settings, signin or artist:<id> (live runs only). Every route except signin renders with a sample signed-in account, so no network or keychain is needed. MUSYX_SNAPSHOT_DRAWER takes queue or lyrics. MUSYX_SNAPSHOT_THEME takes light or dark. MUSYX_SNAPSHOT_LIVE=1 signs in with the account stored in the keychain instead of using sample data. Set MUSYX_SNAPSHOT_DELAY (ms) to wait longer for slow pages.

cargo run -p musyx --example api_probe calls the discovery endpoints with the stored account (read-only) and prints what came back.

Tracing

MUSYX_TRACE=1 cargo run -p musyx logs each user action (not playback ticks or cover loads) to stderr, followed by what's playing and the next three tracks.

Audio

cargo run -p musyx --example audio_probe lists the output devices and checks that each one opens. Use it when the player bar says no sound output was found.

cargo run -p musyx --example stream_probe -- "artist title" asks for the lossless stream of the first search hit with the stored account (read-only). It downloads and decrypts the file, and prints the codec Yandex granted plus the decoded sample rate.

Licences

Musyx is MIT. Onest and Unbounded are OFL (crates/musyx/assets/fonts), and Lucide icons are ISC (crates/musyx/assets/icons/LICENSE.txt).

S
Description
Yandex Music Custom player
Readme MIT
2 MiB
0 Stars 1 Watchers 0 Forks
Musyx 0.4.0
Latest
2026-11-16 12:26:09 +06:00
Languages
Rust 90.4%
HTML 7.6%
Shell 1.4%
Python 0.4%
PowerShell 0.2%