Skip to content

Hyprland

Configuration Tree

. 📂 ~/.config/hypr
└── 📂 animations/
├── 📄 animations.conf
├── 📄 hyde.conf
├── 📄 hypridle.conf
├── 📄 hyprland.conf
└── 📂 hyprlock/
├── 📄 hyprlock.conf
├── 📄 keybindings.conf
├── 📄 monitors.conf
├── 📄 nvidia.conf
└── 📂 themes/
│ ├── 📄 colors.conf
│ ├── 📄 theme.conf
│ ├── 📄 wallbash.conf
├── 📄 userprefs.conf
└── 📄 windowrules.conf
├──
. 📂 ~/.local/share/hyde
│ ├── 📄 hyprland.conf

HyDE’s Hyprland Configuration

Since Hyprland sources ~/.config/hypr/hyprland.conf, HyDE’s hyprland configuration is divided into three sections:

1. Boilerplate

This section contains the default configuration of HyDE. It is recommended not to change this section.

Filepath: $XDG_DATA_HOME/hyde/hyprland.conf`

This file is sourced on top of other configurations in ~/.config/hypr/hyprland.conf`.

# Boilerplate configuration
source = ~/.local/share/hyde/hyprland.conf

2. Overrides

This section is for overriding the default configuration of HyDE.

As per Hyprland’s Defining Variables, HyDE uses $VARIABLES to expose default configurations to be overridden.

Change this section if you intend to:

  • Change the startup and environment variables
  • Stop an app/service from starting
  • Override HyDE’s default variables

Filepath: $XDG_CONFIG_HOME/hypr/hyde.conf`

HyDE Configuration Variables

VariableDescriptionDefault Value
$mainModKeyboard modifierSUPER (Windows key)
$QUICKAPPSUsed for quick app launcher(Empty)
$BROWSERDefault browserfirefox
$EDITORDefault editorcode
$EXPLORERDefault file managerdolphin
$TERMINALDefault terminalkitty
$LOCKSCREENDefault lockscreenhyprlock
$IDLEDefault idle managerhypridle
$GTK_THEMEGTK themeWallbash-Gtk
$ICON_THEMEIcon themeTela-circle-dracula
$COLOR_SCHEMEColor schemeprefer-dark
$CURSOR_THEMECursor themeBibata-Modern-Ice
$CURSOR_SIZECursor size30
$FONTFontCanterell
$FONT_SIZEFont size10
$DOCUMENT_FONTDocument fontCantarell
$DOCUMENT_FONT_SIZEDocument font size10
$MONOSPACE_FONTMonospace fontCaskaydiaCove Nerd Font Mono
$MONOSPACE_FONT_SIZEMonospace font size9
$FONT_ANTIALIASINGFont antialiasingrgba
$FONT_HINTINGFont hintingfull

Startup Commands ($start.*`)

The default commands on startup.

VariableDescriptionDefault Value
$start.XDG_PORTAL_RESETResets XDG Portal$scrPath/resetxdgportal.sh
$start.DBUS_SHARE_PICKERUpdates DBus environment for share pickerdbus-update-activation-environment —systemd —all
$start.SYSTEMD_SHARE_PICKERImports environment variables for share picker using systemdsystemctl —user import-environment QT_QPA_PLATFORMTHEME WAYLAND_DISPLAY XDG_CURRENT_DESKTOP
$start.BARStarts the Waybarwaybar
$start.NOTIFICATIONSStarts the notification daemonswaync
$start.APPTRAY_BLUETOOTHStarts the Bluetooth appletblueman-applet
$start.WALLPAPERSets the wallpaper$scrPath/swwwallpaper.sh
$start.TEXT_CLIPBOARDStarts the text clipboard managerwl-paste —type text —watch cliphist store
$start.IMAGE_CLIPBOARDStarts the image clipboard managerwl-paste —type image —watch cliphist store
$start.BATTERY_NOTIFYStarts the battery notification script$scrPath/batterynotify.sh
$start.NETWORK_MANAGERStarts the network manager appletnm-applet —indicator
$start.REMOVABLE_MEDIAStarts the removable media managerudiskie —no-automount —smart-tray
$start.AUTH_DIALOGUEStarts the authentication dialogue script$scrPath/polkitkdeauth.sh
$start.IDLE_DAEMONStarts the idle daemon$IDLE

Environment Variables ($env.*`)

VariableDescriptionDefault Value
$env.GDK_BACKENDGTK backend to use (Wayland preferred)wayland,x11,*
$env.QT_QPA_PLATFORMQt platform to use (Wayland)wayland
$env.SDL_VIDEODRIVERSDL2 video driver (Wayland)wayland
$env.CLUTTER_BACKENDClutter backend (Wayland)wayland
$env.XDG_CURRENT_DESKTOPXDG current desktop environmentHyprland
$env.XDG_SESSION_TYPEXDG session typewayland
$env.XDG_SESSION_DESKTOPXDG session desktopHyprland
$env.QT_AUTO_SCREEN_SCALE_FACTORQt automatic screen scaling1
$env.QT_QPA_PLATFORMQt platformwayland
$env.QT_WAYLAND_DISABLE_WINDOWDECORATIONDisables window decorations on Qt applications1
$env.QT_QPA_PLATFORMTHEMEQt platform themeqt6ct
$env.PATHPath environment variable(Empty)
$env.MOZ_ENABLE_WAYLANDEnables Wayland for Firefox1
$env.GDK_SCALEGDK scale for Xwayland on HiDPI1
$env.ELECTRON_OZONE_PLATFORM_HINTElectron Ozone Platform Hintauto
$env.XDG_RUNTIME_DIRXDG runtime directory$XDG_RUNTIME_DIR
$env.XDG_CONFIG_HOMEXDG config directory$HOME/.config
$env.XDG_CACHE_HOMEXDG cache directory$HOME/.cache
$env.XDG_DATA_HOMEXDG data directory$HOME/.local/share
$LAYOUT_PATHPath to Hyprlock layout configuration/path/to/hyprlock/layout.conf
$BACKGROUND_PATHPath to Hyprlock background image$HYPRLOCK_BACKGROUND

3. Users

This section is for user configuration. It is recommended to change this section to your liking.

Filepaths:

  • ./keybindings.conf`
  • ./windowrules.conf`
  • ./monitors.conf`
  • ./userprefs.conf`

Now you should know which file is which. Refer to the Hyprland Wiki for more information and to achieve your perfect desktop experience.

Also seeFAQs and Tips