Player: hide the mouse pointer when it is not moving #240

Closed
opened 2026-11-15 17:39:33 +00:00 by vivy · 1 comment
Owner

Requested by the product owner on the test client (GRI-2051, 2026-11-15 17:37 UTC): "make the mouse hidden when nobody is moving the mouse. This is so we can take control if needed, but don't get bothered by the mouse on the screen when not in active use."

Today

The player (gtk-renderer, crates/client/src/renderer/) sets no cursor at all, so the GTK default arrow stays on top of the content for as long as the pointer is on the screen.

Wanted

  • The player window hides the pointer after N seconds without pointer movement (default 3 s). It comes back at once on the next movement, click or key press. Then it hides again after the same wait.
  • This covers every content kind: image, video (gtksink) and web (WebKit). A web page must not show its own cursor again under the player.
  • N comes from client.toml (for example [display] hide_cursor_after_secs = 3). An environment variable can override it. 0 means never hide. No hard-coded value (GRI-1884).
  • It is done inside the player, without unclutter or another extra package. Then it works the same on every install path.

Done when

  • On the test client, the pointer disappears after the configured wait and comes back when the mouse moves, over each content kind.
  • A test covers the idle timer (move → visible, wait → hidden, move → visible).
Requested by the product owner on the test client (GRI-2051, 2026-11-15 17:37 UTC): *"make the mouse hidden when nobody is moving the mouse. This is so we can take control if needed, but don't get bothered by the mouse on the screen when not in active use."* ## Today The player (`gtk-renderer`, `crates/client/src/renderer/`) sets no cursor at all, so the GTK default arrow stays on top of the content for as long as the pointer is on the screen. ## Wanted - The player window hides the pointer after N seconds without pointer movement (default 3 s). It comes back at once on the next movement, click or key press. Then it hides again after the same wait. - This covers every content kind: image, video (`gtksink`) and web (WebKit). A web page must not show its own cursor again under the player. - N comes from `client.toml` (for example `[display] hide_cursor_after_secs = 3`). An environment variable can override it. `0` means never hide. No hard-coded value (GRI-1884). - It is done inside the player, without `unclutter` or another extra package. Then it works the same on every install path. ## Done when - On the test client, the pointer disappears after the configured wait and comes back when the mouse moves, over each content kind. - A test covers the idle timer (move → visible, wait → hidden, move → visible).
Author
Owner

In dev: #259 (8815968). Closing.

In dev: #259 (8815968). Closing.
vivy closed this issue 2026-11-15 23:16:01 +00:00
Sign in to join this conversation.
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
Grimoirix/grimoire-of-digital-signage#240
No description provided.