+local hotkeys_popup = require("awful.hotkeys_popup").widget
+
-- 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"
+altkey = "Mod1"
--- {{{ Mouse bindings
+-- Mouse bindings {{{1
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)
+ awful.button({ }, 3, function () mymainmenu:toggle() 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))
--- }}}
-
--- {{{ Global Keys
-globalkeys = awful.util.table.join(
- -- {{{ Awesome Keys
- awful.key({ modkey, }, "Left", awful.tag.viewprev ),
- awful.key({ modkey, }, "Right", awful.tag.viewnext ),
- awful.key({ modkey, }, "Escape", awful.tag.history.restore),
+-- Global Keys {{{1
+globalkeys = awful.util.table.join(globalkeys,
+ awful.key({ modkey, }, "s", hotkeys_popup.show_help,
+ {description="show help", group="awesome"}),
+ awful.key({ modkey, }, "Left", awful.tag.viewprev,
+ {description = "view previous", group = "tag"}),
+ awful.key({ modkey, }, "Down", awful.tag.viewprev,
+ {description = "view previous", group = "tag"}),
+ awful.key({ modkey, }, "Right", awful.tag.viewnext,
+ {description = "view next", group = "tag"}),
+ awful.key({ modkey, }, "Up", awful.tag.viewnext,
+ {description = "view next", group = "tag"}),
+ awful.key({ modkey, }, "Escape", awful.tag.history.restore,
+ {description = "go back", group = "tag"}),
- awful.key({ modkey, }, "j",
+ awful.key({ modkey, }, "k",
function ()
awful.client.focus.byidx( 1)
- if client.focus then client.focus:raise() end
- end),
- awful.key({ modkey, }, "k",
+ end,
+ {description = "focus next by index", group = "client"}
+ ),
+ awful.key({ modkey, }, "j",
function ()
awful.client.focus.byidx(-1)
- if client.focus then client.focus:raise() end
- end),
+ end,
+ {description = "focus previous by index", group = "client"}
+ ),
+ awful.key({ modkey, }, "w", function () mymainmenu:show({ coords = { x = 0, y = 0}}) end,
+ {description = "show main menu", group = "awesome"}),
-- 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, }, "u", awful.client.urgent.jumpto),
+ awful.key({ modkey, "Shift" }, "j", function () awful.client.swap.byidx( 1) end,
+ {description = "swap with next client by index", group = "client"}),
+ awful.key({ modkey, "Shift" }, "k", function () awful.client.swap.byidx( -1) end,
+ {description = "swap with previous client by index", group = "client"}),
+ awful.key({ modkey, }, "#49", function () awful.screen.focus_relative( 1) end, -- that's the key left of 1 (chronos)
+ {description = "focus the next screen", group = "screen"}),
+ awful.key({ modkey, }, "=", function () awful.screen.focus_relative( 1) end, -- that's the key left of 1 (kinesis)
+ {description = "focus the next screen", group = "screen"}),
+ awful.key({ modkey, "Control" }, "Right", function () awful.screen.focus_relative(-1) end,
+ {description = "focus the next screen", group = "screen"}),
+ awful.key({ modkey, "Control" }, "Left", function () awful.screen.focus_relative(-1) end,
+ {description = "focus the previous screen", group = "screen"}),
+ awful.key({ modkey, }, "u", awful.client.urgent.jumpto,
+ {description = "jump to urgent client", group = "client"}),
awful.key({ modkey, }, "Tab",
function ()
awful.client.focus.history.previous()
if client.focus then
client.focus:raise()
end
- end),
+ end,
+ {description = "go back", group = "client"}),
-- Standard program
- awful.key({ modkey, }, "Return", function () awful.util.spawn(terminal) end),
- awful.key({ modkey, "Control" }, "r", awesome.restart),
- awful.key({ modkey, "Shift" }, "q", awesome.quit),
+ awful.key({ modkey, }, "Return", function () awful.spawn(terminal) end,
+ {description = "open a terminal", group = "launcher"}),
+ awful.key({ modkey, "Control" }, "r", awesome.restart,
+ {description = "reload awesome", group = "awesome"}),
- 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, "Shift" }, "h", function () awful.tag.incnmaster( 1) end),
- awful.key({ modkey, "Shift" }, "l", 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, }, "h", function () awful.tag.incmwfact(-0.05) end,
+ {description = "increase master width factor", group = "layout"}),
+ awful.key({ modkey, }, "l", function () awful.tag.incmwfact( 0.05) end,
+ {description = "decrease master width factor", group = "layout"}),
+ awful.key({ modkey, "Shift" }, "h", function () awful.tag.incnmaster( 1, nil, true) end,
+ {description = "increase the number of master clients", group = "layout"}),
+ awful.key({ modkey, "Shift" }, "l", function () awful.tag.incnmaster(-1, nil, true) end,
+ {description = "decrease the number of master clients", group = "layout"}),
+ awful.key({ modkey, "Control" }, "h", function () awful.tag.incncol( 1, nil, true) end,
+ {description = "increase the number of columns", group = "layout"}),
+ awful.key({ modkey, "Control" }, "l", function () awful.tag.incncol(-1, nil, true) end,
+ {description = "decrease the number of columns", group = "layout"}),
+ -- resize slave
+ awful.key({ modkey, "Control" }, "j", function () awful.client.incwfact( 0.05) end,
+ {description = "increase focused client window factor", group = "layout"}),
+ awful.key({ modkey, "Control" }, "k", function () awful.client.incwfact(-0.05) end,
+ {description = "decrease focused client window factor", group = "layout"}),
- awful.key({ modkey, "Control" }, "n", awful.client.restore),
+ -- switch between layouts
+ awful.key({ modkey, }, "]", function () awful.layout.inc( 1) end,
+ {description = "select next", group = "layout"}),
+ awful.key({ modkey, }, "[", function () awful.layout.inc(-1) end,
+ {description = "select previous", group = "layout"}),
- awful.key({ modkey }, "x",
+ awful.key({ modkey, "Control" }, "n",
function ()
- awful.prompt.run({ prompt = "Run Lua code: " },
- mypromptbox[mouse.screen].widget,
- awful.util.eval, nil,
- awful.util.getdir("cache") .. "/history_eval")
- end),
- -- Menubar
- awful.key({ modkey }, "p", function() menubar.show() end),
- -- }}}
-
- -- {{{ My Keys
- -- Menu
- awful.key({ modkey }, "w", function () mymainmenu:show({ coords = { x = 0, y = 0}}) end),
- -- Lock
- awful.key({ modkey }, "l", function () awful.util.spawn("slock") end),
+ local c = awful.client.restore()
+ -- Focus restored client
+ if c then
+ client.focus = c
+ c:raise()
+ end
+ end,
+ {description = "restore minimized", group = "client"}),
+
-- Prompt
- awful.key({ modkey }, "space", function () mypromptbox[mouse.screen]:run() end),
- -- switch layout
- awful.key({ modkey }, "]", function () awful.layout.inc(layouts, 1) end),
- awful.key({ modkey }, "[", function () awful.layout.inc(layouts, -1) end),
- -- resize slave
- awful.key({ modkey, "Control" }, "j", function () awful.client.incwfact( 0.05) end),
- awful.key({ modkey, "Control" }, "k", function () awful.client.incwfact(-0.05) end),
+ awful.key({ modkey }, "space", function () awful.screen.focused().mypromptbox:run() end,
+ {description = "run prompt", group = "launcher"}),
+
+ awful.key({ modkey }, "x",
+ function ()
+ awful.prompt.run {
+ prompt = "Run Lua code: ",
+ textbox = awful.screen.focused().mypromptbox.widget,
+ exe_callback = awful.util.eval,
+ history_path = awful.util.get_cache_dir() .. "/history_eval"
+ }
+ end,
+ {description = "lua execute prompt", group = "awesome"}),
+
+ -- Applications {{{2
-- Ksnapshot
- awful.key({ }, "F13", function () awful.util.spawn("ksnapshot") end),
- awful.key({ }, "Print", function () awful.util.spawn("ksnapshot") end),
- -- Layout manipulation
- awful.key({ modkey, }, "#94", function () awful.screen.focus_relative( 1) end), -- that's the key left of 1
- awful.key({ modkey, "Control" }, "Left", function () awful.screen.focus_relative( 1) end),
- awful.key({ modkey, "Control" }, "Right", function () awful.screen.focus_relative(-1) end),
+ awful.key({ }, "F13", function () awful.spawn("ksnapshot") end),
+ awful.key({ }, "Print", function () awful.spawn("ksnapshot") end),
+ -- ranger
+ awful.key({ modkey }, "r", function () awful.spawn(terminal .. " -e ranger") end),
-- Volume
- awful.key({ }, "XF86AudioRaiseVolume", function () awful.util.spawn("ponymix increase 5") end),
- awful.key({ }, "XF86AudioLowerVolume", function () awful.util.spawn("ponymix decrease 5") end),
- awful.key({ }, "XF86AudioMute", function () awful.util.spawn("ponymix toggle") end),
- -- Clementine
- awful.key({ }, "XF86AudioPlay", function () awful.util.spawn("clementine -t") end),
- awful.key({ }, "XF86AudioNext", function () awful.util.spawn("clementine -f") end),
- awful.key({ }, "XF86AudioPrev", function () awful.util.spawn("clementine -r") end),
- awful.key({ "Shift" }, "XF86AudioRaiseVolume", function () awful.util.spawn("clementine --volume-increase-by 5") end),
- awful.key({ "Shift" }, "XF86AudioLowerVolume", function () awful.util.spawn("clementine --volume-decrease-by 5") end)
- -- }}}
+ awful.key({ }, "XF86AudioMute", function () awful.spawn("ponymix toggle") end,
+ {description = "toggle mute", group = "volume"}),
+ awful.key({ }, "XF86AudioLowerVolume", function () awful.spawn("ponymix decrease 5") end,
+ {description = "decrease volume", group = "volume"}),
+ awful.key({ }, "XF86AudioRaiseVolume", function () awful.spawn("ponymix increase 5") end,
+ {description = "increase volume", group = "volume"}),
+ awful.key({ modkey }, "F10", function () awful.spawn("ponymix toggle") end,
+ {description = "toggle mute", group = "volume"}),
+ awful.key({ modkey }, "F11", function () awful.spawn("ponymix decrease 5") end,
+ {description = "decrease volume", group = "volume"}),
+ awful.key({ modkey }, "F12", function () awful.spawn("ponymix increase 5") end,
+ {description = "increase volume", group = "volume"}),
+ -- Lock
+ awful.key({ modkey, "Control" }, "Escape", function () awful.spawn("i3lock -nc 000000") end),
+ -- VimWiki
+ awful.key({ modkey }, "i", function ()
+ awful.spawn(terminal.." -name vimwiki -e vim -c 'call vimwiki#base#goto_index(v:count1)'")
+ end)
)
--- }}}
--- {{{ Client keys
+-- Client keys {{{1
clientkeys = awful.util.table.join(
- -- {{{ Awesome Client Keys
- awful.key({ modkey, }, "f", function (c) c.fullscreen = not c.fullscreen end),
- awful.key({ modkey, "Shift" }, "c", function (c) c:kill() end),
- awful.key({ modkey, "Control" }, "space", awful.client.floating.toggle ),
- awful.key({ modkey, "Control" }, "Return", function (c) c:swap(awful.client.getmaster()) end),
+ awful.key({ modkey, }, "f",
+ function (c)
+ c.fullscreen = not c.fullscreen
+ c:raise()
+ end,
+ {description = "toggle fullscreen", group = "client"}),
+ awful.key({ modkey, "Shift" }, "c", function (c) c:kill() end,
+ {description = "close", group = "client"}),
+ awful.key({ modkey, "Control" }, "space", awful.client.floating.toggle ,
+ {description = "toggle floating", group = "client"}),
+ awful.key({ modkey, "Control" }, "Return", function (c) c:swap(awful.client.getmaster()) end,
+ {description = "move to master", group = "client"}),
+ awful.key({ modkey, }, "t", function (c) c.ontop = not c.ontop end,
+ {description = "toggle keep on top", group = "client"}),
+ awful.key({ modkey, }, "b", function (c) c.below = not c.below end,
+ {description = "toggle keep below", group = "client"}),
awful.key({ modkey, }, "n",
function (c)
-- The client currently has the input focus, so it cannot be
-- minimized, since minimized clients can't have the focus.
c.minimized = true
- end),
+ end ,
+ {description = "minimize", group = "client"}),
awful.key({ modkey, }, "m",
function (c)
- c.maximized_horizontal = not c.maximized_horizontal
- c.maximized_vertical = not c.maximized_vertical
- end),
- -- }}}
+ c.maximized = not c.maximized
+ c:raise()
+ end ,
+ {description = "maximize", group = "client"}),
- -- {{{ My Client Keys
-- Move client to screen
- awful.key({ modkey, "Shift" }, "#94", awful.client.movetoscreen ),
- -- ontop and below
- awful.key({ modkey, }, "t", function (c) c.ontop = not c.ontop end),
- awful.key({ modkey, }, "b", function (c) c.below = not c.below end)
- -- }}}
+ awful.key({ modkey, "Shift" }, "#94", function (c) c:move_to_screen() end,
+ {description = "move to screen", group = "client"}),
+ awful.key({ modkey, "Shift" }, "#49", function (c) c:move_to_screen() end,
+ {description = "move to screen", group = "client"}),
+ awful.key({ modkey, "Shift" }, "=", function (c) c:move_to_screen() end,
+ {description = "move to screen", group = "client"})
)
--- }}}
+-- Tags {{{1
-- 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, 9 do
globalkeys = awful.util.table.join(globalkeys,
+ -- View tag only.
awful.key({ modkey }, "#" .. i + 9,
function ()
- local screen = mouse.screen
- local tag = awful.tag.gettags(screen)[i]
+ local screen = awful.screen.focused()
+ local tag = screen.tags[i]
if tag then
- awful.tag.viewonly(tag)
+ if tag.selected then
+ awful.tag.history.restore(screen)
+ else
+ tag:view_only()
+ end
end
- end),
+ end,
+ {description = "view tag #"..i, group = "tag"}),
+ -- Toggle tag display.
awful.key({ modkey, "Control" }, "#" .. i + 9,
function ()
- local screen = mouse.screen
- local tag = awful.tag.gettags(screen)[i]
+ local screen = awful.screen.focused()
+ local tag = screen.tags[i]
if tag then
awful.tag.viewtoggle(tag)
end
- end),
+ end,
+ {description = "toggle tag #" .. i, group = "tag"}),
+ -- Move client to tag.
awful.key({ modkey, "Shift" }, "#" .. i + 9,
function ()
- local tag = awful.tag.gettags(client.focus.screen)[i]
- if client.focus and tag then
- awful.client.movetotag(tag)
+ if client.focus then
+ local tag = client.focus.screen.tags[i]
+ if tag then
+ client.focus:move_to_tag(tag)
+ end
end
- end),
+ end,
+ {description = "move focused client to tag #"..i, group = "tag"}),
+ -- Toggle tag on focused client.
awful.key({ modkey, "Control", "Shift" }, "#" .. i + 9,
function ()
- local tag = awful.tag.gettags(client.focus.screen)[i]
- if client.focus and tag then
- awful.client.toggletag(tag)
+ if client.focus then
+ local tag = client.focus.screen.tags[i]
+ if tag then
+ client.focus:toggle_tag(tag)
+ end
end
- end))
+ end,
+ {description = "toggle focused client on tag #" .. i, group = "tag"})
+ )
end
--- }}}
+-- Client Buttons {{{1
+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))