Take the 2-minute tour ×
Super User is a question and answer site for computer enthusiasts and power users. It's 100% free, no registration required.

I've installed awesome on my Ubuntu laptop, and I like it. But I feel kind of lost. I don't know any keyboard shortcuts and the man pages aren't really any help (for instance, what does Mod4 mean?).

Is there any kind of brief introduction to awesome I can read?

share|improve this question
Mod4 is the "Wind*ws" Key. –  SabreWolfy Dec 19 '11 at 11:51

6 Answers 6

up vote 13 down vote accepted

Here is one person's introduction

Here is a guide to installing it with Ubuntu

And here is a history and additional links via Wikipedia

Hope that helps!

share|improve this answer
typo on the Wiki link, the ending curly brace is not linked –  Sathya Oct 6 '09 at 14:10
Funny that leaving out the ) will take you to a different page –  Ivo Flipse Oct 6 '09 at 18:56
Ah, I think it's fixed now. Thank you –  Diablomarcus Oct 6 '09 at 22:08
Note to people reading this in 2014: the first link refers to an old version of Awesome. Awesome has replaced ini files with the Lua language for ita configuration. –  spaceknarf Sep 12 '14 at 19:21

I assume Mod4 is the same as meta which is the Windows key on most modern keyboards.

share|improve this answer

Press Mod4+Enter (typically this would be the Wind*ws key and Enter) to open a terminal and then enter man awesome. A list of default key-bindings is shown.

share|improve this answer

Here is my bare bones intro to awesome window manager: http://isomorphismes.tumblr.com/post/33846445632/awesome-window-manager. First few lines:

The main keys you need to know are:

  • ⌘+space = change screen layout type
  • ⌘+shift + space = change screen layout type, cycling backwards
  • ⌘+j = go to the next window on this desktop (focus on, as if you had hovered your mouse over it … but without needing to reach over to the mouse)
  • ⌘+k = go to the previous window on this desktop
  • ⌘+J = swap this window and the next one
  • ⌘+K = swap this window and the previous one
  • ⌘+h = → the center partition squashing the right pane(s)
  • ⌘+l = ← the center partition expanding the right pane(s)
  • ⌘+← = desktop to the left
  • ⌘+→ = desktop to the right
  • ⌘+9 = desktop number nine

Notice that h,j,k,l are the right-handed home row keys on a QWERTY|AZERTY.

share|improve this answer

I recently started out with Awesome too. The links diablomarcus posted are great. You should also check out http://awesome.naquadah.org/wiki/Main_Page If there exists an answer to any question you can't find on the wiki, which is sometimes a little out of date, you're gonna find it at #awesome on OFTC. They're really helpful, even to the novice. Try to do as much research as possible on the wiki.

Oh, and almost right away you're going to want to change at least one settings, so check out the Configuration page on the wiki.

share|improve this answer

I just started using Awesome WM myself.

Regarding the sub-question: "What is Mod4"?

  • Mod4 is one of the modifier keys set for the xserver currently running
  • it can be any physical key you like
  • check setting with $xmodmap -pm

Yuo can read more from the man pages ($man xmodmap) or via Google: xmodmap keyboard layout

You can do some great things with it! Took me a bit to understand it, though.

share|improve this answer

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.