GRI-1855: client .deb with full-screen XDG autostart #81

Merged
vivy merged 1 commit from feature/GRI-1855-client-deb-autostart into dev 2026-11-09 18:33:48 +00:00
Member

What

Packages the client as a .deb for x86_64 Ubuntu Desktop that starts full
screen at login (forge #27).

  • scripts/package-client-deb.sh builds crates/client's renderer_spike
    binary (--features gtk-renderer --release) and assembles
    grimoirix-signage-client_<version>_<arch>.deb.
  • packaging/client-deb/autostart/grimoirix-signage-client.desktop is
    installed to /etc/xdg/autostart/, so any desktop session on the device
    starts the client automatically.
  • Runtime Depends are computed by dpkg-shlibdeps against the actual
    shared libraries the binary links on the build host, not hand-typed, so a
    distro package rename (Ubuntu 24.04's libgtk-3-0 → libgtk-3-0t64, for
    one) can't drift out of sync with a guess written here. GStreamer plugin
    packages (gst-plugins-{base,good,ugly}, gst-libav, gst-gtk3) are
    added by hand, since dpkg-shlibdeps only sees linked libraries and these
    are loaded by element name at run time.
  • crates/client/src/bin/renderer_spike.rs now fullscreens its window by
    default, since this binary is what the packaged .deb autostarts on the
    signage display. GRIMOIRIX_RENDERER_WINDOWED=1 keeps the windowed
    developer-measurement workflow the file's own doc comment describes.
  • plan/operations/deployment.md names the script and its known gaps
    (no aarch64 build yet, still packages the Phase 0 spike rather than a
    Phase 1 client).

Verified on this build host (Ubuntu 24.04, amd64)

  • ./scripts/package-client-deb.sh builds the binary and the .deb; dpkg-deb -c shows the expected usr/bin/grimoirix-signage-client and
    etc/xdg/autostart/grimoirix-signage-client.desktop layout with correct
    permissions.
  • dpkg-deb --info shows the computed Depends line.
  • The built binary runs under xvfb-run end to end: GTK/GStreamer/WebKit
    all initialise, it cycles through the image, video and web stages
    fullscreen, and exits cleanly (fullscreen has no effect on the headless
    xvfb size, but the call itself does not error).
  • cargo fmt --check and cargo clippy -p client --features gtk-renderer -D warnings are clean on the changed file.
  • ./scripts/local-gates.sh (every gate CI runs) passes.

Not verified here, and still owed

The issue's own "done when" — install the .deb on a real mini PC, reboot,
and the client is on screen — needs actual kiosk hardware with a display
and a login session. This build host has neither a GPU nor a display
manager. That test still has to happen on a real device before this is
called fully done; this PR gets the packaging mechanism to the point where
that test is the only thing left.

Next

Forge #26
(server systemd unit or container) is next on GRI-1855.

## What Packages the client as a `.deb` for x86_64 Ubuntu Desktop that starts full screen at login (forge [#27](https://git.grimoirix.org/Grimoirix/grimoire-of-digital-signage/issues/27)). - `scripts/package-client-deb.sh` builds `crates/client`'s `renderer_spike` binary (`--features gtk-renderer --release`) and assembles `grimoirix-signage-client_<version>_<arch>.deb`. - `packaging/client-deb/autostart/grimoirix-signage-client.desktop` is installed to `/etc/xdg/autostart/`, so any desktop session on the device starts the client automatically. - Runtime `Depends` are computed by `dpkg-shlibdeps` against the actual shared libraries the binary links on the build host, not hand-typed, so a distro package rename (Ubuntu 24.04's `libgtk-3-0` → `libgtk-3-0t64`, for one) can't drift out of sync with a guess written here. GStreamer plugin packages (`gst-plugins-{base,good,ugly}`, `gst-libav`, `gst-gtk3`) are added by hand, since `dpkg-shlibdeps` only sees linked libraries and these are loaded by element name at run time. - `crates/client/src/bin/renderer_spike.rs` now fullscreens its window by default, since this binary is what the packaged `.deb` autostarts on the signage display. `GRIMOIRIX_RENDERER_WINDOWED=1` keeps the windowed developer-measurement workflow the file's own doc comment describes. - `plan/operations/deployment.md` names the script and its known gaps (no aarch64 build yet, still packages the Phase 0 spike rather than a Phase 1 client). ## Verified on this build host (Ubuntu 24.04, amd64) - `./scripts/package-client-deb.sh` builds the binary and the `.deb`; `dpkg-deb -c` shows the expected `usr/bin/grimoirix-signage-client` and `etc/xdg/autostart/grimoirix-signage-client.desktop` layout with correct permissions. - `dpkg-deb --info` shows the computed `Depends` line. - The built binary runs under `xvfb-run` end to end: GTK/GStreamer/WebKit all initialise, it cycles through the image, video and web stages fullscreen, and exits cleanly (fullscreen has no effect on the headless `xvfb` size, but the call itself does not error). - `cargo fmt --check` and `cargo clippy -p client --features gtk-renderer -D warnings` are clean on the changed file. - `./scripts/local-gates.sh` (every gate CI runs) passes. ## Not verified here, and still owed The issue's own "done when" — install the `.deb` on a real mini PC, reboot, and the client is on screen — needs actual kiosk hardware with a display and a login session. This build host has neither a GPU nor a display manager. That test still has to happen on a real device before this is called fully done; this PR gets the packaging mechanism to the point where that test is the only thing left. ## Next Forge [#26](https://git.grimoirix.org/Grimoirix/grimoire-of-digital-signage/issues/26) (server systemd unit or container) is next on [GRI-1855](/GRI/issues/GRI-1855).
GRI-1855: package the client as a .deb with full-screen XDG autostart
Some checks failed
CI / the pre-push hook (pull_request) Successful in 15s
CI / cargo fmt (pull_request) Successful in 5s
CI / cargo deny (pull_request) Successful in 54s
CI / cargo deny advisories (pull_request) Failing after 43s
CI / repository boundary (pull_request) Successful in 5s
CI / cargo clippy (pull_request) Successful in 9m39s
CI / cargo test (pull_request) Successful in 9m43s
CI / frontend-web (pull_request) Successful in 9m42s
CI / CI (pull_request) Successful in 5s
CI / Notify gate failed (pull_request) Has been skipped
d0b8fd05e1
scripts/package-client-deb.sh builds the renderer_spike binary, computes
its runtime Depends with dpkg-shlibdeps against this build host instead of
a hand-typed guess, and assembles grimoirix-signage-client_<version>_<arch>.deb
with an /etc/xdg/autostart entry that starts it full screen at login.

The spike fullscreens its window by default now (opt out with
GRIMOIRIX_RENDERER_WINDOWED for the existing developer workflow), since it
is what the packaged .deb autostarts on a signage display.
vivy merged commit 67f559dd26 into dev 2026-11-09 18:33:48 +00:00
vivy deleted branch feature/GRI-1855-client-deb-autostart 2026-11-09 18:33:49 +00:00
Sign in to join this conversation.
No reviewers
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
Grimoirix/grimoire-of-digital-signage!81
No description provided.