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 -- Standard awesome library
2 local gears = require("gears")
3 local awful = require("awful")
4 require("awful.autofocus")
5 -- Widget and layout library
6 local wibox = require("wibox")
7 -- Theme handling library
8 local beautiful = require("beautiful")
9 -- Notification library
10 local naughty = require("naughty")
11 local menubar = require("menubar")
12 local hotkeys_popup = require("awful.hotkeys_popup").widget
15 -- Check if awesome encountered an error during startup and fell back to
16 -- another config (This code will only ever execute for the fallback config)
17 if awesome.startup_errors then
18 naughty.notify({ preset = naughty.config.presets.critical,
19 title = "Oops, there were errors during startup!",
20 text = awesome.startup_errors })
23 -- Handle runtime errors after startup
25 local in_error = false
26 awesome.connect_signal("debug::error", function (err)
27 -- Make sure we don't go into an endless error loop
28 if in_error then return end
31 naughty.notify({ preset = naughty.config.presets.critical,
32 title = "Oops, an error happened!",
33 text = tostring(err) })
39 -- {{{ Variable definitions
40 -- Themes define colours, icons, and wallpapers
41 beautiful.init(awful.util.get_themes_dir() .. "default/theme.lua")
43 -- This is used later as the default terminal and editor to run.
44 terminal = "x-terminal-emulator"
45 editor = "sensible-editor"
46 editor_cmd = terminal .. " -e " .. editor
49 -- Usually, Mod4 is the key with a logo between Control and Alt.
50 -- If you do not like this or do not have such a key,
51 -- I suggest you to remap Mod4 to another key using xmodmap or other tools.
52 -- However, you can use another modifier like Mod1, but it may interact with others.
56 -- Table of layouts to cover with awful.layout.inc, order matters.
57 awful.layout.layouts = {
58 awful.layout.suit.fair,
59 awful.layout.suit.tile,
60 -- awful.layout.suit.tile.left,
61 -- awful.layout.suit.tile.bottom,
62 awful.layout.suit.tile.top,
63 -- awful.layout.suit.spiral,
64 -- awful.layout.suit.spiral.dwindle,
65 awful.layout.suit.max,
66 awful.layout.suit.max.fullscreen,
67 -- awful.layout.suit.magnifier,
68 -- awful.layout.suit.corner.nw,
69 -- awful.layout.suit.corner.ne,
70 -- awful.layout.suit.corner.sw,
71 -- awful.layout.suit.corner.se,
72 awful.layout.suit.floating,
75 layout_default = awful.layout.layouts[1]
76 layout_tiled = awful.layout.layouts[2]
77 layout_maximised = awful.layout.layouts[4]
78 layout_floating = awful.layout.layouts[5]
81 -- {{{ Helper functions
82 local function client_menu_toggle_fn()
86 if instance and instance.wibox.visible then
90 instance = awful.menu.clients({ theme = { width = 250 } })
97 -- Create a launcher widget and a main menu
99 { "hotkeys", function() return false, hotkeys_popup.show_help end},
100 { "manual", terminal .. " -e man awesome" },
101 { "edit config", editor_cmd .. " " .. awesome.conffile },
102 { "restart", awesome.restart },
103 { "quit", awesome.quit }
106 mymainmenu = awful.menu({ items = { { "awesome", myawesomemenu, beautiful.awesome_icon },
107 { "open terminal", terminal }
111 mylauncher = awful.widget.launcher({ image = beautiful.awesome_icon,
114 -- Menubar configuration
115 menubar.utils.terminal = terminal -- Set the terminal for applications that require it
118 -- Keyboard map indicator and switcher
119 mykeyboardlayout = awful.widget.keyboardlayout()
122 -- Create a textclock widget
123 mytextclock = wibox.widget.textclock("%a %d %b %H:%M:%S", 1)
125 -- Create a wibox for each screen and add it
130 mytaglist.buttons = awful.util.table.join(
131 awful.button({ }, 1, function(t) t:view_only() end),
132 awful.button({ modkey }, 1, function(t)
134 client.focus:move_to_tag(t)
137 awful.button({ }, 3, awful.tag.viewtoggle),
138 awful.button({ modkey }, 3, function(t)
140 client.focus:toggle_tag(t)
143 awful.button({ }, 4, function(t) awful.tag.viewnext(t.screen) end),
144 awful.button({ }, 5, function(t) awful.tag.viewprev(t.screen) end)
148 mytasklist.buttons = awful.util.table.join(
149 awful.button({ }, 1, function (c)
150 if c == client.focus then
153 -- Without this, the following
154 -- :isvisible() makes no sense
156 if not c:isvisible() and c.first_tag then
157 c.first_tag:view_only()
159 -- This will also un-minimize
160 -- the client, if needed
165 awful.button({ }, 3, client_menu_toggle_fn()),
166 awful.button({ }, 4, function ()
167 awful.client.focus.byidx(1)
169 awful.button({ }, 5, function ()
170 awful.client.focus.byidx(-1)
173 awful.screen.connect_for_each_screen(function(s)
175 --DISABLED--if beautiful.wallpaper then
176 --DISABLED-- local wallpaper = beautiful.wallpaper
177 --DISABLED-- -- If wallpaper is a function, call it with the screen
178 --DISABLED-- if type(wallpaper) == "function" then
179 --DISABLED-- wallpaper = wallpaper(s)
181 --DISABLED-- gears.wallpaper.maximized(wallpaper, s, true)
184 -- Each screen has its own tag table.
185 tags = awful.tag.new({ "1", "2", "3", "4", "5", "6", "7", "8", "9" }, s, layout_default)
186 tags[7].layout = layout_maximised
187 tags[8].layout = layout_maximised
188 tags[9].layout = layout_maximised
189 tags[1].selected = true
191 -- Create a promptbox for each screen
192 mypromptbox[s] = awful.widget.prompt()
193 -- Create an imagebox widget which will contains an icon indicating which layout we're using.
194 -- We need one layoutbox per screen.
195 mylayoutbox[s] = awful.widget.layoutbox(s)
196 mylayoutbox[s]:buttons(awful.util.table.join(
197 awful.button({ }, 1, function () awful.layout.inc( 1) end),
198 awful.button({ }, 3, function () awful.layout.inc(-1) end),
199 awful.button({ }, 4, function () awful.layout.inc( 1) end),
200 awful.button({ }, 5, function () awful.layout.inc(-1) end)))
201 -- Create a taglist widget
202 mytaglist[s] = awful.widget.taglist(s, awful.widget.taglist.filter.all, mytaglist.buttons)
204 -- Create a tasklist widget
205 mytasklist[s] = awful.widget.tasklist(s, awful.widget.tasklist.filter.currenttags, mytasklist.buttons)
208 mywibox[s] = awful.wibar({ position = "top", screen = s })
210 -- Add widgets to the wibox
212 layout = wibox.layout.align.horizontal,
214 layout = wibox.layout.fixed.horizontal,
219 mytasklist[s], -- Middle widget
221 layout = wibox.layout.fixed.horizontal,
223 wibox.widget.systray(),
231 -- {{{ Mouse bindings
232 root.buttons(awful.util.table.join(
233 awful.button({ }, 3, function () mymainmenu:toggle() end),
234 awful.button({ }, 4, awful.tag.viewnext),
235 awful.button({ }, 5, awful.tag.viewprev)
240 globalkeys = awful.util.table.join(
241 awful.key({ modkey, }, "s", hotkeys_popup.show_help,
242 {description="show help", group="awesome"}),
243 awful.key({ modkey, }, "Left", awful.tag.viewprev,
244 {description = "view previous", group = "tag"}),
245 awful.key({ modkey, }, "Right", awful.tag.viewnext,
246 {description = "view next", group = "tag"}),
247 awful.key({ modkey, }, "Escape", awful.tag.history.restore,
248 {description = "go back", group = "tag"}),
250 awful.key({ modkey, }, "j",
252 awful.client.focus.byidx( 1)
254 {description = "focus next by index", group = "client"}
256 awful.key({ modkey, }, "k",
258 awful.client.focus.byidx(-1)
260 {description = "focus previous by index", group = "client"}
262 awful.key({ modkey, }, "w", function () mymainmenu:show() end,
263 {description = "show main menu", group = "awesome"}),
265 -- Layout manipulation
266 awful.key({ modkey, "Shift" }, "j", function () awful.client.swap.byidx( 1) end,
267 {description = "swap with next client by index", group = "client"}),
268 awful.key({ modkey, "Shift" }, "k", function () awful.client.swap.byidx( -1) end,
269 {description = "swap with previous client by index", group = "client"}),
270 awful.key({ modkey, "Control" }, "j", function () awful.screen.focus_relative( 1) end,
271 {description = "focus the next screen", group = "screen"}),
272 awful.key({ modkey, "Control" }, "k", function () awful.screen.focus_relative(-1) end,
273 {description = "focus the previous screen", group = "screen"}),
274 awful.key({ modkey, }, "u", awful.client.urgent.jumpto,
275 {description = "jump to urgent client", group = "client"}),
276 awful.key({ modkey, }, "Tab",
278 awful.client.focus.history.previous()
283 {description = "go back", group = "client"}),
286 awful.key({ modkey, }, "Return", function () awful.spawn(terminal) end,
287 {description = "open a terminal", group = "launcher"}),
288 awful.key({ modkey, "Control" }, "r", awesome.restart,
289 {description = "reload awesome", group = "awesome"}),
290 awful.key({ modkey, "Shift" }, "q", awesome.quit,
291 {description = "quit awesome", group = "awesome"}),
293 awful.key({ modkey, }, "l", function () awful.tag.incmwfact( 0.05) end,
294 {description = "increase master width factor", group = "layout"}),
295 awful.key({ modkey, }, "h", function () awful.tag.incmwfact(-0.05) end,
296 {description = "decrease master width factor", group = "layout"}),
297 awful.key({ modkey, "Shift" }, "h", function () awful.tag.incnmaster( 1, nil, true) end,
298 {description = "increase the number of master clients", group = "layout"}),
299 awful.key({ modkey, "Shift" }, "l", function () awful.tag.incnmaster(-1, nil, true) end,
300 {description = "decrease the number of master clients", group = "layout"}),
301 awful.key({ modkey, "Control" }, "h", function () awful.tag.incncol( 1, nil, true) end,
302 {description = "increase the number of columns", group = "layout"}),
303 awful.key({ modkey, "Control" }, "l", function () awful.tag.incncol(-1, nil, true) end,
304 {description = "decrease the number of columns", group = "layout"}),
305 awful.key({ modkey, }, "space", function () awful.layout.inc( 1) end,
306 {description = "select next", group = "layout"}),
307 awful.key({ modkey, "Shift" }, "space", function () awful.layout.inc(-1) end,
308 {description = "select previous", group = "layout"}),
310 awful.key({ modkey, "Control" }, "n",
312 local c = awful.client.restore()
313 -- Focus restored client
319 {description = "restore minimized", group = "client"}),
322 awful.key({ modkey }, "r", function () mypromptbox[awful.screen.focused()]:run() end,
323 {description = "run prompt", group = "launcher"}),
325 awful.key({ modkey }, "x",
327 awful.prompt.run({ prompt = "Run Lua code: " },
328 mypromptbox[awful.screen.focused()].widget,
329 awful.util.eval, nil,
330 awful.util.get_cache_dir() .. "/history_eval")
332 {description = "lua execute prompt", group = "awesome"}),
334 awful.key({ modkey }, "p", function() menubar.show() end,
335 {description = "show the menubar", group = "launcher"})
338 clientkeys = awful.util.table.join(
339 awful.key({ modkey, }, "f",
341 c.fullscreen = not c.fullscreen
344 {description = "toggle fullscreen", group = "client"}),
345 awful.key({ modkey, "Shift" }, "c", function (c) c:kill() end,
346 {description = "close", group = "client"}),
347 awful.key({ modkey, "Control" }, "space", awful.client.floating.toggle ,
348 {description = "toggle floating", group = "client"}),
349 awful.key({ modkey, "Control" }, "Return", function (c) c:swap(awful.client.getmaster()) end,
350 {description = "move to master", group = "client"}),
351 awful.key({ modkey, }, "o", function (c) c:move_to_screen() end,
352 {description = "move to screen", group = "client"}),
353 awful.key({ modkey, }, "t", function (c) c.ontop = not c.ontop end,
354 {description = "toggle keep on top", group = "client"}),
355 awful.key({ modkey, }, "n",
357 -- The client currently has the input focus, so it cannot be
358 -- minimized, since minimized clients can't have the focus.
361 {description = "minimize", group = "client"}),
362 awful.key({ modkey, }, "m",
364 c.maximized = not c.maximized
367 {description = "maximize", group = "client"})
370 -- Bind all key numbers to tags.
371 -- Be careful: we use keycodes to make it works on any keyboard layout.
372 -- This should map on the top row of your keyboard, usually 1 to 9.
374 globalkeys = awful.util.table.join(globalkeys,
376 awful.key({ modkey }, "#" .. i + 9,
378 local screen = awful.screen.focused()
379 local tag = screen.tags[i]
384 {description = "view tag #"..i, group = "tag"}),
386 awful.key({ modkey, "Control" }, "#" .. i + 9,
388 local screen = awful.screen.focused()
389 local tag = screen.tags[i]
391 awful.tag.viewtoggle(tag)
394 {description = "toggle tag #" .. i, group = "tag"}),
395 -- Move client to tag.
396 awful.key({ modkey, "Shift" }, "#" .. i + 9,
399 local tag = client.focus.screen.tags[i]
401 client.focus:move_to_tag(tag)
405 {description = "move focused client to tag #"..i, group = "tag"}),
406 -- Toggle tag on focused client.
407 awful.key({ modkey, "Control", "Shift" }, "#" .. i + 9,
410 local tag = client.focus.screen.tags[i]
412 client.focus:toggle_tag(tag)
416 {description = "toggle focused client on tag #" .. i, group = "tag"})
420 clientbuttons = awful.util.table.join(
421 awful.button({ }, 1, function (c) client.focus = c; c:raise() end),
422 awful.button({ modkey }, 1, awful.mouse.client.move),
423 awful.button({ modkey }, 3, awful.mouse.client.resize))
426 root.keys(globalkeys)
430 -- Rules to apply to new clients (through the "manage" signal).
431 awful.rules.rules = {
432 -- All clients will match this rule.
434 properties = { border_width = beautiful.border_width,
435 border_color = beautiful.border_normal,
436 focus = awful.client.focus.filter,
437 size_hints_honor = false,
440 buttons = clientbuttons,
441 placement = awful.placement.no_overlap+awful.placement.no_offscreen
448 "DTA", -- Firefox addon DownThemAll.
449 "copyq", -- Includes session name in class.
455 "MessageWin", -- kalarm.
463 "Event Tester", -- xev.
466 "AlarmWindow", -- Thunderbird's calendar.
467 "pop-up", -- e.g. Google Chrome's (detached) Developer Tools.
469 }, properties = { floating = true }},
471 -- Add titlebars to normal clients and dialogs
472 { rule_any = {type = { "normal", "dialog" }
473 }, properties = { titlebars_enabled = false }
476 -- Set Firefox to always map on the tag named "2" on screen 1.
477 -- { rule = { class = "Firefox" },
478 -- properties = { screen = 1, tag = "2" } },
483 -- Signal function to execute when a new client appears.
484 client.connect_signal("manage", function (c)
485 -- Set the windows at the slave,
486 -- i.e. put it at the end of others instead of setting it master.
487 -- if not awesome.startup then awful.client.setslave(c) end
489 if awesome.startup and
490 not c.size_hints.user_position
491 and not c.size_hints.program_position then
492 -- Prevent clients from being unreachable after screen count changes.
493 awful.placement.no_offscreen(c)
497 -- Add a titlebar if titlebars_enabled is set to true in the rules.
498 client.connect_signal("request::titlebars", function(c)
499 -- buttons for the titlebar
500 local buttons = awful.util.table.join(
501 awful.button({ }, 1, function()
504 awful.mouse.client.move(c)
506 awful.button({ }, 3, function()
509 awful.mouse.client.resize(c)
513 awful.titlebar(c) : setup {
515 awful.titlebar.widget.iconwidget(c),
517 layout = wibox.layout.fixed.horizontal
522 widget = awful.titlebar.widget.titlewidget(c)
525 layout = wibox.layout.flex.horizontal
528 awful.titlebar.widget.floatingbutton (c),
529 awful.titlebar.widget.maximizedbutton(c),
530 awful.titlebar.widget.stickybutton (c),
531 awful.titlebar.widget.ontopbutton (c),
532 awful.titlebar.widget.closebutton (c),
533 layout = wibox.layout.fixed.horizontal()
535 layout = wibox.layout.align.horizontal
539 -- Enable sloppy focus
540 client.connect_signal("mouse::enter", function(c)
541 if awful.layout.get(c.screen) ~= awful.layout.suit.magnifier
542 and awful.client.focus.filter(c) then
547 client.connect_signal("focus", function(c) c.border_color = beautiful.border_focus end)
548 client.connect_signal("unfocus", function(c) c.border_color = beautiful.border_normal end)
551 -- vim:ft=lua:sw=4:sts=4:ts=4:et