jay-compositor 1.13.0

The Jay compositor
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

# Environment Variables

Jay can set environment variables that are inherited by all programs it spawns.

## Setting environment variables at startup

Use the `[env]` table in your config to define variables that apply to every
application launched by the compositor:

```toml
[env]
GTK_THEME = "Adwaita:dark"
QT_QPA_PLATFORM = "wayland"
MOZ_ENABLE_WAYLAND = "1"
```

These variables are set when the config is loaded. Programs started after that
point will inherit them.

## Changing variables at runtime

### set-env

Use the `set-env` action to add or update environment variables while the
compositor is running. This affects all programs started **after** the action
runs:

```toml
[shortcuts]
alt-F11 = {
    type = "set-env",
    env = { GTK_THEME = "Adwaita:dark" },
}
alt-F12 = {
    type = "set-env",
    env = { GTK_THEME = "Adwaita" },
}
```

### unset-env

Use the `unset-env` action to remove environment variables:

```toml
[shortcuts]
alt-F10 = { type = "unset-env", env = ["GTK_THEME"] }
```

You can unset multiple variables at once with an array:

```toml
[shortcuts]
alt-F10 = {
    type = "unset-env",
    env = ["GTK_THEME", "QT_QPA_PLATFORM"],
}
```

## Per-process environment variables

When using the table form of the `exec` action, you can set environment
variables that apply only to that specific process:

```toml
[shortcuts]
alt-Return = {
    type = "exec",
    exec = {
        prog = "alacritty",
        env = { TERM = "xterm-256color" },
    },
}
```

These per-process variables are merged with (and override) the global
environment for that single execution.