wlroots-hyprland/docs/env_vars.md

wlroots reads these environment variables

wlroots specific
----------------
* *WLR_DRM_DEVICES*: specifies the DRM devices (as a colon separated list)
  instead of auto probing them. The first existing device in this list is
  considered the primary DRM device.
* *WLR_DRM_NO_ATOMIC*: set to 1 to use legacy DRM interface instead of atomic
  mode setting
* *WLR_DRM_NO_ATOMIC_GAMMA*: set to 1 to use legacy DRM interface for gamma
  control instead of the atomic interface
* *WLR_LIBINPUT_NO_DEVICES*: set to 1 to not fail without any input devices
* *WLR_BACKENDS*: comma-separated list of backends to use (available backends:
  wayland, x11, headless, noop)
* *WLR_WL_OUTPUTS*: when using the wayland backend specifies the number of outputs
* *WLR_X11_OUTPUTS*: when using the X11 backend specifies the number of outputs
* *WLR_HEADLESS_OUTPUTS*: when using the headless backend specifies the number
  of outputs
* *WLR_NO_HARDWARE_CURSORS*: set to 1 to use software cursors instead of
  hardware cursors
* *WLR_SESSION*: specifies the wlr\_session to be used (available sessions:
  logind/systemd, direct)

rootston specific
------------------
* *XKB_DEFAULT_RULES*, *XKB_DEFAULT_MODEL*, *XKB_DEFAULT_LAYOUT*,
  *XKB_DEFAULT_VARIANT*, *XKB_DEFAULT_OPTIONS*: xkb setup

generic
-------
* *DISPLAY*: if set probe X11 backend in *wlr_backend_autocreate*
* *WAYLAND_DISPLAY*, *_WAYLAND_DISPLAY*, *WAYLAND_SOCKET*: if set probe Wayland
  backend in *wlr_backend_autocreate*
* *XCURSOR_PATH*: directory where xcursors are located
Document env vars used by wlroots 2018-05-03 12:30:48 +02:00			`wlroots reads these environment variables`

			`wlroots specific`
			`----------------`
backend: allow multiple backends in WLR_BACKENDS 2018-05-15 23:10:51 +02:00			`* WLR_DRM_DEVICES: specifies the DRM devices (as a colon separated list)`
			`instead of auto probing them. The first existing device in this list is`
			`considered the primary DRM device.`
			`* WLR_DRM_NO_ATOMIC: set to 1 to use legacy DRM interface instead of atomic`
			`mode setting`
backend/drm: add WLR_DRM_NO_ATOMIC_GAMMA env variable This allows the legacy interface to be used instead of atomic if needed. This is a workaround to make some Intel GPUs work (if this variable is unset) as well as to make some AMD GPUs work (if this variable is set). 2018-10-28 23:43:21 +01:00			`* WLR_DRM_NO_ATOMIC_GAMMA: set to 1 to use legacy DRM interface for gamma`
			`control instead of the atomic interface`
Document env vars used by wlroots 2018-05-03 12:30:48 +02:00			`* WLR_LIBINPUT_NO_DEVICES: set to 1 to not fail without any input devices`
backend: allow multiple backends in WLR_BACKENDS 2018-05-15 23:10:51 +02:00			`* WLR_BACKENDS: comma-separated list of backends to use (available backends:`
Introduce noop backend The noop backend is similar to headless, but it doesn't contain a renderer. It can be used as a place to stash views for when there's no physical outputs connected. 2019-01-17 11:13:55 +01:00			`wayland, x11, headless, noop)`
Document env vars used by wlroots 2018-05-03 12:30:48 +02:00			`* WLR_WL_OUTPUTS: when using the wayland backend specifies the number of outputs`
			`* WLR_X11_OUTPUTS: when using the X11 backend specifies the number of outputs`
Document WLR_HEADLESS_OUTPUTS 2018-07-18 17:19:41 +02:00			`* WLR_HEADLESS_OUTPUTS: when using the headless backend specifies the number`
			`of outputs`
output: introduce WLR_NO_HARDWARE_CURSORS 2018-09-14 18:07:21 +02:00			`* WLR_NO_HARDWARE_CURSORS: set to 1 to use software cursors instead of`
			`hardware cursors`
Add support for WLR_SESSION env variable Valid values are "logind"/"systemd" and "direct". If WLR_SESSION is set, only its value is potentially tried; it will not try any other option. 2018-09-18 01:18:35 +02:00			`* WLR_SESSION: specifies the wlr\_session to be used (available sessions:`
			`logind/systemd, direct)`
Document env vars used by wlroots 2018-05-03 12:30:48 +02:00
			`rootston specific`
			`------------------`
backend: allow multiple backends in WLR_BACKENDS 2018-05-15 23:10:51 +02:00			`* XKB_DEFAULT_RULES, XKB_DEFAULT_MODEL, XKB_DEFAULT_LAYOUT,`
			`XKB_DEFAULT_VARIANT, XKB_DEFAULT_OPTIONS: xkb setup`
Document env vars used by wlroots 2018-05-03 12:30:48 +02:00
			`generic`
			`-------`
			`* DISPLAY: if set probe X11 backend in wlr_backend_autocreate`
backend: allow multiple backends in WLR_BACKENDS 2018-05-15 23:10:51 +02:00			`* WAYLAND_DISPLAY, _WAYLAND_DISPLAY, WAYLAND_SOCKET: if set probe Wayland`
			`backend in wlr_backend_autocreate`
Document env vars used by wlroots 2018-05-03 12:30:48 +02:00			`* XCURSOR_PATH: directory where xcursors are located`