COSMIC session service which applies backgrounds to displays. Supports the following features:
-
Supports any image format supported by image-rs
-
Use of colors and gradients for backgrounds
-
Per-display background application
-
Slideshow: alternate between backgrounds periodically
-
8-bit and 10-bit (HDR) backgrounds
The following system dependencies are also required to compile: just libwayland-dev libxkbcommon-dev pkg-config
. The software is written in Rust, so cargo rustc
are also required. Developers should install Rust from from https://rustup.rs/.
A release build can be generated by running just
, and then installed with sudo just install
. If packaging for Linux distribution, use the rootdir
variable to change the root path, in addition to the prefix: just rootdir=debian/cosmic-bg prefix=/usr install
.
To get debug logs from the service, first kill the cosmic-bg
process a few times in a row to prevent it from being launched by cosmic-session
. Then launch it with just run
to display backtraces and debug logs in the terminal.
Licensed under the Mozilla Public License Version 2.0.
Any contribution intentionally submitted for inclusion in the work by you shall be licensed under the Mozilla Public License Version 2.0 (MPL-2.0). Each source file should have a SPDX copyright notice at the top of the file:
// SPDX-License-Identifier: MPL-2.0