- Media keys and Now Playing (souvlaki): title, artist, album, cover and
position published on track and state changes; play/pause/toggle,
next/previous and seeking from the OS controls
- Audio engine reopens the default output when the device changes or
disappears, reloading the current track at the same position; with no
device it keeps looking and resumes when one appears. Underruns are
ignored rather than treated as device loss
- Settings screen: streaming quality (Best, Balanced <=192 kbps, Data
saver <=128 kbps), appearance (system/light/dark), clear cover cache;
quality, appearance and volume persist as JSON in the config folder
- Bitrate cap chooses the best variant within it, or the smallest above
- Lyrics failures get a retry button
- App icon drawn by tool/make_icon.py; tool/bundle-macos.sh builds an
ad-hoc signed Musyx.app (--install copies it to /Applications)
- Release profile: thin LTO and stripped symbols
- 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: 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
- 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