Adventures with Awesome-3.4.1-Part1-The Basics

              
#TODO: Add screenshots


        I promised a walk-through of how to setup an rc.lua with widgets and other personalizations in Awesome, and here I am to come through :)  First thing is first, installing Awesome.  I will assume that you are familiar with your linux distribution enough to be able to install a package.  For Sabayon users you can open up your favorite terminal and type:

equo update && equo install awesome

Once the package is complete, enter this command:

cp /etc/xdg/awesome/rc.lua /home/yourname/.config/awesome

If you get a complaint about the awesome directory not being there, create it (as user)

mkdir ~/.config/awesome  

and then follow the previous command to copy the stock rc.lua to your home directory.

To alleviate any issues of permissions, as root: chown yourname /home/yourname/.config/awesome/rc.lua

Remember! you will still have to be root to edit the rc.lua in /etc/xdg/awesome.

Now that all of that is out of the way, let's get to personalizing Awesome.  Open the run prompt (at the top of the screen) by typing mod4+r (mod4 = windows key on most US keymaps).  You will notice a small "run" dialog at the top of your screen on the statusbar.  Enter the run command for your text editor of choice (gedit, bluefish-unstable, emacs, etc), once your editor is up on your screen, open your rc.lua (from within your ~/.config/awesome directory) and take a look at what is going on.  Here is a look at the top of my rc.lua:

1.  -- Standard awesome library
2.  require("awful")
3.  require("awful.autofocus")
4.  require("awful.rules")
5.  -- Theme handling library
6.  require("beautiful")
7.  -- Notification library
8.  require("naughty")
9.  -- Vicious Widgets
10. require("vicious")

As you can see there is quite a bit going on here :)  Lines 1 - 10 are telling awesome what libraries to open, for now we won't worry about this, just know that what is contained in that block is what's required for awesome to open.

12.-- {{{ Variable definitions

13.-- Themes define colours, icons, and wallpapers
14.beautiful.init("/home/darthlukan/.config/awesome/themes/default/theme.lua")

Lines 12 - 14 are the first of what I think of as the "eye candy" configs.  Here is where we specify our themes to be used.  There are infinite possibilities to theming awesome since the themes are really just config files themselves where arguments for colors and images can be made (among other things).  Awesome by default comes with three themes, Default, Zenburn, and Sky.  More on themes in  later How To.  For now just keep in mind that there are several themes available to you and some user submitted ones can be found on the Awesome wiki.

16. -- This is used later as the default terminal and editor to run.
17. terminal = "lilyterm"
18. editor = os.getenv("EDITOR") or "vim"
19. editor_cmd = terminal .. " -e " .. editor

Now we move on to lines 16 - 19.  As you can see in the screen shot, I have selected lilyterm as my terminal of choice, your rc.lua (assuming no changes from stock) most-likely shows Terminal = "xterm".  To change this simply do as I did and within the quotes enter the run command for your terminal of choice ("Eterm", "rxvt", "aterm", etc).  You will also see the line (18) specifying the terminal editor of choice, I prefer vim, so I left it there, but you can change this to match your preference as well ("nano", "vim", "pico", etc).

20. -- Default modkey.
21. -- Usually, Mod4 is the key with a logo between Control and Alt.
22. -- If you do not like this or do not have such a key,
23. -- I suggest you to remap Mod4 to another key using xmodmap or 24. other tools.
25. -- However, you can use another modifier like Mod1, but it may 26. interact with others.
27. modkey = "Mod4"

I won't touch on the next few lines (21 - 26) only because I have not myself adjusted these settings (for lack of a reason to) and I don't want to give bad information.  However, the mod4 key in my case is the "winkey", it's just about the only useful things that I have found for windows (yes that's a stab at an inferior OS :P ).

For the sake of ensuring that we have our bearings straight, I've included the layout arguments in the screenshot.  But really we are going to skip this and get right into the tags.  Your rc.lua (if stock) does not look the same on these lines, instead you have numbers:

tags[s] = awful.tag({ 1, 2, 3, 4, 5, 6, 7, 8, 9 }, s)

Notice that there are no quotes ( ' ' or " " ), that is because you have numerical values.  To change the names of your tags (desktops) simply add either single (' ') or double (" ") quotes with your desired names within the quotes as you see in mine above.

Now we are going to take a break from this config file, I've thrown a lot at you and really by now you are looking at the default awesome background on your desktop and wonder, "when can I change this?".  So we are going to skip ahead a little and change that wallpaper :)

There are a couple of ways to do this, however, we are still at the basics level, so I'm going to show you the easiest way.  The following needs to be done as root using whichever text editor that you choose, here I'll use gedit:

# gedit /usr/share/awesome/themes/default/theme.lua

Once you have the file opened in your text editor, scroll down to line 77 (theme.wallpaper_cmd = )

and point the command to your desired background; in my case it is the same background as my SLiM theme.  You will have to restart awesome (or logout and log back in) for the change to take effect, but yes, it is truly as easy as that.  To restart awesome you can use key combinations (mod4+shift+r) or you can right-click on the desktop and in the awesome menu select "restart" or "quit".  If you select quit, awesome will close out completely and you will be sent back to your login manager, you will have to then log back in just as you would if you had turned on your computer.

With all of that done, you should now have Awesome setup for basic desktop use.  In the next part we will dive into changing themes, adding custom menus, and creating some simple widgets using Vicious!  If you are a more advanced user and feel that you have what it takes to dive right into customizing awesome, feel free to visit the Awesome wiki and have a look at all of the possibilities that have been posted there.  If you would rather play it safe, I'll have more up tomorrow.  For now, I'll leave you with a nice screenshot of some simple things that are possible with awesome :)  Enjoy:

-DarthLukan

Adventures with Awesome-3.4.1

#TODO: Add new screenshot

So I have been using the Awesome window manager on Sabayon Linux (above screenshot) for the better part of a month as my primary window manager and am in love! Although first developed as a "tiling" window manager, Awesome has begun to change into quite the floating window manager as well. It's configuration is not very difficult at all (coming from me that is saying a lot) and is even easier if you are familiar with Lua code (I am not).

Awesome is configured by editing a single config file (~/.config/awesome/rc.lua) by default, which offers A LOT of functionality from default keybindings to background images, to menus, to you get the idea. It can optionally be extended by the use of external libraries to create widgets

#TODO: Add Images

Your tastes may vary, but as you can see I prefer a more simple interface. My widget library of choice so far is Vicious, however there are several others which can be found here at the Awesome Wiki. I chose Vicious because of a recommendation from Adrian C. (anrxc) who also happens to be a Vicious developer (pun intended). Vicious allows you to spare yourself the added typing of standard widgets by using a single line of code ( vicious.register() ).

Soon I will use this space to give a walk-through of sorts of how I edited the default rc.lua and how to create widgets with vicious. For now however, I have other things to do :)

Good Night!

What's been going on...

Let's see, I started this blog, I thought I had lots to talk about (I did and do) but I had a hard time finding the time and best method to integrate a blog into my life outside of facebook, myspace, and my forum use. So here I am, playing catch-up.

I came home from Iraq in May of '08 to BEAUTIFUL Prairie Grove, AR. My wife and I got the chance to have a mostly new start. My kids got to know me (again) which was a real treat and it seemed like we were in paradise. That's when tragedy happened. Bad market, no work, no money, had to move back to California. The great thing about it was that I had over six months to recover and focus on my family and dealing with a few "new found friends" that I brought home with me from Iraq...

Well, we have made the best of our situation and are actually pretty comfortable with where we are at right now as a family. So all is well there.

My wife and I have been using Sabayon Linux (www.sabayonlinux.org) for a few months now (no windblowz in our house :P) and it has made things a little more fun and interesting. Last night I received my google wave invite which is proving to be a LOT of great fun (darthlukan@googlewave.com) and I've already begun working on a few projects of which I will be posting about up here very soon.

Soon to follow, my adventures with Sabayon Linux, learning python and lua, modifying awesomewm, and other random bits of hopefully fun and useful info.

-DarthLukan