omfreebdy: The Beautiful, Modern Desktop Environment Bringing Omarchy’s Elegance to FreeBSD

omfreebdy: The Beautiful, Modern Desktop Environment Bringing Omarchy’s Elegance to FreeBSD

Table of contents:-

The Philosophy and the Pieces: What Exactly Is omfreebdy?

Getting Started: Installation and First Boot

Shaping Your Environment: Keybindings, Theming, and AI Integration

Available Desktop Profiles in omfreebdy

For those of us who love the raw power and legendary stability of FreeBSD but secretly yearn for a desktop that feels curated, cohesive, and visually stunning, a quiet revolution has been brewing. Enter omfreebdy – a project that describes itself as "a beautiful, modern desktop environment for FreeBSD" and delivers precisely that. It is not merely a window manager or a collection of disparate tools; it is a complete, thoughtfully assembled desktop experience that ports the elegant "omarchy" philosophy from Arch Linux to the world's most advanced open-source operating system. If you have ever felt that FreeBSD’s desktop offerings, while functional, lacked a certain *je ne sais quoi*, then omfreebdy might just be the breath of fresh air you have been waiting for.

The project is the brainchild of developer Josh Adams, hosted openly on GitLab, and it arrives with a clear mission: to deliver a Wayland-native, GPU-accelerated, tiling desktop that can be installed in roughly three minutes and themed globally with a single command. Everything about it screams intentionality, from the choice of Hyprland as its dynamic compositor to the seventeen pre-built colour schemes that ripple across every application in perfect harmony. Let’s dive in and explore what makes omfreebdy tick, how to get it running on your FreeBSD machine, and the myriad ways you can bend it to your will.

The Philosophy and the Pieces: What Exactly Is omfreebdy?

To understand omfreebdy, we first need to understand its lineage. The project is a direct FreeBSD port of omarchy, a beautifully crafted Arch Linux desktop environment originally from Basecamp. Omarchy earned a reputation for being visually cohesive and refreshingly simple to set up, and omfreebdy takes that same spirit and marries it to FreeBSD’s unique strengths. The result is a desktop that feels both familiar to anyone who has admired omarchy screenshots and distinctly at home on a FreeBSD system, with native package management and platform-specific optimisations baked right in.

So, what exactly is under the bonnet? Omfreebdy is built around Hyprland, a dynamic tiling Wayland compositor that brings smooth animations and a modern aesthetic to window management. This is not a stacking window manager retrofitted with tiling shortcuts; Hyprland is a proper, first-class Wayland citizen that handles everything from window placement to GPU-accelerated rendering with aplomb. The status bar is handled by Waybar, a highly configurable panel that can show workspaces, the clock, battery levels, and audio controls right out of the gate. For terminals, omfreebdy offers two excellent choices: Foot and Ghostty, both of which leverage GPU acceleration for buttery-smooth scrolling and rendering. Application launching falls to Fuzzel, a Wayland-native launcher that is fast, unobtrusive, and perfectly in keeping with the desktop’s minimalist vibe. Notifications are handled by the lightweight Mako daemon, while screen locking is entrusted to Hyprlock, which can apply beautiful blur effects to your desktop when the system is idle.

But perhaps the most compelling aspect of omfreebdy is its theme system. This is not a case of changing your terminal colours and hoping for the best. With a single command – `theme-set tokyo-night`, for example – the entire desktop transforms. Hyprland’s borders, Waybar’s panels, both Foot and Ghostty terminals, Mako notifications, Fuzzel’s launcher, Swaylock, GTK3/4 applications, Neovim, btop system monitor, and even Visual Studio Code or Cursor all update their colours simultaneously and instantly. The project ships with seventeen pre-made themes, ranging from the moody blues of Tokyo Night and Nord to the warm retro vibes of Gruvbox, the soothing pastels of Catppuccin, the green-on-black hacker aesthetic of Hackerman, and even ultra-dark options like Vantablack. If none of those tickle your fancy, the theme structure is documented and extensible, allowing you to create your own colour schemes with a simple `colors.toml` file and a few supporting assets. This unified approach to theming is the secret sauce that makes omfreebdy feel like a single, coherent product rather than a jumble of independently configured components.

Beyond the visual layer, omfreebdy brings a genuinely useful suite of utility scripts that elevate it from a pretty face to a practical daily driver. These scripts are installed to `~/.local/bin/` and cover everything from screenshot capture and screen recording to volume and brightness control, WiFi management, idle toggling, and even an interactive system menu for locking, logging out, or shutting down. The inclusion of a `keybindings-show` command means you are never left guessing what keyboard shortcuts are available, and an `emoji-picker` adds a touch of modern convenience. All of this points to a design philosophy that values both beauty and usability in equal measure.

Getting Started: Installation and First Boot

One of the most refreshing aspects of omfreebdy is how seriously it takes the installation experience. The project proudly advertises a "3-minute setup," and while your mileage may vary depending on download speeds and existing system configuration, the process is genuinely streamlined. The recommended quick-start method is a single command that fetches and executes the installer script directly. If you prefer more control – and being FreeBSD users, many of us do – you can manually clone the repository into `~/.omfreebdy` and run the installer from there. Whichever route you choose, the installer uses FreeBSD’s native `pkg` system to pull in approximately forty packages, including Hyprland itself, Waybar, Foot, Fuzzel, Mako, Hyprlock, Hypridle, and more.

The installer is thoughtful about where it places things. All configuration files go into `~/.config/`, neatly organised into subdirectories for Hyprland, Waybar, Foot, Ghostty, Mako, Fuzzel, btop, Neovim, and the theme system. Hyprland’s configuration, in particular, is modular, with separate files for keybindings, appearance, window rules, and monitor settings, all sourced from a main `hyprland.conf`. This modularity makes it far easier to tweak individual aspects of the desktop without wading through a monolithic configuration file. Utility scripts land in `~/.local/bin/`, and it is worth ensuring that this directory is on your `$PATH` so that commands like `theme-set` and `bg-next` work seamlessly.

Before you rush off to install, there are a few prerequisites to bear in mind. Omfreebdy requires FreeBSD 14.0 or later (with 15.0 recommended), a GPU with Wayland and DRM support – Intel, AMD, and NVIDIA are all in the frame – and at least 4GB of RAM. Once the installer has finished its work, launching the desktop depends on your login method. If you are using a display manager, you can simply select Hyprland from the session menu. For console login, adding `exec Hyprland` to `~/.xinitrc` and starting X manually, or configuring an automatic start, will do the trick.

After logging in for the first time, a few keybindings will immediately become your best friends. `Super + Return` launches a terminal, `Super + Space` opens the Fuzzel application launcher, and `Super + F1` (or running `keybindings-show`) displays a handy reference of all available keyboard shortcuts. From here, you can switch themes with `Super + Shift + T`, which brings up an interactive picker, or use `theme-set --list` in a terminal to see what is available. The desktop should feel immediately responsive, with Hyprland’s smooth animations and Waybar’s clean status bar greeting you upon arrival.

Updating omfreebdy is equally straightforward: simply navigate to `~/.omfreebdy`, run `git pull` to fetch the latest changes, and re-execute `./install.sh`. Should you ever wish to remove omfreebdy, the documentation provides clear instructions for deleting the relevant configuration directories and, optionally, removing the installed system packages with `pkg remove`. This transparency about both installation and removal is a mark of a well-maintained project that respects its users.

Shaping Your Environment: Keybindings, Theming, and AI Integration

Once omfreebdy is up and running, the real fun begins. The desktop is designed to be shaped around your workflow, and nowhere is this more evident than in the keybinding system. All keyboard shortcuts are defined in a single, clearly commented file at `~/.config/hypr/conf/bindings.conf`, and the documentation encourages you to open it up and make it your own. The default bindings follow a logical pattern: `Super + Arrow Keys` or `Super + H/J/K/L` to move focus between windows, `Super + Shift + Arrow Keys` to swap windows, `Super + 1-9, 0` to switch workspaces, and `Super + Shift + 1-9, 0` to move windows to different workspaces. Media keys for volume and brightness are mapped out of the box, as are shortcuts for screenshots and screen recording. If you need to discover the key name for an obscure key on your keyboard, the `wev` utility is recommended – simply install it with `pkg install wev`, run it, press the key in question, and note the output. Modifying a binding is as simple as changing a line like `bind = SUPER, N, exec, nautilus` to whatever command or key combination you prefer, and commenting out lines you no longer want is equally trivial.

The theme system deserves a deeper look because it is, frankly, a joy to use. Each of the seventeen bundled themes resides in `~/.config/omfreebdy/themes/` as its own directory, containing a `colors.toml` file that defines the palette in a straightforward key-value format. This file specifies everything from the background and foreground colours to the full sixteen-colour terminal palette, plus optional extended colours for selections and the cursor. Alongside the colour definitions, a theme directory can include a Neovim colourscheme plugin, a VSCode theme mapping, a btop colour theme, and a `backgrounds/` subdirectory filled with wallpaper images. When you run `theme-set`, the script reads these files and updates every relevant application’s configuration in one fell swoop. The `bg-next` command cycles through the wallpapers for your current theme, and a dedicated keybinding (`Super + Shift + B`) makes this instantly accessible. For those who like to tinker, creating a custom theme is as simple as creating a new directory, writing a `colors.toml` with your chosen hex codes, and optionally adding wallpapers and application-specific files.

A particularly intriguing aspect of omfreebdy is its embrace of local AI inference. The documentation highlights support for llama.cpp with Vulkan GPU acceleration, enabling you to run large language models entirely on your own hardware. While the specifics of configuring this feature are somewhat sparse in the public documentation, its inclusion signals a forward-thinking approach that acknowledges the growing interest in privacy-respecting, locally-run AI assistants. The fact that omfreebdy is built on FreeBSD – an operating system renowned for its security, stability, and ZFS-powered data integrity – makes it an especially compelling platform for those who want to experiment with AI without surrendering their data to the cloud.

The utility scripts bundled with omfreebdy further round out the experience. The `omfreebdy-menu` command, bound to `Super + D`, provides a hierarchical system menu with submenus for launching applications, capturing screenshots or recordings, switching themes and backgrounds, and accessing power and session controls. The `system-menu` script, triggered by `Super + Escape`, offers a quick way to lock, log out, suspend, reboot, or shut down. There is even a `nightlight-toggle` script (`Super + Shift + N`) for reducing blue light in the evenings, and a `wifi-manager` for handling wireless networks. These touches make omfreebdy feel less like a hobbyist’s weekend project and more like a mature, daily-driver-ready environment.

Of course, no software is without its potential hiccups, and omfreebdy’s troubleshooting documentation is refreshingly candid about common issues. If Hyprland refuses to start, the first port of call is checking that your GPU’s DRM kernel module is loaded, with clear instructions for Intel (`i915kms`), AMD (`amdgpu`), and how to make these modules persist across reboots in `/etc/rc.conf`. Screen flickering can often be resolved by disabling variable refresh rate or forcing a specific refresh rate in the monitor configuration. HiDPI scaling is handled by editing `~/.config/hypr/conf/monitors.conf` and setting an appropriate scale factor, with additional environment variables available for GTK and Qt applications. Theme-related problems are typically caused by syntax errors in `colors.toml` or missing dependencies like `jq` for VSCode theming, and the documentation walks you through checking both. Audio issues invariably point back to PipeWire – checking that it is running with `pw-cli info`, starting it if necessary, and verifying sinks with `wpctl status` are all covered. This pragmatic, solutions-oriented approach to documentation inspires confidence and reduces the friction of adoption.

Available Desktop Profiles in omfreebdy

Actually omfreebdy surprisingly provides two desktop profiles, each representing a complete graphical environment built on FreeBSD. You choose one during setup, or install both. 

1. Wayland — Hyprland (default)

A modern, GPU‑accelerated Wayland compositor with dynamic tiling and smooth animations.

• Designed for most systems with supported Intel, AMD, or open‑source NVIDIA drivers. 

• Offers a Wayland‑native toolchain, including Hyprland, Waybar, Hyprlock, Hypridle, and related components. 

• Recommended if your hardware supports Wayland well.

• Install via:
  mise run setup -- --profile wayland 

  
  
  

2. X11 — i3

A classic, lightweight tiling window manager running on the Xorg stack.

• Ideal for older hardware, proprietary NVIDIA drivers, or systems where Wayland is unavailable. 

• Uses i3, i3status, i3lock, picom, and other X11‑based utilities.

• Install via:
  mise run setup -- --profile x11

  
  
  

---

What Both Profiles Share

Regardless of which profile you choose, omfreebdy provides a unified ecosystem:

• Theme system

• Scripts and CLI tools

• System utilities

• A consistent workflow across both Wayland and X11 environments

The main difference lies in the window manager and its supporting stack (Wayland compositor vs. Xorg server, status bar, lock screen, launcher).

Stepping back, omfreebdy represents something genuinely exciting for the FreeBSD community. It bridges a gap that has long existed: the space between FreeBSD’s undeniable technical excellence and the desire for a desktop environment that feels polished, modern, and cohesive without requiring days of configuration. By building on the shoulders of Hyprland and the omarchy design language, and by wrapping everything in a thoughtful theme system and a library of practical scripts, Josh Adams has created something that deserves serious attention. Whether you are a seasoned FreeBSD veteran looking to refresh your desktop or a newcomer curious about what the platform can offer, omfreebdy makes a compelling case for FreeBSD as a daily-driver operating system.

Conclusion

omfreebdy is far more than a simple Hyprland configuration. It is a lovingly crafted, holistic desktop environment that brings a rare level of visual cohesion and out-of-the-box usability to FreeBSD. From its rapid installer and modular configuration structure to its spectacular unified theming and growing collection of utility scripts, it demonstrates that FreeBSD desktops can be both powerful and beautiful. For anyone who values the solidity of FreeBSD but desires a modern, Wayland-native workspace that looks as good as it performs, omfreebdy is an absolute gem.

Disclaimer

This article is published in good faith by The Distrowrite Project with the noble aim of providing accurate, factual, and educational content to the open-source community. All trade names, trademarks, and registered trademarks mentioned herein – including but not limited to FreeBSD, Hyprland, Waybar, Foot, Ghostty, Fuzzel, Mako, Hyprlock, and Omarchy – are the property of their respective owners. We encourage all readers to use open-source software responsibly and in full compliance with applicable laws and licensing terms.

References:-

1. Omfreebdy Official Website

2. Omfreebdy GitLab Repository

3. Omfreebdy Installation Guide

4. Omfreebdy Configuration Guide

5. Omfreebdy Keybindings Documentation

6. Omfreebdy Theme System Documentation

7. Omfreebdy Scripts Reference

8. Omfreebdy AI and LLM Documentation

9. Omfreebdy Troubleshooting Guide

---

꧁ ༺ omfreebdy ༻ ꧂

Back to top