Repository navigation
Home
Welcome to the BSDRunner wiki.
- BSDRunner Apps — visual overview and entry point for the custom desktop tools
- Themes — visual gallery of the Default, Haas-Bioroid, Jinteki, NBN, and Weyland identities
BSDRunner is a FreeBSD 15 desktop built on Wayland. It uses Hyprland as its compositor and window manager, with Waybar for the top bar and Quickshell/QML for the custom panels and system-management apps shown in this wiki.
The supporting desktop pieces include Rofi for Wayland as the general application launcher, Kitty as the terminal, swww for themed wallpapers, and xdg-desktop-portal-hyprland for desktop integration. BSDRunner's management apps sit close to the operating system, presenting guarded interfaces over native FreeBSD facilities such as pkg, ZFS, PF, local_unbound, and jails, with Bastille integration where appropriate.
BSDRunner aims to be a small, composable Wayland desktop with a strong visual identity. Hyprland provides dynamic tiling and floating windows, workspaces and gestures, plus visual hooks for animated transitions, rounded borders, blur, and theme-driven colors. At the same time, it leaves room for BSDRunner to assemble its own bar, launcher, panels, and system tools from Waybar, Rofi, and Quickshell instead of adopting a full desktop environment.
swww is a natural fit for that design: runtime wallpaper changes, transitions, animated-image support, and a scriptable interface all complement BSDRunner's themes and workspace-based wallpaper rotation.