Arch Linux

demian

Member

From: Frankfurt, Germany

Registered: 2009-05-06

Posts: 709

awmtt: AwesomeWM Testing Tool

awmtt (awesomewm testing tool) is a bash script that helps you test your Awesome configuration files. It also gives you some control over your current theme.
It requires Xephyr, an Xorg-Application which can spawn a nested instance of Xorg-server allowing you to open multiple instances of Desktop Environments or Window Mangers like AwesomeWM.
Here's an example of what that looks like: http://ompldr.org/vOTNteA

awmtt [ start | stop | restart | -h | -e | -t [ get | change | list | random ] ] [ -C /path/to/rc.lua ] [ -D display ] [ -S windowsize ]

start                 Spawn nested Awesome via Xephyr
stop                  Stops Xephyr
      all               Stop all instances of Xephyr
restart               Restart nested Awesome
-N|--notest        Don't use a testfile but your actual rc.lua (i.e. $HOME/.config/awesome/rc.lua)
-C|--config          Specify configuration file
-D|--display        Specify the display to use (e.g. 1)
-S|--size              Specify the window size
-e|--execute        Execute command in nested Awesome
-t|--theme           Control the current theme
      c|change       Change theme
      p|print           Print themename
      l|list              List available themes
      r|random      Choose random theme
-h|--help             Show this help text

examples:
awmtt start -D 3 -C /etc/xdg/awesome/rc.lua -S 1280x800
awmtt -t change zenburn
awmtt start (uses defaults)

The defaults are -D 1 -C $HOME/.config/awesome/rc.lua.test -S 1024x640

The last few days I've been tinkering a lot with my rc.lua. So i wrote a simple bash function that would load awesome with my rc.lua. This script does essentially that plus some bonus functionality. The theming functionality might come in handy if you want to test a variety of themes, like I've collected them here.

You can get awmtt from GitHub or the AUR.

Regards,
demian

Last edited by demian (2011-06-17 15:32:19)

---

no place like /home
github

Kenny164

Member

Registered: 2010-12-10

Posts: 1

Re: awmtt: AwesomeWM Testing Tool

I've just started out on awesome, and as a newbie all I have to say is...

This is amazing, Thank you!