# Miscellaneous This chapter covers smaller configuration options that don't warrant their own chapter. ## Color Management The Wayland color management protocol lets applications communicate color space information to the compositor. It is disabled by default. ```toml [color-management] enabled = true ``` > [!NOTE] > Changing this setting has no effect on applications that are already running. The CLI and control center (**Color Management** pane) can also toggle it: ```shell ~$ jay color-management enable ~$ jay color-management disable ~$ jay color-management status ``` See [HDR & Color Management](../hdr.md) for a complete guide to HDR output and the color management protocol. ## Libei [libei](https://gitlab.freedesktop.org/libinput/libei) allows applications to emulate input events. Setting `enable-socket` exposes an unauthenticated socket that any application can use. ```toml libei.enable-socket = false # default ``` ## UI Drag Controls whether workspaces and tiles can be dragged with the mouse, and how far the pointer must move before a drag begins. ```toml ui-drag = { enabled = true, threshold = 10 } # defaults ``` Set `enabled = false` to disable drag-and-drop rearrangement entirely. Increase `threshold` if you find yourself accidentally starting drags. ## Floating Window Pin Icon Floating windows can show a small pin icon. This is hidden by default. ```toml [float] show-pin-icon = true ``` ## Workspace Capture Controls whether newly created workspaces can be captured (e.g. for screen sharing). The default is `true`. ```toml workspace-capture = false ``` ## Simple Input Method Jay includes a built-in XCompose-based input method. It is enabled by default but only activates when no external input method is running. ```toml [simple-im] enabled = true # default ``` Related actions for use in shortcuts: `enable-simple-im` : Enable the built-in input method `disable-simple-im` : Disable the built-in input method `toggle-simple-im-enabled` : Toggle the built-in input method `reload-simple-im` : Reload XCompose files without restarting `enable-unicode-input` : Start Unicode codepoint input (requires active IM) ## Log Level Sets the compositor's log verbosity. Valid values: `trace`, `debug`, `info`, `warn`, `error`. ```toml log-level = "info" ``` This setting **cannot** be changed by reloading the configuration. Use the CLI instead: ```shell ~$ jay set-log-level debug ``` ## Log File Cleanup Jay creates a new log file each time it starts. Over time, old log files can accumulate. To automatically delete old log files on startup, use the `clean-logs-older-than` option: ```toml clean-logs-older-than.days = 7 ``` The table accepts `weeks` and `days` fields. At least one must be specified. They can be combined and accept fractional values: ```toml [clean-logs-older-than] weeks = 2 days = 3 ``` Log files belonging to other running Jay instances (e.g. on another VT) are never deleted, even if they are older than the specified age. > [!NOTE] > This setting only takes effect at compositor startup. It cannot be triggered > by reloading the configuration. ## Focus Follows Mouse When enabled, moving the pointer over a window automatically gives it keyboard focus. ```toml focus-follows-mouse = true # default ``` ## Window Management Key Designates a key that, while held, enables window management mode. In this mode, the left mouse button moves floating windows and the right mouse button resizes any window. ```toml window-management-key = "Alt_L" ``` The value should be a keysym name (see the [xkbcommon keysym list](https://github.com/xkbcommon/libxkbcommon/blob/master/include/xkbcommon/xkbcommon-keysyms.h) with the `XKB_KEY_` prefix removed). ## Middle-Click Paste Controls whether middle-clicking pastes the primary selection. Changing this has no effect on running applications. ```toml middle-click-paste = true # default ``` ## Pointer Revert Key Pressing this key cancels any active grabs, drags, or selections, returning the pointer to its default state. The default is `Escape`. ```toml pointer-revert-key = "Escape" # default ``` Set it to `NoSymbol` to disable this functionality entirely: ```toml pointer-revert-key = "NoSymbol" ``` ## Fallback Output Mode Determines which output is used when no particular output is specified -- for example, when placing a newly opened window or choosing which workspace to move with `move-to-output`. `cursor` : Use the output the cursor is on (default) `focus` : Use the output the focused window is on ```toml fallback-output-mode = "cursor" # default ``` ## Focus History Configures the behavior of the `focus-prev` and `focus-next` actions. `only-visible` : Only cycle to windows that are already visible. Default: `false`. `same-workspace` : Only cycle to windows on the current workspace. Default: `false`. If `only-visible` is `false`, switching to a non-visible window will make it visible first. ```toml [focus-history] only-visible = true same-workspace = true ``` ## Control Center Fonts The `[egui]` table configures fonts used by the control center (an egui-based GUI). ```toml [egui] proportional-fonts = ["sans-serif", "Noto Sans", "Noto Color Emoji"] # default monospace-fonts = ["monospace", "Noto Sans Mono", "Noto Color Emoji"] # default ``` Override these lists to use your preferred fonts in the control center UI.