- label and document the YouTube Music search source - allow up to 60s for a search and request ten results - keep refreshing a new mood until its first recommendations arrive
3.2 KiB
3.2 KiB
Mood-first redesign — client notes
The canonical design and decision log lives in the server repo:
- local:
/home/taptap/AudioManager/docs/design/mood-first.md - web: https://gitea.tap-tap.win/TapTap/AudioManager/src/branch/main/docs/design/mood-first.md
Read that first. This file only records the client-side consequences.
What the client becomes
- Moods are the only content model. No Library, no Longform, no mounted music.
- All music is downloaded on the server from YouTube Music; the client searches and adds songs to a mood.
- A mood has songs (collection) and recommendations (auto-downloaded, playable in radio, not permanent until added).
- Playback mixes collection and ready recommendations using
collectionPercent. - A mood needs at least one song to play.
Screens
Moods | MoodDetail | Search | Downloads | Settings
- Moods: mood list, create, global search.
- MoodDetail: songs, add music, recommendations (Add / Not interested / Retry), next batch, mood settings (query, genres, collectionPercent, recommendationCount 0–30, refreshHours).
- Search: remote YouTube Music search, results over 10 minutes hidden, add to the current or a chosen mood, already-downloaded/in-mood badges, paste URL.
- Downloads: device-side offline files, delete/clear, storage usage.
- Settings: server/account/devices/logout (no scan UI).
Remove LibraryScreen and all longform UI.
State/API changes
- Remove
library,longform,longformResults,longformProgress,musicResults, localsearchResults,playAll,playLongform*,resumeLongform, longform progress reporting. - Add remote search state (
searchResults,searchTargetMoodId), add/remove song, recommendation add/reject/retry, mood song counts. CachedStatebecomes version 2 with moods + mood details only; invalidate old caches.SongDtogainsvideoIdandthumbnail; loses folder/album-id/path/genres.- Cover art is song-keyed:
coverUrl(songId). - Playback snapshot/history, desktop seek, Android media session, sleep timer and device downloads remain.
- Offline mood playback uses device downloads and cached mood details.
Implementation status (2026-11-15)
Implemented. Concretely:
Models.ktreflects the mood-first DTOs:Song(videoId, thumbnail),Mood(collectionPercent, recommendationCount, song counts),MoodSong,Recommendation(song, download),SearchResult.ApiClientuses/moods/{id}/songs,/search, recommendationadd|reject|retry, and/songs/{id}/cover.AppCache(version 2) stores moods and details only; old cache shapes are discarded. Session and playback snapshots are kept.AppStorehasMoods | MoodDetail | Search | Downloads | Settings, remote YouTube Music search with a target mood, add/remove song, recommendation actions, offline playback from device downloads, and no longform/library paths.- The UI has a dedicated Search screen (mood picker, paste URL, downloaded badges) and a Downloads screen. Mood Detail shows songs, add music, recommendation states and the new options. The player keeps queue editing, previous/seek and the sleep timer.
- Device downloads store covers by song id (
<songId>.jpg).