Installation Guide

IN-01 // INSTALLATION GUIDE

OS	FreeBSD 14+
GPU	Wayland/DRM	Intel (i915, xe), AMD (amdgpu, radeonkms), NVIDIA (nouveau or nvidia-drm)
RAM	4GB+
Disk	10GB+

Quick Install

Clone the repository

git clone https://gitlab.daringbit.com/josh/omfreebdy.git ~/.omfreebdy

Run the setup

cd ~/.omfreebdy
mise run setup

Reboot and log in

Log out and select Hyprland from your display manager, or reboot your system.

What Gets Installed

System Packages

The installer uses pkg to install approximately 60 packages:

Desktop: hyprland, hyprlock, hypridle, hyprpicker, hyprsunset, seatd, swaybg, xdg-desktop-portal-hyprland, xdg-desktop-portal-gtk
Bar & Notifications: waybar, mako
Terminals: foot (ghostty via port)
Launcher: fuzzel, gum
Screenshot: grim, slurp, satty, wf-recorder
Clipboard: wl-clipboard, cliphist
Audio: pipewire, wireplumber, playerctl, pamixer, alsa-utils, alsa-plugins
CLI Tools: btop, fastfetch, starship, tmux, neovim, tree-sitter, zoxide, fzf, eza, bat, fd-find, ripgrep, jq, dust, tldr, lazygit, gh, plocate
Development: git, bash, mise, rust, ruby
GUI Apps: nautilus, brave (linux compat), imv, mpv, evince, gnome-calculator
Fonts: nerd-fonts, noto, noto-emoji, font-awesome
Services: dbus, avahi, gnome-keyring, polkit-gnome, cups

Configuration Files

Configurations are installed to ~/.config/:

~/.config/
├── hypr/                # Hyprland window manager
│   ├── hyprland.conf   # Main config
│   ├── conf/           # Modular configs
│   │   ├── bindings.conf
│   │   ├── looknfeel.conf
│   │   ├── windows.conf
│   │   └── monitors.conf
│   ├── hyprlock.conf   # Lock screen
│   └── hypridle.conf   # Idle behavior
├── waybar/             # Status bar
├── foot/               # Terminal
├── ghostty/            # Ghostty terminal (optional)
├── mako/               # Notifications
├── fuzzel/             # App launcher
├── btop/               # System monitor
├── nvim/               # Neovim editor
└── omfreebdy/          # Theme system state
    ├── current-theme   # Active theme name
    ├── current-background  # Active wallpaper
    └── themes/         # Theme definitions

User Scripts

Scripts are installed to ~/.local/bin/:

theme-set - Theme switcher
bg-next - Cycle wallpapers
screenshot - Screen capture
screenrecord - Video capture
volume - Audio control
brightness - Display brightness
And more…

After Installation

First Steps

Press Super + Return to open terminal
Press Super + Space for app launcher
Run theme-set —list to see themes
Run theme-set tokyo-night to try a theme

Console Login

If not using a display manager, add to your login profile:

exec Hyprland

Updating

cd ~/.omfreebdy
mise run update

Uninstalling

Back up any customizations in ~/.config/ before removing.

Remove configurations and scripts

rm -rf ~/.config/hypr ~/.config/waybar ~/.config/foot
rm -rf ~/.config/mako ~/.config/fuzzel ~/.config/omfreebdy
rm -rf ~/.local/bin/theme-set ~/.local/bin/bg-next

Remove system packages

pkg remove hyprland waybar foot mako fuzzel hypridle hyprlock