Hyprnix Documentation Options
_module.args Link copied!
lazy attribute set of raw valueAdditional 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: ThespecialArgsargument passed toevalModules. -
All attributes of
specialArgsWhereas 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
specialArgswhich are available during import resolution.For NixOS,
specialArgsincludesmodulesPath, which allows you to import extra modules from the nixpkgs package tree without having to somehow make the module aware of the location of thenixpkgsor 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 thenixpkgs.pkgsoption.
{ }lib/modules.nixhyprnix.enable Link copied!
booleanWhether to enable hyprnix.
falsetruemodules/homeManager/default.nixhyprnix.extraConfig Link copied!
strings concatenated with "\n"Extra configuration lines to append to the bottom of
~/.config/hypr/hyprland.conf.
""modules/homeManager/default.nixhyprnix.package Link copied!
null or packageThe hyprland package to use. Set this to null if you use the NixOS module to install Hyprland.
nullmodules/homeManager/default.nixhyprnix.plugins Link copied!
list of (package or absolute path)List of Hyprland plugins to use.
[ ]modules/homeManager/default.nixhyprnix.portalPackage Link copied!
null or packageThe xdg-desktop-portal-hyprland package to use. Set this to null if you use the NixOS module to install Hyprland.
nullmodules/homeManager/default.nixhyprnix.settings.animations.animations Link copied!
list of (submodule)This option has no description.
[ ]modules/homeManager/settings/animations.nixhyprnix.settings.animations.animations.*.curve Link copied!
stringBezier curve name
"linear"modules/homeManager/settings/animations.nixhyprnix.settings.animations.animations.*.name Link copied!
stringName of the animation
"workspacesIn"modules/homeManager/settings/animations.nixhyprnix.settings.animations.animations.*.speed Link copied!
positive integer, meaning >0Amount of ds (1ds = 100ms) the animation will take
10modules/homeManager/settings/animations.nixhyprnix.settings.animations.animations.*.style Link copied!
null or stringAnimation style (optional, depends on animation name)
nullmodules/homeManager/settings/animations.nixhyprnix.settings.animations.bezier Link copied!
attribute set of list with 4 number valuesThis option has no description.
{ }{
linear = [
0
0
1
1
];
}modules/homeManager/settings/animations.nixhyprnix.settings.animations.enabled Link copied!
null or booleanenable animations
nullmodules/homeManager/settings/animations.nixhyprnix.settings.animations.workspace_wraparound Link copied!
null or booleanenable workspace wraparound, causing directional workspace animations to animate as if the first and last workspaces were adjacent
nullmodules/homeManager/settings/animations.nixhyprnix.settings.binds.allow_pin_fullscreen Link copied!
null or booleanIf enabled, Allow fullscreen to pinned windows, and restore their pinned status afterwards
nullmodules/homeManager/settings/binds.nixhyprnix.settings.binds.allow_workspace_cycles Link copied!
null or booleanIf enabled, workspaces don’t forget their previous workspace, so cycles can be created by switching to the first workspace in a sequence, then endlessly going to the previous workspace.
nullmodules/homeManager/settings/binds.nixhyprnix.settings.binds.disable_keybind_grabbing Link copied!
null or booleanIf enabled, apps that request keybinds to be disabled (e.g. VMs) will not be able to do so.
nullmodules/homeManager/settings/binds.nixhyprnix.settings.binds.drag_threshold Link copied!
null or (unsigned integer, meaning >=0)Movement threshold in pixels for window dragging and c/g bind flags. 0 to disable and grab on mousedown.
nullmodules/homeManager/settings/binds.nixhyprnix.settings.binds.focus_preferred_method Link copied!
null or one of 0, 1sets the preferred focus finding method when using focuswindow/movewindow/etc with a direction. 0 - history (recent have priority) 1 - length (longer shared edges have priority)
nullmodules/homeManager/settings/binds.nixhyprnix.settings.binds.hide_special_on_workspace_change Link copied!
null or booleanIf enabled, changing the active workspace (including to itself) will hide the special workspace on the monitor where the newly active workspace resides.
nullmodules/homeManager/settings/binds.nixhyprnix.settings.binds.ignore_group_lock Link copied!
null or booleanIf enabled, dispatchers like moveintogroup, moveoutofgroup and movewindoworgroup will ignore lock per group.
nullmodules/homeManager/settings/binds.nixhyprnix.settings.binds.movefocus_cycles_fullscreen Link copied!
null or booleanIf enabled, when on a fullscreen window, movefocus will cycle fullscreen, if not, it will move the focus in a direction.
nullmodules/homeManager/settings/binds.nixhyprnix.settings.binds.movefocus_cycles_groupfirst Link copied!
null or booleanIf enabled, when in a grouped window, movefocus will cycle windows in the groups first, then at each ends of tabs, it’ll move on to other windows/groups
nullmodules/homeManager/settings/binds.nixhyprnix.settings.binds.pass_mouse_when_bound Link copied!
null or booleanif disabled, will not pass the mouse events to apps / dragging windows around if a keybind has been triggered.
nullmodules/homeManager/settings/binds.nixhyprnix.settings.binds.scroll_event_delay Link copied!
null or (unsigned integer, meaning >=0)in ms, how many ms to wait after a scroll event to allow passing another one for the binds.
nullmodules/homeManager/settings/binds.nixhyprnix.settings.binds.window_direction_monitor_fallback Link copied!
null or booleanIf enabled, moving a window or focus over the edge of a monitor with a direction will move it to the next monitor in that direction.
nullmodules/homeManager/settings/binds.nixhyprnix.settings.binds.workspace_back_and_forth Link copied!
null or booleanIf enabled, an attempt to switch to the currently focused workspace will instead switch to the previous workspace. Akin to i3’s auto_back_and_forth.
nullmodules/homeManager/settings/binds.nixhyprnix.settings.binds.workspace_center_on Link copied!
null or one of 0, 1Whether switching workspaces should center the cursor on the workspace (0) or on the last active window for that workspace (1)
nullmodules/homeManager/settings/binds.nixhyprnix.settings.cursor.default_monitor Link copied!
null or stringthe name of a default monitor for the cursor to be set to on startup (see hyprctl monitors for names)
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.hide_on_key_press Link copied!
null or booleanHides the cursor when you press any key until the mouse is moved.
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.hide_on_tablet Link copied!
null or booleanHides the cursor when the last input was a tablet input until a mouse input is done.
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.hide_on_touch Link copied!
null or booleanHides the cursor when the last input was a touch input until a mouse input is done.
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.hotspot_padding Link copied!
null or (unsigned integer, meaning >=0)the padding, in logical px, between screen edges and the cursor
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.hyprcursor.enable Link copied!
null or booleanwhether to enable hyprcursor support
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.hyprcursor.name Link copied!
null or stringset cursor's name. Requires Hyprland restart.
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.hyprcursor.package Link copied!
null or packageset cursor's package to install
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.hyprcursor.size Link copied!
null or (positive integer, meaning >0)set cursor's size. Requires Hyprland restart.
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.inactive_timeout Link copied!
null or unsigned number, meaning >=0in seconds, after how many seconds of cursor’s inactivity to hide it. Set to 0 for never.
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.invisible Link copied!
null or booleandon't render cursors
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.min_refresh_rate Link copied!
null or (unsigned integer, meaning >=0)minimum refresh rate for cursor movement when no_break_fs_vrr = 1 Set to minimum supported refresh rate or higher
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.no_break_fs_vrr Link copied!
null or integer between 0 and 2 (both inclusive)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’)
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.no_hardware_cursors Link copied!
null or integer between 0 and 2 (both inclusive)disables hardware cursors. 0 - use hw cursors if possible, 1 - don’t use hw cursors, 2 - auto (disable when tearing)
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.no_warps Link copied!
null or booleanif true, will not warp the cursor in many cases (focusing, keybinds, etc)
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.persistent_warps Link copied!
null or booleanWhen a window is refocused, the cursor returns to its last position relative to that window, rather than to the centre.
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.sync_gsettings_theme Link copied!
null or booleansync 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.
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.use_cpu_buffer Link copied!
null or integer between 0 and 2 (both inclusive)(NVIDIA Only) Makes HW cursors use a CPU buffer. Required on NVIDIA to have HW cursors. 0 - off, 1 - on, 2 - auto
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.warp_back_after_non_mouse_input Link copied!
null or booleanWarp the cursor back to where it was after using a non-mouse input to move it, and then returning back to mouse.
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.warp_on_change_workspace Link copied!
null or integer between 0 and 2 (both inclusive)Move the cursor to the last focused window after changing the workspace. Options: 0 (Disabled), 1 (Enabled), 2 (Force - ignores cursor.no_warps option)
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.warp_on_toggle_special Link copied!
null or integer between 0 and 2 (both inclusive)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)
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.zoom_detached_camera Link copied!
null or booleandetach 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
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.zoom_disable_aa Link copied!
null or booleandisable antialiasing when zooming, which means things will be pixelated instead of blurry
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.zoom_factor Link copied!
null or positive number, meaning >0the factor to zoom by around the cursor. Like a magnifying glass. Minimum 1.0 (meaning no zoom)
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.cursor.zoom_rigid Link copied!
null or booleanwhether the zoom should follow the cursor rigidly (cursor is always centered if it can be) or loosely
nullmodules/homeManager/settings/cursor.nixhyprnix.settings.debug.colored_stdout_logs Link copied!
null or booleanenables colors in the stdout logs.
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.damage_blink Link copied!
null or boolean(epilepsy warning!) flash areas updated with damage tracking
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.damage_tracking Link copied!
null or integer between 0 and 2 (both inclusive)redraw only the needed bits of the display. Do not change. 0 - none, 1 - monitor, 2 - full (default on Hyprland)
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.disable_logs Link copied!
null or booleandisable logging to a file
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.disable_scale_checks Link copied!
null or booleandisables verification of the scale factors. Will result in pixel alignment and rounding errors.
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.disable_time Link copied!
null or booleandisables time logging
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.enable_stdout_logs Link copied!
null or booleanenables logging to stdout
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.error_limit Link copied!
null or (positive integer, meaning >0)limits the number of displayed config file parsing errors.
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.error_position Link copied!
null or integer between 0 and 1 (both inclusive)sets the position of the error bar. top - 0, bottom - 1
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.full_cm_proto Link copied!
null or booleanclaims support for all cm proto features (requires restart)
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.gl_debugging Link copied!
null or booleanenables OpenGL debugging with glGetError and EGL_KHR_debug, requires a restart after changing.
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.manual_crash Link copied!
null or integer between 0 and 1 (both inclusive)set to 1 and then back to 0 to crash Hyprland.
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.overlay Link copied!
null or booleanprint the debug performance overlay. Disable VFR for accurate results.
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.pass Link copied!
null or booleanenables render pass debugging.
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.suppress_errors Link copied!
null or booleanif true, do not display config file parsing errors.
nullmodules/homeManager/settings/debug.nixhyprnix.settings.debug.watchdog_timeout Link copied!
null or (unsigned integer, meaning >=0)sets the timeout in seconds for watchdog to abort processing of a signal of the main thread. Set to 0 to disable.
nullmodules/homeManager/settings/debug.nixhyprnix.settings.decoration.active_opacity Link copied!
null or number between 0 and 1 (both inclusive)opacity of active windows
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.brightness Link copied!
null or number between 0 and 2 (both inclusive)brightness modulation for blur
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.contrast Link copied!
null or number between 0 and 2 (both inclusive)contrast modulation for blur
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.enabled Link copied!
null or booleanenable kawase window background blur
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.ignore_opacity Link copied!
null or booleanmake the blur layer ignore the opacity of the window
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.input_methods Link copied!
null or booleanwhether to blur input methods (e.g. fcitx5)
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.input_methods_ignorealpha Link copied!
null or number between 0 and 1 (both inclusive)works like ignore_alpha in layer rules. If pixel opacity is below set value, will not blur
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.new_optimizations Link copied!
null or booleanwhether to enable further optimizations to the blur. Recommended to leave on, as it will massively improve performance.
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.noise Link copied!
null or number between 0 and 1 (both inclusive)how much noise to apply
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.passes Link copied!
null or (positive integer, meaning >0)the amount of passes to perform
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.popups Link copied!
null or booleanwhether to blur popups (e.g. right-click menus)
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.popups_ignorealpha Link copied!
null or number between 0 and 1 (both inclusive)works like ignore_alpha in layer rules. If pixel opacity is below set value, will not blur
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.size Link copied!
null or (positive integer, meaning >0)blur size (distance)
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.special Link copied!
null or booleanwhether to blur behind the special workspace (note: expensive)
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.vibrancy Link copied!
null or number between 0 and 1 (both inclusive)Increase saturation of blurred colors
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.vibrancy_darkness Link copied!
null or number between 0 and 1 (both inclusive)How strong the effect of vibrancy is on dark areas
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.blur.xray Link copied!
null or booleanif enabled, floating windows will ignore tiled windows in their blur. Only available if new_optimizations is true. Will reduce overhead on floating blur significantly.
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.border_part_of_window Link copied!
null or booleanwhether the window border should be a part of the window
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.dim_around Link copied!
null or number between 0 and 1 (both inclusive)how much the dim_around window rule should dim by
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.dim_inactive Link copied!
null or booleanenables dimming of inactive windows
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.dim_modal Link copied!
null or booleanenables dimming of parents of modal windows
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.dim_special Link copied!
null or number between 0 and 1 (both inclusive)how much to dim the rest of the screen by when a special workspace is open
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.dim_strength Link copied!
null or number between 0 and 1 (both inclusive)how much inactive windows should be dimmed
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.fullscreen_opacity Link copied!
null or number between 0 and 1 (both inclusive)opacity of fullscreen windows
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.glow.color Link copied!
null or stringglow’s color. Alpha dictates glow’s opacity.
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.glow.color_inactive Link copied!
null or stringinactive glow color. (if not set, will fall back to color)
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.glow.enabled Link copied!
null or booleanenable inner glow on windows
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.glow.range Link copied!
null or (positive integer, meaning >0)Glow range ("size") in layout px
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.glow.render_power Link copied!
null or integer between 1 and 4 (both inclusive)in what power to render the falloff (more power, the faster the falloff)
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.inactive_opacity Link copied!
null or number between 0 and 1 (both inclusive)opacity of inactive windows
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.rounding Link copied!
null or (unsigned integer, meaning >=0)rounded corners’ radius (in layout px)
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.rounding_power Link copied!
null or number between 1 and 10 (both inclusive)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
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.screen_shader Link copied!
null or string or absolute patha path to a custom shader to be applied at the end of rendering. See examples/screenShader.frag for an example.
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.shadow.color Link copied!
null or stringshadow’s color. Alpha dictates shadow’s opacity.
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.shadow.color_inactive Link copied!
null or stringinactive shadow color. (if not set, will fall back to color)
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.shadow.enabled Link copied!
null or booleanenable drop shadows on windows
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.shadow.ignore_window Link copied!
null or booleanif true, the shadow will not be rendered behind the window itself, only around it.
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.shadow.offset Link copied!
null or (list with 2 number values)shadow’s rendering offset.
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.shadow.range Link copied!
null or (positive integer, meaning >0)Shadow range ("size") in layout px
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.shadow.render_power Link copied!
null or integer between 1 and 4 (both inclusive)in what power to render the falloff (more power, the faster the falloff)
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.shadow.scale Link copied!
null or number between 0 and 1 (both inclusive)shadow's scale
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.decoration.shadow.sharp Link copied!
null or booleanif enabled, will make the shadows sharp, akin to an infinite render power
nullmodules/homeManager/settings/decoration.nixhyprnix.settings.dwindle.default_split_ratio Link copied!
null or number between 0.100000 and 1.900000 (both inclusive)The default split ratio on window open. 1 means even 50/50 split.
nullmodules/homeManager/settings/dwindle.nixhyprnix.settings.dwindle.force_split Link copied!
null or integer between 0 and 2 (both inclusive)0 -> split follows mouse 1 -> always split to the left (new = left or top) 2 -> always split to the right (new = right or bottom)
nullmodules/homeManager/settings/dwindle.nixhyprnix.settings.dwindle.permanent_direction_override Link copied!
null or booleanIf 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)
nullmodules/homeManager/settings/dwindle.nixhyprnix.settings.dwindle.precise_mouse_move Link copied!
null or booleanIf enabled bindm movewindow will drop the window more precisely depending on where your mouse is.
nullmodules/homeManager/settings/dwindle.nixhyprnix.settings.dwindle.preserve_split Link copied!
null or booleanIf enabled, the split (side/top) will not change regardless of what happens to the container.
nullmodules/homeManager/settings/dwindle.nixhyprnix.settings.dwindle.pseudotile Link copied!
null or booleanPseudotiled windows retain their floating size when tiled.
nullmodules/homeManager/settings/dwindle.nixhyprnix.settings.dwindle.smart_resizing Link copied!
null or booleanIf 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.
nullmodules/homeManager/settings/dwindle.nixhyprnix.settings.dwindle.smart_split Link copied!
null or booleanIf 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.
nullmodules/homeManager/settings/dwindle.nixhyprnix.settings.dwindle.special_scale_factor Link copied!
null or number between 0 and 1 (both inclusive)Specifies the scale factor of windows on the special workspace
nullmodules/homeManager/settings/dwindle.nixhyprnix.settings.dwindle.split_bias Link copied!
null or one of 0, 1Specifies which window will receive the split ratio. 0 -> directional (the top or left window) 1 -> the current window
nullmodules/homeManager/settings/dwindle.nixhyprnix.settings.dwindle.split_width_multiplier Link copied!
null or signed integer or floating point numberSpecifies the auto-split width multiplier. Multiplying window size is useful on widescreen monitors where window W > H even after several splits.
nullmodules/homeManager/settings/dwindle.nixhyprnix.settings.dwindle.use_active_for_splits Link copied!
null or booleanPrefer the active window or the mouse position for splits
nullmodules/homeManager/settings/dwindle.nixhyprnix.settings.ecosystem.enforce_permissions Link copied!
null or booleanwhether to enable permission control.
nullmodules/homeManager/settings/ecosystem.nixhyprnix.settings.ecosystem.no_donation_nag Link copied!
null or booleandisable the popup that shows up twice a year encouraging to donate.
nullmodules/homeManager/settings/ecosystem.nixhyprnix.settings.ecosystem.no_update_news Link copied!
null or booleandisable the popup that shows up when you update hyprland to a new version.
nullmodules/homeManager/settings/ecosystem.nixhyprnix.settings.env Link copied!
null or (attribute set of (string or signed integer or floating point number))Environment variables to set, as name-value pairs.
null{
HYPRLAND_TRACE = 1;
QT_QPA_PLATFORM = "wayland;xcb";
XDG_CURRENT_DESKTOP = "Hyprland";
}modules/homeManager/settings/env.nixhyprnix.settings.exec Link copied!
list of stringShell scripts that will execute on each reload
[ ]modules/homeManager/settings/exec.nixhyprnix.settings.exec-once Link copied!
list of stringShell scripts that will execute only on launch
[ ]modules/homeManager/settings/exec.nixhyprnix.settings.exec-shutdown Link copied!
list of stringShell scripts that will execute only on shutdown
[ ]modules/homeManager/settings/exec.nixhyprnix.settings.execr Link copied!
list of stringRaw shell scripts that will execute on each reload
[ ]modules/homeManager/settings/exec.nixhyprnix.settings.execr-once Link copied!
list of stringRaw shell scripts that will execute only on launch
[ ]modules/homeManager/settings/exec.nixhyprnix.settings.general.allow_tearing Link copied!
null or booleanmaster switch for allowing tearing to occur. See the Tearing page.
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.border_size Link copied!
null or (positive integer, meaning >0)size of the border around windows
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.col.active_border Link copied!
null or stringborder color for the active window
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.col.inactive_border Link copied!
null or stringborder color for inactive windows
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.col.nogroup_border Link copied!
null or stringinactive border color for window that cannot be added to a group (see denywindowfromgroup dispatcher)
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.col.nogroup_border_active Link copied!
null or stringactive border color for window that cannot be added to a group
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.extend_border_grab_area Link copied!
null or (positive integer, meaning >0)extends the area around the border where you can click and drag on, only used when general:resize_on_border is on.
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.float_gaps Link copied!
null or signed integergaps between windows and monitor edges for floating windows, also supports css style gaps (top, right, bottom, left -> 5 10 15 20). -1 means default
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.gaps_in Link copied!
null or (unsigned integer, meaning >=0)gaps between windows, also supports css style gaps (top, right, bottom, left -> 5,10,15,20)
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.gaps_out Link copied!
null or (unsigned integer, meaning >=0)gaps between windows and monitor edges, also supports css style gaps (top, right, bottom, left -> 5,10,15,20)
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.gaps_workspaces Link copied!
null or (unsigned integer, meaning >=0)gaps between workspaces. Stacks with gaps_out.
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.hover_icon_on_border Link copied!
null or booleanshow a cursor icon when hovering over borders, only used when general:resize_on_border is on.
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.layout Link copied!
null or one of "dwindle", "master", "scrolling", "monocle"which layout to use
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.locale Link copied!
null or stringoverrides the system locale (e.g. en_US, es)
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.modal_parent_blocking Link copied!
null or booleanwhether parent windows of modals will be interactive
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.no_focus_fallback Link copied!
null or booleanif true, will not fall back to the next available window when moving focus in a direction where no window was found
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.resize_corner Link copied!
null or integer between 0 and 4 (both inclusive)force floating windows to use a specific corner when being resized (1-4 going clockwise from top left, 0 to disable)
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.resize_on_border Link copied!
null or booleanenables resizing windows by clicking and dragging on borders and gaps
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.snap.border_overlap Link copied!
null or booleanif true, windows snap such that only one border’s worth of space is between them
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.snap.enabled Link copied!
null or booleanenable snapping for floating windows
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.snap.monitor_gap Link copied!
null or (unsigned integer, meaning >=0)minimum gap in pixels between window and monitor edges before snapping
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.snap.respect_gaps Link copied!
null or booleanif true, snapping will respect gaps between windows(set in general:gaps_in)
nullmodules/homeManager/settings/general.nixhyprnix.settings.general.snap.window_gap Link copied!
null or (unsigned integer, meaning >=0)minimum gap in pixels between windows before snapping
nullmodules/homeManager/settings/general.nixhyprnix.settings.gesture.close_max_timeout Link copied!
null or (unsigned integer, meaning >=0)the timeout for a window to close when using a 1:1 gesture, in ms
nullmodules/homeManager/settings/gesture.nixhyprnix.settings.gesture.gestures Link copied!
null or (list of (string or (submodule)))list of gestures
[ ][
{
action = "close";
direction = "pinchOut";
fingers = 2;
}
"3, up, mod: SUPER, scale: 1.5, fullscreen"
]modules/homeManager/settings/gesture.nixhyprnix.settings.gesture.workspace_swipe_cancel_ratio Link copied!
null or number between 0 and 1 (both inclusive)how much the swipe has to proceed in order to commence it. (0.7 -> if > 0.7 * distance, switch, if less, revert)
nullmodules/homeManager/settings/gesture.nixhyprnix.settings.gesture.workspace_swipe_create_new Link copied!
null or booleanwhether a swipe right on the last workspace should create a new one.
nullmodules/homeManager/settings/gesture.nixhyprnix.settings.gesture.workspace_swipe_direction_lock Link copied!
null or booleanif enabled, switching direction will be locked when you swipe past the direction_lock_threshold (touchpad only).
nullmodules/homeManager/settings/gesture.nixhyprnix.settings.gesture.workspace_swipe_direction_lock_threshold Link copied!
null or (unsigned integer, meaning >=0)in px, the distance to swipe before direction lock activates (touchpad only).
nullmodules/homeManager/settings/gesture.nixhyprnix.settings.gesture.workspace_swipe_distance Link copied!
null or (unsigned integer, meaning >=0)in px, the distance of the touchpad gesture
nullmodules/homeManager/settings/gesture.nixhyprnix.settings.gesture.workspace_swipe_forever Link copied!
null or booleanif enabled, swiping will not clamp at the neighboring workspaces but continue to the further ones.
nullmodules/homeManager/settings/gesture.nixhyprnix.settings.gesture.workspace_swipe_invert Link copied!
null or booleaninvert the direction (touchpad only)
nullmodules/homeManager/settings/gesture.nixhyprnix.settings.gesture.workspace_swipe_min_speed_to_force Link copied!
null or (unsigned integer, meaning >=0)minimum speed in px per timepoint to force the change ignoring cancel_ratio. Setting to 0 will disable this mechanic.
nullmodules/homeManager/settings/gesture.nixhyprnix.settings.gesture.workspace_swipe_touch Link copied!
null or booleanenable workspace swiping from the edge of a touchscreen
nullmodules/homeManager/settings/gesture.nixhyprnix.settings.gesture.workspace_swipe_touch_invert Link copied!
null or booleaninvert the direction (touchscreen only)
nullmodules/homeManager/settings/gesture.nixhyprnix.settings.gesture.workspace_swipe_use_r Link copied!
null or booleanif enabled, swiping will use the r prefix instead of the m prefix for finding workspaces.
nullmodules/homeManager/settings/gesture.nixhyprnix.settings.group.auto_group Link copied!
null or booleanwhether 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.
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.col.border_active Link copied!
null or stringactive group border color
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.col.border_inactive Link copied!
null or stringinactive (out of focus) group border color
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.col.border_locked_active Link copied!
null or stringactive locked group border color
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.col.border_locked_inactive Link copied!
null or stringinactive locked group border color
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.drag_into_group Link copied!
null or integer between 0 and 2 (both inclusive)whether dragging a window into a unlocked group will merge them. 0 -> disabled. 1 -> enabled. 2 -> only when dragging into the groupbar.
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.focus_removed_window Link copied!
null or booleanwhether Hyprland should focus on the window that has just been moved out of the group
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.group_on_movetoworkspace Link copied!
null or booleanwhether using movetoworkspace[silent] will merge the window into the workspace’s solitary unlocked group
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.blur Link copied!
null or booleanapplies blur to the groupbar indicators and gradients
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.col.active Link copied!
null or stringactive group bar background color
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.col.inactive Link copied!
null or stringinactive (out of focus) group bar background color
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.col.locked_active Link copied!
null or stringactive locked group bar background color
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.col.locked_inactive Link copied!
null or stringinactive locked group bar background color
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.enabled Link copied!
null or booleanenables groupbars
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.font_family Link copied!
null or stringfont used to display groupbar titles, use misc:font_family if not specified
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.font_size Link copied!
null or (positive integer, meaning >0)font size of groupbar title
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.font_weight_active Link copied!
null or integer between 100 and 1000 (both inclusive) or one of "thin", "ultralight", "light", "semilight", "book", "normal", "medium", "semibold", "bold", "ultrabold", "heavy", "ultraheavy"font weight of active groupbar title
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.font_weight_inactive Link copied!
null or integer between 100 and 1000 (both inclusive) or one of "thin", "ultralight", "light", "semilight", "book", "normal", "medium", "semibold", "bold", "ultrabold", "heavy", "ultraheavy"font weight of inactive groupbar title
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.gaps_in Link copied!
null or (unsigned integer, meaning >=0)gap size between gradients
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.gaps_out Link copied!
null or (unsigned integer, meaning >=0)gap size between gradients and window
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.gradient_round_only_edges Link copied!
null or booleanround only the gradient edges of the entire groupbar
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.gradient_rounding Link copied!
null or (unsigned integer, meaning >=0)how much to round the gradients
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.gradient_rounding_power Link copied!
null or number between 1 and 10 (both inclusive)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
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.gradients Link copied!
null or booleanenables gradients
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.height Link copied!
null or (positive integer, meaning >0)height of the groupbar
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.indicator_gap Link copied!
null or (unsigned integer, meaning >=0)height of gap between groupbar indicator and title
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.indicator_height Link copied!
null or (positive integer, meaning >0)height of the groupbar indicator
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.keep_upper_gap Link copied!
null or booleanadd or remove upper gap
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.priority Link copied!
null or signed integersets the decoration priority for groupbars
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.render_titles Link copied!
null or booleanwhether to render titles in the group bar decoration
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.round_only_edges Link copied!
null or booleanround only the indicator edges of the entire groupbar
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.rounding Link copied!
null or (unsigned integer, meaning >=0)how much to round the indicator
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.rounding_power Link copied!
null or number between 1 and 10 (both inclusive)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
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.scrolling Link copied!
null or booleanwhether scrolling in the groupbar changes group active window
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.stacked Link copied!
null or booleanrender the groupbar as a vertical stack
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.text_color Link copied!
null or stringcolor for window titles in the groupbar
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.text_color_inactive Link copied!
null or stringcolor for inactive windows’ titles in the groupbar (if unset, defaults to text_color)
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.text_color_locked_active Link copied!
null or stringcolor for the active window’s title in a locked group (if unset, defaults to text_color)
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.text_color_locked_inactive Link copied!
null or stringcolor for inactive windows’ titles in locked groups (if unset, defaults to text_color_inactive)
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.text_offset Link copied!
null or signed integeradjust vertical position for titles
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.groupbar.text_padding Link copied!
null or (unsigned integer, meaning >=0)set horizontal padding for titles
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.insert_after_current Link copied!
null or booleanwhether new windows in a group spawn after current or at group tail
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.merge_floated_into_tiled_on_groupbar Link copied!
null or booleanwhether dragging a floating window into a tiled window groupbar will merge them
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.merge_groups_on_drag Link copied!
null or booleanwhether window groups can be dragged into other groups
nullmodules/homeManager/settings/group.nixhyprnix.settings.group.merge_groups_on_groupbar Link copied!
null or booleanwhether one group will be merged with another when dragged into its groupbar
nullmodules/homeManager/settings/group.nixhyprnix.settings.input.accel_profile Link copied!
null or one of "adaptive", "flat", "custom"Sets the cursor acceleration profile. Leave empty to use libinput’s default mode for your input device.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.emulate_discrete_scroll Link copied!
null or integer between 0 and 2 (both inclusive)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.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.float_switch_override_focus Link copied!
null or integer between 1 and 2 (both inclusive)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.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.focus_on_close Link copied!
null or integer between 0 and 2 (both inclusive)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.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.follow_mouse Link copied!
null or integer between 0 and 3 (both inclusive)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.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.follow_mouse_threshold Link copied!
null or unsigned number, meaning >=0The smallest distance in logical pixels the mouse needs to travel for the window under it to get focused. Works only with follow_mouse = 1.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.force_no_accel Link copied!
null or booleanForce 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.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.kb_file Link copied!
null or string or absolute pathIf you prefer, you can use a path to your custom .xkb file.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.kb_layout Link copied!
null or stringAppropriate XKB keymap parameter
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.kb_model Link copied!
null or stringAppropriate XKB keymap parameter
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.kb_options Link copied!
null or stringAppropriate XKB keymap parameter
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.kb_rules Link copied!
null or stringAppropriate XKB keymap parameter
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.kb_variant Link copied!
null or stringAppropriate XKB keymap parameter
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.left_handed Link copied!
null or booleanSwitches RMB and LMB
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.mouse_refocus Link copied!
null or booleanIf disabled, mouse focus won’t switch to the hovered window unless the mouse crosses a window boundary when follow_mouse=1.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.natural_scroll Link copied!
null or booleanInverts scrolling direction. When enabled, scrolling moves content directly, rather than manipulating a scrollbar.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.numlock_by_default Link copied!
null or booleanEngage numlock by default.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.off_window_axis_events Link copied!
null or integer between 0 and 3 (both inclusive)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.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.repeat_delay Link copied!
null or (unsigned integer, meaning >=0)Delay before a held-down key is repeated, in milliseconds.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.repeat_rate Link copied!
null or (positive integer, meaning >0)The repeat rate for held-down keys, in repeats per second.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.resolve_binds_by_sym Link copied!
null or booleanDetermines 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.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.rotation Link copied!
null or integer between 0 and 359 (both inclusive)Sets the rotation of a device in degrees clockwise off the logical neutral position.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.scroll_button Link copied!
null or (unsigned integer, meaning >=0)Sets the scroll button. Check wev if you have any doubts regarding the ID. 0 means default.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.scroll_button_lock Link copied!
null or booleanIf 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.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.scroll_factor Link copied!
null or signed integer or floating point numberMultiplier added to scroll movement for external mice. Note that there is a separate setting for touchpad scroll_factor.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.scroll_method Link copied!
null or one of "2fg", "edge", "on_button_down", "no_scroll"Sets the scroll method.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.scroll_points Link copied!
null or stringSets 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.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.sensitivity Link copied!
null or number between -1 and 1 (both inclusive)Sets the mouse input sensitivity.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.special_fallthrough Link copied!
null or booleanif enabled, having only floating windows in the special workspace will not block focusing windows in the regular workspace.
nullmodules/homeManager/settings/input/default.nixhyprnix.settings.input.tablet.absolute_region_position Link copied!
null or booleanwhether to treat the region_position as an absolute position in monitor layout. Only applies when output is empty.
nullmodules/homeManager/settings/input/tablet.nixhyprnix.settings.input.tablet.active_area_position Link copied!
null or (list with 2 number values)position of the active area in mm
nullmodules/homeManager/settings/input/tablet.nixhyprnix.settings.input.tablet.active_area_size Link copied!
null or (list with 2 number values)size of tablet’s active area in mm
nullmodules/homeManager/settings/input/tablet.nixhyprnix.settings.input.tablet.left_handed Link copied!
null or booleanif enabled, the tablet will be rotated 180 degrees
nullmodules/homeManager/settings/input/tablet.nixhyprnix.settings.input.tablet.output Link copied!
null or stringthe monitor to bind tablets. Can be current or a monitor name. Leave empty to map across all monitors.
nullmodules/homeManager/settings/input/tablet.nixhyprnix.settings.input.tablet.region_position Link copied!
null or (list with 2 number values)position of the mapped region in monitor layout relative to the top left corner of the bound monitor or all monitors.
nullmodules/homeManager/settings/input/tablet.nixhyprnix.settings.input.tablet.region_size Link copied!
null or (list with 2 number values)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.
nullmodules/homeManager/settings/input/tablet.nixhyprnix.settings.input.tablet.relative_input Link copied!
null or booleanwhether the input should be relative
nullmodules/homeManager/settings/input/tablet.nixhyprnix.settings.input.tablet.transform Link copied!
null or integer between -1 and 7 (both inclusive)transform the input from tablets. The possible transformations are the same as those of the monitors. -1 means it’s unset.
nullmodules/homeManager/settings/input/tablet.nixhyprnix.settings.input.touchdevice.enabled Link copied!
null or booleanWhether input is enabled for touch devices.
nullmodules/homeManager/settings/input/touchdevice.nixhyprnix.settings.input.touchdevice.output Link copied!
null or stringThe monitor to bind touch devices. The default is auto-detection. To stop auto-detection, use an empty string or the “[[Empty]]” value.
nullmodules/homeManager/settings/input/touchdevice.nixhyprnix.settings.input.touchdevice.transform Link copied!
null or integer between -1 and 7 (both inclusive)Transform the input from touchdevices. The possible transformations are the same as those of the monitors. -1 means it’s unset.
nullmodules/homeManager/settings/input/touchdevice.nixhyprnix.settings.input.touchpad.clickfinger_behavior Link copied!
null or booleanButton 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.
nullmodules/homeManager/settings/input/touchpad.nixhyprnix.settings.input.touchpad.disable_while_typing Link copied!
null or booleanDisable the touchpad while typing.
nullmodules/homeManager/settings/input/touchpad.nixhyprnix.settings.input.touchpad.drag_3fd Link copied!
null or integer between 0 and 2 (both inclusive)enables three finger drag. 0 -> disabled. 1 -> 3 fingers. 2 -> 4 fingers.
nullmodules/homeManager/settings/input/touchpad.nixhyprnix.settings.input.touchpad.drag_lock Link copied!
null or integer between 0 and 2 (both inclusive)When enabled, lifting the finger off while dragging will not drop the dragged item. 0 -> disabled. 1 -> enabled with timeout. 2 -> enabled sticky.
nullmodules/homeManager/settings/input/touchpad.nixhyprnix.settings.input.touchpad.flip_x Link copied!
null or booleaninverts the horizontal movement of the touchpad
nullmodules/homeManager/settings/input/touchpad.nixhyprnix.settings.input.touchpad.flip_y Link copied!
null or booleaninverts the vertical movement of the touchpad
nullmodules/homeManager/settings/input/touchpad.nixhyprnix.settings.input.touchpad.middle_button_emulation Link copied!
null or booleanSending 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.
nullmodules/homeManager/settings/input/touchpad.nixhyprnix.settings.input.touchpad.natural_scroll Link copied!
null or booleanInverts scrolling direction. When enabled, scrolling moves content directly, rather than manipulating a scrollbar.
nullmodules/homeManager/settings/input/touchpad.nixhyprnix.settings.input.touchpad.scroll_factor Link copied!
null or signed integer or floating point numberMultiplier applied to the amount of scroll movement.
nullmodules/homeManager/settings/input/touchpad.nixhyprnix.settings.input.touchpad.tap-and-drag Link copied!
null or booleanSets the tap and drag mode for the touchpad
nullmodules/homeManager/settings/input/touchpad.nixhyprnix.settings.input.touchpad.tap-to-click Link copied!
null or booleanTapping on the touchpad with 1, 2, or 3 fingers will send LMB, RMB, and MMB respectively.
nullmodules/homeManager/settings/input/touchpad.nixhyprnix.settings.input.touchpad.tap_button_map Link copied!
null or one of "lrm", "lmr"Sets the tap button mapping for touchpad button emulation. Can be one of lrm (default) or lmr (Left, Middle, Right Buttons)
nullmodules/homeManager/settings/input/touchpad.nixhyprnix.settings.input.virtualkeyboard.release_pressed_on_close Link copied!
null or booleanRelease all pressed keys by virtual keyboard on close.
nullhyprnix.settings.input.virtualkeyboard.share_states Link copied!
null or integer between 0 and 2 (both inclusive)Unify key down states and modifier states with other keyboards. 0 -> no. 1 -> yes. 2 -> yes unless IME client.
nullhyprnix.settings.keybinds Link copied!
attribute set of (attribute set)This option has no description.
{ }{
bind = {
"SUPER, Q" = "exit";
};
bindel = {
XF86AudioRaiseVolume = "exec, pamixer -i 5";
};
}modules/homeManager/settings/keybinds.nixhyprnix.settings.layout.single_window_aspect_ratio Link copied!
null or (list with 2 int values)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.
nullmodules/homeManager/settings/layout.nixhyprnix.settings.layout.single_window_aspect_ratio_tolerance Link copied!
null or number between 0 and 1 (both inclusive)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
nullmodules/homeManager/settings/layout.nixhyprnix.settings.master.allow_small_split Link copied!
null or booleanenable adding additional master windows in a horizontal split style
nullmodules/homeManager/settings/master.nixhyprnix.settings.master.always_keep_position Link copied!
null or booleanwhether to keep the master window in its configured position when there are no slave windows
nullmodules/homeManager/settings/master.nixhyprnix.settings.master.center_master_fallback Link copied!
null or one of "left", "right", "top", "bottom"Set fallback for center master when slaves are less than slave_count_for_center_master
nullmodules/homeManager/settings/master.nixhyprnix.settings.master.drop_at_cursor Link copied!
null or booleanwhen 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.
nullmodules/homeManager/settings/master.nixhyprnix.settings.master.mfact Link copied!
null or number between 0 and 1 (both inclusive)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
nullmodules/homeManager/settings/master.nixhyprnix.settings.master.new_on_active Link copied!
null or one of "before", "after", "none"before, after: place new window relative to the focused window; none: place new window according to the value of new_on_top.
nullmodules/homeManager/settings/master.nixhyprnix.settings.master.new_on_top Link copied!
null or booleanwhether a newly open window should be on the top of the stack
nullmodules/homeManager/settings/master.nixhyprnix.settings.master.new_status Link copied!
null or one of "master", "slave", "inherit"master: new window becomes master; slave: new windows are added to slave stack; inherit: inherit from focused window
nullmodules/homeManager/settings/master.nixhyprnix.settings.master.orientation Link copied!
null or one of "left", "right", "top", "bottom", "center"default placement of the master area
nullmodules/homeManager/settings/master.nixhyprnix.settings.master.slave_count_for_center_master Link copied!
null or (unsigned integer, meaning >=0)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.
nullmodules/homeManager/settings/master.nixhyprnix.settings.master.smart_resizing Link copied!
null or booleanif 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.
nullmodules/homeManager/settings/master.nixhyprnix.settings.master.special_scale_factor Link copied!
null or number between 0 and 1 (both inclusive)the scale of the special workspace windows.
nullmodules/homeManager/settings/master.nixhyprnix.settings.misc.allow_session_lock_restore Link copied!
null or booleanif true, will allow you to restart a lockscreen app in case it crashes
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.always_follow_on_dnd Link copied!
null or booleanWill make mouse focus follow the mouse when drag and dropping. Recommended to leave it enabled, especially for people using focus follows mouse at 0.
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.animate_manual_resizes Link copied!
null or booleanIf true, will animate manual window resizes/moves
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.animate_mouse_windowdragging Link copied!
null or booleanIf true, will animate windows being dragged by mouse, note that this can cause weird behavior on some curves
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.anr_missed_pings Link copied!
null or (positive integer, meaning >0)number of missed pings before showing the ANR dialog
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.background_color Link copied!
null or stringchange the background color. (requires enabled disable_hyprland_logo)
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.close_special_on_empty Link copied!
null or booleanclose the special workspace if the last window is removed
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.col.splash Link copied!
null or stringChanges the color of the splash text (requires a monitor reload to take effect).
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.disable_autoreload Link copied!
null or booleanIf true, the config will not reload automatically on save, and instead needs to be reloaded with hyprctl reload. Might save on battery.
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.disable_hyprland_logo Link copied!
null or booleandisables the random Hyprland logo / anime girl background.
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.disable_hyprland_qtutils_check Link copied!
null or booleandisable the warning if hyprland-qtutils is not installed
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.disable_scale_notification Link copied!
null or booleandisables notification popup when a monitor fails to set a suitable scale
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.disable_splash_rendering Link copied!
null or booleandisables the Hyprland splash rendering. (requires a monitor reload to take effect)
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.disable_watchdog_warning Link copied!
null or booleanwhether to disable the warning about not using start-hyprland
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.disable_xdg_env_checks Link copied!
null or booleandisable the warning if XDG environment is externally managed
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.enable_anr_dialog Link copied!
null or booleanwhether to enable the ANR (app not responding) dialog when your apps hang
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.enable_swallow Link copied!
null or booleanEnable window swallowing
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.exit_window_retains_fullscreen Link copied!
null or booleanif true, closing a fullscreen window makes the next focused window fullscreen
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.focus_on_activate Link copied!
null or booleanWhether Hyprland should focus an app that requests to be focused (an activate request)
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.font_family Link copied!
null or stringSet the global default font to render the text including debug fps/notification, config error messages and etc., selected from system fonts.
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.force_default_wallpaper Link copied!
null or integer between -1 and 2 (both inclusive)Enforce any of the 3 default wallpapers. Setting this to 0 or 1 disables the anime background. -1 means “random”.
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.initial_workspace_tracking Link copied!
null or integer between 0 and 2 (both inclusive)if enabled, windows will open on the workspace they were invoked on. 0 - disabled, 1 - single-shot, 2 - persistent (all children too)
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.key_press_enables_dpms Link copied!
null or booleanIf DPMS is set to off, wake up the monitors if a key is pressed.
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.layers_hog_keyboard_focus Link copied!
null or booleanIf true, will make keyboard-interactive layers keep their focus on mouse move (e.g. wofi, bemenu)
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.lockdead_screen_delay Link copied!
null or integer between 100 and 5000 (both inclusive)delay after which the "lockdead" screen will appear in case a lockscreen app fails to cover all the outputs (5 seconds max)
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.middle_click_paste Link copied!
null or booleanwhether to enable middle-click-paste (aka primary selection)
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.mouse_move_enables_dpms Link copied!
null or booleanIf DPMS is set to off, wake up the monitors if the mouse moves.
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.mouse_move_focuses_monitor Link copied!
null or booleanWhether mouse moving into a different monitor should focus it
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.name_vk_after_proc Link copied!
null or booleanName virtual keyboards after the processes that create them. E.g. /usr/bin/fcitx5 will have hl-virtual-keyboard-fcitx5.
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.on_focus_under_fullscreen Link copied!
null or integer between 0 and 2 (both inclusive)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
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.render_unfocused_fps Link copied!
null or (positive integer, meaning >0)the maximum limit for render_unfocused windows’ fps in the background (see also Window-Rules - render_unfocused)
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.session_lock_xray Link copied!
null or booleanif true, keep rendering workspaces below your lockscreen
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.size_limits_tiled Link copied!
null or booleanwhether to apply min_size and max_size rules to tiled windows
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.splash_font_family Link copied!
null or stringChanges the font used to render the splash text, selected from system fonts (requires a monitor reload to take effect).
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.swallow_exception_regex Link copied!
null or stringThe 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.
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.swallow_regex Link copied!
null or stringThe class regex to be used for windows that should be swallowed (usually, a terminal).
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.vfr Link copied!
null or booleancontrols the VFR status of Hyprland. Heavily recommended to leave enabled to conserve resources.
nullmodules/homeManager/settings/misc.nixhyprnix.settings.misc.vrr Link copied!
null or integer between 0 and 3 (both inclusive)controls the VRR (Adaptive Sync) of your monitors. 0 - off, 1 - on, 2 - fullscreen only, 3 - fullscreen with video or game content type.
nullmodules/homeManager/settings/misc.nixhyprnix.settings.monitors Link copied!
null or (list of (submodule))Hyprland monitors configuration (monitorv2)
[ ]{
mode = "1920x1080@100";
output = "DP-1";
position = "auto";
scale = 1;
}modules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.bitdepth Link copied!
null or one of 8, 10Color bit depth
nullmodules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.disabled Link copied!
null or booleanWhether to disable the monitor
nullmodules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.max_avg_luminance Link copied!
null or signed integer or floating point numberMaximum average luminance of the monitor (nits)
nullmodules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.max_luminance Link copied!
null or signed integer or floating point numberPeak luminance of the monitor (nits)
nullmodules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.min_luminance Link copied!
null or signed integer or floating point numberMinimum luminance of the monitor (nits)
nullmodules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.mirror Link copied!
null or stringMirror another monitor output
null"DP-1"modules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.mode Link copied!
stringResolution and refresh rate
"1920x1080@60"modules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.output Link copied!
stringMonitor output name
"DP-1"modules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.position Link copied!
stringMonitor position
"0x0"modules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.scale Link copied!
positive number, meaning >0Monitor scale factor
1modules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.sdr_max_luminance Link copied!
null or signed integer or floating point numberSDR maximum luminance for SDR→HDR mapping (nits)
nullmodules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.sdr_min_luminance Link copied!
null or signed integer or floating point numberSDR minimum luminance for SDR→HDR mapping (0.005 for true black matching HDR black)
nullmodules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.supports_hdr Link copied!
null or integer between -1 and 1 (both inclusive)Force HDR support, requires wide color (0=auto, 1=force on, -1=force off)
nullmodules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.supports_wide_color Link copied!
null or integer between -1 and 1 (both inclusive)Force wide color gamut support (0=auto, 1=force on, -1=force off)
nullmodules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.transform Link copied!
null or integer between 0 and 7 (both inclusive)Rotation/flip (0=normal, 1=90°, 2=180°, 3=270°, 4=flipped, 5=flipped+90°, 6=flipped+180°, 7=flipped+270°)
nullmodules/homeManager/settings/monitors.nixhyprnix.settings.monitors.*.vrr Link copied!
null or integer between 0 and 3 (both inclusive)Variable Refresh Rate (0=off, 1=on, 2=fullscreen only, 3=fullscreen with video or game content type)
nullmodules/homeManager/settings/monitors.nixhyprnix.settings.opengl.nvidia_anti_flicker Link copied!
null or booleanreduces flickering on nvidia at the cost of possible frame drops on lower-end GPUs. On non-nvidia, this is ignored.
nullmodules/homeManager/settings/opengl.nixhyprnix.settings.permissions Link copied!
null or (list of (submodule))Hyprland permissions configuration
[ ][
{
executable = "lib.getExe pkgs.grim";
mode = "allow";
permission = "screencopy";
}
]modules/homeManager/settings/permissions.nixhyprnix.settings.permissions.*.executable Link copied!
string or absolute pathpath to executable
"lib.getExe pkgs.grim"modules/homeManager/settings/permissions.nixhyprnix.settings.permissions.*.mode Link copied!
one of "allow", "ask", "deny"permission mode
"allow"modules/homeManager/settings/permissions.nixhyprnix.settings.permissions.*.permission Link copied!
one of "screencopy", "plugin", "keyboard"permission assigned to the executable
"screencopy"modules/homeManager/settings/permissions.nixhyprnix.settings.quirks.prefer_hdr Link copied!
null or integer between 0 and 2 (both inclusive)Report HDR mode as preferred. 0 - off, 1 - always, 2 - gamescope only
nullmodules/homeManager/settings/quirks.nixhyprnix.settings.render.cm_auto_hdr Link copied!
null or integer between 0 and 2 (both inclusive)Auto-switch to HDR in fullscreen when needed. 0 - off, 1 - switch to "cm, hdr," 2 - switch to "cm, hdredid"
nullmodules/homeManager/settings/render.nixhyprnix.settings.render.cm_enabled Link copied!
null or booleanWhether the color management pipeline should be enabled or not (requires a restart of Hyprland to fully take effect)
nullmodules/homeManager/settings/render.nixhyprnix.settings.render.cm_fs_passthrough Link copied!
null or integer between 0 and 2 (both inclusive)Passthrough color settings for fullscreen apps when possible. 0 - off, 1 - always, 2 - hdr only
nullmodules/homeManager/settings/render.nixhyprnix.settings.render.cm_sdr_eotf Link copied!
null or stringDefault 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
nullmodules/homeManager/settings/render.nixhyprnix.settings.render.commit_timing_enabled Link copied!
null or booleanEnable commit timing proto. Requires restart
nullmodules/homeManager/settings/render.nixhyprnix.settings.render.ctm_animation Link copied!
null or (unsigned integer, meaning >=0)Whether to enable a fade animation for CTM changes (hyprsunset). 2 means “auto” which disables them on Nvidia.
nullmodules/homeManager/settings/render.nixhyprnix.settings.render.direct_scanout Link copied!
null or one of 0, 1, 2Enables 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’)
nullmodules/homeManager/settings/render.nixhyprnix.settings.render.expand_undersized_textures Link copied!
null or booleanWhether to expand undersized textures along the edge, or rather stretch the entire texture.
nullmodules/homeManager/settings/render.nixhyprnix.settings.render.new_render_scheduling Link copied!
null or booleanAutomatically uses triple buffering when needed, improves FPS on underpowered devices.
nullmodules/homeManager/settings/render.nixhyprnix.settings.render.non_shader_cm Link copied!
null or integer between 0 and 3 (both inclusive)Enable CM without shader. 0 - disable, 1 - whenever possible, 2 - DS and passthrough only, 3 - disable and ignore CM issues
nullmodules/homeManager/settings/render.nixhyprnix.settings.render.send_content_type Link copied!
null or booleanReport content type to allow monitor profile autoswitch (may result in a black screen during the switch)
nullmodules/homeManager/settings/render.nixhyprnix.settings.render.xp_mode Link copied!
null or booleanDisables back buffer and bottom layer rendering.
nullmodules/homeManager/settings/render.nixhyprnix.settings.scrolling.column_width Link copied!
null or number between 0.100000 and 1 (both inclusive)the default width of a column
nullmodules/homeManager/settings/scrolling.nixhyprnix.settings.scrolling.direction Link copied!
null or one of "left", "right", "down", "up"Direction in which new windows appear and the layout scrolls.
nullmodules/homeManager/settings/scrolling.nixhyprnix.settings.scrolling.explicit_column_widths Link copied!
null or (list of (signed integer or floating point number))A list of preconfigured widths for colresize +conf/-conf
nullmodules/homeManager/settings/scrolling.nixhyprnix.settings.scrolling.focus_fit_method Link copied!
null or integer between 0 and 1 (both inclusive)When a column is focused, what method should be used to bring it into view. 0 = center, 1 = fit
nullmodules/homeManager/settings/scrolling.nixhyprnix.settings.scrolling.follow_focus Link copied!
null or booleanwhen a window is focused, should the layout move to bring it into view automatically
nullmodules/homeManager/settings/scrolling.nixhyprnix.settings.scrolling.follow_min_visible Link copied!
null or number between 0 and 1 (both inclusive)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.
nullmodules/homeManager/settings/scrolling.nixhyprnix.settings.scrolling.fullscreen_on_one_column Link copied!
null or booleanwhen enabled, a single column on a workspace will always span the entire screen.
nullmodules/homeManager/settings/scrolling.nixhyprnix.settings.scrolling.wrap_focus Link copied!
null or booleanWhen enabled, causes layoutmsg focus l/r to wrap around at the beginning and end.
nullmodules/homeManager/settings/scrolling.nixhyprnix.settings.scrolling.wrap_swapcol Link copied!
null or booleanWhen enabled, causes layoutmsg swapcol l/r to wrap around at the beginning and end.
nullmodules/homeManager/settings/scrolling.nixhyprnix.settings.windowrules Link copied!
list of (submodule)Hyprland windowrules configuration.
[ ][
{
center = true;
float = true;
match = {
class = "mpv";
};
name = "floating-mpv";
size = [
1280
720
];
}
{
match = {
class = "kitty";
};
opacity = [
0.9
0.75
];
}
]modules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.allows_input Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.animation Link copied!
null or stringThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.border_color Link copied!
null or stringThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.border_size Link copied!
null or (unsigned integer, meaning >=0)This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.center Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.content Link copied!
null or one of "none", "photo", "video", "game"This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.decorate Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.dim_around Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.float Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.focus_on_activate Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.force_rgbx Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.fullscreen Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.fullscreen_state Link copied!
null or integer between 0 and 3 (both inclusive)This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.idle_inhibit Link copied!
null or one of "none", "always", "focus", "fullscreen"This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.immediate Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.keep_aspect_ratio Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match Link copied!
submoduleMatch conditions.
{ }modules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.class Link copied!
null or stringThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.content Link copied!
null or integer between 0 and 3 (both inclusive)This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.float Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.focus Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.fullscreen Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.fullscreen_state_client Link copied!
null or integer between 0 and 3 (both inclusive)This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.fullscreen_state_internal Link copied!
null or integer between 0 and 3 (both inclusive)This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.group Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.initial_class Link copied!
null or stringThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.initial_title Link copied!
null or stringThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.modal Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.pin Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.tag Link copied!
null or stringThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.title Link copied!
null or stringThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.workspace Link copied!
null or unsigned integer, meaning >=0, or stringThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.xdg_tag Link copied!
null or stringThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.match.xwayland Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.max_size Link copied!
null or (list of (unsigned integer, meaning >=0))This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.maximize Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.min_size Link copied!
null or (list of (unsigned integer, meaning >=0))This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.monitor Link copied!
null or unsigned integer, meaning >=0, or stringThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.move Link copied!
null or string or list of (unsigned integer, meaning >=0)This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.name Link copied!
null or stringName of the windowrule
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.nearest_neighbor Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.no_anim Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.no_blur Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.no_close_for Link copied!
null or (unsigned integer, meaning >=0)This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.no_dim Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.no_focus Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.no_follow_mouse Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.no_initial_focus Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.no_max_size Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.no_screen_share Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.no_shadow Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.no_shortcuts_inhibit Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.no_vrr Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.opacity Link copied!
null or (Additional opacity multiplier.
One value -> sets an overall opacity
Two values -> sets active_opacity and inactive_opacity respectively
Three values -> sets active_opacity, inactive_opacity and fullscreen_opacity respectively.
)This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.opaque Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.persistent_size Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.pin Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.pseudo Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.render_unfocused Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.rounding Link copied!
null or (unsigned integer, meaning >=0)This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.rounding_power Link copied!
null or unsigned number, meaning >=0This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.scroll_mouse Link copied!
null or unsigned number, meaning >=0This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.scroll_touchpad Link copied!
null or unsigned number, meaning >=0This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.scrolling_width Link copied!
null or unsigned number, meaning >=0This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.size Link copied!
null or string or list of (unsigned integer, meaning >=0)This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.stay_focused Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.suppress_event Link copied!
null or one of "fullscreen", "maximize", "activate", "activatefocus", "fullscreenoutput"This option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.sync_fullscreen Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.tag Link copied!
null or stringThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.tile Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.workspace Link copied!
null or unsigned integer, meaning >=0, or stringThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.windowrules.*.xray Link copied!
null or booleanThis option has no description.
nullmodules/homeManager/settings/windowrules.nixhyprnix.settings.workspaces Link copied!
list of (submodule)Hyprland workspace rules configuration.
[ ][
{
id = 1;
rules = {
default = true;
persistent = true;
};
}
]modules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.id Link copied!
integer between 1 and 9 (both inclusive)The workspace's id.
modules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.rules Link copied!
submoduleRules for this workspace. At least one must be set.
{ }modules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.rules.animations Link copied!
null or stringThe animation style to use for this workspace.
nullmodules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.rules.border Link copied!
null or booleanWhether to draw borders or not
nullmodules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.rules.bordersize Link copied!
null or (positive integer, meaning >0)Set the border size around windows (equivalent to General->border_size)
nullmodules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.rules.decorate Link copied!
null or booleanWhether to draw window decorations or not
nullmodules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.rules.default Link copied!
null or booleanWhether this workspace should be the default workspace for the given monitor
nullmodules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.rules.defaultName Link copied!
null or stringA default name for the workspace.
nullmodules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.rules.gapsin Link copied!
null or (unsigned integer, meaning >=0)Set the gaps between windows (equivalent to General->gaps_in)
nullmodules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.rules.gapsout Link copied!
null or (unsigned integer, meaning >=0)Set the gaps between windows and monitor edges (equivalent to General->gaps_out)
nullmodules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.rules.layout Link copied!
null or stringThe layout to use for this workspace.
nullmodules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.rules.monitor Link copied!
null or stringBinds a workspace to a monitor.
nullmodules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.rules.persistent Link copied!
null or booleanKeep this workspace alive even if empty and inactive
nullmodules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.rules.rounding Link copied!
null or booleanWhether to draw rounded windows or not
nullmodules/homeManager/settings/workspaces.nixhyprnix.settings.workspaces.*.rules.shadow Link copied!
null or booleanWhether to draw shadows or not
nullmodules/homeManager/settings/workspaces.nixhyprnix.systemd.enable Link copied!
booleanWhether to enable systemd integration.
falsetruemodules/homeManager/default.nixhyprnix.xwayland.create_abstract_socket Link copied!
null or booleanCreate the abstract Unix domain socket for XWayland connections. XWayland restart is required for changes to take effect.
nullmodules/homeManager/xwayland.nixhyprnix.xwayland.enable Link copied!
booleanWhether to enable allow running applications using X11.
falsetruemodules/homeManager/xwayland.nixhyprnix.xwayland.force_zero_scaling Link copied!
null or booleanforces a scale of 1 on xwayland windows on scaled displays.
nullmodules/homeManager/xwayland.nixhyprnix.xwayland.use_nearest_neighbor Link copied!
null or booleanuses the nearest neighbor filtering for xwayland apps, making them pixelated rather than blurry
nullmodules/homeManager/xwayland.nix