Additional arguments passed to each module in addition to ones like lib, config, and pkgs, modulesPath.

This option is also available to all submodules. Submodules do not inherit args from their parent module, nor do they provide args to their parent module or sibling submodules. The sole exception to this is the argument name which is provided by parent modules to a submodule and contains the attribute name the submodule is bound to, or a unique generated name if it is not bound to an attribute.

Some arguments are already passed by default, of which the following cannot be changed with this option:

• lib: The nixpkgs library.

• config: The results of all options after merging the values from all modules together.

• options: The options declared in all modules.

• specialArgs: The specialArgs argument passed to evalModules.

• All attributes of specialArgs

  Whereas option values can generally depend on other option values thanks to laziness, this does not apply to imports, which must be computed statically before anything else.

  For this reason, callers of the module system can provide specialArgs which are available during import resolution.

  For NixOS, specialArgs includes modulesPath, which allows you to import extra modules from the nixpkgs package tree without having to somehow make the module aware of the location of the nixpkgs or NixOS directories.

  { modulesPath, ... }: {
    imports = [
      (modulesPath + "/profiles/minimal.nix")
    ];
  }
  

For NixOS, the default value for this option includes at least this argument:

• pkgs: The nixpkgs package set according to the nixpkgs.pkgs option.

Whether to enable hyprnix.

Extra configuration lines to append to the bottom of ~/.config/hypr/hyprland.lua.

The hyprland package to use. Set this to null if you use the NixOS module to install Hyprland.

List of Hyprland plugins to use.

The xdg-desktop-portal-hyprland package to use. Set this to null if you use the NixOS module to install Hyprland.

This option has no description.

bezier curve name

whether the animation is enabled

amount of ds (1ds = 100ms) the animation will take

spring curve name

(optional) the animation style

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

the name of a default monitor for the cursor to be set to on startup (see hyprctl monitors for names)

Hides the cursor when you press any key until the mouse is moved.

Hides the cursor when the last input was a tablet input until a mouse input is done.

Hides the cursor when the last input was a touch input until a mouse input is done.

the padding, in logical px, between screen edges and the cursor

whether to enable hyprcursor support

set cursor's name. Requires Hyprland restart.

set cursor's package to install

set cursor's size. Requires Hyprland restart.

in seconds, after how many seconds of cursor's inactivity to hide it. Set to 0 for never.

don't render cursors

minimum refresh rate for cursor movement when no_break_fs_vrr = 1 Set to minimum supported refresh rate or higher

disables scheduling new frames on cursor movement for fullscreen apps with VRR enabled to avoid framerate spikes (may require no_hardware_cursors = 1) 0 - off, 1 - on, 2 - auto (on with content type "game")

disables hardware cursors. 0 - use hw cursors if possible, 1 - don't use hw cursors, 2 - auto (disable when tearing)

if true, will not warp the cursor in many cases (focusing, keybinds, etc)

When a window is refocused, the cursor returns to its last position relative to that window, rather than to the centre.

sync xcursor theme with gsettings, it applies cursor-theme and cursor-size on theme load to gsettings making most CSD gtk based clients use same xcursor theme and size.

(NVIDIA Only) Makes HW cursors use a CPU buffer. Required on NVIDIA to have HW cursors. 0 - off, 1 - on, 2 - auto

Warp the cursor back to where it was after using a non-mouse input to move it, and then returning back to mouse.

Move the cursor to the last focused window after changing the workspace. Options: 0 (Disabled), 1 (Enabled), 2 (Force - ignores cursor.no_warps option)

Move the cursor to the last focused window when toggling a special workspace. Options: 0 (Disabled), 1 (Enabled), 2 (Force - ignores cursor.no_warps option)

detach the camera from the mouse when zoomed in, only ever moving the camera to keep the mouse in view when it goes past the screen edges

disable antialiasing when zooming, which means things will be pixelated instead of blurry

the factor to zoom by around the cursor. Like a magnifying glass. Minimum 1.0 (meaning no zoom)

whether the zoom should follow the cursor rigidly (cursor is always centered if it can be) or loosely

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

enables colors in the stdout logs.

(epilepsy warning!) flash areas updated with damage tracking

redraw only the needed bits of the display. Do not change. 0 - none, 1 - monitor, 2 - full (default on Hyprland)

disable logging to a file

disables verification of the scale factors. Will result in pixel alignment and rounding errors.

disables time logging

enables logging to stdout

limits the number of displayed config file parsing errors.

sets the position of the error bar. top - 0, bottom - 1

claims support for all cm proto features (requires restart)

enables OpenGL debugging with glGetError and EGL_KHR_debug, requires a restart after changing.

Allow fp16 buffer invalidation (invalidation increases performance but produces glitches on some systems). 0 - not allowed, 1 - allowed, 2 - not allowed on nvidia

set to 1 and then back to 0 to crash Hyprland.

print the debug performance overlay. Disable VFR for accurate results.

enables render pass debugging.

if true, do not display config file parsing errors.

controls the VFR status of Hyprland. Heavily recommended to leave enabled to conserve resources.

sets the timeout in seconds for watchdog to abort processing of a signal of the main thread. Set to 0 to disable.

opacity of active windows

brightness modulation for blur

contrast modulation for blur

enable kawase window background blur

make the blur layer ignore the opacity of the window

whether to blur input methods (e.g. fcitx5)

works like ignore_alpha in layer rules. If pixel opacity is below set value, will not blur

whether to enable further optimizations to the blur. Recommended to leave on, as it will massively improve performance.

how much noise to apply

the amount of passes to perform

whether to blur popups (e.g. right-click menus)

works like ignore_alpha in layer rules. If pixel opacity is below set value, will not blur

blur size (distance)

whether to blur behind the special workspace (note: expensive)

Increase saturation of blurred colors

How strong the effect of vibrancy is on dark areas

if enabled, floating windows will ignore tiled windows in their blur. Only available if new_optimizations is true. Will reduce overhead on floating blur significantly.

whether the window border should be a part of the window

how much the dim_around window rule should dim by

enables dimming of inactive windows

enables dimming of parents of modal windows

how much to dim the rest of the screen by when a special workspace is open

how much inactive windows should be dimmed

opacity of fullscreen windows

glow's color. Alpha dictates glow's opacity.

inactive glow color. (if not set, will fall back to color)

enable inner glow on windows

Glow range ("size") in layout px

in what power to render the falloff (more power, the faster the falloff)

opacity of inactive windows

rounded corners' radius (in layout px)

adjusts the curve used for rounding corners, larger is smoother, 2.0 is a circle, 4.0 is a squircle, 1.0 is a triangular corner

a path to a custom shader to be applied at the end of rendering.

shadow's color. Alpha dictates shadow's opacity.

inactive shadow color. (if not set, will fall back to color)

enable drop shadows on windows

shadow's rendering offset.

Shadow range ("size") in layout px

in what power to render the falloff (more power, the faster the falloff)

shadow's scale

if enabled, will make the shadows sharp, akin to an infinite render power

The default split ratio on window open. 1 means even 50/50 split.

0 -> split follows mouse 1 -> always split to the left (new = left or top) 2 -> always split to the right (new = right or bottom)

If enabled, makes the preselect direction persist until either this mode is turned off, another direction is specified, or a non-direction is specified (anything other than l,r,u/t,d/b)

If enabled bindm movewindow will drop the window more precisely depending on where your mouse is.

If enabled, the split (side/top) will not change regardless of what happens to the container.

If enabled, resizing direction will be determined by the mouse's position on the window (nearest to which corner). Else, it is based on the window's tiling position.

If enabled, allows a more precise control over the window split direction based on the cursor's position. The window is conceptually divided into four triangles, and cursor's triangle determines the split direction. This feature also turns on preserve_split.

Specifies the scale factor of windows on the special workspace

Specifies which window will receive the split ratio. 0 -> directional (the top or left window) 1 -> the current window

Specifies the auto-split width multiplier. Multiplying window size is useful on widescreen monitors where window W > H even after several splits.

Prefer the active window or the mouse position for splits

whether to enable permission control.

disable the popup that shows up twice a year encouraging to donate.

disable the popup that shows up when you update hyprland to a new version.

Environment variables to set, as name-value pairs.

master switch for allowing tearing to occur. See the Tearing page.

size of the border around windows

border color for the active window

border color for inactive windows

inactive border color for window that cannot be added to a group (see denywindowfromgroup dispatcher)

active border color for window that cannot be added to a group

extends the area around the border where you can click and drag on, only used when general:resize_on_border is on.

gaps between windows and monitor edges for floating windows, also supports css style gaps (top, right, bottom, left -> 5 10 15 20). -1 means default

gaps between windows, also supports css style gaps (top, right, bottom, left -> 5,10,15,20)

gaps between windows and monitor edges, also supports css style gaps (top, right, bottom, left -> 5,10,15,20)

gaps between workspaces. Stacks with gaps_out.

show a cursor icon when hovering over borders, only used when general:resize_on_border is on.

which layout to use

overrides the system locale (e.g. en_US, es)

whether parent windows of modals will be interactive

if true, will not fall back to the next available window when moving focus in a direction where no window was found

force floating windows to use a specific corner when being resized (1-4 going clockwise from top left, 0 to disable)

enables resizing windows by clicking and dragging on borders and gaps

if true, windows snap such that only one border's worth of space is between them

enable snapping for floating windows

minimum gap in pixels between window and monitor edges before snapping

if true, snapping will respect gaps between windows(set in general:gaps_in)

minimum gap in pixels between windows before snapping

the timeout for a window to close when using a 1:1 gesture, in ms

list of gestures

action to perform

gesture direction

if true, allows the gesture to bypass shortcut inhibitors

number of fingers

value depends on the action. action is "fullscreen" -> "maximize" to do maximize instead of fullscreen action is "float" -> "float" or "tile" to force a direction of floating action is "cursor_zoom" -> "mult" to use a multiplier or "live" to update continuously during the pinch

optional modifier mask

optional gesture delta multiplier

special workspace name

zoom factor if action is "cursor_zoom"

how much the swipe has to proceed in order to commence it. (0.7 -> if > 0.7 * distance, switch, if less, revert)

whether a swipe right on the last workspace should create a new one.

if enabled, switching direction will be locked when you swipe past the direction_lock_threshold (touchpad only).

in px, the distance to swipe before direction lock activates (touchpad only).

in px, the distance of the touchpad gesture

if enabled, swiping will not clamp at the neighboring workspaces but continue to the further ones.

invert the direction (touchpad only)

minimum speed in px per timepoint to force the change ignoring cancel_ratio. Setting to 0 will disable this mechanic.

enable workspace swiping from the edge of a touchscreen

invert the direction (touchscreen only)

if enabled, swiping will use the r prefix instead of the m prefix for finding workspaces.

whether new windows will be automatically grouped into the focused unlocked group. Note: if you want to disable auto_group only for specific windows, use the "group barred" window rule instead.

active group border color

inactive (out of focus) group border color

active locked group border color

inactive locked group border color

whether dragging a window into a unlocked group will merge them. 0 -> disabled. 1 -> enabled. 2 -> only when dragging into the groupbar.

whether Hyprland should focus on the window that has just been moved out of the group

whether using movetoworkspace[silent] will merge the window into the workspace's solitary unlocked group

applies blur to the groupbar indicators and gradients

active group bar background color

inactive (out of focus) group bar background color

active locked group bar background color

inactive locked group bar background color

enables groupbars

font used to display groupbar titles, use misc:font_family if not specified

font size of groupbar title

font weight of active groupbar title

font weight of inactive groupbar title

gap size between gradients

gap size between gradients and window

round only the gradient edges of the entire groupbar

how much to round the gradients

adjusts the curve used for rounding gradient corners, larger is smoother, 2.0 is a circle, 4.0 is a squircle, 1.0 is a triangular corner

enables gradients

height of the groupbar

height of gap between groupbar indicator and title

height of the groupbar indicator

add or remove upper gap

whether middle clicking the groupbar closes the clicked window

sets the decoration priority for groupbars

whether to render titles in the group bar decoration

round only the indicator edges of the entire groupbar

how much to round the indicator

adjusts the curve used for rounding groupbar corners, larger is smoother, 2.0 is a circle, 4.0 is a squircle, 1.0 is a triangular corner

whether scrolling in the groupbar changes group active window

render the groupbar as a vertical stack

color for window titles in the groupbar

color for inactive windows' titles in the groupbar (if unset, defaults to text_color)

color for the active window's title in a locked group (if unset, defaults to text_color)

color for inactive windows' titles in locked groups (if unset, defaults to text_color_inactive)

adjust vertical position for titles

set horizontal padding for titles

whether new windows in a group spawn after current or at group tail

whether dragging a floating window into a tiled window groupbar will merge them

whether window groups can be dragged into other groups

whether one group will be merged with another when dragged into its groupbar

Sets the cursor acceleration profile. Leave empty to use libinput's default mode for your input device.

Emulates discrete scrolling from high resolution scrolling events. 0 disables it. 1 enables handling of non-standard events only. 2 force enables all scroll wheel events to be handled.

If enabled, focus will change to the window under the cursor when changing from tiled-to-floating and vice versa. If 2, focus will also follow mouse on float-to-float switches.

Controls the window focus behavior when a window is closed. When set to 0, focus will shift to the next window candidate. When set to 1, focus will shift to the window under the cursor. When set to 2, focus will shift to the most recently used/active window.

Specify if and how cursor movement should affect window focus. 0 - Cursor movement will not change focus. 1 - Cursor movement will always change focus to the window under the cursor. 2 - Cursor focus will be detached from keyboard focus. Clicking on a window will move keyboard focus to that window. 3 - Cursor focus will be completely separate from keyboard focus. Clicking on a window will not change keyboard focus.

The smallest distance in logical pixels the mouse needs to travel for the window under it to get focused. Works only with follow_mouse = 1.

Force no cursor acceleration. This bypasses most of your pointer settings to get as raw of a signal as possible. Enabling this is not recommended due to potential cursor desynchronization.

If you prefer, you can use a path to your custom .xkb file.

Appropriate XKB keymap parameter

Appropriate XKB keymap parameter

Appropriate XKB keymap parameter

Appropriate XKB keymap parameter

Appropriate XKB keymap parameter

Switches RMB and LMB

If disabled, mouse focus won't switch to the hovered window unless the mouse crosses a window boundary when follow_mouse=1.

Inverts scrolling direction. When enabled, scrolling moves content directly, rather than manipulating a scrollbar.

Engage numlock by default.

Handles axis events around (gaps/border for tiled, dragarea/border for floated) a focused window. 0 ignores axis events. 1 sends out-of-bound coordinates. 2 fakes pointer coordinates to the closest point inside the window. 3 warps the cursor to the closest point inside the window.

Delay before a held-down key is repeated, in milliseconds.

The repeat rate for held-down keys, in repeats per second.

Determines how keybinds act when multiple layouts are used. If false, keybinds will always act as if the first specified layout is active. If true, keybinds specified by symbols are activated when you type the respective symbol with the current layout.

Sets the rotation of a device in degrees clockwise off the logical neutral position.

Sets the scroll button. Check wev if you have any doubts regarding the ID. 0 means default.

If the scroll button lock is enabled, the button does not need to be held down. Pressing and releasing the button toggles the button lock, which logically holds the button down or releases it. While the button is logically held down, motion events are converted to scroll events.

Multiplier added to scroll movement for external mice. Note that there is a separate setting for touchpad scroll_factor.

Sets the scroll method.

Sets the scroll acceleration profile, when accel_profile is set to custom. Has to be in the form <step> <points>. Leave empty to have a flat scroll curve.

Sets the mouse input sensitivity.

if enabled, having only floating windows in the special workspace will not block focusing windows in the regular workspace.

whether to treat the region_position as an absolute position in monitor layout. Only applies when output is empty.

position of the active area in mm

size of tablet's active area in mm

if enabled, the tablet will be rotated 180 degrees

the monitor to bind tablets. Can be current or a monitor name. Leave empty to map across all monitors.

position of the mapped region in monitor layout relative to the top left corner of the bound monitor or all monitors.

size of the mapped region. When this variable is set, tablet input will be mapped to the region. [0, 0] or invalid size means unset.

whether the input should be relative

transform the input from tablets. The possible transformations are the same as those of the monitors. -1 means it's unset.

Whether input is enabled for touch devices.

The monitor to bind touch devices. The default is auto-detection. To stop auto-detection, use an empty string or the "Empty" value.

Transform the input from touchdevices. The possible transformations are the same as those of the monitors. -1 means it's unset.

Button presses with 1, 2, or 3 fingers will be mapped to LMB, RMB, and MMB respectively. This disables interpretation of clicks based on location on the touchpad.

Disable the touchpad while typing.

enables three finger drag. 0 -> disabled. 1 -> 3 fingers. 2 -> 4 fingers.

When enabled, lifting the finger off while dragging will not drop the dragged item. 0 -> disabled. 1 -> enabled with timeout. 2 -> enabled sticky.

inverts the horizontal movement of the touchpad

inverts the vertical movement of the touchpad

Sending LMB and RMB simultaneously will be interpreted as a middle click. This disables any touchpad area that would normally send a middle click based on location.

Inverts scrolling direction. When enabled, scrolling moves content directly, rather than manipulating a scrollbar.

Multiplier applied to the amount of scroll movement.

Sets the tap and drag mode for the touchpad

Tapping on the touchpad with 1, 2, or 3 fingers will send LMB, RMB, and MMB respectively.

Sets the tap button mapping for touchpad button emulation. Can be one of lrm (default) or lmr (Left, Middle, Right Buttons)

Release all pressed keys by virtual keyboard on close.

Unify key down states and modifier states with other keyboards. 0 -> no. 1 -> yes. 2 -> yes unless IME client.

Hyprland layer_rule configuration.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

Namespace of the layer. Check hyprctl layers

This option has no description.

This option has no description.

This option has no description.

This option has no description.

whenever only a single window is shown on a screen, add padding so that it conforms to the specified aspect ratio. A value like 4 3 on a 16:9 screen will make it a 4:3 window in the middle with padding to the sides.

sets a tolerance for single_window_aspect_ratio, so that if the padding that would have been added is smaller than the specified fraction of the height or width of the screen, it will not attempt to adjust the window size

enable adding additional master windows in a horizontal split style

whether to keep the master window in its configured position when there are no slave windows

Set fallback for center master when slaves are less than slave_count_for_center_master

when enabled, dragging and dropping windows will put them at the cursor position. Otherwise, when dropped at the stack side, they will go to the top/bottom of the stack depending on new_on_top.

when enabled, closing a window focuses the master window

the size as a percentage of the master window, for example mfact = 0.70 would mean 70% of the screen will be the master window, and 30% the slave

before, after: place new window relative to the focused window; none: place new window according to the value of new_on_top.

whether a newly open window should be on the top of the stack

master: new window becomes master; slave: new windows are added to slave stack; inherit: inherit from focused window

default placement of the master area

when using orientation=center, make the master window centered only when at least this many slave windows are open. Set 0 to always center master.

if enabled, resizing direction will be determined by the mouse's position on the window (nearest to which corner). Else, it is based on the window's tiling position.

the scale of the special workspace windows.

if true, will allow you to restart a lockscreen app in case it crashes

Will make mouse focus follow the mouse when drag and dropping. Recommended to leave it enabled, especially for people using focus follows mouse at 0.

If true, will animate manual window resizes/moves

If true, will animate windows being dragged by mouse, note that this can cause weird behavior on some curves

number of missed pings before showing the ANR dialog

change the background color. (requires enabled disable_hyprland_logo)

close the special workspace if the last window is removed

Changes the color of the splash text (requires a monitor reload to take effect).

If true, the config will not reload automatically on save, and instead needs to be reloaded with hyprctl reload. Might save on battery.

disables the random Hyprland logo / anime girl background.

disable the warning if hyprland-qtutils is not installed

disables notification popup when a monitor fails to set a suitable scale

disables the Hyprland splash rendering. (requires a monitor reload to take effect)

whether to disable the warning about not using start-hyprland

disable the warning if XDG environment is externally managed

whether to enable the ANR (app not responding) dialog when your apps hang

Enable window swallowing

if true, closing a fullscreen window makes the next focused window fullscreen

Whether Hyprland should focus an app that requests to be focused (an activate request)

Set the global default font to render the text including debug fps/notification, config error messages and etc., selected from system fonts.

Enforce any of the 3 default wallpapers. Setting this to 0 or 1 disables the anime background. -1 means “random”.

if enabled, windows will open on the workspace they were invoked on. 0 - disabled, 1 - single-shot, 2 - persistent (all children too)

If DPMS is set to off, wake up the monitors if a key is pressed.

If true, will make keyboard-interactive layers keep their focus on mouse move (e.g. wofi, bemenu)

delay after which the "lockdead" screen will appear in case a lockscreen app fails to cover all the outputs (5 seconds max)

whether to enable middle-click-paste (aka primary selection)

If DPMS is set to off, wake up the monitors if the mouse moves.

Whether mouse moving into a different monitor should focus it

Name virtual keyboards after the processes that create them. E.g. /usr/bin/fcitx5 will have hl-virtual-keyboard-fcitx5.

if there is a fullscreen or maximized window, decide whether a tiled window requested to focus should replace it, stay behind or disable the fullscreen/maximized state. 0 - ignore focus request (keep focus on fullscreen window), 1 - takes over, 2 - unfullscreen/unmaximize

the maximum limit for render_unfocused windows' fps in the background (see also Window-Rules - render_unfocused)

if true, keep rendering workspaces below your lockscreen

whether to apply min_size and max_size rules to tiled windows

Changes the font used to render the splash text, selected from system fonts (requires a monitor reload to take effect).

The title regex to be used for windows that should not be swallowed by the windows specified in swallow_regex(e.g. wev). The regex is matched against the parent (e.g. Kitty) window's title on the assumption that it changes to whatever process it's running.

The class regex to be used for windows that should be swallowed (usually, a terminal).

controls the VFR status of Hyprland. Heavily recommended to leave enabled to conserve resources.

controls the VRR (Adaptive Sync) of your monitors. 0 - off, 1 - on, 2 - fullscreen only, 3 - fullscreen with video or game content type.

Hyprland monitors configuration

Color bit depth

Color management preset

Whether to disable the monitor

Absolute path to an ICC profile

Maximum average luminance of the monitor (nits)

Peak luminance of the monitor (nits)

Minimum luminance of the monitor (nits)

Mirror another monitor output

Resolution and refresh rate

Monitor output name

Monitor position

integer for all sides or table with top/right/bottom/left

Monitor scale factor

SDR transfer function

SDR maximum luminance for SDR→HDR mapping (nits)

SDR minimum luminance for SDR→HDR mapping (0.005 for true black matching HDR black)

SDR brightness in HDR mode

SDR brightness in HDR mode

Force HDR support, requires wide color (0=auto, 1=force on, -1=force off)

Force wide color gamut support (0=auto, 1=force on, -1=force off)

Rotation/flip (0=normal, 1=90°, 2=180°, 3=270°, 4=flipped, 5=flipped+90°, 6=flipped+180°, 7=flipped+270°)

Variable Refresh Rate (0=off, 1=on, 2=fullscreen only, 3=fullscreen with video or game content type)

reduces flickering on nvidia at the cost of possible frame drops on lower-end GPUs. On non-nvidia, this is ignored.

Hyprland permissions configuration

path to binary

permission mode

permission assigned to the binary

Report HDR mode as preferred. 0 - off, 1 - always, 2 - gamescope only

Auto-switch to HDR in fullscreen when needed. 0 - off, 1 - switch to "cm, hdr," 2 - switch to "cm, hdredid"

Whether the color management pipeline should be enabled or not (requires a restart of Hyprland to fully take effect)

Default transfer function for displaying SDR apps. default - Use default value (Gamma 2.2), gamma22 - Treat unspecified as Gamma 2.2, gamma22force - Treat unspecified and sRGB as Gamma 2.2, srgb - Treat unspecified as sRGB

Enable commit timing proto. Requires restart

Whether to enable a fade animation for CTM changes (hyprsunset). 2 means “auto” which disables them on Nvidia.

Enables direct scanout. Direct scanout attempts to reduce lag when there is only one fullscreen application on a screen (e.g. game). It is also recommended to set this to 0 if the fullscreen application shows graphical glitches. 0 - off, 1 - on, 2 - auto (on with content type "game")

Whether to expand undersized textures along the edge, or rather stretch the entire texture.

Keep umodified SDR frame copy for sreensharing 0 - disabled 1 - on 2 - auto (enabled in HDR with SDR modifiers) Set to 1 if screenshots are transparent

Automatically uses triple buffering when needed, improves FPS on underpowered devices.

Enable CM without shader. 0 - disable, 1 - whenever possible, 2 - DS and passthrough only, 3 - disable and ignore CM issues

0 - external ctm (hypersunset, etc.) is disabled in fullscreen 1 - external ctm is enabled in fullscreen 2 - external ctm is disabled for fullscreen photo/video/game content types

Report content type to allow monitor profile autoswitch (may result in a black screen during the switch)

Use FP16 buffers internally 0 - disabled 1 - enabled 2 - enabled in hdr mode

Use experimental blurred bg blending (glitched on rotated screens) Set to true if blur is missing with fp16 or keep_unmodified_copy

Disables back buffer and bottom layer rendering.

the default width of a column

Direction in which new windows appear and the layout scrolls.

A list of preconfigured widths for colresize +conf/-conf

When a column is focused, what method should be used to bring it into view. 0 = center, 1 = fit

when a window is focused, should the layout move to bring it into view automatically

when a window is focused, require that at least a given fraction of it is visible for focus to follow. Hard input (e.g. binds, clicks) will always follow.

when enabled, a single column on a workspace will always span the entire screen.

When enabled, causes layoutmsg focus l/r to wrap around at the beginning and end.

When enabled, causes layoutmsg swapcol l/r to wrap around at the beginning and end.

Hyprland window_rule configuration.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

Match conditions.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.

This option has no description.