hyprconf-gen

General & Window Settings

Core window manager settings controlling borders, gaps, and tiling behavior.

Borders & Gaps

Border Size

Window border thickness in pixels. 0 disables borders.

Gaps In

Inner gaps between tiled windows (px).

Gaps Out

Outer gaps between windows and monitor edges (px). Can be negative.

Gaps Workspaces

Extra gaps between workspaces on the same monitor (px).

Colors

Active Border

Single color or gradient. Use text field for gradient syntax.

Inactive Border

No-Group Border

Border color for windows that cannot be added to a group.

Layout & Behavior

Default Layout

Default tiling layout algorithm.

Resize on Border

Enable resizing windows by dragging borders or gaps.

Border Grab Area

Extra pixels outside the border that can be grabbed for resizing (requires resize_on_border).

Hover Icon

Show resize cursor when hovering over borders.

Allow Tearing

Allow screen tearing for reduced latency (requires windowrule). Read wiki first!

Window Snapping

Enable window snapping when dragging near edges.

Snap Gap

Minimum gap in pixels between windows before snapping.

Snap Monitor Gap

Distance from monitor edge before snapping.

Monitor Configuration

Define your monitor setup. Leave Name blank for any monitor. Use preferred for resolution/refresh to use native mode. Position auto places monitors automatically. Scale auto means 1.

Input Devices

Configure keyboard, mouse, and touchpad behavior.

Keyboard

Layout

XKB layout. e.g. us, gb, de, tr

Variant

XKB variant. e.g. dvorak, colemak

Model

Options

XKB options, comma separated. e.g. caps:swapescape

Rules

Numlock

Enable numlock by default on startup.

Repeat Rate

Key repeat rate (chars/sec). Default: 25.

Repeat Delay

Delay before key repeat starts (ms). Default: 600.

Mouse

Sensitivity

Mouse sensitivity (-1.0 to 1.0). 0 = no modification.

Accel Profile

libinput acceleration profile. flat = 1:1 movement.

Follow Mouse

Focus-follows-mouse behavior.

Focus on Close

Left Handed

Enable left-handed mouse mode (swaps buttons).

Scroll Method

Scroll Button

Mouse button used for scroll_method = on_button_down. 0 = disable.

Natural Scroll

Enable natural (inverted) scroll for mouse wheel.

Touchpad

Natural Scroll

Touchpad natural scrolling (content follows fingers).

Disable While Typing

Disable touchpad while keyboard is in use.

Tap-to-Click

Enable tapping the touchpad to click.

Tap and Drag

Enable tap-and-drag gesture.

Drag Lock

Keep finger lifted briefly to continue drag.

Scroll Factor

Touchpad scroll speed multiplier. Default: 1.0

Middle Button

Emulate middle button by tapping with 3 fingers.

Click Behavior

Decoration

Window appearance: rounding, opacity, blur, and shadows.

Window

Rounding

Window corner radius in pixels. 0 disables rounding.

Rounding Power

Controls the corner curve shape. 2 = circular, higher = squircle. Default: 2.

Active Opacity

Opacity of the active focused window (0.0 - 1.0).

Inactive Opacity

Opacity of inactive windows (0.0 - 1.0).

Fullscreen Opacity

Opacity of fullscreen windows (0.0 - 1.0).

Blur

Enable Blur

Enable background blur for transparent windows.

Blur Size

Blur kernel size. Larger = blurrier but slower.

Blur Passes

Number of blur passes. More passes = smoother, higher GPU cost.

Ignore Opacity

Ignore window opacity for blur (blur all transparent windows).

New Optimizations

Enable blur optimizations for tiled windows (recommended).

Xray

Make blur use the bottom-most windows as the source, not the monitor.

Noise

Noise amount for the blur (0.0 - 1.0).

Contrast

Contrast modifier for blur (0.0 - 2.0). Default: 0.8916

Brightness

Brightness modifier for blur (0.0 - 2.0). Default: 0.8172

Vibrancy

Vibrancy/saturation of blurred colors (0.0 - 1.0).

Vibrancy Darkness

How dark vibrancy is for dark colors (0.0 - 1.0).

Blur Popups

Apply blur to popup surfaces (tooltips, menus, etc.).

Popups Alpha Threshold

Alpha threshold for blurring popups (0.0 - 1.0).

Shadow

Enable Shadow

Enable window drop shadows.

Shadow Range

Shadow size/spread in pixels.

Render Power

Shadow falloff power. 1 = soft, 4 = sharp. Default: 3.

Shadow Color

Shadow color. Use rgba format with alpha, e.g. rgba(000000aa)

Inactive Shadow

Inactive window shadow color. Defaults to shadow color if unset.

Shadow Offset

Shadow offset as x y in pixels. e.g. 2 4

Shadow Scale

Scale of the shadow relative to the window (0.0 - 1.0). Default: 1.

Dimming

Dim Inactive

Dim inactive windows.

Dim Strength

Amount to dim inactive windows (0.0 - 1.0). Default: 0.5

Dim Special

Dim behind special workspaces (0.0 - 1.0). Default: 0.2

Dim Around

Dim behind windows with dimaround window rule (0.0 - 1.0). Default: 0.4

Animations

Define animation curves (beziers) and assign them to animation types. Each animation is: name, enabled, speed, curve, [style]

Enable Animations

Master toggle for all animations.

First Launch

Show fade-in animation on first launch.

Bezier Curves

Define custom cubic bezier curves. Format: x1,y1,x2,y2. Use the preset selector to apply known curves.

Animation Assignments

Assign curves to animation types. Speed in seconds (lower = faster). Style is optional.

Layout Settings

These settings apply only when the corresponding layout is active. Select your layout in General settings.

Dwindle Layout

Pseudotile

Pseudotile by default — windows keep their float size while tiled.

Preserve Split

Maintain split direction when a window is closed.

Force Split

Smart Split

Split the longer side of the container.

Smart Resizing

Resize the side that is "facing" the cursor instead of always the bottom-right.

Active for Splits

Use the active window instead of the mouse for splits.

Split Ratio

Default split ratio (0.1 - 1.9). 1.0 = equal split.

Master Layout

New Window Status

Where new windows go in the master layout.

New on Top

New slave windows go to the top of the stack.

Master Factor

Size of the master area (0.05 - 0.95). Default: 0.55

Orientation

Which side the master area is on.

Always Center

Always center master window when it's alone on a workspace.

Allow Small Split

Allow making the master very small.

Keybinds

Define keyboard shortcuts. bind = normal, bindm = mouse, bindl = locked screen, binde = repeat while held, bindel = repeat + locked, bindr = on release.

Window Rules v2

Rules applied to windows matching conditions. Uses windowrulev2 format: rule, matcher1:pattern, matcher2:pattern...

Workspace Rules

Bind workspaces to monitors, set default properties, or make them persistent. Format: workspace = name, rule1:value, rule2:value

Gestures

Touchpad gesture configuration for workspace switching and other actions.

Workspace Swipe

Enable 3-finger touchpad swipe to switch workspaces.

Swipe Fingers

Number of fingers for workspace swipe gesture. Default: 3.

Min Fingers

If enabled, require at least workspace_swipe_fingers fingers (not exactly).

Swipe Distance

Swipe distance in pixels to trigger workspace switch. Default: 300.

Invert Swipe

Invert the swipe direction.

Touch Swipe

Enable touchscreen gesture for workspace swipe.

Use R-direction

When on last workspace, swipe to open a new one (r-ref workspaces).

Cancel Ratio

How far the swipe must go before it can't be cancelled (0.0 - 1.0). Default: 0.5

Speed with Velocity

Scale speed based on swipe velocity.

Autostart

Programs launched once at startup via exec-once. Typical entries: bar, notification daemon, wallpaper setter, auth agent.

Environment Variables

Set via env = NAME,value. Common ones include cursor size, Wayland/Qt/GTK theming, and NVIDIA-specific variables.

Quick add:

Variables

Custom $variables for reuse throughout your config (e.g. $mainMod, $terminal). Referenced with $name syntax.

Miscellaneous

Various settings that don't fit elsewhere.

Display

Disable Logo

Hide the random Hyprland logo on empty workspace background.

Disable Splash

Disable the splash text under the Hyprland logo.

Force Wallpaper

Force a specific default wallpaper variant. -1 = random, 0/1/2 = specific ones.

Splash Color

Window Behavior

Focus on Activate

Focus windows when they request activation (can be annoying).

Take Over Fullscreen

Initial Workspace

Track what workspace apps launch on and restore them there.

System

VFR

Variable frame rate — lower CPU/GPU usage when idle. Recommended on.

VRR

Variable refresh rate (FreeSync/G-Sync). Monitor must support it.

Window Swallow

Enable window swallowing (terminal hides when launching GUI app).

Swallow Regex

Regex matching terminal class names that can swallow windows.

Swallow Exception

Regex for window titles that prevent swallowing.

Animate Resizes

Animate manual window resizes (can be laggy).

Animate Drag

Animate window dragging with mouse.

Render Ahead

Render a frame slightly ahead of time. Can reduce latency.

Disable Autoreload

Don't auto-reload config on file change. Manual reload only via hyprctl reload.

Layers Hog Focus

If a layer requests keyboard focus (e.g. rofi), give it. Recommended on.

Close Special Empty

Close the special workspace if the last window inside is closed.

Middle Click Paste

Enable X11 middle-click paste.