Kabegami

Kabegami is a simple and self-contained wallpaper setter written in Rust. It does not rely on any other wallpaper utilities, making it a minimal solution for setting your desktop background. The tool is designed to be customizable and work properly on all platforms and desktop environments.

Supported Desktop Environments

Kabegami currently supports the following desktop environments:

• Gnome
• Kde
• Xfce
• Lxde
• Lxqt
• Mate
• Cinnamon

In case your desktop environment is not supported, the wallpaper will be set using Xcb. however, multiple monitor support is currently not available with Xcb. You can create a file named setter.sh in the config directory $HOME/.config/kabegami and add your custom setting command. The tool will run this script to set the background.

Installation

You can install Kabegami using Cargo, the package manager for Rust:

cargo install kabegami

Usage

Usage: kabegami [OPTIONS] <PATH>

Positional arguments:
  PATH                  the path to the images directory or image file

Options:
  -h, --help            display this help and exit
  -m, --mode MODE       default mode: strim, available modes: strim, stretch, fill (default: strim)

Cross-Platform Support

Kabegami has been tested on Xfce and Bspw. Support for other platforms can be added as needed.

Customization

Kabegami creates a config file in the path $HOME/.config/kabegami in the supported desktop environments. The file is named based on the current desktop environment and can be edited for customization.

Contributing

If you'd like to contribute to this project, feel free to submit a pull request or open an issue on the repository. All contributions are welcome!

License

This project is licensed under the MIT License.