Monet-like color engine and a color daemon that distributes the resulting theme across the desktop.
  • C 97.1%
  • Meson 2.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-06 16:57:22 +05:00
daemon feat(daemon): add SetWallpaper D-Bus method 2026-11-06 16:57:22 +05:00
engine refactor(engine): expose fallback source color in public header 2026-10-24 11:51:48 +05:00
.gitignore chore: add GPL-3.0 license and gitignore 2026-10-24 11:01:54 +05:00
CONTRIBUTING.md docs: add README and CONTRIBUTING 2026-10-24 11:01:55 +05:00
LICENSE chore: add GPL-3.0 license and gitignore 2026-10-24 11:01:54 +05:00
meson.build feat(daemon): add INI configuration parser 2026-10-24 11:44:24 +05:00
meson_options.txt feat(daemon): derive source color from wallpaper image 2026-10-24 13:38:25 +05:00
README.md docs: describe SetWallpaper 2026-11-06 16:57:22 +05:00

Sanar Seurat

Monet-like color engine and a color daemon that distributes the resulting theme across the desktop.

Note

Repository Mirrors

  • git.nuros.org (sanarde/seurat): primary, self-hosted Forgejo instance, accounts restricted to the core team.
  • GitHub (sanarde/seurat): mirror for external contributors. Issues and Pull Requests opened here are welcome and are reviewed and processed by the core team.

Dependencies

  • C17 compiler
  • Meson (>= 1.0) and Ninja
  • libdbus-1 (daemon)

Build

meson setup build
meson compile -C build
meson test -C build

The image used for automatic color selection is set at configure time:

meson setup build -Dwallpaper_path=/path/to/wallpaper.png

Interfaces

seuratd publishes the current scheme over two channels.

D-Bus (session bus): name org.nuros.sanar.seurat, object /org/nuros/sanar/seurat, interface org.nuros.sanar.Seurat.

  • GetScheme() -> a{su}: role name to opaque ARGB.
  • GetSourceColor() -> u: source color as ARGB.
  • SetWallpaper(s path): use the image at path as the wallpaper from now on, in place of the one set at configure time. An empty path selects the fallback color. The setting is not saved and is lost when seuratd restarts. Any client of the session bus can call it.
  • Signal SchemeChanged(a{su}).

Unix socket: $XDG_RUNTIME_DIR/seurat.sock. A client receives the current scheme on connect and again on every change, as text blocks:

scheme source=#6750a4 mode=light
primary=#65558f
...
end

Configuration

$XDG_CONFIG_HOME/seurat/seurat.conf (default ~/.config/seurat/seurat.conf), section [seurat]:

  • enabled: true or false. The daemon exits when set to false.
  • color: #rrggbb. Empty or absent selects the color from the wallpaper image (PNG or JPEG), or #4285f4 when no image is set, the image cannot be read or it has no suitable color.
  • color_scheme: default, light or dark.

The file and the wallpaper image are watched. A change to either is applied without a restart. Deleting the configuration file takes effect on SIGHUP. Deleting the image keeps the last computed color.

License

GPL-3.0-only. See LICENSE.