AWESOMERC(5)

📦
version 4.3 · 10 versions
, in opensuse-leap 16.0

💅 awesomerc — the rc file for the awesome window manager (that's awesomerc(5) bestie, section 5 of the manual, we're in the config-file zone)

okay so picture this: you're setting up awesome, the window manager, and you want it to actually be yours. That's this page. Welcome. 🎀

✨ SYNOPSIS ✨

so when awesome wakes up it goes looking for your config file, and it checks these spots in this exact order, no skipping, no cap:

  1. $XDG_CONFIG_HOME/awesome/rc.lua
  2. $HOME/.config/awesome/rc.lua
  3. $XDG_CONFIG_DIRS/awesome/rc.lua

first one it finds wins, that's the whole vibe check 🦋

🌸 DESCRIPTION 🌸

The rc.lua file is where all of awesome's configuration info lives. You can use it to tweak the behavior and the look of awesome in, like, a whole bunch of ways. Think of it as a Lua program/script that awesome runs at startup — genuinely, that's what it is, and it gets run through the awesome Lua API described over in the API section. This file is read at startup. Periodt. 👑

🧚 AWESOME LUA API 🧚

want the docs for the Lua API? they live in the luadoc directory. go look, iykyk 💜

🌈 COLORS FORMAT 🌈

okay so colors in awesome come in two flavors:

  • a standard X color name — like blue, darkblue, lightred, etc etc, you get it
  • a hexadecimal formatted color — #rrggbb or #rrggbbaa

and here's the iconic part: with the hex format you can also specify an alpha channel. so #00ff00 draws pure green, but #00ff00aa sets the alpha channel to ‘aa’ and blends that green with the color underneath it. translucent slay ✨

🦋 TEXT FORMAT 🦋

you can use Pango markup inside a text string, which is how you format the text rendered inside widgets. 🫶

Pango markup documentation lives in the Pango docs at http://library.gnome.org/devel/pango/stable/PangoMarkupFormat.html.

a Pango markup example, so you can see the vibe:

<span weight="bold" foreground="#336699">...</span>

👀 SEE ALSO 👀

go read these too, bestie:

💖 AUTHORS 💖

Written by Julien Danjou julien@danjou.info. iconic of him, honestly.

🌐 WWW 🌐

https://awesomewm.org

lowkey important reminder: everything above is facts, i just gave them a makeover. no invented options, no extra claims, we stay honest 💅

okay bye ily, this page is from AWESOMERC(5) and it's dated 2024-02-20 — go make that rc.lua of yours main character energy 🌸🎀

📦 where this page comes from