3 releases (stable)

new 1.1.0 Apr 22, 2024
1.0.0 Apr 7, 2024
0.1.0 May 2, 2022

#286 in Configuration

Download history 4/week @ 2024-02-21 6/week @ 2024-02-28 7/week @ 2024-03-27 133/week @ 2024-04-03 22/week @ 2024-04-10 114/week @ 2024-04-17

276 downloads per month
Used in 2 crates

GPL-3.0-only

280KB
6K SLoC

Jay

crates.io

Jay is a Wayland compositor.

screenshot.png

Features

See features.md.

Configuration

See config.md.

Building and Setup

See setup.md.

License

Jay is free software licensed under the GNU General Public License v3.0.


lib.rs:

This crate allows you to configure the Jay compositor.

A minimal example configuration looks as follows:

use jay_config::{config, quit, reload};
use jay_config::input::get_default_seat;
use jay_config::keyboard::mods::ALT;
use jay_config::keyboard::syms::{SYM_q, SYM_r};

fn configure() {
    let seat = get_default_seat();
    // Create a key binding to exit the compositor.
    seat.bind(ALT | SYM_q, || quit());
    // Reload the configuration.
    seat.bind(ALT | SYM_r, || reload());
}

config!(configure);

You should configure your crate to be compiled as a shared library:

[lib]
crate-type = ["cdylib"]

After compiling it, copy the shared library to $HOME/.config/jay/config.so and restart the compositor. It should then use your configuration file.

Note that you do not have to restart the compositor every time you want to reload your configuration afterwards. Instead, simply invoke the reload function via a shortcut.

Dependencies

~8–11MB
~214K SLoC