bluefin_common
Tags: desktop, bluefin
Secrets needed: No
Runs on: Desktop group only (skipped on Bluefin hosts unless force_bluefin: true)
Syncs Bluefin branding, fonts, wallpapers, and GNOME extensions from the Project Bluefin OCI image.
What It Does
- Pulls the
ghcr.io/projectbluefin/common:latestcontainer image - Extracts Bluefin gsettings/dconf overrides, backgrounds, icons, and logos
- Installs branding assets to
~/.local/share/ - Fixes XML background paths to point to home directory
- Applies dconf settings via a Python script
- Installs Bluefin-standard fonts (Inter, JetBrains Mono)
- Installs Bluefin-recommended GNOME extensions
- Deploys a wallpaper rotation service and timer
- Deploys the
corral(Go) VM utility
Fonts
- Inter — UI font (from GitHub releases)
- JetBrains Mono — monospace font for terminals and editors
Wallpaper Rotation
A systemd timer (bluefin-wallpaper-rotate.timer) cycles through Bluefin backgrounds daily. The Python script applies the wallpaper via D-Bus.
Corral
Deploys corral, the Go VM manager
(CLI + TUI + web). Corral is downloaded from the rolling binaries release of
hanthor/corral (checksum-verified, so it
updates whenever CI publishes a new build). It is no longer embedded in this
repo.
Notes
- Skips by default on actual Bluefin hosts (they already have this)
- Set
force_bluefin: trueto apply on Bluefin (e.g., after an image reset) - Set
skip_bluefin: trueinhost_varsto skip entirely