Hyprland on FreeBSD: Wayland Compositor Review
Hyprland is a dynamic tiling Wayland compositor that has gained rapid adoption on Linux for its smooth animations, active development pace, and eye-candy that most tiling window managers deliberately avoid. The question for FreeBSD users is whether it actually works well outside the Linux ecosystem.
The short answer: it works, with caveats. Hyprland on FreeBSD is functional for daily use as of early 2026, but you will encounter more friction than on Linux. This review covers installation, configuration, real-world usability, and an honest comparison with Sway -- the more mature Wayland option on FreeBSD.
For a broader comparison of desktop environments on FreeBSD, see our guide to the best desktop environments for FreeBSD.
What Hyprland Is
Hyprland is a wlroots-based dynamic tiling Wayland compositor written in C++. Its defining features compared to other tiling compositors:
- Smooth window animations (open, close, resize, workspace switch)
- Dynamic tiling with a "dwindle" and "master" layout
- Window decorations with rounded corners, blur, and shadows
- A plugin system for extending functionality
- Active, fast-moving development with frequent releases
Hyprland was created by Vaxry and first released in 2022. It has become one of the most popular tiling compositors on Linux, driven largely by the visual polish that sets it apart from i3/Sway's deliberately spartan aesthetic.
Prerequisites
Before installing Hyprland, your FreeBSD system needs working GPU drivers and basic Wayland infrastructure.
GPU Drivers
sh# Install the appropriate GPU driver # For Intel GPUs: pkg install drm-kmod sysrc kld_list+="i915kms" # For AMD GPUs: pkg install drm-kmod sysrc kld_list+="amdgpu" # Load the driver now (or reboot) kldload i915kms # or amdgpu
Wayland Dependencies
sh# Install core Wayland libraries pkg install wayland wayland-protocols seatd # Enable and start seatd sysrc seatd_enable="YES" service seatd start # Add your user to the video and seatd groups pw groupmod video -m yourusername pw groupmod _seatd -m yourusername
You must log out and back in for group changes to take effect.
Installation
sh# Install Hyprland pkg install hyprland # Install recommended companion utilities pkg install waybar # Status bar pkg install wofi # Application launcher pkg install mako # Notification daemon pkg install grim slurp # Screenshot tools pkg install wl-clipboard # Clipboard management pkg install foot # Terminal emulator (lightweight, Wayland-native) pkg install swww # Wallpaper daemon
Check the installed version:
shHyprland --version
First Launch
Start Hyprland from a TTY (not from within X11 or another Wayland session):
sh# From a virtual console (Ctrl+Alt+F2, log in) # Set the XDG runtime directory export XDG_RUNTIME_DIR=/tmp/$(whoami)-runtime mkdir -p $XDG_RUNTIME_DIR # Launch Hyprland Hyprland
On first launch, Hyprland creates a default configuration file at ~/.config/hypr/hyprland.conf. The default config includes keybindings that work out of the box -- SUPER+Enter opens a terminal, SUPER+Q closes a window, SUPER+1-9 switches workspaces.
Configuration
The configuration file uses Hyprland's own syntax (not INI, not TOML). It is straightforward but unique to Hyprland.
sh# Edit the configuration vi ~/.config/hypr/hyprland.conf
Monitor Setup
sh# In hyprland.conf # List available monitors # Run: hyprctl monitors # Configure a single monitor at native resolution monitor=,preferred,auto,1 # Configure a specific monitor monitor=DP-1,2560x1440@144,0x0,1 monitor=HDMI-A-1,1920x1080@60,2560x0,1
Keybindings
sh# Mod key (SUPER = Windows/Command key) $mod = SUPER # Core bindings bind = $mod, Return, exec, foot bind = $mod, Q, killactive bind = $mod, D, exec, wofi --show drun bind = $mod, F, fullscreen bind = $mod SHIFT, E, exit # Focus movement bind = $mod, H, movefocus, l bind = $mod, L, movefocus, r bind = $mod, K, movefocus, u bind = $mod, J, movefocus, d # Move windows bind = $mod SHIFT, H, movewindow, l bind = $mod SHIFT, L, movewindow, r bind = $mod SHIFT, K, movewindow, u bind = $mod SHIFT, J, movewindow, d # Workspaces bind = $mod, 1, workspace, 1 bind = $mod, 2, workspace, 2 bind = $mod, 3, workspace, 3 bind = $mod, 4, workspace, 4 bind = $mod, 5, workspace, 5 # Move window to workspace bind = $mod SHIFT, 1, movetoworkspace, 1 bind = $mod SHIFT, 2, movetoworkspace, 2 bind = $mod SHIFT, 3, movetoworkspace, 3 # Resize mode bind = $mod, R, submap, resize submap = resize binde = , L, resizeactive, 30 0 binde = , H, resizeactive, -30 0 binde = , K, resizeactive, 0 -30 binde = , J, resizeactive, 0 30 bind = , escape, submap, reset submap = reset
Animations
Animations are Hyprland's signature feature. The default configuration provides smooth window transitions:
sh# Animation configuration animations { enabled = true bezier = easeOut, 0.16, 1, 0.3, 1 bezier = easeIn, 0.5, 0, 0.5, 1 animation = windows, 1, 4, easeOut, popin 60% animation = windowsOut, 1, 4, easeIn, popin 60% animation = fade, 1, 5, easeOut animation = workspaces, 1, 4, easeOut, slide animation = specialWorkspace, 1, 4, easeOut, slidevert }
To disable animations (useful on slower hardware or if you find them distracting):
shanimations { enabled = false }
Window Decoration
shdecoration { rounding = 8 blur { enabled = true size = 5 passes = 2 new_optimizations = true } shadow { enabled = true range = 15 render_power = 3 color = rgba(00000055) } }
Input Configuration
shinput { kb_layout = us follow_mouse = 1 sensitivity = 0 touchpad { natural_scroll = true tap-to-click = true } }
Status Bar with Waybar
Waybar is the most common status bar used with Hyprland:
sh# Create waybar config directory mkdir -p ~/.config/waybar
Create ~/.config/waybar/config:
shcat > ~/.config/waybar/config << 'CONF' { "layer": "top", "position": "top", "height": 30, "modules-left": ["hyprland/workspaces"], "modules-center": ["clock"], "modules-right": ["cpu", "memory", "network", "pulseaudio", "tray"], "clock": { "format": "{:%Y-%m-%d %H:%M}" }, "cpu": { "format": "CPU {usage}%" }, "memory": { "format": "RAM {percentage}%" } } CONF
Add waybar to your Hyprland autostart:
sh# In hyprland.conf exec-once = waybar exec-once = mako exec-once = swww-daemon
Screenshots
sh# Full screen screenshot bind = , Print, exec, grim ~/screenshots/$(date +%Y%m%d_%H%M%S).png # Region selection screenshot bind = SHIFT, Print, exec, grim -g "$(slurp)" ~/screenshots/$(date +%Y%m%d_%H%M%S).png # Create screenshots directory mkdir -p ~/screenshots
FreeBSD-Specific Issues
Screen Sharing
Screen sharing via PipeWire and xdg-desktop-portal-hyprland is less reliable on FreeBSD than on Linux. The PipeWire stack on FreeBSD is functional but not as mature. Video calls in Firefox or Chromium may not capture the screen correctly.
sh# Install screen sharing dependencies pkg install pipewire xdg-desktop-portal-hyprland
If screen sharing does not work, this is the current state of the art on FreeBSD. It is improving with each release.
Nvidia GPUs
Nvidia GPU support on FreeBSD under Wayland is essentially non-functional. The proprietary Nvidia driver does not support Wayland on FreeBSD. If you have an Nvidia GPU, use X11 with i3 or another X11 window manager. This is not a Hyprland limitation -- it affects all Wayland compositors on FreeBSD.
XWayland Compatibility
XWayland works for running X11 applications under Hyprland:
shpkg install xwayland
Hyprland will use XWayland automatically when an X11 application is launched. Some X11 applications may appear blurry on HiDPI displays because they render at 1x and are scaled up.
Session Management
elogind provides session management for Wayland on FreeBSD:
shpkg install elogind sysrc dbus_enable="YES" service dbus start
Performance Assessment
Testing on a system with an AMD Ryzen 7 7700X and AMD RX 7600:
- Idle RAM usage: ~180 MB (Hyprland + Waybar + mako)
- Animation smoothness: Solid 144fps at 1440p on AMD GPU
- Application launch time: Negligible overhead compared to bare X11
- Multi-monitor: Works correctly with mixed refresh rates
On Intel integrated graphics (12th gen), animations are smooth at 60Hz but may drop frames at higher refresh rates with blur enabled. Disabling blur fixes this.
Hyprland vs Sway on FreeBSD
This is the key comparison for FreeBSD Wayland users:
| Aspect | Hyprland | Sway |
|--------|----------|------|
| Stability on FreeBSD | Good, occasional edge cases | Excellent, very mature |
| Animations | Smooth, configurable | None |
| Configuration | Custom syntax | i3-compatible |
| Plugin system | Yes | No |
| Screen sharing | Partial | Partial (same PipeWire limitation) |
| Resource usage | ~180 MB idle | ~120 MB idle |
| i3 migration | Not compatible | Drop-in compatible |
| Community size on FreeBSD | Small | Larger |
| Update frequency | Very frequent | Stable, less frequent |
Choose Hyprland if: You want visual polish, do not mind occasional rough edges, and are comfortable debugging FreeBSD-specific issues.
Choose Sway if: You want maximum stability, are migrating from i3, or prioritize reliability over aesthetics.
For most FreeBSD users, Sway is the safer choice today. Hyprland is the more exciting one.
Plugin System
Hyprland supports plugins that extend its functionality:
sh# Hyprland plugin manager # Note: plugin availability on FreeBSD may lag behind Linux hyprpm update hyprpm add https://github.com/hyprwm/hyprland-plugins # List available plugins hyprpm list
Popular plugins include:
- hyprexpo: Workspace overview (like GNOME Activities)
- hyprbars: Window title bars
- hyprtrails: Mouse cursor trails
Plugin compatibility with FreeBSD builds varies. Some plugins assume Linux-specific headers or syscalls. Check each plugin's issue tracker for FreeBSD support.
Recommended Full Configuration
A minimal but complete ~/.config/hypr/hyprland.conf for FreeBSD:
sh# Monitor monitor=,preferred,auto,1 # Autostart exec-once = waybar exec-once = mako exec-once = swaybg -i ~/wallpaper.jpg -m fill # Environment env = XDG_CURRENT_DESKTOP,Hyprland env = XDG_SESSION_TYPE,wayland env = MOZ_ENABLE_WAYLAND,1 # Input input { kb_layout = us follow_mouse = 1 } # Appearance general { gaps_in = 4 gaps_out = 8 border_size = 2 col.active_border = rgb(89b4fa) col.inactive_border = rgb(313244) layout = dwindle } decoration { rounding = 6 blur { enabled = true size = 4 passes = 2 } } animations { enabled = true bezier = smooth, 0.16, 1, 0.3, 1 animation = windows, 1, 4, smooth, popin 60% animation = fade, 1, 5, smooth animation = workspaces, 1, 4, smooth, slide } # Keybindings $mod = SUPER bind = $mod, Return, exec, foot bind = $mod, Q, killactive bind = $mod, D, exec, wofi --show drun bind = $mod, F, fullscreen bind = $mod SHIFT, E, exit bind = $mod, H, movefocus, l bind = $mod, L, movefocus, r bind = $mod, K, movefocus, u bind = $mod, J, movefocus, d bind = $mod, 1, workspace, 1 bind = $mod, 2, workspace, 2 bind = $mod, 3, workspace, 3 bind = $mod, 4, workspace, 4 bind = $mod, 5, workspace, 5 bind = $mod SHIFT, 1, movetoworkspace, 1 bind = $mod SHIFT, 2, movetoworkspace, 2 bind = $mod SHIFT, 3, movetoworkspace, 3 bind = $mod SHIFT, 4, movetoworkspace, 4 bind = $mod SHIFT, 5, movetoworkspace, 5 # Mouse bindings bindm = $mod, mouse:272, movewindow bindm = $mod, mouse:273, resizewindow
FAQ
Does Hyprland work on FreeBSD?
Yes. Hyprland is available in the FreeBSD ports tree and as a binary package. It requires working GPU drivers (Intel or AMD via drm-kmod) and the seatd service.
Can I use Hyprland with an Nvidia GPU on FreeBSD?
No. The proprietary Nvidia driver on FreeBSD does not support Wayland. This affects all Wayland compositors, not just Hyprland. Use X11 with an Nvidia GPU.
Is Hyprland stable enough for daily use on FreeBSD?
For most tasks, yes. The core tiling, keybindings, and window management work reliably. Areas that may cause issues: screen sharing, certain XWayland edge cases, and some plugins that assume Linux-specific features.
How do I switch between Hyprland and X11?
Simply log out of Hyprland (SUPER+SHIFT+E by default) and start your X11 session instead. The two do not conflict because they use different display protocols.
What terminal emulator should I use with Hyprland?
foot is the recommended choice. It is lightweight, Wayland-native, and fast. alacritty also works well. Avoid X11-only terminals like xterm -- they will run through XWayland and may have rendering issues.
How do I set up auto-login to Hyprland?
Add to your shell profile (~/.profile or ~/.zprofile):
shif [ -z "$DISPLAY" ] && [ "$(tty)" = "/dev/ttyv0" ]; then export XDG_RUNTIME_DIR=/tmp/$(whoami)-runtime mkdir -p $XDG_RUNTIME_DIR exec Hyprland fi
Does multi-monitor work?
Yes. Configure monitors in hyprland.conf with the monitor= directive. Mixed resolutions and refresh rates are supported. Use hyprctl monitors to list detected displays.