- C 97.1%
- Meson 2.9%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| daemon | ||
| engine | ||
| .gitignore | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| meson.build | ||
| meson_options.txt | ||
| README.md | ||
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 atpathas 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 whenseuratdrestarts. 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:trueorfalse. The daemon exits when set tofalse.color:#rrggbb. Empty or absent selects the color from the wallpaper image (PNG or JPEG), or#4285f4when no image is set, the image cannot be read or it has no suitable color.color_scheme:default,lightordark.
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.
Links
License
GPL-3.0-only. See LICENSE.