All patches and comments are welcome. Please squash your changes to logical
commits before using git-format-patch and git-send-email to
patches@git.madduck.net.
If you'd read over the Git project's submission guidelines and adhered to them,
I'd be especially grateful.
1 -- awesome 3 configuration file
3 AWESOME_DATADIR = "/home/madduck/code"
4 package.path = AWESOME_DATADIR .. "/awesome/lib/?.lua;" .. package.path
6 -- Include awesome library, with lots of useful function!
10 -- Uncomment this to activate autotabbing
11 -- tabulous.autotab_start()
13 -- {{{ Variable definitions
14 -- This is used later as the default terminal to run.
15 terminal = "x-terminal-emulator"
18 -- Usually, Mod4 is the key with a logo between Control and Alt.
19 -- If you do not like this or do not have such a key,
20 -- I suggest you to remap Mod4 to another key using xmodmap or other tools.
21 -- However, you can use another modifier like Mod1, but it may interact with others.
24 -- Table of layouts to cover with awful.layout.inc, order matters.
38 -- Table of clients that should be set floating
48 -- Color & Appearance definitions, we use these later to display things
49 font = "RotisSansSerif 10"
54 border_normal = "#000000"
58 border_focus = bg_focus
59 border_marked = "#91231C"
61 awesome.font_set(font)
62 awesome.colors_set({ fg = fg_normal, bg = bg_normal })
69 for s = 1, screen.count() do
70 -- Each screen has its own tag table
72 -- Create 9 tags per screen
73 for tagnumber = 1, 9 do
74 tags[s][tagnumber] = tag.new({ name = tagnumber })
75 -- Add tags to screen one by one
76 -- split at 0.5/50% exactly
77 tags[s][tagnumber]:mwfact_set(0.5)
78 tags[s][tagnumber]:add(s)
80 -- I'm sure you want to see at least one tag.
86 -- Create a taglist widget
87 mytaglist = widget.new({ type = "taglist", name = "mytaglist" })
88 mytaglist:mouse_add(mouse.new({}, 1, function (object, tag) awful.tag.viewonly(tag) end))
89 mytaglist:mouse_add(mouse.new({ modkey }, 1, function (object, tag) awful.client.movetotag(tag) end))
90 mytaglist:mouse_add(mouse.new({}, 3, function (object, tag) tag:view(not tag:isselected()) end))
91 mytaglist:mouse_add(mouse.new({ modkey }, 3, function (object, tag) awful.client.toggletag(tag) end))
92 mytaglist:mouse_add(mouse.new({ }, 4, awful.tag.viewnext))
93 mytaglist:mouse_add(mouse.new({ }, 5, awful.tag.viewprev))
94 mytaglist:text_set({ ["focus"] = "<bg color='"..bg_focus.."'/> <span color='"..fg_focus.."'><title/></span> " })
96 -- Create a tasklist widget
97 mytasklist = widget.new({ type = "tasklist", name = "mytasklist" })
98 mytasklist:mouse_add(mouse.new({ }, 1, function (object, c) c:focus_set(); c:raise() end))
99 mytasklist:mouse_add(mouse.new({ }, 4, function () awful.client.focus(1) end))
100 mytasklist:mouse_add(mouse.new({ }, 5, function () awful.client.focus(-1) end))
101 mytasklist:text_set({ ["focus"] = "<bg color='"..bg_focus.."'/> <span color='"..fg_focus.."'><title/></span> " })
103 -- Create a textbox widget
104 mytextbox = widget.new({ type = "textbox", name = "mytextbox", align = "right" })
105 -- Set the default text in textbox
106 mytextbox:text_set("<b><small> awesome " .. AWESOME_VERSION .. " </small></b>")
107 mypromptbox = widget.new({ type = "textbox", name = "mypromptbox", align = "left" })
109 -- Create an iconbox widget
110 myiconbox = widget.new({ type = "textbox", name = "myiconbox", align = "left" })
111 myiconbox:text_set("<bg image=\"/usr/local/share/awesome/icons/awesome16.png\" resize=\"true\"/>")
114 mysystray = widget.new({ type = "systray", name = "mysystray", align = "right" })
116 -- Create an iconbox widget which will contains an icon indicating which layout we're using.
117 -- We need one layoutbox per screen.
119 for s = 1, screen.count() do
120 mylayoutbox[s] = widget.new({ type = "textbox", name = "mylayoutbox", align = "right" })
121 mylayoutbox[s]:mouse_add(mouse.new({ }, 1, function () awful.layout.inc(layouts, 1) end))
122 mylayoutbox[s]:mouse_add(mouse.new({ }, 3, function () awful.layout.inc(layouts, -1) end))
123 mylayoutbox[s]:mouse_add(mouse.new({ }, 4, function () awful.layout.inc(layouts, 1) end))
124 mylayoutbox[s]:mouse_add(mouse.new({ }, 5, function () awful.layout.inc(layouts, -1) end))
125 mylayoutbox[s]:text_set("<bg image=\"/usr/local/share/awesome/icons/layouts/tilew.png\" resize=\"true\"/>")
128 -- Create a statusbar for each screen and add it
130 for s = 1, screen.count() do
131 mystatusbar[s] = statusbar.new({ position = "top", name = "mystatusbar" .. s,
132 fg = fg_normal, bg = bg_normal })
133 -- Add widgets to the statusbar - order matters
134 mystatusbar[s]:widget_add(mytaglist)
135 mystatusbar[s]:widget_add(myiconbox)
136 mystatusbar[s]:widget_add(mytasklist)
137 mystatusbar[s]:widget_add(mypromptbox)
138 mystatusbar[s]:widget_add(mytextbox)
139 mystatusbar[s]:widget_add(mylayoutbox[s])
140 mystatusbar[s]:add(s)
142 mystatusbar[screen.count()]:widget_add(mysystray)
145 -- {{{ Mouse bindings
146 awesome.mouse_add(mouse.new({ }, 3, function () awful.spawn(terminal) end))
147 awesome.mouse_add(mouse.new({ }, 4, awful.tag.viewnext))
148 awesome.mouse_add(mouse.new({ }, 5, awful.tag.viewprev))
153 -- Bind keyboard digits
154 -- Compute the maximum number of digit we need, limited to 9
156 for s = 1, screen.count() do
157 keynumber = math.min(9, math.max(#tags[s], keynumber));
160 for i = 1, keynumber do
161 keybinding.new({ modkey }, i,
163 local screen = mouse.screen_get()
164 if tags[screen][i] then
165 awful.tag.viewonly(tags[screen][i])
168 keybinding.new({ modkey, "Control" }, i,
170 local screen = mouse.screen_get()
171 if tags[screen][i] then
172 tags[i]:view(not tags[screen][i]:isselected())
175 keybinding.new({ modkey, "Shift" }, i,
177 local screen = mouse.screen_get()
178 if tags[screen][i] then
179 awful.client.movetotag(tags[screen][i])
182 keybinding.new({ modkey, "Control", "Shift" }, i,
184 local screen = mouse.screen_get()
185 if tags[screen][i] then
186 awful.client.toggletag(tags[screen][i])
191 keybinding.new({ modkey }, "Left", awful.tag.viewprev):add()
192 keybinding.new({ modkey }, "Right", awful.tag.viewnext):add()
195 keybinding.new({ modkey }, "Return", function () awful.spawn(terminal) end):add()
197 keybinding.new({ modkey, "Control" }, "r", awesome.restart):add()
198 keybinding.new({ modkey, "Shift" }, "q", awesome.quit):add()
200 -- Client manipulation
201 keybinding.new({ modkey, "Shift" }, "Escape", function () client.focus_get():kill() end):add()
202 keybinding.new({ modkey }, "k", function () awful.client.focus(1); client.focus_get():raise() end):add()
203 keybinding.new({ modkey }, "j", function () awful.client.focus(-1); client.focus_get():raise() end):add()
204 keybinding.new({ modkey, "Shift" }, "k", function () awful.client.swap(1) end):add()
205 keybinding.new({ modkey, "Shift" }, "j", function () awful.client.swap(-1) end):add()
206 keybinding.new({ modkey, "Control" }, "k", function () awful.screen.focus(1) end):add()
207 keybinding.new({ modkey, "Control" }, "j", function () awful.screen.focus(-1) end):add()
208 keybinding.new({ modkey, "Control" }, "space", awful.client.togglefloating):add()
209 keybinding.new({ modkey, "Control" }, "Return", function () client.focus_get():swap(awful.client.master()) end):add()
210 keybinding.new({ modkey }, "o", awful.client.movetoscreen):add()
212 -- Layout manipulation
213 keybinding.new({ modkey }, "l", function () awful.tag.incmwfact(0.05) end):add()
214 keybinding.new({ modkey }, "h", function () awful.tag.incmwfact(-0.05) end):add()
215 keybinding.new({ modkey, "Shift" }, "h", function () awful.tag.incnmaster(1) end):add()
216 keybinding.new({ modkey, "Shift" }, "l", function () awful.tag.incnmaster(-1) end):add()
217 keybinding.new({ modkey, "Control" }, "h", function () awful.tag.incncol(1) end):add()
218 keybinding.new({ modkey, "Control" }, "l", function () awful.tag.incncol(-1) end):add()
219 keybinding.new({ modkey }, "space", function () awful.layout.inc(layouts, 1) end):add()
220 keybinding.new({ modkey, "Shift" }, "space", function () awful.layout.inc(layouts, -1) end):add()
223 keybinding.new({ modkey }, "F1", function ()
224 awful.prompt({ prompt = "Run: ", cursor_fg = fg_focus, cursor_bg = bg_focus }, mypromptbox, awful.spawn, awful.completion.bash)
226 keybinding.new({ modkey }, "F4", function ()
227 awful.prompt({ prompt = "Run Lua code: ", cursor_fg = fg_focus, cursor_bg = bg_focus }, mypromptbox, awful.eval, awful.prompt.bash)
230 --- Tabulous, tab manipulation
231 keybinding.new({ modkey, "Control" }, "y", function ()
232 local tabbedview = tabulous.tabindex_get()
233 local nextclient = awful.client.next(1)
235 if tabbedview == nil then
236 tabbedview = tabulous.tabindex_get(nextclient)
238 if tabbedview == nil then
239 tabbedview = tabulous.tab_create()
240 tabulous.tab(tabbedview, nextclient)
242 tabulous.tab(tabbedview, client.focus_get())
245 tabulous.tab(tabbedview, nextclient)
249 keybinding.new({ modkey, "Shift" }, "y", tabulous.untab):add()
251 keybinding.new({ modkey }, "y", function ()
252 local tabbedview = tabulous.tabindex_get()
254 if tabbedview ~= nil then
255 local n = tabulous.next(tabbedview)
256 tabulous.display(tabbedview, n)
260 -- Client awful tagging: this is useful to tag some clients and then do stuff like move to tag on them
261 keybinding.new({ modkey }, "t", awful.client.togglemarked):add()
262 keybinding.new({ modkey, 'Shift' }, "t", function ()
263 local tabbedview = tabulous.tabindex_get()
264 local clients = awful.client.getmarked()
266 if tabbedview == nil then
267 tabbedview = tabulous.tab_create(clients[1])
268 table.remove(clients, 1)
271 for k,c in pairs(clients) do
272 tabulous.tab(tabbedview, c)
277 for i = 1, keynumber do
278 keybinding.new({ modkey, "Shift" }, "F" .. i,
280 local screen = mouse.screen_get()
281 if tags[screen][i] then
282 for k, c in pairs(awful.client.getmarked()) do
283 awful.client.movetotag(tags[screen][i], c)
291 -- Hook function to execute when focusing a client.
292 function hook_focus(c)
293 if not awful.client.ismarked(c) then
294 c:border_set({ width = border_width, color = border_focus })
298 -- Hook function to execute when unfocusing a client.
299 function hook_unfocus(c)
300 if not awful.client.ismarked(c) then
301 c:border_set({ width = border_width, color = border_normal })
305 -- Hook function to execute when marking a client
306 function hook_marked(c)
307 c:border_set({ width = border_width, color = border_marked })
310 -- Hook function to execute when unmarking a client
311 function hook_unmarked(c)
312 c:border_set({ width = border_width, color = border_focus })
315 -- Hook function to execute when the mouse is over a client.
316 function hook_mouseover(c)
317 -- Sloppy focus, but disabled for magnifier layout
318 if awful.layout.get(c:screen_get()) ~= "magnifier" then
323 -- Hook function to execute when a new client appears.
324 function hook_manage(c)
325 -- Add mouse bindings
326 c:mouse_add(mouse.new({ }, 1, function (c) c:focus_set(); c:raise() end))
327 c:mouse_add(mouse.new({ modkey }, 1, function (c) c:mouse_move() end))
328 c:mouse_add(mouse.new({ modkey }, 3, function (c) c:mouse_resize() end))
329 -- New client may not receive focus
330 -- if they're not focusable, so set border anyway.
331 c:border_set({ width = border_width, color = border_normal })
333 if floatings[c:name_get():lower()] then
337 c:honorsizehints_set(true)
340 -- Hook function to execute when arranging the screen
341 -- (tag switch, new client, etc)
342 function hook_arrange(screen)
343 local layout = awful.layout.get(screen)
344 mylayoutbox[screen]:text_set("<bg image=\"/usr/local/share/awesome/icons/layouts/" .. layout .. "w.png\" resize=\"true\"/>")
346 -- Uncomment if you want mouse warping
348 local sel = client.focus_get()
350 local c_c = sel:coords_get()
351 local m_c = mouse.coords_get()
353 if m_c.x < c_c.x or m_c.x >= c_c.x + c_c.width or
354 m_c.y < c_c.y or m_c.y >= c_c.y + c_c.height then
355 if table.maxn(m_c.buttons) == 0 then
356 mouse.coords_set(c_c.x + 5, c_c.y + 5)
364 -- Hook called every second
365 function hook_timer ()
366 -- For unix time_t lovers
367 -- mytextbox:text_set(" " .. os.time() .. " time_t ")
369 mytextbox:text_set(" " .. os.date() .. " ")
373 awful.hooks.focus(hook_focus)
374 awful.hooks.unfocus(hook_unfocus)
375 awful.hooks.marked(hook_marked)
376 awful.hooks.unmarked(hook_unmarked)
377 awful.hooks.manage(hook_manage)
378 awful.hooks.mouseover(hook_mouseover)
379 awful.hooks.arrange(hook_arrange)
380 awful.hooks.timer(1, hook_timer)