Version: Awesome 3.4.10 Awesome Homepage: http://awesome.naquadah.org

Beta testing: Awesome 3.5 is being tested in the v3.5 branch. It is experimental, if you have any problems feel free to file an issue.

NOTICE: version 3.5 is going to get the latest features. I will merge these branches when I am sure that 3.4 still works with them, but that will only happen seldomly. If you want to try out the latest features I've added (such as a lock screen command, monitor focus changes, etc.) please checkout the 3.5 branch

Based off of Adrian C's awesome config.

The aim of this project is to create a robust yet beautiful awesome configuration that works out of the box with minimal configuration.

Features

• Modkey + Shift + Enter is Terminal
• Modkey + Control + r is reload rc.lua
• Modkey + t to attach/detach window from tiles
• Modkey + shift + t to toggle titlebars
• Battery widget - autodetects if you have battery, adds widget
• Network widget - pick your devices, eth0 for ethernet, wlan0 for wireless or custom
• Number taglists in various number systems - arabic (1,2,3...), chinese
• mpd widget - autodetects if song player, adds widget (requires curl)
• Random background picker (requires feh)

Credits

• rc.lua and zhongguo thing is based off Adrian C.'s awesome configuration. Licensed CC Attribute Share-Alike.
• Some icons used on the bar are from Yusuke Kamiyaman. Creative Commons Attribution.

Installation

To use this configuration, git clone this, and mv awesome-config to ~/.config/awesome

• cd ~/.config; git clone https://github.com/tony/awesome-config.git awesome
• cd ~/.config/awesome
• git submodule init && git submodule update - download vicious module

Try the one liner:

git clone https://github.com/tony/awesome-config.git ~/.config/awesome && cd ~/.config/awesome && git submodule init && git submodule update && less ~/.config/awesome/README.md

If you are using awesome version 3.5 (beta, in testing), then do:

• cd ~/.config/awesome
• git checkout v3.5

Version 3.5 is in testing in the 3.5 branch.

Configuration

Create a file called personal.lua in ~/.config/awesome. Here are some things you can place in your ~/.config/awesome/personal.lua file:

terminal = 'xterm' -- can be app in path, or full path e.g. /usr/bin/xterm
editor = "vim"

wallpaper_dir = os.getenv("HOME") .. "/yourwallpaper_dir/" -- grabs a random bg

taglist_numbers = "arabic" -- we support arabic (1,2,3...),
-- arabic, chinese, {east|persian}_arabic, roman, thai, random

cpugraph_enable = true -- show CPU graph
cputext_format = " $1%" -- %1 average cpu, %[2..] every other thread individually

membar_enable = true -- show memory bar
memtext_format = " $1%" -- %1 percentage, %2 used %3 total %4 free

date_format = "%a %m/%d/%Y %l:%M%p" -- refer to http://en.wikipedia.org/wiki/Date_(Unix) specifiers

networks = {'eth0', 'wlan0'} -- Add your devices network interface here netwidget, only show one that works

save.

You can use Mod + Control + r to reload configuation.

Autorun

Create a file called autorun.lua in ~/.config/awesome.

First is the binary of the app, the second is the arguments. So to load xscreensaver -no-splash we do: run_once("xscreensaver", "-no-splash").

run_once("xscreensaver", "-no-splash")         -- starts screensaver daemon 
run_once("xsetroot", "-cursor_name left_ptr")  -- sets the cursor icon

--run_once("redshift", "-o -l 0:0 -b 0.5 -t 6500:6500") -- brightness
run_once("ibus-daemon", "--xim") -- ibus
run_once(os.getenv("HOME") .. "/.dropbox-dist/dropboxd") -- dropbox
run_once("nm-applet") -- networking

run_once("wmname", "LG3D") -- java fix

run_once("sh " .. os.getenv("HOME") .. "/.screenlayout/dual-monitor.sh") -- set screens up

Optional stuff

Terminus is a crisp font pleasant to the eyes.

• FreeBSD: cd /usr/ports/x11-fonts/terminus-font/ && make install clean or pkg_add -r terminus-font
• ArchLinux: pacman -S terminus-font
• Debian / Ubuntu: apt-get install xfonts-terminus
• Gentoo: emerge -av media-fonts/terminus-font
• Fedora / CentOS / Redhat: yum install terminus-fonts

In Arch, you may have to edit /etc/X11/xorg.conf and have your font dir to be scanned:

Section "Files"
	FontPath     "/usr/share/fonts/local"
EndSection

You may also want to:

• cd /etc/fonts/conf.d
• ln -sf ../conf.avail/10-autohint.conf ./
• ln -sf ../conf.avail/70-yes-bitmaps.conf ./

Then restart X.

by Tony Narlock (tony@git-pull.com)

• Github: http://www.github.com/tony
• Website: http://www.git-pull.com

Current maintainer:

Alex Keyes

• Github: https://www-github.com/alex-keyes
• Website: http://alexkey.es