Skip to content

FAQ

How do I change the theme?

Interactive picker: press + + T or run:

theme-set --select

Apply a specific theme directly:

theme-set tokyo-night
How do I connect to WiFi?

First-time setup:

wifi-setup install
wifi-setup configure

After setup, manage networks with + Ctrl + W or:

wifi-manager select
How do I install apps?

Use pkg for packages from the FreeBSD repository:

pkg install firefox

Or open the omfreebdy menu with + Alt + Space and browse the Apps section.

How do I update the system?
omfreebdy-update

This updates both FreeBSD packages and omfreebdy configs.

How do I lock the screen?

Press + Ctrl + L to lock immediately.

The screen also locks automatically after the hypridle timeout (default: 5 minutes idle).

How do I take a screenshot?
ActionKey
Screenshot area Print
Screenshot screen + Print
Screenshot to clipboard + + S
Screenshot window Ctrl + Print

Screenshots save to ~/Pictures/Screenshots/.

How do I change the wallpaper?

Cycle through the current theme’s backgrounds:

bg-next

Or press + B .

How do I change the font?
font-set <name>

List available fonts:

font-set --list
How do I run Linux apps?

Linux apps run via the linuxulator (FreeBSD’s Linux compatibility layer). Brave and Steam are pre-configured.

For other Linux apps, see the Sandbox page for running untrusted software in isolation.

How do I roll back if something breaks?

omfreebdy uses ZFS boot environments. Roll back to the last known-good state:

boot-env rollback

Or create a snapshot before making changes:

boot-env create

Press + Ctrl + S to snapshot the current boot environment.

Where are config files?

All user configs live in ~/.config/:

ComponentPath
Hyprland~/.config/hypr/
Waybar~/.config/waybar/
Themes~/.config/omfreebdy/themes/
Terminals~/.config/foot/, ~/.config/ghostty/
Where are the scripts?

All omfreebdy scripts are installed to ~/.local/bin/. They are on your $PATH by default.

ls ~/.local/bin/