Skip to main content

beautiful

The beautiful library handles theming in AwesomeWM/SomeWM. It loads theme files and provides access to theme variables throughout your configuration.

Upstream documentation: awesomewm.org/apidoc/theme_related_libraries/beautiful.html

Usage

local beautiful = require("beautiful")

-- Load a theme
beautiful.init("~/.config/awesome/theme.lua")

-- Access theme variables
local bg = beautiful.bg_normal
local font = beautiful.font

Reference

ReferenceDescription
Theme VariablesComplete list of theme variables

Behavioral Notes

SomeWM's beautiful implementation is fully compatible with AwesomeWM. Theme files work identically.