Hyprland

WM-01 // COMPOSITOR

Hyprland is a dynamic tiling Wayland compositor with smooth animations and GPU-accelerated rendering. It is the core window manager in omfreebdy.

Three terminals tiled with dwindle layout

Floating window over tiled layout

Three terminals tiled with dwindle layout

Floating window over tiled layout

▶

Window tiling and management demo

Window tiling and management demo

OMFBD

Window tiling and management demo

Window tiling and management demo

Configuration

Hyprland’s config lives at ~/.config/hypr/hyprland.conf with modular includes from ~/.config/hypr/conf/:

File	Purpose
conf/envs.conf	Wayland/XDG environment variables
conf/autostart.conf	Applications started with Hyprland
conf/looknfeel.conf	Gaps, borders, opacity, blur, animations
conf/input.conf	Keyboard layout, repeat rate, touchpad
conf/windows.conf	Per-application window rules
conf/bindings.conf	All keybindings

Default Programs

Program	Command
Terminal	ghostty
Browser	brave-browser
File Manager	nautilus
Launcher	fuzzel

Visual Defaults

• Gaps: 5px inner, 10px outer
• Borders: 2px, blue-to-green gradient (active), dark gray (inactive)
• Opacity: 0.97 active, 0.90 inactive
• Corner rounding: 8px
• Blur: enabled, size 3, 2 passes, brightness 0.60
• Layout: dwindle (spiral tiling), toggles through master and scrolling

Key Bindings

The primary modifier is Super (Windows key).

Window Management

Shortcut	Action
Super + W	Close window
Super + T	Toggle floating
Super + F	Fullscreen
Super + J	Toggle split layout
Super + O	Pop out (float + pin)
Super + C	Center floating window

Navigation

Shortcut	Action
Super + Arrow keys	Move focus
Super + H/J/K/L	Move focus (Vim-style)
Alt + Tab	Cycle windows
Super + 1-9	Switch workspace
Super + Tab	Next workspace

Launchers

Shortcut	Action
Super + Return	Terminal
Super + Space	App launcher
Super + Shift + Return	Browser
Super + E	File manager

See the full Keybindings reference for all shortcuts.

Plugins

omfreebdy ships with several Hyprland plugins on 0.53.1, managed via hyprland-plugins:

Plugin	Description
hyprscrolling	Scrolling column layout (PaperWM-style). Windows arrange in horizontally scrollable columns instead of tiling.
hyprfocus	Flash-highlights the newly focused window briefly, making it easy to track focus changes.
borders-plus-plus	Adds additional decorative borders to windows. Configure in hyprland.conf with plugin:borders-plus-plus { }.
xtra-dispatchers	Adds extra dispatch commands like movewindoworgroup.
hyprtrails	Adds smooth trails behind moving windows.

Disabled plugins

hyprexpo, hyprbars, and hyprwinwrap are available but disabled due to a FreeBSD memory layout incompatibility with function hooks. On FreeBSD, mmap places the plugin .so more than 35 GB from the Hyprland binary, so relative jumps cannot reach the hook targets. This requires an upstream fix (absolute jumps) before these plugins can work.

Managing Plugins

# Interactive plugin management menu
hyprland-plugins menu

# List installed plugins and their status
hyprland-plugins list

Layout Toggle

The layout toggle keybinding (Super + J) cycles through three layouts:

1. dwindle — spiral tiling (default)
2. master — single master window with a stack
3. scrolling — horizontally scrollable columns (via hyprscrolling)

Press Super + Ctrl + P to switch directly to the scrolling layout.

Customization

Edit ~/.config/hypr/conf/looknfeel.conf to change gaps, borders, opacity, and animations. Changes apply immediately — Hyprland live-reloads its config.

# Reload manually if needed
hyprctl reload