- ym-api: stations, station settings (mood/character/language), track
batches, rotor feedback (started, track started/finished, skip) and
play-audio reports
- Play reports send millisecond ISO timestamps: yamuse's default drops
the milliseconds and /play-audio rejects it
- Player: station mode tops up the queue when two tracks remain, waits
instead of ending when a batch runs dry, ignores shuffle and batches
from other stations, and reports every track left (finished or
skipped with time played); feedback names the batch each track came in
- Queue can grow (radio batches) and drop upcoming items (new settings)
- My Wave screen with settings chips and station tiles; Home and My Wave
hero draws drifting lines on a canvas, animated only while My Wave plays
- Genre pages get a Play radio button
- 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: 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