/awesome-awesome-wm

A curated list of awesome tools/scripts/configs for Awesome Window Manager.

Creative Commons Zero v1.0 UniversalCC0-1.0

Awesome Awesome WM Awesome

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

Widget Packs

  • 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

Basic Widgets

  • 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.

Productivity Widgets

  • 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).