1100 lines
37 KiB
Org Mode
1100 lines
37 KiB
Org Mode
#+TITLE: Personal Awesome WM Configuration
|
|
#+AUTHOR: Sravan Balaji
|
|
#+AUTO_TANGLE: t
|
|
#+STARTUP: showeverything
|
|
|
|
* Table of Contents :TOC_3:noexport:
|
|
- [[#welcome][Welcome]]
|
|
- [[#libraries][Libraries]]
|
|
- [[#error-handling][Error Handling]]
|
|
- [[#variable-definitions][Variable Definitions]]
|
|
- [[#file-paths][File Paths]]
|
|
- [[#themes][Themes]]
|
|
- [[#commands][Commands]]
|
|
- [[#modkey][Modkey]]
|
|
- [[#layouts][Layouts]]
|
|
- [[#tags][Tags]]
|
|
- [[#notifications][Notifications]]
|
|
- [[#status-bar][Status Bar]]
|
|
- [[#launcher-and-main-menu][Launcher and Main Menu]]
|
|
- [[#keyboard-map-indicator-and-switcher][Keyboard Map Indicator and Switcher]]
|
|
- [[#clock][Clock]]
|
|
- [[#tag-list][Tag List]]
|
|
- [[#task-list][Task List]]
|
|
- [[#setup-status-bar-per-screen][Setup Status Bar per Screen]]
|
|
- [[#bindings][Bindings]]
|
|
- [[#mouse][Mouse]]
|
|
- [[#global][Global]]
|
|
- [[#client][Client]]
|
|
- [[#keyboard][Keyboard]]
|
|
- [[#global-1][Global]]
|
|
- [[#client-1][Client]]
|
|
- [[#numbers-to-tags][Numbers to Tags]]
|
|
- [[#set-keys][Set Keys]]
|
|
- [[#rules][Rules]]
|
|
- [[#signals][Signals]]
|
|
- [[#new-client-appears][New Client Appears]]
|
|
- [[#titlebar][Titlebar]]
|
|
- [[#focus][Focus]]
|
|
- [[#focus-follows-mouse][Focus follows Mouse]]
|
|
- [[#focus-border-color][Focus Border Color]]
|
|
- [[#theme][Theme]]
|
|
- [[#libraries-1][Libraries]]
|
|
- [[#inherit-default-theme][Inherit Default Theme]]
|
|
- [[#variable-definitions-1][Variable Definitions]]
|
|
- [[#windows][Windows]]
|
|
- [[#notifications-1][Notifications]]
|
|
- [[#tool-tip][Tool Tip]]
|
|
- [[#tag-list-1][Tag List]]
|
|
- [[#task-list-1][Task List]]
|
|
- [[#title-bar][Title Bar]]
|
|
- [[#mouse-finder][Mouse Finder]]
|
|
- [[#menu][Menu]]
|
|
- [[#icons][Icons]]
|
|
- [[#layout][Layout]]
|
|
- [[#title-bar-1][Title Bar]]
|
|
- [[#applications][Applications]]
|
|
- [[#awesome][Awesome]]
|
|
- [[#tag-list-squares][Tag List Squares]]
|
|
- [[#wallpaper][Wallpaper]]
|
|
- [[#detect-light--dark-theme][Detect Light / Dark Theme]]
|
|
- [[#generate-wallpaper][Generate Wallpaper]]
|
|
- [[#return-theme][Return Theme]]
|
|
|
|
* Welcome
|
|
|
|
My personal configuration of Awesome WM, written as an [[https://orgmode.org][Org Mode]] document.
|
|
|
|
Run the block below with ~C-c C-c~ to tangle code blocks to config file.
|
|
|
|
#+BEGIN_SRC emacs-lisp :tangle no
|
|
(org-mode-restart)
|
|
(org-babel-tangle)
|
|
#+END_SRC
|
|
|
|
* Libraries
|
|
|
|
If LuaRocks is installed, make sure that packages installed through it are found (e.g. lgi). If LuaRocks is not installed, do nothing.
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
pcall(require, "luarocks.loader")
|
|
#+END_SRC
|
|
|
|
Standard awesome library
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
local gears = require("gears")
|
|
local awful = require("awful")
|
|
require("awful.autofocus")
|
|
#+END_SRC
|
|
|
|
Remote execution (i.e., control awesome from outside awesome)
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
require("awful.remote")
|
|
#+END_SRC
|
|
|
|
Widget and layout library
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
local wibox = require("wibox")
|
|
#+END_SRC
|
|
|
|
Theme handling library
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
local beautiful = require("beautiful")
|
|
#+END_SRC
|
|
|
|
Notification library
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
local naughty = require("naughty")
|
|
#+END_SRC
|
|
|
|
Enable hotkeys help widget for VIM and other apps when client with a matching name is opened:
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
local hotkeys_popup = require("awful.hotkeys_popup")
|
|
require("awful.hotkeys_popup.keys")
|
|
#+END_SRC
|
|
|
|
Automatically move and center mouse cursors to the focused window
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
require("awesomewm-micky")
|
|
#+END_SRC
|
|
|
|
Automatically focus back to the previous client on minimize and close
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
require("awesomewm-backham")
|
|
#+END_SRC
|
|
|
|
* Error Handling
|
|
|
|
Check if awesome encountered an error during startup and fell back to another config (This code will only ever execute for the fallback config)
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
if awesome.startup_errors then
|
|
naughty.notify({ preset = naughty.config.presets.critical,
|
|
title = "Oops, there were errors during startup!",
|
|
text = awesome.startup_errors })
|
|
end
|
|
#+END_SRC
|
|
|
|
Handle runtime errors after startup
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
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
|
|
#+END_SRC
|
|
|
|
* Variable Definitions
|
|
|
|
** File Paths
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
home_path = "/home/sravan"
|
|
awesome_config_path = home_path .. "/.config/awesome"
|
|
awesome_config_file = awesome_config_path .. "/" .. "README.org"
|
|
awesome_theme_file = awesome_config_path .. "/" .. "theme.lua"
|
|
#+END_SRC
|
|
|
|
** Themes
|
|
|
|
Themes define colours, icons, font and wallpapers.
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
beautiful.init(awesome_theme_file)
|
|
#+END_SRC
|
|
|
|
** Commands
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
terminal_cmd = "kitty"
|
|
editor_cmd = os.getenv("EDITOR") or "emacs"
|
|
rofi_cmd = "rofi -show combi"
|
|
control_center_cmd = "/home/sravan/.scripts/control-center.sh --rofi"
|
|
brightness_cmd = "/home/sravan/.scripts/brightness.sh --rofi"
|
|
clipboard_cmd = "rofi -show clipboard"
|
|
rbw_cmd = "rofi-rbw"
|
|
volume_cmd = "/home/sravan/.scripts/pactl.sh --rofi"
|
|
media_cmd = "/home/sravan/.scripts/playerctl.sh --rofi"
|
|
notification_cmd = "/home/sravan/.scripts/naughty.sh --rofi"
|
|
session_cmd = "/home/sravan/.scripts/session.sh --rofi"
|
|
compositor_cmd = "/home/sravan/.scripts/picom.sh --rofi"
|
|
lower_volume_cmd = "/home/sravan/.scripts/pactl.sh --lower"
|
|
mute_volume_cmd = "/home/sravan/.scripts/pactl.sh --mute"
|
|
raise_volume_cmd = "/home/sravan/.scripts/pactl.sh --raise"
|
|
player_play_pause_cmd = "/home/sravan/.scripts/playerctl.sh --play-pause"
|
|
player_next_cmd = "/home/sravan/.scripts/playerctl.sh --next"
|
|
player_prev_cmd = "/home/sravan/.scripts/playerctl.sh --prev"
|
|
flameshot_cmd = "flameshot gui"
|
|
force_close_window_cmd = "xkill"
|
|
trackpad_toggle_cmd = "/home/sravan/.scripts/trackpad.sh"
|
|
#+END_SRC
|
|
|
|
** Modkey
|
|
|
|
Default modkey.
|
|
Usually, Mod4 is the key with a logo between Control and Alt (Super key).
|
|
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.
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
modkey = "Mod4"
|
|
#+END_SRC
|
|
|
|
** Layouts
|
|
|
|
Table of layouts to cover with awful.layout.inc, order matters.
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
awful.layout.layouts = {
|
|
awful.layout.suit.tile,
|
|
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.max.fullscreen,
|
|
awful.layout.suit.magnifier,
|
|
-- awful.layout.suit.corner.nw,
|
|
-- awful.layout.suit.corner.ne,
|
|
-- awful.layout.suit.corner.sw,
|
|
-- awful.layout.suit.corner.se,
|
|
awful.layout.suit.floating,
|
|
}
|
|
#+END_SRC
|
|
|
|
** Tags
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
taglist = { " ₁", "龎 ₂", " ₃", " ₄", "爵 ₅", " ₆", " ₇", " ₈", " ₉" }
|
|
#+END_SRC
|
|
|
|
* Notifications
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
naughty.config.defaults.timeout = 10 -- in seconds
|
|
naughty.config.defaults.position = "top_right"
|
|
#+END_SRC
|
|
|
|
* Status Bar
|
|
|
|
** Launcher and Main Menu
|
|
|
|
Create a launcher widget and a main menu
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
myawesomemenu = {
|
|
{ "hotkeys", function() hotkeys_popup.show_help(nil, awful.screen.focused()) end },
|
|
{ "manual", terminal_cmd .. " -e man awesome" },
|
|
{ "edit config", editor_cmd .. " " .. awesome_config_file },
|
|
{ "restart", awesome.restart },
|
|
{ "quit", function() awesome.quit() end },
|
|
}
|
|
|
|
mymainmenu = awful.menu({ items = { { "awesome", myawesomemenu, beautiful.awesome_icon },
|
|
{ "open terminal", terminal_cmd }
|
|
}
|
|
})
|
|
|
|
mylauncher = awful.widget.launcher({ image = beautiful.awesome_icon,
|
|
menu = mymainmenu })
|
|
#+END_SRC
|
|
|
|
** Keyboard Map Indicator and Switcher
|
|
|
|
Keyboard map indicator and switcher
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
mykeyboardlayout = awful.widget.keyboardlayout()
|
|
#+END_SRC
|
|
|
|
** Clock
|
|
|
|
Create a textclock widget
|
|
|
|
See https://www.gammon.com.au/scripts/doc.php?lua=os.date for formatting options
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
mytextclock = wibox.widget.textclock()
|
|
mytextclock.format = " %a %m/%d/%y %I:%M %p"
|
|
mytextclock.refresh = 60 -- in seconds
|
|
#+END_SRC
|
|
|
|
** Tag List
|
|
|
|
Create a wibox for each screen and add it
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
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)
|
|
)
|
|
#+END_SRC
|
|
|
|
** Task List
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
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))
|
|
#+END_SRC
|
|
|
|
** Setup Status Bar per Screen
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
awful.screen.connect_for_each_screen(function(s)
|
|
-- Each screen has its own tag table.
|
|
awful.tag(taglist, 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 wibox
|
|
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.mylayoutbox,
|
|
s.mypromptbox,
|
|
},
|
|
s.mytasklist, -- Middle widget
|
|
{ -- Right widgets
|
|
layout = wibox.layout.fixed.horizontal,
|
|
-- mykeyboardlayout,
|
|
wibox.widget.systray(),
|
|
mytextclock,
|
|
},
|
|
}
|
|
end)
|
|
#+END_SRC
|
|
|
|
* Bindings
|
|
|
|
** Mouse
|
|
|
|
*** Global
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
root.buttons(gears.table.join(
|
|
awful.button({ }, 3, function () mymainmenu:toggle() end),
|
|
awful.button({ }, 4, awful.tag.viewnext),
|
|
awful.button({ }, 5, awful.tag.viewprev)
|
|
))
|
|
#+END_SRC
|
|
|
|
*** Client
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
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)
|
|
)
|
|
#+END_SRC
|
|
|
|
** Keyboard
|
|
|
|
*** Global
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
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, }, "Tab", 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"}
|
|
),
|
|
awful.key({ modkey, }, "w", function () mymainmenu:show() end,
|
|
{description = "show main menu", group = "awesome"}),
|
|
|
|
-- 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, }, ".", function () awful.screen.focus_relative( 1) end,
|
|
{description = "focus the next screen", group = "screen"}),
|
|
awful.key({ modkey, }, ",", 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, "Control" }, "Tab",
|
|
function ()
|
|
awful.client.focus.history.previous()
|
|
if client.focus then
|
|
client.focus:raise()
|
|
end
|
|
end,
|
|
{description = "go back", group = "client"}),
|
|
|
|
-- Standard program
|
|
awful.key({ modkey, "Shift" }, "Return", function () awful.spawn(terminal_cmd) end,
|
|
{description = "open a terminal", group = "launcher"}),
|
|
awful.key({ modkey, "Shift", "Control" }, "q", 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, "Shift" }, "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() awful.spawn(rofi_cmd) end,
|
|
{description = "show rofi menu", group = "launcher"}),
|
|
awful.key({ modkey, "Control" }, "p", function() awful.spawn(control_center_cmd) end,
|
|
{description = "show control center", group = "launcher"}),
|
|
awful.key({ modkey, "Control" }, "c", function() awful.spawn(clipboard_cmd) end,
|
|
{description = "show clipboard history", group = "launcher"}),
|
|
awful.key({ modkey, "Control" }, "d", function() awful.spawn(brightness_cmd) end,
|
|
{description = "show brightness controls", group = "launcher"}),
|
|
awful.key({ modkey, "Control" }, "b", function() awful.spawn(rbw_cmd) end,
|
|
{description = "show bitwarden password vault", group = "launcher"}),
|
|
awful.key({ modkey, "Control" }, "v", function() awful.spawn(volume_cmd) end,
|
|
{description = "show volume controls", group = "launcher"}),
|
|
awful.key({ modkey, "Control" }, "m", function() awful.spawn(media_cmd) end,
|
|
{description = "show media controls", group = "launcher"}),
|
|
awful.key({ modkey, "Control" }, "n", function() awful.spawn(notification_cmd) end,
|
|
{description = "show notification controls", group = "launcher"}),
|
|
awful.key({ modkey, "Control" }, "q", function() awful.spawn(session_cmd) end,
|
|
{description = "show session controls", group = "launcher"}),
|
|
awful.key({ modkey, "Control" }, "Escape", function() awful.spawn(compositor_cmd) end,
|
|
{description = "show compositor controls", group = "launcher"}),
|
|
|
|
-- Media Keys
|
|
awful.key({ }, "XF86AudioLowerVolume", function() awful.spawn(lower_volume_cmd) end,
|
|
{description = "Lower audio volume", group = "media"}),
|
|
awful.key({ }, "XF86AudioMute", function() awful.spawn(mute_volume_cmd) end,
|
|
{description = "Mute audio", group = "media"}),
|
|
awful.key({ }, "XF86AudioRaiseVolume", function() awful.spawn(raise_volume_cmd) end,
|
|
{description = "Raise audio volume", group = "media"}),
|
|
awful.key({ }, "XF86AudioPlay", function() awful.spawn(player_play_pause_cmd) end,
|
|
{description = "Play / Pause Media", group = "media"}),
|
|
awful.key({ }, "XF86AudioNext", function() awful.spawn(player_next_cmd) end,
|
|
{description = "Next media track", group = "media"}),
|
|
awful.key({ }, "XF86AudioPrev", function() awful.spawn(player_prev_cmd) end,
|
|
{description = "Previous media track", group = "media"}),
|
|
|
|
-- Special Keys and Miscellaneous Shortcuts
|
|
awful.key({ }, "XF86TouchpadToggle", function() awful.spawn(trackpad_toggle_cmd) end,
|
|
{description = "Enable / Disable Touchpad", group = "misc"}),
|
|
awful.key({ }, "Print", function() awful.spawn(flameshot_cmd) end,
|
|
{description = "Take a screenshot", group = "misc"}),
|
|
awful.key({ modkey, "Shift", "Control" }, "c", function () awful.spawn(force_close_window_cmd) end,
|
|
{description = "force close window", group = "misc"})
|
|
)
|
|
#+END_SRC
|
|
|
|
*** Client
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
clientkeys = gears.table.join(
|
|
awful.key({ modkey, "Shift" }, "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, }, "f", awful.client.floating.toggle ,
|
|
{description = "toggle floating", group = "client"}),
|
|
awful.key({ modkey, }, "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, }, "t", function (c) c.ontop = not c.ontop end,
|
|
{description = "toggle keep on top", 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 ,
|
|
{description = "minimize", group = "client"}),
|
|
awful.key({ modkey, }, "m",
|
|
function (c)
|
|
c.maximized = not c.maximized
|
|
c:raise()
|
|
end ,
|
|
{description = "(un)maximize", 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"})
|
|
)
|
|
#+END_SRC
|
|
|
|
*** Numbers to Tags
|
|
|
|
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.
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
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
|
|
#+END_SRC
|
|
|
|
*** Set Keys
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
root.keys(globalkeys)
|
|
#+END_SRC
|
|
|
|
* Rules
|
|
|
|
Rules to apply to new clients (through the "manage" signal).
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
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 = {
|
|
"DTA", -- Firefox addon DownThemAll.
|
|
"copyq", -- Includes session name in class.
|
|
"pinentry",
|
|
},
|
|
class = {
|
|
"Arandr",
|
|
"Blueman-manager",
|
|
"Gpick",
|
|
"Kruler",
|
|
"MessageWin", -- kalarm.
|
|
"Sxiv",
|
|
"Tor Browser", -- Needs a fixed window size to avoid fingerprinting by screen size.
|
|
"Wpa_gui",
|
|
"veromix",
|
|
"xtightvncviewer"},
|
|
|
|
-- Note that the name property shown in xprop might be set slightly after creation of the client
|
|
-- and the name shown there might not match defined rules here.
|
|
name = {
|
|
"Event Tester", -- xev.
|
|
"Picture in picture",
|
|
},
|
|
role = {
|
|
"AlarmWindow", -- Thunderbird's calendar.
|
|
"ConfigManager", -- Thunderbird's about:config.
|
|
"pop-up", -- e.g. Google Chrome's (detached) Developer Tools.
|
|
}
|
|
}, properties = { floating = true }},
|
|
|
|
-- Add titlebars to normal clients and dialogs
|
|
{ rule_any = {type = { "normal", "dialog" }
|
|
}, properties = { titlebars_enabled = false } -- Enable/Disable Titlebars here
|
|
},
|
|
|
|
-- Set Firefox to always map on the tag named "2" on screen 1.
|
|
-- { rule = { class = "Firefox" },
|
|
-- properties = { screen = 1, tag = "2" } },
|
|
}
|
|
#+END_SRC
|
|
|
|
* Signals
|
|
|
|
** New Client Appears
|
|
|
|
Signal function to execute when a new client appears.
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
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)
|
|
#+END_SRC
|
|
|
|
** Titlebar
|
|
|
|
Add a titlebar if titlebars_enabled is set to true in the rules.
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
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
|
|
awful.titlebar.widget.floatingbutton (c),
|
|
awful.titlebar.widget.maximizedbutton(c),
|
|
awful.titlebar.widget.stickybutton (c),
|
|
awful.titlebar.widget.ontopbutton (c),
|
|
awful.titlebar.widget.closebutton (c),
|
|
layout = wibox.layout.fixed.horizontal()
|
|
},
|
|
layout = wibox.layout.align.horizontal
|
|
}
|
|
end)
|
|
#+END_SRC
|
|
|
|
** Focus
|
|
|
|
*** Focus follows Mouse
|
|
|
|
Enable sloppy focus, so that focus follows mouse.
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
client.connect_signal("mouse::enter", function(c)
|
|
c:emit_signal("request::activate", "mouse_enter", {raise = false})
|
|
end)
|
|
#+END_SRC
|
|
|
|
*** Focus Border Color
|
|
|
|
#+BEGIN_SRC lua :tangle rc.lua
|
|
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)
|
|
#+END_SRC
|
|
|
|
* Theme
|
|
|
|
Based on Awesome theme which follows xrdb config by Yauhen Kirylau.
|
|
|
|
** Libraries
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
local theme_assets = require("beautiful.theme_assets")
|
|
local xresources = require("beautiful.xresources")
|
|
local dpi = xresources.apply_dpi
|
|
local xrdb = xresources.get_current_theme()
|
|
local gfs = require("gears.filesystem")
|
|
local themes_path = gfs.get_themes_dir()
|
|
local shape = require("gears.shape")
|
|
local naughty = require("naughty")
|
|
#+END_SRC
|
|
|
|
** Inherit Default Theme
|
|
|
|
Load vector assets' generators for this theme
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
local theme = dofile(themes_path.."default/theme.lua")
|
|
#+END_SRC
|
|
|
|
** Variable Definitions
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
local font = "Ubuntu Nerd Font"
|
|
local font_size = dpi(11)
|
|
local gap_size = dpi(10)
|
|
local border_size = dpi(2)
|
|
local menu_height = dpi(20)
|
|
local menu_width = dpi(200)
|
|
local taglist_square_size = dpi(5)
|
|
|
|
local notification_font = "Ubuntu Nerd Font"
|
|
local notification_font_size = dpi(12)
|
|
local notification_border_color = xrdb.color2
|
|
local notification_shape = shape.rounded_rect
|
|
local notification_width = dpi(700)
|
|
local notification_icon_size = dpi(125)
|
|
#+END_SRC
|
|
|
|
** Windows
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
theme.font = font .. " " .. tostring(font_size)
|
|
|
|
theme.bg_normal = xrdb.background
|
|
theme.bg_focus = xrdb.color12
|
|
theme.bg_urgent = xrdb.color9
|
|
theme.bg_minimize = xrdb.color8
|
|
theme.bg_systray = theme.bg_normal
|
|
|
|
theme.fg_normal = xrdb.foreground
|
|
theme.fg_focus = theme.bg_normal
|
|
theme.fg_urgent = theme.bg_normal
|
|
theme.fg_minimize = theme.bg_normal
|
|
|
|
theme.useless_gap = gap_size
|
|
theme.border_width = border_size
|
|
theme.border_normal = xrdb.color0
|
|
theme.border_focus = theme.bg_focus
|
|
theme.border_marked = xrdb.color10
|
|
theme.gap_single_client = true
|
|
#+END_SRC
|
|
|
|
** Notifications
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
theme.notification_font = notification_font .. " " .. tostring(notification_font_size)
|
|
theme.notification_bg = xrdb.background
|
|
theme.notification_fg = xrdb.foreground
|
|
theme.notification_border_width = border_size
|
|
theme.notification_border_color = notification_border_color
|
|
theme.notification_shape = notification_shape
|
|
-- theme.notification_opacity
|
|
theme.notification_margin = gap_size
|
|
theme.notification_width = notification_width
|
|
theme.notification_icon_size = notification_icon_size
|
|
|
|
naughty.config.padding = gap_size
|
|
naughty.config.spacing = gap_size
|
|
|
|
naughty.config.presets.critical.bg = xrdb.color1
|
|
naughty.config.presets.critical.fg = xrdb.foreground
|
|
#+END_SRC
|
|
|
|
** Tool Tip
|
|
|
|
Configuration options:
|
|
|
|
#+BEGIN_EXAMPLE
|
|
tooltip_[font|opacity|fg_color|bg_color|border_width|border_color]
|
|
#+END_EXAMPLE
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
theme.tooltip_fg = theme.fg_normal
|
|
theme.tooltip_bg = theme.bg_normal
|
|
#+END_SRC
|
|
|
|
** Tag List
|
|
|
|
Configuration options:
|
|
|
|
#+BEGIN_EXAMPLE
|
|
taglist_[bg|fg]_[focus|urgent|occupied|empty|volatile]
|
|
#+END_EXAMPLE
|
|
|
|
** Task List
|
|
|
|
Configuration options:
|
|
|
|
#+BEGIN_EXAMPLE
|
|
tasklist_[bg|fg]_[focus|urgent]
|
|
#+END_EXAMPLE
|
|
|
|
** Title Bar
|
|
|
|
Configuration options:
|
|
|
|
#+BEGIN_EXAMPLE
|
|
titlebar_[bg|fg]_[normal|focus]
|
|
#+END_EXAMPLE
|
|
|
|
** Mouse Finder
|
|
|
|
Configuration options:
|
|
|
|
#+BEGIN_EXAMPLE
|
|
mouse_finder_[color|timeout|animate_timeout|radius|factor]
|
|
#+END_EXAMPLE
|
|
|
|
** Menu
|
|
|
|
Configuration options:
|
|
|
|
#+BEGIN_EXAMPLE
|
|
menu_[bg|fg]_[normal|focus]
|
|
menu_[border_color|border_width]
|
|
#+END_EXAMPLE
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
theme.menu_submenu_icon = themes_path.."default/submenu.png"
|
|
theme.menu_height = menu_height
|
|
theme.menu_width = menu_width
|
|
#+END_SRC
|
|
|
|
** Icons
|
|
|
|
*** Layout
|
|
|
|
Recolor Layout icons:
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
theme = theme_assets.recolor_layout(theme, theme.fg_normal)
|
|
#+END_SRC
|
|
|
|
*** Title Bar
|
|
|
|
Recolor titlebar icons:
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
local function darker(color_value, darker_n)
|
|
local result = "#"
|
|
for s in color_value:gmatch("[a-fA-F0-9][a-fA-F0-9]") do
|
|
local bg_numeric_value = tonumber("0x"..s) - darker_n
|
|
if bg_numeric_value < 0 then bg_numeric_value = 0 end
|
|
if bg_numeric_value > 255 then bg_numeric_value = 255 end
|
|
result = result .. string.format("%2.2x", bg_numeric_value)
|
|
end
|
|
return result
|
|
end
|
|
theme = theme_assets.recolor_titlebar(
|
|
theme, theme.fg_normal, "normal"
|
|
)
|
|
theme = theme_assets.recolor_titlebar(
|
|
theme, darker(theme.fg_normal, -60), "normal", "hover"
|
|
)
|
|
theme = theme_assets.recolor_titlebar(
|
|
theme, xrdb.color1, "normal", "press"
|
|
)
|
|
theme = theme_assets.recolor_titlebar(
|
|
theme, theme.fg_focus, "focus"
|
|
)
|
|
theme = theme_assets.recolor_titlebar(
|
|
theme, darker(theme.fg_focus, -60), "focus", "hover"
|
|
)
|
|
theme = theme_assets.recolor_titlebar(
|
|
theme, xrdb.color1, "focus", "press"
|
|
)
|
|
#+END_SRC
|
|
|
|
*** Applications
|
|
|
|
Define the icon theme for application icons. If not set then the icons from =/usr/share/icons= and =/usr/share/icons/hicolor= will be used.
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
theme.icon_theme = nil
|
|
#+END_SRC
|
|
|
|
*** Awesome
|
|
|
|
Generate Awesome icon:
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
theme.awesome_icon = theme_assets.awesome_icon(
|
|
theme.menu_height, theme.bg_focus, theme.fg_focus
|
|
)
|
|
#+END_SRC
|
|
|
|
*** Tag List Squares
|
|
|
|
Generate taglist squares:
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
theme.taglist_squares_sel = theme_assets.taglist_squares_sel(
|
|
taglist_square_size, theme.fg_normal
|
|
)
|
|
theme.taglist_squares_unsel = theme_assets.taglist_squares_unsel(
|
|
taglist_square_size, theme.fg_normal
|
|
)
|
|
#+END_SRC
|
|
|
|
** Wallpaper
|
|
|
|
*** Detect Light / Dark Theme
|
|
|
|
Try to determine if we are running light or dark colorscheme:
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
local bg_numberic_value = 0;
|
|
for s in theme.bg_normal:gmatch("[a-fA-F0-9][a-fA-F0-9]") do
|
|
bg_numberic_value = bg_numberic_value + tonumber("0x"..s);
|
|
end
|
|
local is_dark_bg = (bg_numberic_value < 383)
|
|
#+END_SRC
|
|
|
|
*** Generate Wallpaper
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
local wallpaper_bg = xrdb.color8
|
|
local wallpaper_fg = xrdb.color7
|
|
local wallpaper_alt_fg = xrdb.color12
|
|
if not is_dark_bg then
|
|
wallpaper_bg, wallpaper_fg = wallpaper_fg, wallpaper_bg
|
|
end
|
|
theme.wallpaper = function(s)
|
|
return theme_assets.wallpaper(wallpaper_bg, wallpaper_fg, wallpaper_alt_fg, s)
|
|
end
|
|
#+END_SRC
|
|
|
|
** Return Theme
|
|
|
|
#+BEGIN_SRC lua :tangle theme.lua
|
|
return theme
|
|
#+END_SRC
|