Redesign Android Auto home with artwork and profiles #71

Merged
alexander merged 75 commits from mcp/issue-65-auto-home-profiles-artwork into main 2026-09-20 21:15:12 +02:00
Owner

Implements #65 / PD-001.

Scope

  • replaces the Android Auto browse root with exactly Continue → Series → Authors → Profiles;
  • removes Library, History, Chapters and Audio output as reachable browse destinations while retaining their old ids only for stale-host eviction;
  • orders Series by most recent profile-scoped progress activity, then alphabetical fallback, while preserving LIB-003 book sequence order;
  • adds book/Series/Author artwork through opaque profile-bound content URIs backed by the existing authenticated Coil cache;
  • adds Profiles as a real browse destination with active/locked/sign-in presentation;
  • uses Media3 media-item command buttons for profile selection and delegates switching to the existing SwitchProfileUseCase / RestoreProfilePlaybackUseCase owners;
  • extends the merged #10 snapshot adapter rather than creating a second browse invalidation mechanism.

Security / privacy

  • Android Auto artwork URIs contain no server URL, item id, token or reusable credential;
  • the exported artwork provider is read-only/capability-only and refuses a capability after its originating profile is no longer active;
  • locked profile selection is still rejected by ProfileActivationGuard inside SwitchProfileUseCase; Android Auto never receives a credential-entry surface;
  • retired profile-scoped browse ids are invalidated with zero children on a hard profile boundary.

Existing behavior intentionally unchanged

No changes are intended to #34 car-selected state, #35 Queue suppression, #36 headset/car continuity, route-heard ownership, media-button layout, notification controls or sleep scheduling.

Verification

Focused tests have been added/updated for:

  • exact root shape and retired destinations;
  • Series recency, ties, alphabetical fallback and LIB-003 child order;
  • same-membership reorder invalidation;
  • Profiles presentation invalidation and profile media ids;
  • prior-profile static/dynamic eviction;
  • opaque artwork capabilities and missing-art fallback.

The authoritative Forgejo PR workflow will be dispatched for this PR and any failures fixed before it is reported ready. Physical Android Auto acceptance remains required for host rendering/command-button behavior.

Implements #65 / PD-001. ## Scope - replaces the Android Auto browse root with exactly Continue → Series → Authors → Profiles; - removes Library, History, Chapters and Audio output as reachable browse destinations while retaining their old ids only for stale-host eviction; - orders Series by most recent profile-scoped progress activity, then alphabetical fallback, while preserving LIB-003 book sequence order; - adds book/Series/Author artwork through opaque profile-bound content URIs backed by the existing authenticated Coil cache; - adds Profiles as a real browse destination with active/locked/sign-in presentation; - uses Media3 media-item command buttons for profile selection and delegates switching to the existing SwitchProfileUseCase / RestoreProfilePlaybackUseCase owners; - extends the merged #10 snapshot adapter rather than creating a second browse invalidation mechanism. ## Security / privacy - Android Auto artwork URIs contain no server URL, item id, token or reusable credential; - the exported artwork provider is read-only/capability-only and refuses a capability after its originating profile is no longer active; - locked profile selection is still rejected by ProfileActivationGuard inside SwitchProfileUseCase; Android Auto never receives a credential-entry surface; - retired profile-scoped browse ids are invalidated with zero children on a hard profile boundary. ## Existing behavior intentionally unchanged No changes are intended to #34 car-selected state, #35 Queue suppression, #36 headset/car continuity, route-heard ownership, media-button layout, notification controls or sleep scheduling. ## Verification Focused tests have been added/updated for: - exact root shape and retired destinations; - Series recency, ties, alphabetical fallback and LIB-003 child order; - same-membership reorder invalidation; - Profiles presentation invalidation and profile media ids; - prior-profile static/dynamic eviction; - opaque artwork capabilities and missing-art fallback. The authoritative Forgejo PR workflow will be dispatched for this PR and any failures fixed before it is reported ready. Physical Android Auto acceptance remains required for host rendering/command-button behavior.
alexander force-pushed mcp/issue-65-auto-home-profiles-artwork from 156e23c9d4 to 4136c27b72 2026-09-20 13:26:14 +02:00 Compare
alexander deleted branch mcp/issue-65-auto-home-profiles-artwork 2026-09-20 21:15:12 +02:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
alexander/Audiobookshelf-Manager-Claude!71
No description provided.