Files
musyx/README.md
T
Yuriy Panov e7726aac3a feat: search, home landing, chart, genres and podcasts
- ym-api: search by kind with paging and best match, suggestions, landing
  (personal playlists, new releases and playlists) plus the full chart
  with movement, genres, tag playlists and featured podcasts
- Tag playlist ids are parsed from raw JSON: yamuse types them as strings
  but the API sends {uid, kind} objects
- Featured podcasts capped at 48 (the API lists thousands)
- Search screen: debounced suggestions floating under the field, tabs with
  totals, top result card, Show more paging, genre browsing when empty
- Home with personal playlists, top-10 chart, new releases and playlists,
  genre tiles; Chart page; Genre pages with sub-genres; Podcasts page
- Chart lists show position movement; top-N lists are built once so
  cached rows survive playback ticks
- Snapshot mode can sign in live; api_probe example for discovery calls
2026-10-15 15:04:37 +06:00

2.4 KiB

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.

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 or signin. 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.

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.

Licences

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