Home

Awesome

Red Flat Awesome WM config

Custom config for Awesome WM.

This config is compatible with AwesomeWM version 4.0 and newer.

Screenshot

<!--suppress HtmlDeprecatedAttribute --><p align="center"><a href="https://github.com/worron/awesome-config/wiki">Gallery</a></p> <!--suppress HtmlDeprecatedAttribute --><p align="center"><a href="https://youtu.be/_1M1Wv64JGA">Video Demo</a></p>

Description

Advanced user config for awesome consist of a bunch of new widgets, features, tiling schemes, and some reworked standard widgets. This repository provide only config examples and themes. Main code base can be found in redflat submodule.

Core Features

Dependencies

Main

Widgets

widgettypeutility
unread mail indicatorpanelcurl/user scripts
system updatespanelapt-get*
volume controlpanelpacmd
brightness controlfloatingxbacklight
mpris2 playerfloatingdbus-send
CPU temperaturedesktoplm-sensors
HDD temperaturedesktopsmartctl**
Nvidia GPU temperaturedesktopnvidia-smi/optirun
torrent infodesktoptransmission-remote

* Actually any one-liner written for your package manager.
** Should be configured to run from user.

Installation and Usage

Installation

Copy scripts to WM setting folder. Simple way to do so with git

$ git clone https://github.com/worron/awesome-config.git ~/.config/awesome --recursive

Then edit rc.lua to select wanted config.

Start with Colorless

Config rc-colorless.lua is basic setup. It provide general features only and should work without any additional editing. After installing colorless config you can set you own colors, fonts, hotkeys and then start porting wanted widgets from colored configs. It's the most safe and reliable way to use this config.

Start with Colors

Colored are author's personal configs. It's full featured setup filled with widgets preconfigured for certain software and hardware environment. Should be carefully edited and adapted before using. This way suitable mostly to experienced awesome users. Some things to pay attention:

Start with Shades

The same as colors but may have some experimental or unpolished features.

Tips

Hotkeys helper bound to Mod4+F1 (with holding modkey) by default, It will show you all hotkeys available at the current moment.

Theme files is very valuable part of config. Some widgets appearance can be changed dramatically with themes.

This config was designed to work with composite manager (e.g. compton).

ACYLS icon pack is very good complement for this configs. Some widgets was designed with this pack in mind.

There are lot shared parts between configs and themes, pay attention to require directives.

Xephyr is excellent tool for awesome deep customization.

Themes

This config isn't compatible with standard awesome themes and its themes not compatible with default config.

Structure

There is some inheritance and code sharing between theme files.

Colorless themes/colorless/theme.lua is base and only one self-sufficient theme. It contains list of all appearance variables for redflat widgets with commentaries. Also it directly define style for rc-colorless config.

Colored themes/colored/theme.lua is theme which contain some shared settings (e.g. fonts) for different color configs. It inherits all data from colorless theme and overwrites some values. Doesn't used directly from configs.

Color specified themes (e.g. themes/blue/theme.lua for rc-blue.lua) are inherit all data from colored and overwrite config specific values. So to find some widget style for blue theme you shuold check theme files order blue -> colored -> colorless.

Adding new theme

Easiest way to make a copy of colorless theme file and edit it.

Statement

All code provided as is without any warranties.

The project started as custom personal config. Later was reconstructed as awesome extension module but still has a lot things to fix. Some parts of redflat were designed for early versions of awesome and need refactoring now. Project always open to any code improvement and fixes.