[Hallmark] Rebalance the full player around History-first audiobook navigation #97

Open
opened 2026-09-27 13:48:49 +02:00 by alexander · 2 comments
Owner

Purpose

Refine the full player's action hierarchy around how the audiobook player is actually used.

Related audit: #47. This is a focused child issue for player interaction hierarchy, not playback-engine behavior.

Reviewed against current main at f9f7feba8e7bb499c6001bf0cc19a38357b7494a on 2026-09-27.

User priority

For navigation while listening:

  • History is used more than seeking back and forth through secondary navigation surfaces.
  • Bookmarks are rarely used.

The primary transport trio remains useful and should stay:

  • configured skip back;
  • Play/Pause;
  • configured skip forward.

The change is mainly to the secondary hierarchy.

Proposed hierarchy

Primary transport

Keep Back / Play-Pause / Forward centered and visually dominant.

Do not remove or weaken configured skip controls merely because History becomes more prominent.

Secondary actions

Promote:

  • History to the strongest secondary navigation action;
  • Sleep Timer;
  • Speed;
  • Chapters where chapter metadata exists.

Demote:

  • Bookmarks from equal permanent prominence.

Bookmarks must remain available, including Add Bookmark behavior, but may move behind a secondary overflow/sheet or another lower-priority path if that produces a clearer player.

Do not hide History behind a generic More action.

Text hierarchy

Prototype a more editorial metadata block:

  • book title;
  • author;
  • current chapter.

Evaluate left alignment for that text block while retaining centered transport controls. The intent is to separate reading information from mechanical controls, not to redesign the whole player.

Preserve the existing adaptive artwork behavior: at large text the artwork yields before controls become unusable, and wide windows retain the two-pane composition.

Seek controls

Keep both whole-book and chapter seeking because they answer different questions.

Improve distinction rather than removing either:

  • clearly identify whole-book position versus chapter position visually and semantically;
  • use tabular figures for clock labels;
  • preserve thin visual tracks with full touch targets.

Acceptance

  • History is immediately visible and clearly more discoverable than Bookmarks.
  • Bookmarks remain reachable without occupying equal permanent visual weight.
  • Primary skip/play controls remain direct and unchanged in behavior.
  • Whole-book and chapter seek remain distinct and accessible.
  • Layout survives 320/375/414/768dp, landscape/tablet and font scales through 2.0.
  • Preserve output chooser, notification/retry notices, playback loading/error behavior and sleep-timer countdown.
  • Validate TalkBack order, minimum targets, reduced motion, long titles/chapters and light/dark/AMOLED/background appearances.
  • Compare screenshots and device interaction before acceptance; this issue does not authorize playback-policy changes.
## Purpose Refine the full player's action hierarchy around how the audiobook player is actually used. Related audit: #47. This is a focused child issue for player interaction hierarchy, not playback-engine behavior. Reviewed against current `main` at `f9f7feba8e7bb499c6001bf0cc19a38357b7494a` on 2026-09-27. ## User priority For navigation while listening: - **History is used more than seeking back and forth through secondary navigation surfaces.** - Bookmarks are rarely used. The primary transport trio remains useful and should stay: - configured skip back; - Play/Pause; - configured skip forward. The change is mainly to the secondary hierarchy. ## Proposed hierarchy ### Primary transport Keep Back / Play-Pause / Forward centered and visually dominant. Do not remove or weaken configured skip controls merely because History becomes more prominent. ### Secondary actions Promote: - **History** to the strongest secondary navigation action; - **Sleep Timer**; - **Speed**; - **Chapters** where chapter metadata exists. Demote: - **Bookmarks** from equal permanent prominence. Bookmarks must remain available, including Add Bookmark behavior, but may move behind a secondary overflow/sheet or another lower-priority path if that produces a clearer player. Do not hide History behind a generic More action. ### Text hierarchy Prototype a more editorial metadata block: - book title; - author; - current chapter. Evaluate left alignment for that text block while retaining centered transport controls. The intent is to separate reading information from mechanical controls, not to redesign the whole player. Preserve the existing adaptive artwork behavior: at large text the artwork yields before controls become unusable, and wide windows retain the two-pane composition. ### Seek controls Keep both whole-book and chapter seeking because they answer different questions. Improve distinction rather than removing either: - clearly identify whole-book position versus chapter position visually and semantically; - use tabular figures for clock labels; - preserve thin visual tracks with full touch targets. ## Acceptance - History is immediately visible and clearly more discoverable than Bookmarks. - Bookmarks remain reachable without occupying equal permanent visual weight. - Primary skip/play controls remain direct and unchanged in behavior. - Whole-book and chapter seek remain distinct and accessible. - Layout survives 320/375/414/768dp, landscape/tablet and font scales through 2.0. - Preserve output chooser, notification/retry notices, playback loading/error behavior and sleep-timer countdown. - Validate TalkBack order, minimum targets, reduced motion, long titles/chapters and light/dark/AMOLED/background appearances. - Compare screenshots and device interaction before acceptance; this issue does not authorize playback-policy changes.
Author
Owner

Hallmark Slice 1 — design/readiness

Current main audit at 8ea2122fc3c1d32bcfc5f0eb295b3521be562ed4:

  • Primary skip/play/skip hierarchy is already strong and will be preserved.
  • Secondary row currently gives Speed, Chapters, History, Bookmarks and Sleep Timer equal permanent weight.
  • Book title/author/chapter are centered as one mechanical stack; dual book/chapter seek controls are functionally good but can be labelled more explicitly.

Slice change:

  • Keep primary transport unchanged in behavior.
  • Make History the first/strongest secondary action, then Sleep Timer, Speed and conditional Chapters.
  • Demote Bookmarks to a lower-priority overflow/action surface while preserving both bookmark list and add-bookmark access.
  • Prototype an editorial left-aligned metadata block where width permits; do not sacrifice narrow-width robustness.
  • Keep whole-book and chapter seeking separate and improve visual/semantic distinction with stable/tabular time treatment.

Preserved deliberately:

  • output chooser; loading/failure/retry; timer countdown; adaptive artwork; wide two-pane layout; modal sheets; transport semantics.

Expected files:

  • FullPlayer.kt
  • MainActivity.kt only for shared overlay/modal ownership
  • player strings
  • focused full-player/a11y tests
  • one shared player motion file if reused

Accessibility/responsive:

  • History remains directly discoverable; Bookmark remains reachable after demotion.
  • Controls retain minimum targets.
  • Validate long title/author/chapter and font scales 1.0/1.3/2.0 at 320/375/414/768dp.
## Hallmark Slice 1 — design/readiness Current `main` audit at `8ea2122fc3c1d32bcfc5f0eb295b3521be562ed4`: - Primary skip/play/skip hierarchy is already strong and will be preserved. - Secondary row currently gives Speed, Chapters, History, Bookmarks and Sleep Timer equal permanent weight. - Book title/author/chapter are centered as one mechanical stack; dual book/chapter seek controls are functionally good but can be labelled more explicitly. Slice change: - Keep primary transport unchanged in behavior. - Make History the first/strongest secondary action, then Sleep Timer, Speed and conditional Chapters. - Demote Bookmarks to a lower-priority overflow/action surface while preserving both bookmark list and add-bookmark access. - Prototype an editorial left-aligned metadata block where width permits; do not sacrifice narrow-width robustness. - Keep whole-book and chapter seeking separate and improve visual/semantic distinction with stable/tabular time treatment. Preserved deliberately: - output chooser; loading/failure/retry; timer countdown; adaptive artwork; wide two-pane layout; modal sheets; transport semantics. Expected files: - `FullPlayer.kt` - `MainActivity.kt` only for shared overlay/modal ownership - player strings - focused full-player/a11y tests - one shared player motion file if reused Accessibility/responsive: - History remains directly discoverable; Bookmark remains reachable after demotion. - Controls retain minimum targets. - Validate long title/author/chapter and font scales 1.0/1.3/2.0 at 320/375/414/768dp.
Author
Owner

Hallmark Slice 1 — implementation staged

Branch: mcp/hallmark-slice-1-player
Base: 8ea2122fc3c1d32bcfc5f0eb295b3521be562ed4
Current HEAD: f4f90f10a624e310cb87d6abe20482aea444bcb2

Implemented for #97:

  • primary skip / Play-Pause / skip transport remains unchanged in behavior and visually central;
  • secondary hierarchy is now History → Sleep Timer → Speed → Chapters when available;
  • History is the only filled/tonal secondary action and remains directly reachable;
  • Bookmarks and Add Bookmark remain supported from the top-bar More menu instead of occupying equal permanent weight;
  • title, author and current chapter now form a left-aligned editorial metadata block while transport stays centered;
  • whole-book and chapter seeking remain separate;
  • whole-book position now has explicit visible and TalkBack identity, while chapter progress retains its own chapter-specific semantics;
  • time figures use tabular numerals;
  • output chooser, failure/retry, loading, Sleep Timer and adaptive one/two-pane artwork behavior remain in place.

Focused full-player tests were extended for direct History, primary transport, bookmark reachability, conditional Chapters, distinct book/chapter semantics and the shared collapse action.

Verification note: these tests were written but intentionally not executed, and no visual/device matrix was run, per owner instruction.

## Hallmark Slice 1 — implementation staged Branch: `mcp/hallmark-slice-1-player` Base: `8ea2122fc3c1d32bcfc5f0eb295b3521be562ed4` Current HEAD: `f4f90f10a624e310cb87d6abe20482aea444bcb2` Implemented for #97: - primary skip / Play-Pause / skip transport remains unchanged in behavior and visually central; - secondary hierarchy is now History → Sleep Timer → Speed → Chapters when available; - History is the only filled/tonal secondary action and remains directly reachable; - Bookmarks and Add Bookmark remain supported from the top-bar More menu instead of occupying equal permanent weight; - title, author and current chapter now form a left-aligned editorial metadata block while transport stays centered; - whole-book and chapter seeking remain separate; - whole-book position now has explicit visible and TalkBack identity, while chapter progress retains its own chapter-specific semantics; - time figures use tabular numerals; - output chooser, failure/retry, loading, Sleep Timer and adaptive one/two-pane artwork behavior remain in place. Focused full-player tests were extended for direct History, primary transport, bookmark reachability, conditional Chapters, distinct book/chapter semantics and the shared collapse action. Verification note: these tests were written but intentionally not executed, and no visual/device matrix was run, per owner instruction.
Sign in to join this conversation.
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#97
No description provided.