tony / awesome-config

:closed_book: Example awesome wm configuration. Includes personalization support (personal.vim), theme, polyglot unicode taglists, mpd support.

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 ([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

awesome-config's Issues

v3.5 中时间不显示

only have a clock icon,but don't have time text.

Menu for the configuration

I've noticed that you awesome configuration lacks from the default menu. I've tried to add it myself, without success. It seems it colides with your configurations.

I'm quite new with awesome, so 100% sure it's my fault, but any help would be greatly appreciated.

I followed the instructions on a 32 bit ubuntu 16.04 machine and get an error

The stack said something on the lines that it couldn't run the require_safe function. I am sorry it did not stay too long on my screen so I could not copy paste. Any clue what it could be?

few rc.lua issues with 3.5

This with the 3.5 branch and version 3.5.1 of awesome.
hopefully this isn't something I am missing but I am getting:

W: awesome: luaA_dofunction:78: error while running function
stack traceback:
    /home/nick/.config/awesome/rc.lua:254: in function </home/nick/.config/awesome/rc.lua:251>
    (tail call): ?
    /home/nick/.config/awesome/vicious/init.lua:70: in function 'update'
    /home/nick/.config/awesome/vicious/init.lua:42: in function 'update'
    /home/nick/.config/awesome/vicious/init.lua:155: in function </home/nick/.config/awesome/vicious/init.lua:154>
error: /home/nick/.config/awesome/rc.lua:254: attempt to concatenate field 'fg_netup_widget' (a nil value)
amixer: Unable to find simple control 'PCM',0

Maintainer?

Tony, I'd be interested in being the maintainer of this theme. Send me an email if you'd like to talk more about this.

tasklist

How would I go about adding the tasklist back? I love everything about this theme, aside from lack of tasklist. I tried to just copy and paste the tasklist from the default rc.lua but tons of errors.

Vicious submodule moved so git submodule functions fail

https://git.sysphere.org/vicious/ moved to https://github.com/vicious-widgets/vicious

What about awesome v4? will it work ?

Attempt to index global 'awful' (a nul value)

When I restart appeared this message
http://i.imgur.com/bN59UUg.jpg