Creating Themes

TH-02 // CUSTOM THEMES

Themes live in ~/.config/omfreebdy/themes/. Each theme is a directory with a colors.toml file and optional backgrounds.

Directory Structure

~/.config/omfreebdy/themes/
└── my-theme/
    ├── colors.toml       # Required — color definitions
    ├── backgrounds/      # Optional — wallpaper images
    │   ├── wallpaper.jpg
    │   └── wallpaper2.png
    └── preview.png       # Optional — theme picker thumbnail

colors.toml Format

Required Keys

# Terminal background and foreground
background = "#1a1b26"
foreground = "#a9b1d6"

# Primary accent color (borders, highlights)
accent = "#7aa2f7"

# Standard 16-color palette
color0  = "#32344a"   # black
color1  = "#f7768e"   # red
color2  = "#9ece6a"   # green
color3  = "#e0af68"   # yellow
color4  = "#7aa2f7"   # blue
color5  = "#ad8ee6"   # magenta
color6  = "#449dab"   # cyan
color7  = "#787c99"   # white
color8  = "#444b6a"   # bright black
color9  = "#ff7a93"   # bright red
color10 = "#b9f27c"   # bright green
color11 = "#ff9e64"   # bright yellow
color12 = "#7da6ff"   # bright blue
color13 = "#bb9af7"   # bright magenta
color14 = "#0db9d7"   # bright cyan
color15 = "#acb0d0"   # bright white

Optional Keys

cursor               = "#c0caf5"   # cursor color (defaults to foreground)
selection_background = "#283457"
selection_foreground = "#c0caf5"

What Gets Updated

When you run theme-set <name>, colors are applied to: foot, ghostty, waybar, hyprland borders, mako notifications, fuzzel launcher, neovim, btop, and GTK apps — all at once.

Create a Theme

# 1. Make the directory
mkdir -p ~/.config/omfreebdy/themes/my-theme/backgrounds

# 2. Create colors.toml
cat > ~/.config/omfreebdy/themes/my-theme/colors.toml << 'EOF'
background = "#1e1e2e"
foreground = "#cdd6f4"
accent     = "#89b4fa"

color0  = "#45475a"
color1  = "#f38ba8"
color2  = "#a6e3a1"
color3  = "#f9e2af"
color4  = "#89b4fa"
color5  = "#f5c2e7"
color6  = "#94e2d5"
color7  = "#bac2de"
color8  = "#585b70"
color9  = "#f38ba8"
color10 = "#a6e3a1"
color11 = "#f9e2af"
color12 = "#89b4fa"
color13 = "#f5c2e7"
color14 = "#94e2d5"
color15 = "#cdd6f4"
EOF

# 3. Add wallpapers (optional)
cp ~/wallpaper.jpg ~/.config/omfreebdy/themes/my-theme/backgrounds/

# 4. Apply
theme-set my-theme

Adding Backgrounds

Drop any JPG or PNG into themes/<name>/backgrounds/. Cycle through them with ⌘ + B or bg-next.

Installing Community Themes

theme-install https://github.com/user/my-omfreebdy-theme

This clones the repo into ~/.config/omfreebdy/themes/ and makes it available immediately.

Testing

# Apply your theme
theme-set my-theme

# List all available themes
theme-set --list

# Interactive picker
theme-set --select

Use ⌘ + ⇧ + T to open the interactive theme picker at any time.