[Hallmark] Simplify mini-player around Sleep Timer and Play/Pause #96

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

Purpose

Make the compact player reflect actual high-frequency use instead of compressing five transport controls into a narrow strip.

Child of the player audit in #47. This issue narrows and supersedes #47's earlier generic compact-player suggestion for the mini-player layout.

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

User priority

For the mini-player, Sleep Timer is used more often than Back/Forward seeking.

The compact surface should therefore prioritize:

  1. book identity / opening the full player;
  2. Sleep Timer;
  3. Play/Pause.

Back/Forward and Stop do not need permanent compact-player buttons.

Proposed compact composition

Primary row:

cover | title + author | sleep | play/pause

  • Keep tapping the artwork/title region as the explicit action to open the full player.
  • Keep Sleep Timer visible as a dedicated control.
  • When the timer is active, show the authoritative remaining countdown in that control rather than an unrelated icon.
  • Make Play/Pause the strongest transport action in the mini-player.
  • Remove permanent Back, Forward and Stop buttons from the compact row.
  • Back/Forward remain available in the full player and through configured media/headset controls.
  • Stop may live in the full player or another secondary action surface; do not use a close glyph in the mini-player if it can be mistaken for merely dismissing the bar.

Progress and text

  • Keep a thin whole-book progress indicator.
  • Do not reserve separate permanent elapsed/remaining clock labels if they compete with title legibility.
  • Keep the title readable; marquee only when needed.
  • Prefer static/ellipsized author text rather than two independently moving lines.
  • Use tabular figures for the sleep countdown and any clock that remains.
  • Preserve full title/author accessibility semantics.

Motion

Replace the current Spring.DampingRatioMediumBouncy entrance with a restrained non-bouncy transition consistent with BookWave's calm glass UI.

Reduced-motion behavior must not depend on spatial animation.

Layout and accessibility

  • Preserve at least 48dp interactive targets.
  • Preserve the existing measured player-clearance contract and system-navigation handling.
  • The bar must remain compact at font scales 1.0 / 1.3 / 2.0 rather than growing because controls were removed.
  • No title/action overlap at 320 / 375 / 414 dp.
  • Opening the full player and both controls remain separate TalkBack nodes.
  • Timer active/inactive states have explicit spoken labels.

Acceptance

  • Sleep Timer and Play/Pause are immediately reachable without opening the full player.
  • Back, Forward and Stop no longer consume permanent mini-player width.
  • Active timer countdown is visible and stable.
  • Long book titles retain materially more usable width than the current five-control layout.
  • No regression to mini-player overlay clearance, notification/media controls or full-player transport.
  • Verify light/dark/AMOLED/background packs, active/paused/loading playback, timer idle/active/grace states, large text, TalkBack and reduced motion.
  • Compare rendered screenshots against the current mini-player at 320/375/414dp before acceptance.
## Purpose Make the compact player reflect actual high-frequency use instead of compressing five transport controls into a narrow strip. Child of the player audit in #47. This issue narrows and supersedes #47's earlier generic compact-player suggestion for the mini-player layout. Reviewed against current `main` at `f9f7feba8e7bb499c6001bf0cc19a38357b7494a` on 2026-09-27. ## User priority For the mini-player, **Sleep Timer is used more often than Back/Forward seeking**. The compact surface should therefore prioritize: 1. book identity / opening the full player; 2. Sleep Timer; 3. Play/Pause. Back/Forward and Stop do not need permanent compact-player buttons. ## Proposed compact composition Primary row: `cover | title + author | sleep | play/pause` - Keep tapping the artwork/title region as the explicit action to open the full player. - Keep Sleep Timer visible as a dedicated control. - When the timer is active, show the authoritative remaining countdown in that control rather than an unrelated icon. - Make Play/Pause the strongest transport action in the mini-player. - Remove permanent Back, Forward and Stop buttons from the compact row. - Back/Forward remain available in the full player and through configured media/headset controls. - Stop may live in the full player or another secondary action surface; do not use a close glyph in the mini-player if it can be mistaken for merely dismissing the bar. ## Progress and text - Keep a thin whole-book progress indicator. - Do not reserve separate permanent elapsed/remaining clock labels if they compete with title legibility. - Keep the title readable; marquee only when needed. - Prefer static/ellipsized author text rather than two independently moving lines. - Use tabular figures for the sleep countdown and any clock that remains. - Preserve full title/author accessibility semantics. ## Motion Replace the current `Spring.DampingRatioMediumBouncy` entrance with a restrained non-bouncy transition consistent with BookWave's calm glass UI. Reduced-motion behavior must not depend on spatial animation. ## Layout and accessibility - Preserve at least 48dp interactive targets. - Preserve the existing measured player-clearance contract and system-navigation handling. - The bar must remain compact at font scales 1.0 / 1.3 / 2.0 rather than growing because controls were removed. - No title/action overlap at 320 / 375 / 414 dp. - Opening the full player and both controls remain separate TalkBack nodes. - Timer active/inactive states have explicit spoken labels. ## Acceptance - Sleep Timer and Play/Pause are immediately reachable without opening the full player. - Back, Forward and Stop no longer consume permanent mini-player width. - Active timer countdown is visible and stable. - Long book titles retain materially more usable width than the current five-control layout. - No regression to mini-player overlay clearance, notification/media controls or full-player transport. - Verify light/dark/AMOLED/background packs, active/paused/loading playback, timer idle/active/grace states, large text, TalkBack and reduced motion. - Compare rendered screenshots against the current mini-player at 320/375/414dp before acceptance.
Author
Owner

Hallmark Slice 1 — design/readiness

Current main audit at 8ea2122fc3c1d32bcfc5f0eb295b3521be562ed4:

  • Mini player currently carries Back, Sleep, Play/Pause, Forward and Stop as five permanent 48dp controls, plus elapsed/remaining labels. That compresses the identity region and gives low-priority transport equal weight.
  • Title and author both marquee, creating competing motion.
  • Entry still uses DampingRatioMediumBouncy.

Slice change:

  • Recompose to cover | title + author | sleep | play/pause.
  • Remove permanent Back/Forward/Stop and elapsed/remaining clock labels; retain the thin whole-book progress track.
  • Title may marquee only when needed; author becomes static/ellipsized.
  • Active Sleep Timer continues to project the authoritative SleepTimerState.remaining; no Compose-owned timer state.
  • Play/Pause remains direct and visually strongest among compact transport actions.

Preserved deliberately:

  • Existing glass/backdrop treatment, measured clearance contract, system-navigation inset behavior, artwork/loading behavior, live playback ownership and timer ownership.

Expected files:

  • MiniPlayer.kt
  • focused mini-player/a11y tests
  • player strings only if semantics need a new label
  • shared player motion primitive only if reused by mini/full player

Accessibility/responsive:

  • Keep separate TalkBack nodes for identity/open, Sleep Timer and Play/Pause.
  • Keep >=48dp targets.
  • Stress 320/375/414dp and font scales through 2.0; metadata remains fully exposed semantically even when visually ellipsized.

Motion:

  • Non-bouncy semantic player motion; no decorative exit flourish during full-player expansion.
## Hallmark Slice 1 — design/readiness Current `main` audit at `8ea2122fc3c1d32bcfc5f0eb295b3521be562ed4`: - Mini player currently carries Back, Sleep, Play/Pause, Forward and Stop as five permanent 48dp controls, plus elapsed/remaining labels. That compresses the identity region and gives low-priority transport equal weight. - Title and author both marquee, creating competing motion. - Entry still uses `DampingRatioMediumBouncy`. Slice change: - Recompose to `cover | title + author | sleep | play/pause`. - Remove permanent Back/Forward/Stop and elapsed/remaining clock labels; retain the thin whole-book progress track. - Title may marquee only when needed; author becomes static/ellipsized. - Active Sleep Timer continues to project the authoritative `SleepTimerState.remaining`; no Compose-owned timer state. - Play/Pause remains direct and visually strongest among compact transport actions. Preserved deliberately: - Existing glass/backdrop treatment, measured clearance contract, system-navigation inset behavior, artwork/loading behavior, live playback ownership and timer ownership. Expected files: - `MiniPlayer.kt` - focused mini-player/a11y tests - player strings only if semantics need a new label - shared player motion primitive only if reused by mini/full player Accessibility/responsive: - Keep separate TalkBack nodes for identity/open, Sleep Timer and Play/Pause. - Keep >=48dp targets. - Stress 320/375/414dp and font scales through 2.0; metadata remains fully exposed semantically even when visually ellipsized. Motion: - Non-bouncy semantic player motion; no decorative exit flourish during full-player expansion.
Author
Owner

Hallmark Slice 1 — implementation staged

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

Implemented for #96:

  • compact composition is now cover | title + author | sleep | play/pause;
  • permanent Back, Forward and Stop controls are removed from the mini player;
  • permanent elapsed/remaining clock labels are removed; the thin whole-book progress indicator remains;
  • title keeps conditional marquee behavior; author is static/ellipsized, so there are no competing marquees;
  • Sleep Timer still reads the authoritative SleepTimerState; active countdown uses tabular figures and explicit TalkBack text;
  • Play/Pause is now the strongest compact action with a primary filled treatment and preserves loading/playing/paused semantics;
  • mini-player entry/exit no longer uses a bouncy spring.

Focused mini-player and accessibility tests were updated to protect the reduced control set, expand action, timer semantics and direct Play/Pause behavior.

Verification note: no automated checks, Forgejo Actions or APK workflow were started, per owner instruction. Width/font-scale/device evidence therefore remains pending physical acceptance.

## Hallmark Slice 1 — implementation staged Branch: `mcp/hallmark-slice-1-player` Base: `8ea2122fc3c1d32bcfc5f0eb295b3521be562ed4` Current HEAD: `f4f90f10a624e310cb87d6abe20482aea444bcb2` Implemented for #96: - compact composition is now `cover | title + author | sleep | play/pause`; - permanent Back, Forward and Stop controls are removed from the mini player; - permanent elapsed/remaining clock labels are removed; the thin whole-book progress indicator remains; - title keeps conditional marquee behavior; author is static/ellipsized, so there are no competing marquees; - Sleep Timer still reads the authoritative `SleepTimerState`; active countdown uses tabular figures and explicit TalkBack text; - Play/Pause is now the strongest compact action with a primary filled treatment and preserves loading/playing/paused semantics; - mini-player entry/exit no longer uses a bouncy spring. Focused mini-player and accessibility tests were updated to protect the reduced control set, expand action, timer semantics and direct Play/Pause behavior. Verification note: no automated checks, Forgejo Actions or APK workflow were started, per owner instruction. Width/font-scale/device evidence therefore remains pending physical acceptance.
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#96
No description provided.