Awesome Awesome WM 
A curated list of high-quality tools/scripts/configs for Awesome
Window Manager.
This guide was created because an out-of-the-box Awesome WM
experience is miserable, yet the WM quickly grows on those courageous
enough to tinker with it and weather version-incompatibility issues.
This guide was created for those who need a head start with their
awesome config.
One problem with Awesome WM is that newer versions of Awesome break a
lot of backwards compatibility. Many of the below libraries have been
updated to Awesome 4.2, ones that haven’t will not work with the latest
version of Awesome. A library written for Awesome 3.5 will not work with
Awesome 4.0 and one written for 3.4 will not work with either so make
sure the versions between your modules match. This in itself creates a
lot of frustration for users and a segmentation of Awesome user
base.
This repository tries to keep up to date, most of the tools listed
here are compatible with Awesome 4.0+, some 3.4-3.5 tools are listed if
they’re notable due to their use case or compatible with current version
of Awesome.
Inspired by the awesome list
thing.
Contents
Official Resources
Pre-Built Versions
- Ubuntu/Mint
- Use this PPA instead of official which tends to be very old.
Configuration
- Valid
Key Names - Useful for figuring out things like
PgUp is
actually called Prior so you can map your shortcuts.
- Dynamic
Tagging - Those numbered tags in upper-left corner can now be
renamed on the fly.
- Menu
Replacement - Unlike default menu that looks very basic compared to
other window managers, this menu replaces the original with a more
Start-like menu with icons.
Theming
- Awesome Zen -
Collection of widgets with a consistent interface that hides when
they’re not relevant to declutter your desktop. Also includes utilities
for managing windows more effectively.
- Awesome
WM Widgets - Good options for battery, music, CPU/RAM, and Volume
widgets
- Lain - Another set of
polished Widgets for Awesome
- Vicious -
Contains modules that gather data about your system
- Volume Icon -
Stand-alone volume icon for lightweight WMs that fits well with
nm-applet (C).
- Network
- A wireless + wired network widget that replaces nm-applet (Lua).
- Battery -
Stand-alone battery widget (C).
- Weather - Widget that
retrieves localized weather information from Yahoo.
- Basic
Calendar - Simple, but pretty calendar.
- Calendar
w/ TODO - (orglendar) A calendar + to-do list for awesome that reads
entries from a .org file (I have a cronjob dumping my Google Calendar to
that file) (Lua).
- Pomodoro Timer -
Hides clutter from the screen for 25 mins, replacing it with a progress
bar (Lua).
- awesome-scratch
- A stashing area for window to declutter the workspace and easily
recall programs, doesn’t seem to be actively maintained
Multi-Monitor and Docking
Stations
- screenful - An
extension that leverages udev to detect monitor
connection/disconnection
- autorandr -
Automatically select xrandr display configuration based on connected
devices
Other
Wanted
- Widgets for CPU monitoring, polished mail integration.
- Audio/MPD integration that’s not overly complex like AwsoMPD (which
is somewhat bloated and buggy).
- More theme bundles to share (if you want to share your theme, I ask
that you attach a screenshot to your repo).