hyprconf-gen

General Settings

Border Size:

Window border thickness (px).

Gaps In:

Inner gaps between windows (px).

Gaps Out:

Outer gaps to monitor edges (px, can be negative).

Active Border Color:

Can be single color (rgba/rgb hex) or gradient. Picker only shows first color. Use text field for gradients.

Inactive Border Color:

Usually a single rgba/rgb hex color.

Default Layout:

Default tiling layout.

Resize on Border:

Enable resizing by dragging borders/gaps.

Allow Tearing:

Allow screen tearing (see wiki first).

Monitor Configuration

Define your monitor setup. Leave Name blank for any. Use `preferred` for resolution/refresh rate to use native mode. Scale `auto` usually means 1.

Input Devices

Configure keyboard, mouse, and touchpad settings.

Keyboard

Layout:

e.g., us, gb, de

Variant:

Options:

Comma-separated list, e.g., grp:alt_shift_toggle,caps:escape

Rules:

Numlock On:

Enable numlock on startup.

Mouse

Follow Mouse Focus:

Sensitivity:

Mouse sensitivity (-1.0 to 1.0, 0 = default).

Touchpad

Natural Scroll:

Enable natural (reverse) scrolling.

Keybinds

Define your keyboard and mouse shortcuts. Use `$mainMod` for your primary modifier (usually Super/Win key). Specify mouse buttons like `mouse:272` (left), `mouse:273` (right), `mouse:274` (middle).

Window Rules

Define rules for specific windows based on class, title, etc. Use RegEx for matching (e.g., `class:^(kitty)$`).

Autostart Programs (exec-once)

Commands to run once when Hyprland starts. Add `&` at the end for background processes.

Animations

Enable Animations:

Globally enable/disable animations.

Define Bezier Curves

Define custom bezier curve names for use in assignments.

Assign Animation Styles

Assign specific animation styles, speeds, and curves to different elements.

Decoration

Rounding:

Window corner rounding radius (px).

Active Opacity:

Opacity for the active window (0.0 - 1.0).

Inactive Opacity:

Opacity for inactive windows (0.0 - 1.0).

Blur

Enable Blur:

Enable background blur for transparent windows.

Blur Size:

Blur kernel size.

Blur Passes:

Number of blur passes (more passes = smoother but slower).

Vibrancy:

Increase saturation of blurred areas (0.0 - 1.0).

Shadow

Enable Shadow:

Enable window drop shadows.

Shadow Range:

Shadow size/spread (px).

Render Power:

Shadow quality (1=low, 4=high). Higher uses more GPU.

Shadow Color:

Shadow color including alpha (e.g., `rgba(000000aa)`).

Layout Specific Settings

These settings only apply if the corresponding layout (Dwindle/Master) is selected in General Settings.

Dwindle Layout

Pseudotile:

Master window is always split.

Preserve Split:

Maintain split ratio when window closes.

Force Split:

Master Layout

New Window Status:

Where new windows appear in the master layout.

Miscellaneous Settings

Force Wallpaper:

Force a specific default wallpaper (-1 = default, 0 = first, 1 = second, etc.).

Disable Logo:

Disable the random Hyprland logo background.