OXWMOXWM

Theming

Customize colors, borders, and gaps

Colors

Define a color palette in your config for easy customization:

local colors = {
    fg = "#bbbbbb",
    bg = "#1a1b26",
    red = "#f7768e",
    cyan = "#0db9d7",
    green = "#9ece6a",
    blue = "#6dade3",
    purple = "#ad8ee6",
}

Borders

Configure window borders:

-- Border width in pixels
oxwm.border.set_width(2)

-- Focused window border color
oxwm.border.set_focused_color(colors.blue)

-- Unfocused window border color
oxwm.border.set_unfocused_color(colors.fg)

Gaps

Configure spacing between windows:

-- Inner gaps (between windows)
oxwm.gaps.set_inner(5, 5)  -- horizontal, vertical

-- Outer gaps (between windows and screen edge)
oxwm.gaps.set_outer(5, 5)

-- Smart gaps: no gaps when only one window
oxwm.gaps.set_smart(true)

Toggle gaps at runtime with Super+A.

Layout Symbols

Customize the symbols shown in the status bar for each layout:

oxwm.set_layout_symbol("tiling", "[T]")
oxwm.set_layout_symbol("normie", "[F]")
oxwm.set_layout_symbol("tabbed", "[=]")
oxwm.set_layout_symbol("grid", "[G]")
oxwm.set_layout_symbol("monocle", "[M]")

On this page