Skip to content

pop-os/cosmic-bg

Repository files navigation

cosmic-bg

COSMIC session service which applies backgrounds to displays. Supports the following features:

  • Supports common image formats supported by image-rs
  • 8 and 10-bit background surface layers
  • Use of colors and gradients for backgrounds
  • Per-display background application
  • Wallpaper slideshows that alternate between backgrounds periodically

Dependencies

Developers should install Rust from from https://rustup.rs/.

  • just
  • cargo / rustc
  • libwayland-dev
  • libxkbcommon-dev
  • mold
  • pkg-config

Install

A release build can be generated by running just, and then installed with sudo just install.

If packaging, use the rootdir variable to change the root path, in addition to the prefix: just rootdir=debian/cosmic-bg prefix=/usr install.

To reduce compile times across COSMIC applications, either use sccache, or set CARGO_TARGET_DIR to a shared path and install with sudo -E just install.

Debugging

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.

License

Licensed under the Mozilla Public License Version 2.0.

Contribution

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