Welcome to Steve Jobs's Awesome-wm config. Listed below is are the important keybindings that differ from the defaults. Underneath is the file itself.


Goodies:
-toggle maximized as layout, not just for a single window
-xtra mode for less important windows
-dmenu with ability to switch to searched window
-bin tag
-undo minimize


How to install:
-Install Awesome-wm. Derp.
-Replace /etc/xdg/awesome/rc.lua with the contents below
-Mod + Ctrl + r to reload Awesome


Description / bindings

Awesome has two ways of maximizing windows: through a layout, and by putting a maximize flag on the active window. The former has the advantage of not being set to a specific window. This way, you can use mod + j/k to go through windows maxmized. The latter has another advantage: you can toggle it on and off with the same binding. This config takes both these advantages: you can toggle on and off as a layout, not just for single windows.

In Awesome, while multiple tags are selected, it uses the layout of the leftmost selected tag. That's why the first tag is reserved for the 'max' layout. With one keybinding (mod+f), you can toggle the tag on/off, thus toggling its layout. You're not supposed to open windows in it, though it can't do harm either. The next 6 tags are your main workspaces. Evens have tile.bottom and odds have tile by default.

The next tag is called 'bin', which simulates an option to undo closing a window. The last tag is called 'xtra' and functions as a place for less important windows. You can send a window there with mod+g and toggle the tag with mod+space.

mod + f         toggle max
mod + i         send window to bin
mod + backspace     kill window
mod + g         send window to xtra
mod + space     toggle xtra
mod + j/k       focus next/previous window, regardless of whether max is enabled


If a window will be used more, you might want to send it from xtra to whatever tag you're using. Sending a window to a tag is more accessible with this config:

mod + #         send window to #
mod + s/d       go to previous/next tag


Besides the use of xtra and bin, this config still allows you to minimize windows. In fact, it has extended support for it:

mod + v         minimize window
mod + c         restore last minimized window


Steve Jobs prefers to have a few important windows in a tag with the rest in xtra. While xtra is on, he wants the important windows to be master windows. This config makes multiple master windows easier:

mod + n/m       increase/decrease number of master windows
mod + ;/'       increase/decrease focused window's size compared to other masters/slaves
mod + h/l       increase/decrease master/slave area size

However, resizing might be easier with mod + right click dragging


mod + p         open dmenu

When you open a program with dmenu, it will first check if there already is an instance of that program. If there is, it will go to that window instead of opening a new instance. This way, you can also use dmenu to switch between windows/tags. If you want to open another instance, use mod + r.


Other stuff:

mod + return        make focused window master
mod+shift + return  open terminal
mod+shift + #       go to #
mod+shift + n/m     next/previous layout


If you prefer fullscreen over maximized, that layout is still left in. You can switch to it manually in the max tag, or change
   layout = { layouts[1], layouts[3], layouts[4], layouts[3], layouts[4],
              layouts[3], layouts[4], layouts[2], layouts[2]
in the config file to
   layout = { layouts[5], layouts[3], layouts[4], layouts[3], layouts[4],
              layouts[3], layouts[4], layouts[2], layouts[2]


Near the end in the config, you will see the line:
run_once("firefox")

This will run firefox on startup. Feel free to add other programs there. Firefox was used for the example because every valid person uses Firefox.


THE FILE IS BELOW

-- Standard awesome library
require("awful")
require("awful.autofocus")
require("awful.rules")
-- Theme handling library
require("beautiful")
-- Notification library
require("naughty")

-- Load Debian menu entries
require("debian.menu")

-- {{{ Variable definitions
-- Themes define colours, icons, and wallpapers
beautiful.init("/usr/share/awesome/themes/default/theme.lua")

-- This is used later as the default terminal and editor to run.
terminal = "x-terminal-emulator"
editor = os.getenv("EDITOR") or "editor"
editor_cmd = terminal .. " -e " .. editor

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

-- Table of layouts to cover with awful.layout.inc, order matters.
layouts =
{
   awful.layout.suit.max,
   awful.layout.suit.fair,
   awful.layout.suit.tile.bottom,
   awful.layout.suit.tile,
   awful.layout.suit.max.fullscreen
}
-- }}}

 -- {{{ Tags
 tags = {
   names  = { "max", 2, 3, 4, 5, 6, 7, "bin", "xtra"},
   layout = { layouts[1], layouts[3], layouts[4], layouts[3], layouts[4],
              layouts[3], layouts[4], layouts[2], layouts[2]
 }}

 for s = 1, screen.count() do
     tags[s] = awful.tag(tags.names, s, tags.layout)
 end
 -- }}}

-- {{{ Menu
-- Create a laucher widget and a main menu
myawesomemenu = {
   { "manual", terminal .. " -e man awesome" },
   { "edit config", editor_cmd .. " " .. awful.util.getdir("config") .. "/rc.lua" },
   { "restart", awesome.restart },
   { "quit", awesome.quit }
}

mymainmenu = awful.menu({ items = { { "awesome", myawesomemenu, beautiful.awesome_icon },
                                    { "Debian", debian.menu.Debian_menu.Debian },
                                    { "open terminal", terminal }
                                  }
                        })

mylauncher = awful.widget.launcher({ image = image(beautiful.awesome_icon),
                                     menu = mymainmenu })
-- }}}

-- {{{ Wibox
-- Create a textclock widget
mytextclock = awful.widget.textclock({ align = "right" })

-- Create a systray
mysystray = widget({ type = "systray" })

-- Create a wibox for each screen and add it
mywibox = {}
mypromptbox = {}
mylayoutbox = {}
mytaglist = {}
mytaglist.buttons = awful.util.table.join(
                    awful.button({ }, 1, awful.tag.viewonly),
                    awful.button({ modkey }, 1, awful.client.movetotag),
                    awful.button({ }, 3, awful.tag.viewtoggle),
                    awful.button({ modkey }, 3, awful.client.toggletag),
                    awful.button({ }, 4, awful.tag.viewnext),
                    awful.button({ }, 5, awful.tag.viewprev)
                    )
mytasklist = {}
mytasklist.buttons = awful.util.table.join(
                     awful.button({ }, 1, function (c)
                                              if not c:isvisible() then
                                                  awful.tag.viewonly(c:tags()[1])
                                              end
                                              client.focus = c
                                              c:raise()
                                          end),
                     awful.button({ }, 3, function ()
                                              if instance then
                                                  instance:hide()
                                                  instance = nil
                                              else
                                                  instance = awful.menu.clients({ width=250 })
                                              end
                                          end),
                     awful.button({ }, 4, function ()
                                              awful.client.focus.byidx(1)
                                              if client.focus then client.focus:raise() end
                                          end),
                     awful.button({ }, 5, function ()
                                              awful.client.focus.byidx(-1)
                                              if client.focus then client.focus:raise() end
                                          end))

for s = 1, screen.count() do
    -- Create a promptbox for each screen
    mypromptbox[s] = awful.widget.prompt({ layout = awful.widget.layout.horizontal.leftright })
    -- Create an imagebox widget which will contains an icon indicating which layout we're using.
    -- We need one layoutbox per screen.
    mylayoutbox[s] = awful.widget.layoutbox(s)
    mylayoutbox[s]:buttons(awful.util.table.join(
                           awful.button({ }, 1, function () awful.layout.inc(layouts, 1) end),
                           awful.button({ }, 3, function () awful.layout.inc(layouts, -1) end),
                           awful.button({ }, 4, function () awful.layout.inc(layouts, 1) end),
                           awful.button({ }, 5, function () awful.layout.inc(layouts, -1) end)))
    -- Create a taglist widget
    mytaglist[s] = awful.widget.taglist(s, awful.widget.taglist.label.all, mytaglist.buttons)

    -- Create a tasklist widget
    mytasklist[s] = awful.widget.tasklist(function(c)
                                              return awful.widget.tasklist.label.currenttags(c, s)
                                          end, mytasklist.buttons)

    -- Create the wibox
    mywibox[s] = awful.wibox({ position = "top", screen = s })
    -- Add widgets to the wibox - order matters
    mywibox[s].widgets = {
        {
            mylauncher,
            mytaglist[s],
            mypromptbox[s],
            layout = awful.widget.layout.horizontal.leftright
        },
        mylayoutbox[s],
        mytextclock,
        s == 1 and mysystray or nil,
        mytasklist[s],
        layout = awful.widget.layout.horizontal.rightleft
    }
end
-- }}}

-- {{{ Mouse bindings
root.buttons(awful.util.table.join(
    awful.button({ }, 3, function () mymainmenu:toggle() end),
    awful.button({ }, 4, awful.tag.viewnext),
    awful.button({ }, 5, awful.tag.viewprev)
))
-- }}}

-- {{{ Key bindings
globalkeys = awful.util.table.join(

-- Run or raise applications with dmenu
    awful.key({ modkey }, "p",
    function ()
       local f_reader = io.popen( "dmenu_path | dmenu -b -nb '"..
    beautiful.bg_normal .."' -nf '".. beautiful.fg_normal .."' -sb      '#955'")
      local command = assert(f_reader:read('*a'))
      f_reader:close()
      if command == "" then return end

-- Check throught the clients if the class match the command
   local lower_command=string.lower(command)
   for k, c in pairs(client.get()) do
       local class=string.lower(c.class)
       if string.match(class, lower_command) then
           for i, v in ipairs(c:tags()) do
               awful.tag.viewonly(v)
               c:raise()
               c.minimized = false
               return
           end
       end
   end
   awful.util.spawn(command)
end),

-- Mod + c = unminimize
   awful.key({ modkey,        }, "c",
       function ()
           local allclients = client.get(mouse.screen)

           for _,c in ipairs(allclients) do
               if c.minimized and c:tags()[mouse.screen] ==
awful.tag.selected(mouse.screen) then
                   c.minimized = false
                   client.focus = c
                   c:raise()
                   return
               end
           end
       end),

    awful.key({ modkey,           }, "f",
                  function ()
                      local screen = mouse.screen
                      if tags[screen] then
                          awful.tag.viewtoggle(tags[screen][1])
                      end
                  end),

    awful.key({ modkey,           }, "space",
                  function ()
                      local screen = mouse.screen
                      if tags[screen] then
                          awful.tag.viewtoggle(tags[screen][9])
                      end
                  end),

    awful.key({ modkey,           }, "g",
                  function ()
                      if client.focus and tags[client.focus.screen] then
                          awful.client.movetotag(tags[client.focus.screen][9])
                      end
                  end),

    awful.key({ modkey,           }, "i",
                  function ()
                      if client.focus and tags[client.focus.screen] then
                          awful.client.movetotag(tags[client.focus.screen][8])
                      end
                  end),

   awful.key({ modkey,         }, ";", function () awful.client.incwfact(-0.05) end),
   awful.key({ modkey,         }, "'", function () awful.client.incwfact( 0.05) end),

    awful.key({ modkey,           }, "s",   awful.tag.viewprev       ),
    awful.key({ modkey,           }, "d",  awful.tag.viewnext       ),
    awful.key({ modkey,           }, "Escape", awful.tag.history.restore),

    awful.key({ modkey,           }, "j",
        function ()
            awful.client.focus.byidx( 1)
            if client.focus then client.focus:raise() end
        end),
    awful.key({ modkey,           }, "k",
        function ()
            awful.client.focus.byidx(-1)
            if client.focus then client.focus:raise() end
        end),
    awful.key({ modkey,           }, "w", function () mymainmenu:show({keygrabber=true}) end),

    -- Layout manipulation
    awful.key({ modkey, "Shift"   }, "j", function () awful.client.swap.byidx(  1)    end),
    awful.key({ modkey, "Shift"   }, "k", function () awful.client.swap.byidx( -1)    end),
    awful.key({ modkey, "Control" }, "j", function () awful.screen.focus_relative( 1) end),
    awful.key({ modkey, "Control" }, "k", function () awful.screen.focus_relative(-1) end),
    awful.key({ modkey,           }, "y", awful.client.urgent.jumpto),
    awful.key({ modkey,           }, "Tab",
        function ()
            awful.client.focus.history.previous()
            if client.focus then
                client.focus:raise()
            end
        end),

    -- Standard program
    awful.key({ modkey, "Shift"   }, "Return", function () awful.util.spawn(terminal) end),
    awful.key({ modkey, "Control" }, "r", awesome.restart),
    awful.key({ modkey, "Shift"   }, "q", awesome.quit),

    awful.key({ modkey,           }, "l",     function () awful.tag.incmwfact( 0.05)    end),
    awful.key({ modkey,           }, "h",     function () awful.tag.incmwfact(-0.05)    end),
    awful.key({ modkey,           }, "n",     function () awful.tag.incnmaster( 1)      end),
    awful.key({ modkey,           }, "m",     function () awful.tag.incnmaster(-1)      end),
    awful.key({ modkey, "Control" }, "h",     function () awful.tag.incncol( 1)         end),
    awful.key({ modkey, "Control" }, "l",     function () awful.tag.incncol(-1)         end),
    awful.key({ modkey, "Shift"   }, "n", function () awful.layout.inc(layouts,  1) end),
    awful.key({ modkey, "Shift"   }, "m", function () awful.layout.inc(layouts, -1) end),

    -- Prompt
    awful.key({ modkey },            "r",     function () mypromptbox[mouse.screen]:run() end),

    awful.key({ modkey }, "x",
              function ()
                  awful.prompt.run({ prompt = "Run Lua code: " },
                  mypromptbox[mouse.screen].widget,
                  awful.util.eval, nil,
                  awful.util.getdir("cache") .. "/history_eval")
              end)
)

clientkeys = awful.util.table.join(
    awful.key({ modkey, "Shift"   }, "f",      function (c) c.fullscreen = not c.fullscreen  end),
    awful.key({ modkey,           }, "BackSpace",      function (c) c:kill()                         end),
    awful.key({ modkey, "Control" }, "space",  awful.client.floating.toggle                     ),
    awful.key({ modkey,           }, "Return", function (c) c:swap(awful.client.getmaster()) end),
    awful.key({ modkey,           }, "o",      awful.client.movetoscreen                        ),
    awful.key({ modkey, "Shift"   }, "r",      function (c) c:redraw()                       end),
    awful.key({ modkey,           }, "t",      function (c) c.ontop = not c.ontop            end),
    awful.key({ modkey,           }, "v",      function (c) c.minimized = not c.minimized    end)
)

-- Compute the maximum number of digit we need, limited to 9
keynumber = 0
for s = 1, screen.count() do
   keynumber = math.min(9, math.max(#tags[s], keynumber));
end

-- Bind all key numbers to tags.
-- Be careful: we use keycodes to make it works on any keyboard layout.
-- This should map on the top row of your keyboard, usually 1 to 9.
for i = 1, keynumber do
    globalkeys = awful.util.table.join(globalkeys,
        awful.key({ modkey, "Shift" }, "#" .. i + 9,
                  function ()
                        local screen = mouse.screen
                        if tags[screen][i] then
                            awful.tag.viewonly(tags[screen][i])
                        end
                  end),
        awful.key({ modkey, "Control" }, "#" .. i + 9,
                  function ()
                      local screen = mouse.screen
                      if tags[screen][i] then
                          awful.tag.viewtoggle(tags[screen][i])
                      end
                  end),
        awful.key({ modkey,        }, "#" .. i + 9,
                  function ()
                      if client.focus and tags[client.focus.screen][i] then
                          awful.client.movetotag(tags[client.focus.screen][i])
                      end
                  end),
        awful.key({ modkey, "Control", "Shift" }, "#" .. i + 9,
                  function ()
                      if client.focus and tags[client.focus.screen][i] then
                          awful.client.toggletag(tags[client.focus.screen][i])
                      end
                  end))
end

clientbuttons = awful.util.table.join(
    awful.button({ }, 1, function (c) client.focus = c; c:raise() end),
    awful.button({ modkey }, 1, awful.mouse.client.move),
    awful.button({ modkey }, 3, awful.mouse.client.resize))

-- Set keys
root.keys(globalkeys)
-- }}}

-- {{{ Rules
awful.rules.rules = {
    -- All clients will match this rule.
    { rule = { },
      properties = { border_width = beautiful.border_width,
                     border_color = beautiful.border_normal,
                     focus = true,
                     keys = clientkeys,
                     buttons = clientbuttons } },
    { rule = { class = "MPlayer" },
      properties = { floating = true } },
    { rule = { class = "pinentry" },
      properties = { floating = true } },
    { rule = { class = "gimp" },
      properties = { floating = true } },
    -- Set Firefox to always map on tags number 2 of screen 1.
    -- { rule = { class = "Firefox" },
    --   properties = { tag = tags[1][2] } },
}
-- }}}

-- {{{ Signals
-- Signal function to execute when a new client appears.
client.add_signal("manage", function (c, startup)
    -- Add a titlebar
    -- awful.titlebar.add(c, { modkey = modkey })

    -- Enable sloppy focus
    c:add_signal("mouse::enter", function(c)
        if awful.layout.get(c.screen) ~= awful.layout.suit.magnifier
            and awful.client.focus.filter(c) then
            client.focus = c
        end
    end)

    if not startup then
        -- Set the windows at the slave,
        -- i.e. put it at the end of others instead of setting it master.
        -- awful.client.setslave(c)

        -- Put windows in a smart way, only if they does not set an initial position.
        if not c.size_hints.user_position and not c.size_hints.program_position then
            awful.placement.no_overlap(c)
            awful.placement.no_offscreen(c)
        end
    end
end)

client.add_signal("focus", function(c) c.border_color = beautiful.border_focus end)
client.add_signal("unfocus", function(c) c.border_color = beautiful.border_normal end)
-- }}}

function run_once(prg)
    if not prg then
        do return nil end
    end
    awful.util.spawn_with_shell("pgrep -f -u $USER -x " .. prg .. " || (" .. prg .. ")")
end

run_once("firefox")


awful.tag.viewonly(tags[1][3])