A dynamic output configuration tool that automatically detects and configures connected outputs based on a set of profiles.
Each profile specifies a set of outputs with additional parameters (e.g., mode). A profile will be applied automatically if all specified outputs and modes can be perfectly matched to the currently connected outputs and their capabilities.
This is a Wayland equivalent for tools like [autorandr]. shikane works with Wayland compositors supporting version 3 of the wlr-output-management protocol (e.g., compositors using wlroots v0.16).
Via cargo from [crates.io]:
sh
cargo install shikane
Via your $AURhelper from the [AUR]:
sh
$AURhelper -S shikane
Documentation is provided as man pages:
sh
man 1 shikane
man 5 shikane
Dependencies: - a rust toolchain >=1.60 - pandoc (for building the man pages)
Building shikane:
sh
cargo build --release
Building the man pages: ```sh ./scripts/build-docs.sh man
man -l build/shikane.1.gz man -l build/shikane.5.gz ```
shikane uses the [TOML] file format for its configuration file
and contains an array of profiles. Each profile is a table containing an
array of output tables. The configuration file should be placed at
$XDG_CONFIG_HOME/shikane/config.toml.
```toml [[profile]] name = "dualfoo" exec = ["notify-send shikane \"Profile $SHIKANEPROFILE_NAME has been applied\""] [[profile.output]] match = "Company Foo" enable = true mode = { width = 1920, height = 1080, refresh = 50 } position = { x = 0, y = 0 } scale = 1.3
[[profile.output]]
match = "/HDMI-[ABC]-[1-9]/"
enable = true
exec = ["echo This is output $SHIKANE_OUTPUT_NAME"]
mode = { width = 2560, height = 1440, refresh = 75 }
position = { x = 1920, y = 0 }
transform = "270"
```
MIT