Running Hyprland on FreeBSD

Hello All!

Just start with a basic guide to getting the Hyprland Wayland Window Manager running on FreeBSD 14.0 current. This is assuming you already have a working installation with a active network connection and sudo installed with the current user added to the "Wheel" and "Video" groups.

You will also need a graphics driver installed which the offical FreeBSD guide covers quiet well (see below).

https://wiki.freebsd.org/Graphics

For Wayland to run properly we need a few dependencies installed and enabled in our rc.conf.

1. Install DBus, seatd and Hyprland.

sudo pkg install dbus seatd hyprland xdg-desktop-portal xdg-desktop-portal-hyprland

2. Enable dbus and seatd in your /etc/rc.conf and reboot the system.

Add the following lines to your /etc/rc.conf

seatd_enable="YES"

dbus_enable="YES"

3. We now need a wrapper script to start Hyprland and set a few env values.

First create your XDG_RUNTIME_DIR to ensure proper permissions.

mkdir /tmp/hypr

Then create the following wrapper script and make it executable.

#!/bin/sh

export XDG_RUNTIME_DIR=/tmp/hypr

export XDG_CURRENT_DESKTOP=Hyprland

export WAYLAND_DESKTOP=wayland-1

export XDG_SESSION_TYPE=wayland

export XKB_DEFAULT_RULES=evdev

export GDK_BACKEND=wayland

export QT_QPA_PLATFORM=wayland

export QT_QPA_PLATFORMTHEME="qt5ct"

export QT_WAYLAND_DISABLE_WINDOWDECORATION=1

export SDL_VIDEODRIVER=wayland

export MOZ_ENABLE_WAYLAND=1

export WM=sway

export CLUTTER_BACKEND=wayland

export BEMENU_BACKEND=wayland

exec ck-launch-session dbus-launch Hyprland

4. We should now be able to start Hyprland from the tty with the script listed above!

Again, this is just covering the basics of getting Hyprland running but does not go over adding additional software like a application launcher like Rofi or a Wayland bar like waybar or eww. I will make another post adding these in the future with some basic configs.