awesome/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
10 -- Load Debian menu entries
11 require("debian.menu")
12
13 -- {{{ Error handling
14 -- Check if awesome encountered an error during startup and fell back to
15 -- another config (This code will only ever execute for the fallback config)
16 if awesome.startup_errors then
17 naughty.notify({ preset = naughty.config.presets.critical,
18 title = "Oops, there were errors during startup!",
19 text = awesome.startup_errors })
20 end
21
22 -- Handle runtime errors after startup
23 do
24 local in_error = false
25 awesome.add_signal("debug::error", function (err)
26 -- Make sure we don't go into an endless error loop
27 if in_error then return end
28 in_error = true
29
30 naughty.notify({ preset = naughty.config.presets.critical,
31 title = "Oops, an error happened!",
32 text = err })
33 in_error = false
34 end)
35 end
36 -- }}}
37
38 -- {{{ Variable definitions
39 -- Themes define colours, icons, and wallpapers
40 beautiful.init("/usr/share/awesome/themes/zenburn/theme.lua")
41
42 -- This is used later as the default terminal and editor to run.
43 terminal = "terminator"
44 editor = os.getenv("EDITOR") or "editor"
45 editor_cmd = terminal .. " -e " .. editor
46
47 -- Default modkey.
48 -- Usually, Mod4 is the key with a logo between Control and Alt.
49 -- If you do not like this or do not have such a key,
50 -- I suggest you to remap Mod4 to another key using xmodmap or other tools.
51 -- However, you can use another modifier like Mod1, but it may interact with others.
52 modkey = "Mod4"
53
54 -- Table of layouts to cover with awful.layout.inc, order matters.
55 layouts =
56 {
57 awful.layout.suit.floating,
58 awful.layout.suit.tile,
59 awful.layout.suit.tile.left,
60 awful.layout.suit.tile.bottom,
61 awful.layout.suit.tile.top,
62 awful.layout.suit.fair,
63 awful.layout.suit.fair.horizontal,
64 awful.layout.suit.spiral,
65 awful.layout.suit.spiral.dwindle,
66 awful.layout.suit.max,
67 awful.layout.suit.max.fullscreen,
68 awful.layout.suit.magnifier
69 }
70 -- }}}
71
72 -- {{{ Tags
73 -- Define a tag table which hold all screen tags.
74 tags = {}
75 for s = 1, screen.count() do
76 -- Each screen has its own tag table.
77 tags[s] = awful.tag({ "www", "term", "irc", "games", "music" }, s, layouts[1])
78 end
79 -- }}}
80
81 -- {{{ Menu
82 -- Create a laucher widget and a main menu
83 myawesomemenu = {
84 { "manual", terminal .. " -e man awesome" },
85 { "edit config", editor_cmd .. " " .. awesome.conffile },
86 { "restart", awesome.restart },
87 { "quit", awesome.quit }
88 }
89
90 mymainmenu = awful.menu({ items = { { "awesome", myawesomemenu, beautiful.awesome_icon },
91 { "Debian", debian.menu.Debian_menu.Debian },
92 { "open terminal", terminal }
93 }
94 })
95
96 mylauncher = awful.widget.launcher({ image = image(beautiful.awesome_icon),
97 menu = mymainmenu })
98 -- }}}
99
100 -- {{{ Wibox
101 -- Create a textclock widget
102 mytextclock = awful.widget.textclock({ align = "right" })
103
104 -- Create a systray
105 mysystray = widget({ type = "systray" })
106
107 -- Create a wibox for each screen and add it
108 mystatusbar = awful.wibox({ position = "bottom", screen = 1, ontop = false, width = 1, height = 16 })
109
110 mywibox = {}
111 mypromptbox = {}
112 mylayoutbox = {}
113 mytaglist = {}
114 mytaglist.buttons = awful.util.table.join(
115 awful.button({ }, 1, awful.tag.viewonly),
116 awful.button({ modkey }, 1, awful.client.movetotag),
117 awful.button({ }, 3, awful.tag.viewtoggle),
118 awful.button({ modkey }, 3, awful.client.toggletag),
119 awful.button({ }, 4, awful.tag.viewnext),
120 awful.button({ }, 5, awful.tag.viewprev)
121 )
122 mytasklist = {}
123 mytasklist.buttons = awful.util.table.join(
124 awful.button({ }, 1, function (c)
125 if c == client.focus then
126 c.minimized = true
127 else
128 if not c:isvisible() then
129 awful.tag.viewonly(c:tags()[1])
130 end
131 -- This will also un-minimize
132 -- the client, if needed
133 client.focus = c
134 c:raise()
135 end
136 end),
137 awful.button({ }, 3, function ()
138 if instance then
139 instance:hide()
140 instance = nil
141 else
142 instance = awful.menu.clients({ width=250 })
143 end
144 end),
145 awful.button({ }, 4, function ()
146 awful.client.focus.byidx(1)
147 if client.focus then client.focus:raise() end
148 end),
149 awful.button({ }, 5, function ()
150 awful.client.focus.byidx(-1)
151 if client.focus then client.focus:raise() end
152 end))
153
154 for s = 1, screen.count() do
155 -- Create a promptbox for each screen
156 mypromptbox[s] = awful.widget.prompt({ layout = awful.widget.layout.horizontal.leftright })
157 -- Create an imagebox widget which will contains an icon indicating which layout we're using.
158 -- We need one layoutbox per screen.
159 mylayoutbox[s] = awful.widget.layoutbox(s)
160 mylayoutbox[s]:buttons(awful.util.table.join(
161 awful.button({ }, 1, function () awful.layout.inc(layouts, 1) end),
162 awful.button({ }, 3, function () awful.layout.inc(layouts, -1) end),
163 awful.button({ }, 4, function () awful.layout.inc(layouts, 1) end),
164 awful.button({ }, 5, function () awful.layout.inc(layouts, -1) end)))
165 -- Create a taglist widget
166 mytaglist[s] = awful.widget.taglist(s, awful.widget.taglist.label.all, mytaglist.buttons)
167
168 -- Create a tasklist widget
169 mytasklist[s] = awful.widget.tasklist(function(c)
170 return awful.widget.tasklist.label.currenttags(c, s)
171 end, mytasklist.buttons)
172
173 -- Create the wibox
174 mywibox[s] = awful.wibox({ position = "top", screen = s })
175 -- Add widgets to the wibox - order matters
176 mywibox[s].widgets = {
177 {
178 mylauncher,
179 mytaglist[s],
180 mypromptbox[s],
181 layout = awful.widget.layout.horizontal.leftright
182 },
183 mylayoutbox[s],
184 mytextclock,
185 s == 1 and mysystray or nil,
186 mytasklist[s],
187 layout = awful.widget.layout.horizontal.rightleft
188 }
189 end
190 -- }}}
191
192 -- {{{ Mouse bindings
193 root.buttons(awful.util.table.join(
194 awful.button({ }, 3, function () mymainmenu:toggle() end),
195 awful.button({ }, 4, awful.tag.viewnext),
196 awful.button({ }, 5, awful.tag.viewprev)
197 ))
198 -- }}}
199
200 -- {{{ Key bindings
201 globalkeys = awful.util.table.join(
202 awful.key({ modkey, }, "Left", awful.tag.viewprev ),
203 awful.key({ modkey, }, "Right", awful.tag.viewnext ),
204 awful.key({ modkey, }, "Escape", awful.tag.history.restore),
205
206 awful.key({ modkey, }, "j",
207 function ()
208 awful.client.focus.byidx( 1)
209 if client.focus then client.focus:raise() end
210 end),
211 awful.key({ modkey, }, "k",
212 function ()
213 awful.client.focus.byidx(-1)
214 if client.focus then client.focus:raise() end
215 end),
216 awful.key({ modkey, }, "w", function () mymainmenu:show({keygrabber=true}) end),
217
218 -- Layout manipulation
219 awful.key({ modkey, "Shift" }, "j", function () awful.client.swap.byidx( 1) end),
220 awful.key({ modkey, "Shift" }, "k", function () awful.client.swap.byidx( -1) end),
221 awful.key({ modkey, "Control" }, "j", function () awful.screen.focus_relative( 1) end),
222 awful.key({ modkey, "Control" }, "k", function () awful.screen.focus_relative(-1) end),
223 awful.key({ modkey, }, "u", awful.client.urgent.jumpto),
224 awful.key({ modkey, }, "Tab",
225 function ()
226 awful.client.focus.history.previous()
227 if client.focus then
228 client.focus:raise()
229 end
230 end),
231
232 -- Standard program
233 awful.key({ modkey, }, "Return", function () awful.util.spawn(terminal) end),
234 awful.key({ modkey, "Control" }, "r", awesome.restart),
235 awful.key({ modkey, "Shift" }, "q", awesome.quit),
236
237 awful.key({ modkey, }, "l", function () awful.tag.incmwfact( 0.05) end),
238 awful.key({ modkey, }, "h", function () awful.tag.incmwfact(-0.05) end),
239 awful.key({ modkey, "Shift" }, "h", function () awful.tag.incnmaster( 1) end),
240 awful.key({ modkey, "Shift" }, "l", function () awful.tag.incnmaster(-1) end),
241 awful.key({ modkey, "Control" }, "h", function () awful.tag.incncol( 1) end),
242 awful.key({ modkey, "Control" }, "l", function () awful.tag.incncol(-1) end),
243 awful.key({ modkey, }, "space", function () awful.layout.inc(layouts, 1) end),
244 awful.key({ modkey, "Shift" }, "space", function () awful.layout.inc(layouts, -1) end),
245
246 awful.key({ modkey, "Control" }, "n", awful.client.restore),
247
248 -- Prompt
249 awful.key({ modkey }, "r", function () mypromptbox[mouse.screen]:run() end),
250
251 awful.key({ modkey }, "x",
252 function ()
253 awful.prompt.run({ prompt = "Run Lua code: " },
254 mypromptbox[mouse.screen].widget,
255 awful.util.eval, nil,
256 awful.util.getdir("cache") .. "/history_eval")
257 end)
258 )
259
260 clientkeys = awful.util.table.join(
261 awful.key({ modkey, }, "f", function (c) c.fullscreen = not c.fullscreen end),
262 awful.key({ modkey, "Shift" }, "c", function (c) c:kill() end),
263 awful.key({ modkey, "Control" }, "space", awful.client.floating.toggle ),
264 awful.key({ modkey, "Control" }, "Return", function (c) c:swap(awful.client.getmaster()) end),
265 awful.key({ modkey, }, "o", awful.client.movetoscreen ),
266 awful.key({ modkey, "Shift" }, "r", function (c) c:redraw() end),
267 awful.key({ modkey, }, "t", function (c) c.ontop = not c.ontop end),
268 awful.key({ modkey, }, "n",
269 function (c)
270 -- The client currently has the input focus, so it cannot be
271 -- minimized, since minimized clients can't have the focus.
272 c.minimized = true
273 end),
274 awful.key({ modkey, }, "m",
275 function (c)
276 c.maximized_horizontal = not c.maximized_horizontal
277 c.maximized_vertical = not c.maximized_vertical
278 end)
279 )
280
281 -- Compute the maximum number of digit we need, limited to 9
282 keynumber = 0
283 for s = 1, screen.count() do
284 keynumber = math.min(9, math.max(#tags[s], keynumber));
285 end
286
287 -- Bind all key numbers to tags.
288 -- Be careful: we use keycodes to make it works on any keyboard layout.
289 -- This should map on the top row of your keyboard, usually 1 to 9.
290 for i = 1, keynumber do
291 globalkeys = awful.util.table.join(globalkeys,
292 awful.key({ modkey }, "#" .. i + 9,
293 function ()
294 local screen = mouse.screen
295 if tags[screen][i] then
296 awful.tag.viewonly(tags[screen][i])
297 end
298 end),
299 awful.key({ modkey, "Control" }, "#" .. i + 9,
300 function ()
301 local screen = mouse.screen
302 if tags[screen][i] then
303 awful.tag.viewtoggle(tags[screen][i])
304 end
305 end),
306 awful.key({ modkey, "Shift" }, "#" .. i + 9,
307 function ()
308 if client.focus and tags[client.focus.screen][i] then
309 awful.client.movetotag(tags[client.focus.screen][i])
310 end
311 end),
312 awful.key({ modkey, "Control", "Shift" }, "#" .. i + 9,
313 function ()
314 if client.focus and tags[client.focus.screen][i] then
315 awful.client.toggletag(tags[client.focus.screen][i])
316 end
317 end))
318 end
319
320 clientbuttons = awful.util.table.join(
321 awful.button({ }, 1, function (c) client.focus = c; c:raise() end),
322 awful.button({ modkey }, 1, awful.mouse.client.move),
323 awful.button({ modkey }, 3, awful.mouse.client.resize))
324
325 -- Set keys
326 root.keys(globalkeys)
327 -- }}}
328
329 -- {{{ Rules
330 awful.rules.rules = {
331 -- All clients will match this rule.
332 { rule = { },
333 properties = { border_width = beautiful.border_width,
334 border_color = beautiful.border_normal,
335 focus = true,
336 keys = clientkeys,
337 buttons = clientbuttons } },
338 { rule = { class = "MPlayer" },
339 properties = { floating = true } },
340 { rule = { class = "pinentry" },
341 properties = { floating = true } },
342 { rule = { class = "gimp" },
343 properties = { floating = true } },
344 -- Set Firefox to always map on tags number 2 of screen 1.
345 -- { rule = { class = "Firefox" },
346 -- properties = { tag = tags[1][2] } },
347 }
348 -- }}}
349
350 -- {{{ Signals
351 -- Signal function to execute when a new client appears.
352 client.add_signal("manage", function (c, startup)
353 -- Add a titlebar
354 -- awful.titlebar.add(c, { modkey = modkey })
355
356 -- Enable sloppy focus
357 c:add_signal("mouse::enter", function(c)
358 if awful.layout.get(c.screen) ~= awful.layout.suit.magnifier
359 and awful.client.focus.filter(c) then
360 client.focus = c
361 end
362 end)
363
364 if not startup then
365 -- Set the windows at the slave,
366 -- i.e. put it at the end of others instead of setting it master.
367 -- awful.client.setslave(c)
368
369 -- Put windows in a smart way, only if they does not set an initial position.
370 if not c.size_hints.user_position and not c.size_hints.program_position then
371 awful.placement.no_overlap(c)
372 awful.placement.no_offscreen(c)
373 end
374 end
375 end)
376
377 client.add_signal("focus", function(c) c.border_color = beautiful.border_focus end)
378 client.add_signal("unfocus", function(c) c.border_color = beautiful.border_normal end)
379 -- }}}