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.
Modkey + Shift + Enter
is TerminalModkey + Control + r
is reload rc.luaModkey + t
to attach/detach window from tilesModkey + 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)
- 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.
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.
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.
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
Terminus is a crisp font pleasant to the eyes.
- FreeBSD:
cd /usr/ports/x11-fonts/terminus-font/ && make install clean
orpkg_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 ([email protected])
- 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