- ym-api: like/unlike tracks, albums, artists and playlists; dislike
tracks; liked ids for drawing state; create, rename, publish/hide and
delete playlists; add, remove and move tracks (fresh revision per edit);
lyrics (LRC parsed, plain text fallback); server queues
- Hearts on every track row, the player bar and album, artist and
playlist pages, applied at once and re-read if Yandex refuses
- Track menu: Play next (moves a queued track up rather than duplicating
it; the playing track's menu offers Next track instead), Add to queue,
like, Add to playlist or a new one, Go to album/artist, Don't recommend,
and Move up/down/Remove on the user's own playlists
- New playlist from the sidebar; Rename, Make public/private and Delete
(confirmed) on own playlist pages; short status messages for every edit
- Lyrics panel highlights and follows the sung line and seeks on click
- Lists played are published as Yandex queues and their position kept
- lyricsInfo decides lyrics availability (the old flag over-reports)
- MUSYX_TRACE=1 logs user actions with the resulting queue
- Headless UI tests (iced_test) click through menus over the full window
- ym-api: album/artist/playlist summaries and pages, liked albums and
artists, own and liked playlists (batch-resolved from like ids),
playlist tracks with missing ones looked up, image download
- Cover cache: fetched when a cover nears the viewport (sensor), at most
eight at once, kept in memory and on disk; arrivals are batched every
150 ms so cached lists rebuild once per batch
- Collection tabs for liked tracks, albums, artists and playlists, each
loading on first visit with a retry on failure
- Album, Artist and Playlist routes with cover headers, Play/Shuffle and
track lists; pages cached per session; sidebar lists playlists
- Shared lazy track list keyed on contents, playing track, likes and
cover version; card grid that wraps
- ym-api: Track/Stream models, liked tracks, signed download URLs (full MP3
over AAC over previews, highest bitrate) and in-memory fetch
- Audio thread on rodio, driven by commands and reporting through an iced
subscription; generation ids drop stale events
- Opens the default output with a buffer clamped to the device's range:
rodio's 2048-frame default fails on Bluetooth headphones that cap at 1024
- Queue with shuffle, repeat off/all/one, back/advance and jump; player
state machine with prefetch of the next track, replay from memory, and
skipping unplayable tracks (stops after three in a row)
- Working player bar (seek, volume, mute, quality badge), queue drawer,
Collection screen with a lazily built liked-tracks list
- audio_probe example lists and test-opens output devices
- ym-api wraps yamuse: device-code flow, token refresh, account status,
and its own Error type that the UI acts on (expired, denied, network)
- Credentials live in the system keychain, never print their tokens, and
refresh when within a week of expiry; a rejected token is forgotten
- Sign-in screen with code, QR, copy/open-in-browser, countdown and a
pasted-token fallback; restoring/unreachable screens on startup
- Sidebar account chip and Settings account card with Plus status and
sign-out; Settings re-reads the account when opened
- Live device-code test behind --ignored
Two-crate workspace (ym-api for the API client, musyx for the iced app).
The app has the sidebar, top bar, Queue/Lyrics drawer and player bar from
the approved mockup, plus signed-out states for every screen.
- DESIGN.md records the mockup tokens; ui/theme.rs mirrors them for dark
and light, and the app follows the system appearance
- Bundles Onest/Unbounded (OFL) and Lucide 0.460 icons (ISC)
- Back-stack navigator, player bar toggles (shuffle, repeat, volume, mute)
- snapshot feature renders a screen to PNG via iced's window screenshot