569 lines
22 KiB
Lua
569 lines
22 KiB
Lua
------------------------------------------------------
|
|
-- Simple and well documented rc.lua for newbs --
|
|
-- --
|
|
-- Copyright (C) 2020 Anaximenes --
|
|
------------------------------------------------------
|
|
|
|
----x Licence - GPL v3.0 x----
|
|
|
|
-- This configuration file is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This file is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details. You should have received a copy of the GNU Library General Public License along with this library; if not, see <http://www.gnu.org/licenses/>. --
|
|
|
|
----x End Licence x----
|
|
|
|
|
|
----x Importing libraries x----
|
|
-- Libraries are collections of code. Each library is --
|
|
-- usually designed to do one (or a few) specific and --
|
|
-- related tasks. For example, wibox is a library for --
|
|
-- handling some basic widgets in awesome wm. Importing --
|
|
-- them means that we are telling the computer where to --
|
|
-- to look when we ask it to do some specific task, like --
|
|
-- displaying a widget using the wibox library. --
|
|
|
|
pcall(require, "luarocks.loader")
|
|
-- Standard awesome library
|
|
local gears = require("gears")
|
|
local awful = require("awful")
|
|
require("awful.autofocus")
|
|
-- Widget and layout library
|
|
local wibox = require("wibox")
|
|
-- Theme handling library
|
|
local beautiful = require("beautiful")
|
|
-- Notification library
|
|
local naughty = require("naughty")
|
|
local menubar = require("menubar")
|
|
local hotkeys_popup = require("awful.hotkeys_popup")
|
|
require("awful.hotkeys_popup.keys")
|
|
|
|
----x End Importing Libraries x----
|
|
|
|
|
|
----x Error Handling x----
|
|
-- Sometimes there are errors that pop up when we make a --
|
|
-- mistake
|
|
|
|
-- Check if awesome encountered an error during startup and fell back to another config --
|
|
if awesome.startup_errors then
|
|
naughty.notify({ preset = naughty.config.presets.critical,
|
|
title = "Oops, there were errors during startup!",
|
|
text = awesome.startup_errors })
|
|
end
|
|
|
|
-- Handle runtime errors after startup
|
|
do
|
|
local in_error = false
|
|
awesome.connect_signal("debug::error", function (err)
|
|
-- Make sure we don't go into an endless error loop
|
|
if in_error then return end
|
|
in_error = true
|
|
|
|
naughty.notify({ preset = naughty.config.presets.critical,
|
|
title = "Oops, an error happened!",
|
|
text = tostring(err) })
|
|
in_error = false
|
|
end)
|
|
end
|
|
|
|
----x End Error Handling x----
|
|
|
|
|
|
----x Defining Variables x----
|
|
|
|
-- Theme file --
|
|
beautiful.init("/home/user/.config/awesome/theme.lua")
|
|
|
|
|
|
-- Frequently used apps --
|
|
terminal = "st"
|
|
scrot = "scrot"
|
|
guitexteditor = "guitexteditor"
|
|
browser = "badwolf"
|
|
nnn = terminal .. " -e nnn"
|
|
aerc = terminal .. " -e aerc"
|
|
htop = terminal .. " -e htop"
|
|
editor = os.getenv("EDITOR") or "vim"
|
|
editor_cmd = terminal .. " -e " .. editor
|
|
|
|
-- Default modkey --
|
|
modkey = "Mod4"
|
|
|
|
----x End Defining Variables x----
|
|
|
|
|
|
----x Layouts x----
|
|
|
|
awful.layout.layouts = {
|
|
awful.layout.suit.tile,
|
|
awful.layout.suit.max.fullscreen,
|
|
awful.layout.suit.floating,
|
|
-- awful.layout.suit.tile.left,
|
|
-- awful.layout.suit.tile.bottom,
|
|
-- awful.layout.suit.tile.top,
|
|
-- awful.layout.suit.fair,
|
|
-- awful.layout.suit.fair.horizontal,
|
|
-- awful.layout.suit.spiral,
|
|
-- awful.layout.suit.spiral.dwindle,
|
|
-- awful.layout.suit.max,
|
|
-- awful.layout.suit.magnifier,
|
|
-- awful.layout.suit.corner.nw,
|
|
-- awful.layout.suit.corner.ne,
|
|
-- awful.layout.suit.corner.sw,
|
|
-- awful.layout.suit.corner.se,
|
|
}
|
|
|
|
----x End Layouts x----
|
|
|
|
|
|
----x Widgets, Screen, and Tags x----
|
|
|
|
-- Textclock widget
|
|
mytextclock = wibox.widget.textclock()
|
|
|
|
-- Widget-box for each screen and add it
|
|
local taglist_buttons = gears.table.join(
|
|
awful.button({ }, 1, function(t) t:view_only() end),
|
|
awful.button({ modkey }, 1, function(t)
|
|
if client.focus then
|
|
client.focus:move_to_tag(t)
|
|
end
|
|
end),
|
|
awful.button({ }, 3, awful.tag.viewtoggle),
|
|
awful.button({ modkey }, 3, function(t)
|
|
if client.focus then
|
|
client.focus:toggle_tag(t)
|
|
end
|
|
end),
|
|
awful.button({ }, 4, function(t) awful.tag.viewnext(t.screen) end),
|
|
awful.button({ }, 5, function(t) awful.tag.viewprev(t.screen) end)
|
|
)
|
|
|
|
local tasklist_buttons = gears.table.join(
|
|
awful.button({ }, 1, function (c)
|
|
if c == client.focus then
|
|
c.minimized = true
|
|
else
|
|
c:emit_signal(
|
|
"request::activate",
|
|
"tasklist",
|
|
{raise = true}
|
|
)
|
|
end
|
|
end),
|
|
awful.button({ }, 3, function()
|
|
awful.menu.client_list({ theme = { width = 250 } })
|
|
end),
|
|
awful.button({ }, 4, function ()
|
|
awful.client.focus.byidx(1)
|
|
end),
|
|
awful.button({ }, 5, function ()
|
|
awful.client.focus.byidx(-1)
|
|
end))
|
|
|
|
local function set_wallpaper(s)
|
|
-- Wallpaper
|
|
if beautiful.wallpaper then
|
|
local wallpaper = beautiful.wallpaper
|
|
-- If wallpaper is a function, call it with the screen
|
|
if type(wallpaper) == "function" then
|
|
wallpaper = wallpaper(s)
|
|
end
|
|
gears.wallpaper.maximized(wallpaper, s, true)
|
|
end
|
|
end
|
|
|
|
-- Re-set wallpaper when a screen's geometry changes (e.g. different resolution)
|
|
screen.connect_signal("property::geometry", set_wallpaper)
|
|
|
|
awful.screen.connect_for_each_screen(function(s)
|
|
-- Wallpaper
|
|
set_wallpaper(s)
|
|
|
|
-- Each screen has its own tag table.
|
|
awful.tag({ "1", "2", "3", "4", "5", "6", "7", "8", "9" }, s, awful.layout.layouts[1])
|
|
|
|
-- Create a promptbox for each screen
|
|
s.mypromptbox = awful.widget.prompt()
|
|
-- Create an imagebox widget which will contain an icon indicating which layout we're using.
|
|
-- We need one layoutbox per screen.
|
|
s.mylayoutbox = awful.widget.layoutbox(s)
|
|
s.mylayoutbox:buttons(gears.table.join(
|
|
awful.button({ }, 1, function () awful.layout.inc( 1) end),
|
|
awful.button({ }, 3, function () awful.layout.inc(-1) end),
|
|
awful.button({ }, 4, function () awful.layout.inc( 1) end),
|
|
awful.button({ }, 5, function () awful.layout.inc(-1) end)))
|
|
-- Create a taglist widget
|
|
s.mytaglist = awful.widget.taglist {
|
|
screen = s,
|
|
filter = awful.widget.taglist.filter.all,
|
|
buttons = taglist_buttons
|
|
}
|
|
|
|
-- Create a tasklist widget
|
|
s.mytasklist = awful.widget.tasklist {
|
|
screen = s,
|
|
filter = awful.widget.tasklist.filter.currenttags,
|
|
buttons = tasklist_buttons
|
|
}
|
|
|
|
-- Create the widget-box
|
|
s.mywibox = awful.wibar({ position = "top", screen = s })
|
|
|
|
-- Add widgets to the wibox
|
|
s.mywibox:setup {
|
|
layout = wibox.layout.align.horizontal,
|
|
{ -- Left widgets
|
|
layout = wibox.layout.fixed.horizontal,
|
|
--mylauncher,
|
|
s.mytaglist,
|
|
s.mypromptbox,
|
|
},
|
|
s.mytasklist, -- Middle widget
|
|
{ -- Right widgets
|
|
layout = wibox.layout.fixed.horizontal,
|
|
wibox.widget.systray(),
|
|
mytextclock,
|
|
s.mylayoutbox,
|
|
},
|
|
}
|
|
end)
|
|
-- }}}
|
|
|
|
----x End Widgets, Screens, and Tags x----
|
|
|
|
|
|
----x Keybindings x----
|
|
|
|
-- {{{
|
|
globalkeys = gears.table.join(
|
|
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, }, "Right", 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",
|
|
function ()
|
|
awful.client.focus.byidx( 1)
|
|
end,
|
|
{description = "focus next by index", group = "client"}
|
|
),
|
|
awful.key({ modkey, }, "k",
|
|
function ()
|
|
awful.client.focus.byidx(-1)
|
|
end,
|
|
{description = "focus previous by index", group = "client"}
|
|
),
|
|
|
|
-- Layout manipulation --
|
|
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, "Control" }, "j", function () awful.screen.focus_relative( 1) end,
|
|
{description = "focus the next screen", group = "screen"}),
|
|
awful.key({ modkey, "Control" }, "k", function () awful.screen.focus_relative(-1) end,
|
|
{description = "focus the previous screen", group = "screen"}),
|
|
|
|
-- Terminal --
|
|
awful.key({ modkey, }, "t", function () awful.spawn(terminal) end,
|
|
{description = "Launch terminal", group = "Applications"}),
|
|
|
|
-- Frequently used programs and applications
|
|
awful.key({ modkey, }, "a", function () awful.spawn(htop) end,
|
|
{description = "Launch htop", group = "Applications"}),
|
|
awful.key({ modkey, }, "d", function () awful.spawn(browser) end,
|
|
{description = "Launch badwolf", group = "Applications"}),
|
|
awful.key({ modkey, }, "x", function () awful.spawn(guitexteditor) end,
|
|
{description = "Launch guitexteditor", group = "Applications"}),
|
|
awful.key({ modkey, }, "y", function () awful.spawn(aerc) end,
|
|
{description = "Launch aerc", group = "Applications"}),
|
|
awful.key({ modkey, }, "z", function () awful.spawn(nnn) end,
|
|
{description = "Launch nnn", group = "Applications"}),
|
|
awful.key({}, "Print", function () awful.spawn(scrot) end,
|
|
{description = "Fullscreen screenshot", group = "Screenshot"}),
|
|
awful.key({"Shift"}, "Print", function () awful.spawn(scrot .. " -u") end,
|
|
{description = "Screenshot of focused window", group = "Screenshot"}),
|
|
awful.key({"Shift"}, "F1", function () awful.spawn.with_shell([[amixer set Master toggle]]) end,
|
|
{description = "Mute/unmute", group = "Volume"}),
|
|
awful.key({"Shift"}, "F2", function () awful.spawn.with_shell([[amixer set Master 4%+]]) end,
|
|
{description = "Increase volume", group = "Volume"}),
|
|
awful.key({"Shift"}, "F3", function () awful.spawn.with_shell([[amixer set Master 4%-]]) end,
|
|
{description = "Reduce volume", group = "Volume"}),
|
|
awful.key({modkey, "Shift"}, "o", function () awful.spawn.with_shell([[loginctl suspend]]) end,
|
|
{description = "Suspend", group = "awesome"}),
|
|
-- End of frequently used
|
|
|
|
awful.key({ modkey, "Control" }, "r", awesome.restart,
|
|
{description = "reload awesome", group = "awesome"}),
|
|
awful.key({ modkey, "Shift" }, "q", awesome.quit,
|
|
{description = "quit awesome", group = "awesome"}),
|
|
awful.key({ modkey, }, "l", function () awful.tag.incmwfact( 0.05) end,
|
|
{description = "increase master width factor", group = "layout"}),
|
|
awful.key({ modkey, }, "h", 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"}),
|
|
awful.key({ modkey, }, "space", function () awful.layout.inc( 1) end,
|
|
{description = "select next", group = "layout"}),
|
|
awful.key({ modkey, "Shift" }, "space", function () awful.layout.inc(-1) end,
|
|
{description = "select previous", group = "layout"}),
|
|
|
|
awful.key({ modkey, "Control" }, "n",
|
|
function ()
|
|
local c = awful.client.restore()
|
|
-- Focus restored client
|
|
if c then
|
|
c:emit_signal(
|
|
"request::activate", "key.unminimize", {raise = true}
|
|
)
|
|
end
|
|
end,
|
|
{description = "restore minimized", group = "client"}),
|
|
|
|
-- Prompt
|
|
awful.key({ modkey }, "r", 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"}),
|
|
|
|
-- Menubar
|
|
|
|
awful.key({ modkey }, "p", function() menubar.show() end,
|
|
{description = "show the menubar", group = "launcher"})
|
|
)
|
|
|
|
clientkeys = gears.table.join(
|
|
awful.key({ modkey, }, "f",
|
|
function (c)
|
|
c.fullscreen = not c.fullscreen
|
|
c:raise()
|
|
end,
|
|
{description = "toggle fullscreen", group = "client"}),
|
|
awful.key({ modkey, }, "q", 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, }, "o", function (c) c:move_to_screen() end,
|
|
{description = "move to screen", group = "client"}),
|
|
awful.key({ modkey, }, "Return", function (c) c.ontop = not c.ontop end,
|
|
{description = "toggle keep on top", group = "client"}),
|
|
awful.key({ modkey, "Control" }, "m",
|
|
function (c)
|
|
c.maximized_vertical = not c.maximized_vertical
|
|
c:raise()
|
|
end ,
|
|
{description = "(un)maximize vertically", group = "client"}),
|
|
awful.key({ modkey, "Shift" }, "m",
|
|
function (c)
|
|
c.maximized_horizontal = not c.maximized_horizontal
|
|
c:raise()
|
|
end ,
|
|
{description = "(un)maximize horizontally", group = "client"})
|
|
)
|
|
|
|
-- Bind all key numbers to tags.
|
|
-- Be careful: we use keycodes to make it work on any keyboard layout.
|
|
-- This should map on the top row of your keyboard, usually 1 to 9.
|
|
for i = 1, 9 do
|
|
globalkeys = gears.table.join(globalkeys,
|
|
-- View tag only.
|
|
awful.key({ modkey }, "#" .. i + 9,
|
|
function ()
|
|
local screen = awful.screen.focused()
|
|
local tag = screen.tags[i]
|
|
if tag then
|
|
tag:view_only()
|
|
end
|
|
end,
|
|
{description = "view tag #"..i, group = "tag"}),
|
|
-- Toggle tag display.
|
|
awful.key({ modkey, "Control" }, "#" .. i + 9,
|
|
function ()
|
|
local screen = awful.screen.focused()
|
|
local tag = screen.tags[i]
|
|
if tag then
|
|
awful.tag.viewtoggle(tag)
|
|
end
|
|
end,
|
|
{description = "toggle tag #" .. i, group = "tag"}),
|
|
-- Move client to tag.
|
|
awful.key({ modkey, "Shift" }, "#" .. i + 9,
|
|
function ()
|
|
if client.focus then
|
|
local tag = client.focus.screen.tags[i]
|
|
if tag then
|
|
client.focus:move_to_tag(tag)
|
|
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 ()
|
|
if client.focus then
|
|
local tag = client.focus.screen.tags[i]
|
|
if tag then
|
|
client.focus:toggle_tag(tag)
|
|
end
|
|
end
|
|
end,
|
|
{description = "toggle focused client on tag #" .. i, group = "tag"})
|
|
)
|
|
end
|
|
|
|
clientbuttons = gears.table.join(
|
|
awful.button({ }, 1, function (c)
|
|
c:emit_signal("request::activate", "mouse_click", {raise = true})
|
|
end),
|
|
awful.button({ modkey }, 1, function (c)
|
|
c:emit_signal("request::activate", "mouse_click", {raise = true})
|
|
awful.mouse.client.move(c)
|
|
end),
|
|
awful.button({ modkey }, 3, function (c)
|
|
c:emit_signal("request::activate", "mouse_click", {raise = true})
|
|
awful.mouse.client.resize(c)
|
|
end)
|
|
)
|
|
|
|
-- Set keys
|
|
root.keys(globalkeys)
|
|
-- }}}
|
|
|
|
----x End Keybindings x----
|
|
|
|
|
|
----x Rules x----
|
|
|
|
-- {{{
|
|
-- Rules to apply to new clients (through the "manage" signal).
|
|
awful.rules.rules = {
|
|
-- All clients will match this rule.
|
|
{ rule = { },
|
|
properties = { border_width = beautiful.border_width,
|
|
border_color = beautiful.border_normal,
|
|
focus = awful.client.focus.filter,
|
|
raise = true,
|
|
keys = clientkeys,
|
|
buttons = clientbuttons,
|
|
screen = awful.screen.preferred,
|
|
placement = awful.placement.no_overlap+awful.placement.no_offscreen
|
|
}
|
|
},
|
|
|
|
-- Floating clients.
|
|
{ rule_any = {
|
|
instance = {
|
|
"pinentry",
|
|
},
|
|
class = {
|
|
"Arandr",
|
|
"Gpick",
|
|
"Sxiv",
|
|
"gimp",
|
|
"Tor Browser", -- Needs a fixed window size to avoid fingerprinting by screen size.
|
|
}
|
|
}, properties = { floating = true }},
|
|
|
|
-- Add titlebars to normal clients and dialogs
|
|
{ rule_any = {type = { "normal", "dialog" }
|
|
}, properties = { titlebars_enabled = false }
|
|
},
|
|
|
|
}
|
|
-- }}} --
|
|
|
|
----x End Rules x----
|
|
|
|
|
|
----x Signals x----
|
|
|
|
-- {{{
|
|
-- Signal function to execute when a new client appears.
|
|
client.connect_signal("manage", function (c)
|
|
-- Set the windows at the slave,
|
|
-- i.e. put it at the end of others instead of setting it master.
|
|
-- if not awesome.startup then awful.client.setslave(c) end
|
|
|
|
if awesome.startup
|
|
and not c.size_hints.user_position
|
|
and not c.size_hints.program_position then
|
|
-- Prevent clients from being unreachable after screen count changes.
|
|
awful.placement.no_offscreen(c)
|
|
end
|
|
end)
|
|
|
|
-- Add a titlebar if titlebars_enabled is set to true in the rules.
|
|
client.connect_signal("request::titlebars", function(c)
|
|
-- buttons for the titlebar
|
|
local buttons = gears.table.join(
|
|
awful.button({ }, 1, function()
|
|
c:emit_signal("request::activate", "titlebar", {raise = true})
|
|
awful.mouse.client.move(c)
|
|
end),
|
|
awful.button({ }, 3, function()
|
|
c:emit_signal("request::activate", "titlebar", {raise = true})
|
|
awful.mouse.client.resize(c)
|
|
end)
|
|
)
|
|
|
|
awful.titlebar(c) : setup {
|
|
{ -- Left
|
|
awful.titlebar.widget.iconwidget(c),
|
|
buttons = buttons,
|
|
layout = wibox.layout.fixed.horizontal
|
|
},
|
|
{ -- Middle
|
|
{ -- Title
|
|
align = "center",
|
|
widget = awful.titlebar.widget.titlewidget(c)
|
|
},
|
|
buttons = buttons,
|
|
layout = wibox.layout.flex.horizontal
|
|
},
|
|
{ -- Right
|
|
layout = wibox.layout.fixed.horizontal()
|
|
},
|
|
layout = wibox.layout.align.horizontal
|
|
}
|
|
end)
|
|
|
|
-- Enable sloppy focus, so that focus follows mouse.
|
|
client.connect_signal("mouse::enter", function(c)
|
|
c:emit_signal("request::activate", "mouse_enter", {raise = false})
|
|
end)
|
|
|
|
client.connect_signal("focus", function(c) c.border_color = beautiful.border_focus end)
|
|
client.connect_signal("unfocus", function(c) c.border_color = beautiful.border_normal end)
|
|
-- }}}
|
|
|
|
----x End Signals x----
|
|
|
|
----x Autostart x----
|
|
|
|
-- Enable nightlight
|
|
awful.spawn.with_shell([[redshift -PO 4500]])
|
|
|
|
----x End Autostart x----
|
|
|
|
----x End rc.lua x----
|