[BW-QS-01] Add configurable BookWave Quick Settings tile #27

Open
opened 2026-09-18 08:46:56 +02:00 by alexander · 0 comments
Owner

Migrated from GitHub issue #118. Forgejo issue: #27. GitHub source content synchronized on 2026-09-19. Migrated issue references below use Forgejo numbers where an equivalent issue exists; historical references without a Forgejo counterpart remain explicit GitHub links.

Classification

Planned Android platform feature. Blocked on #23.

Product intent

Provide a fast BookWave action in Android Quick Settings even when the media carousel is not currently showing BookWave.

One configurable BookWave tile whose primary mode is Continue / Pause:

  • no active BookWave playback -> Continue locally remembered audiobook;
  • BookWave playing -> Pause;
  • BookWave paused -> Play/Continue.

A later configuration may allow the same tile slot to run another safe #23 action such as Start Sleep Timer, but v1 should stay simple.

Why this is separate from Android media controls

Android already surfaces MediaSession controls near Quick Settings. This tile is useful as a stable, always-addressable BookWave command rather than another copy of the full media player.

Scope

  • Implement TileService using the shared #23 semantic action contract.
  • Keep tile label/icon/state truthful enough to distinguish Continue vs Pause/Play.
  • Tap executes the configured action.
  • Long press/open-app behavior leads to BookWave settings/player as appropriate.
  • Provide an in-app explanation/configuration surface if more than one action becomes supported.

Explicitly out of scope

  • No independent player control logic in TileService.
  • No full mini-player inside Quick Settings.
  • No download tile in v1.
  • No sleep-timer behavior implementation; the tile may bind to it later once the sleep feature exists.

Dependencies

  • #23 BW-SYS-01.
  • #24/GitHub #93 indirectly for ContinueListening semantics.

Platform constraints

Use current TileService APIs. On modern Android, launching UI from a tile must follow current PendingIntent/background-start requirements rather than relying on deprecated direct activity-start behavior.

Privacy / security

Tile state must not display book title/author/cover on the lock screen or Quick Settings. Generic BookWave, Playing, Paused, Continue state is sufficient.

Automated tests

  • tile state projection from playback/remembered state;
  • tap maps to exactly one #23 action;
  • locked profile behavior;
  • no remembered book safe no-op/open behavior;
  • process cold-start.

Device acceptance

Samsung and AOSP/Pixel-style Quick Settings:

  • add tile;
  • Continue from stopped state;
  • pause/play;
  • screen locked;
  • process killed;
  • profile switch.

Estimated effort

Small to Medium.

Risk

Low-Medium.

Sequence

After #23. Can ship independently of widget/Garmin.

Acceptance criteria

  • Tile remains useful even when BookWave is not in the media carousel.
  • It never contains separate resume logic.
  • Locked-screen presentation is metadata-free.
  • Modern Android tile launch restrictions are respected.
> Migrated from [GitHub issue #118](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/issues/118). Forgejo issue: #27. GitHub source content synchronized on 2026-09-19. Migrated issue references below use Forgejo numbers where an equivalent issue exists; historical references without a Forgejo counterpart remain explicit GitHub links. ## Classification Planned Android platform feature. Blocked on #23. ## Product intent Provide a fast BookWave action in Android Quick Settings even when the media carousel is not currently showing BookWave. ## Recommended v1 One configurable BookWave tile whose primary mode is **Continue / Pause**: - no active BookWave playback -> Continue locally remembered audiobook; - BookWave playing -> Pause; - BookWave paused -> Play/Continue. A later configuration may allow the same tile slot to run another safe #23 action such as Start Sleep Timer, but v1 should stay simple. ## Why this is separate from Android media controls Android already surfaces MediaSession controls near Quick Settings. This tile is useful as a stable, always-addressable BookWave command rather than another copy of the full media player. ## Scope - Implement `TileService` using the shared #23 semantic action contract. - Keep tile label/icon/state truthful enough to distinguish Continue vs Pause/Play. - Tap executes the configured action. - Long press/open-app behavior leads to BookWave settings/player as appropriate. - Provide an in-app explanation/configuration surface if more than one action becomes supported. ## Explicitly out of scope - No independent player control logic in TileService. - No full mini-player inside Quick Settings. - No download tile in v1. - No sleep-timer behavior implementation; the tile may bind to it later once the sleep feature exists. ## Dependencies - #23 BW-SYS-01. - #24/[GitHub #93](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/issues/93) indirectly for `ContinueListening` semantics. ## Platform constraints Use current `TileService` APIs. On modern Android, launching UI from a tile must follow current PendingIntent/background-start requirements rather than relying on deprecated direct activity-start behavior. ## Privacy / security Tile state must not display book title/author/cover on the lock screen or Quick Settings. Generic `BookWave`, `Playing`, `Paused`, `Continue` state is sufficient. ## Automated tests - tile state projection from playback/remembered state; - tap maps to exactly one #23 action; - locked profile behavior; - no remembered book safe no-op/open behavior; - process cold-start. ## Device acceptance Samsung and AOSP/Pixel-style Quick Settings: - add tile; - Continue from stopped state; - pause/play; - screen locked; - process killed; - profile switch. ## Estimated effort Small to Medium. ## Risk Low-Medium. ## Sequence After #23. Can ship independently of widget/Garmin. ## Acceptance criteria - Tile remains useful even when BookWave is not in the media carousel. - It never contains separate resume logic. - Locked-screen presentation is metadata-free. - Modern Android tile launch restrictions are respected.
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#27
No description provided.