Initial commit

README.md

@@ -0,0 +1,27 @@
+# Modular awesomewm config
+This is my opinionated take on a modular [awesomewm](https://github.com/awesomeWM/awesome) configuration. The structure is setup as such:
+
+- rc.lua - initialize other modules & error handling
+- bindings - bindings
+	- mouse.lua - all global mouse bindings
+	- key - keyboard bindings
+		- client.lua - bindings for clients (windows)
+		- focus.lua - bindings regarding client/screen focus
+		- general.lua - general, miscellaneous, "important" keybinds
+		- layout.lua - bindings regarding changing/switching layouts
+		- tags.lua - bindings regarding tags
+- defs - global definitions
+	- layouts.lua - define the layout table
+	- rules.lua - define client rules
+	- theme.lua - define the theme
+	- vars.lua - define misc. variables
+- ui - ui modules
+	- wibar - configure the wibar
+		- init.lua - actually builds the wibar
+		- widgets.lua - misc. widgets defined outside of `screen.connect_signal`
+	- menubar.lua - configure the menubar
+	- notifications.lua - configure notifications
+	- promptmenu.lua - configure the prompt menu
+	- titlebars.lua - configure window titlebars
+- themes - use themes
+	- note: I made wallpapers go by a per-theme basis. wallpaper.lua in the theme directory will get loaded, and the wallpaper image is defined there

bindings/key/client.lua

@@ -0,0 +1,47 @@
+local awful = require("awful")
+
+client.connect_signal("request::default_keybindings", function()
+awful.keyboard.append_client_keybindings({
+	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,           }, "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)

bindings/key/focus.lua

@@ -0,0 +1,38 @@
+local awful = require("awful")
+
+-- Focus related keybindings
+awful.keyboard.append_global_keybindings({
+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,           }, "Tab",
+	function ()
+		awful.client.focus.history.previous()
+		if client.focus then
+			client.focus:raise()
+		end
+	end,
+	{ description = "go back", 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" }),
+awful.key({ modkey, "Control" }, "n",
+			function ()
+				local c = awful.client.restore()
+				-- Focus restored client
+				if c then
+					c:activate { raise = true, context = "key.unminimize" }
+				end
+			end,
+			{ description = "restore minimized", group = "client" }),
+})

bindings/key/general.lua

@@ -0,0 +1,32 @@
+local awful = require("awful")
+local menubar = require("menubar")
+local hotkeys_popup = require("awful.hotkeys_popup")
+require("awful.hotkeys_popup.keys")
+
+-- General Awesome keys
+awful.keyboard.append_global_keybindings({
+awful.key({ modkey,           }, "s",      hotkeys_popup.show_help,
+			{ description="show help", group="awesome" }),
+awful.key({ modkey,           }, "w", function () mymainmenu:show() end,
+			{ description = "show main menu", group = "awesome" }),
+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 }, "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" }),
+awful.key({ modkey,           }, "Return", function () awful.spawn(terminal) end,
+			{ description = "open a terminal", group = "launcher" }),
+awful.key({ modkey },            "r",     function () awful.screen.focused().mypromptbox:run() end,
+			{ description = "run prompt", group = "launcher" }),
+awful.key({ modkey }, "p", function() menubar.show() end,
+			{ description = "show the menubar", group = "launcher" }),
+})

bindings/key/init.lua

@@ -0,0 +1,5 @@
+require("bindings.key.general")
+require("bindings.key.tags")
+require("bindings.key.focus")
+require("bindings.key.layout")
+require("bindings.key.client")

bindings/key/layout.lua

@@ -0,0 +1,40 @@
+local awful = require("awful")
+
+-- Layout related keybindings
+awful.keyboard.append_global_keybindings({
+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,           }, "u", awful.client.urgent.jumpto,
+			{ description = "jump to urgent client", group = "client" }),
+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 {
+	modifiers   = { modkey },
+	keygroup    = "numpad",
+	description = "select layout directly",
+	group       = "layout",
+	on_press    = function (index)
+		local t = awful.screen.focused().selected_tag
+		if t then
+			t.layout = t.layouts[index] or t.layout
+		end
+	end,
+},
+})

bindings/key/tags.lua

@@ -0,0 +1,65 @@
+local awful = require("awful")
+
+-- Tags related keybindings
+awful.keyboard.append_global_keybindings({
+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 {
+	modifiers   = { modkey },
+	keygroup    = "numrow",
+	description = "only view tag",
+	group       = "tag",
+	on_press    = function (index)
+		local screen = awful.screen.focused()
+		local tag = screen.tags[index]
+		if tag then
+			tag:view_only()
+		end
+	end,
+},
+awful.key {
+	modifiers   = { modkey, "Control" },
+	keygroup    = "numrow",
+	description = "toggle tag",
+	group       = "tag",
+	on_press    = function (index)
+		local screen = awful.screen.focused()
+		local tag = screen.tags[index]
+		if tag then
+			awful.tag.viewtoggle(tag)
+		end
+	end,
+},
+awful.key {
+	modifiers = { modkey, "Shift" },
+	keygroup    = "numrow",
+	description = "move focused client to tag",
+	group       = "tag",
+	on_press    = function (index)
+		if client.focus then
+			local tag = client.focus.screen.tags[index]
+			if tag then
+				client.focus:move_to_tag(tag)
+			end
+		end
+	end,
+},
+awful.key {
+	modifiers   = { modkey, "Control", "Shift" },
+	keygroup    = "numrow",
+	description = "toggle focused client on tag",
+	group       = "tag",
+	on_press    = function (index)
+		if client.focus then
+			local tag = client.focus.screen.tags[index]
+			if tag then
+				client.focus:toggle_tag(tag)
+			end
+		end
+	end,
+},
+})

bindings/mouse.lua

@@ -0,0 +1,28 @@
+local awful = require("awful")
+
+-- root window mouse bindings
+awful.mouse.append_global_mousebindings({
+	awful.button({ }, 3, function () mymainmenu:toggle() end),
+	awful.button({ }, 4, awful.tag.viewprev),
+	awful.button({ }, 5, awful.tag.viewnext),
+})
+
+-- window mouse bindings
+client.connect_signal("request::default_mousebindings", function()
+awful.mouse.append_client_mousebindings({
+	awful.button({ }, 1, function (c)
+		c:activate { context = "mouse_click" }
+	end),
+	awful.button({ modkey }, 1, function (c)
+		c:activate { context = "mouse_click", action = "mouse_move"  }
+	end),
+	awful.button({ modkey }, 3, function (c)
+		c:activate { context = "mouse_click", action = "mouse_resize"}
+	end),
+})
+end)
+
+-- Enable sloppy focus, so that focus follows mouse.
+client.connect_signal("mouse::enter", function(c)
+c:activate { context = "mouse_enter", raise = false }
+end)

defs/layouts.lua

@@ -0,0 +1,20 @@
+local awful = require("awful")
+
+-- Table of layouts to cover with awful.layout.inc, order matters.
+tag.connect_signal("request::default_layouts", function()
+	awful.layout.append_default_layouts({
+		awful.layout.suit.floating,
+		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,
+	})
+end)

defs/rules.lua

@@ -0,0 +1,47 @@
+local awful = require("awful")
+local ruled = require("ruled")
+
+-- Rules to apply to new clients.
+ruled.client.connect_signal("request::rules", function()
+-- All clients will match this rule.
+ruled.client.append_rule {
+	id         = "global",
+	rule       = { },
+	properties = {
+		focus     = awful.client.focus.filter,
+		raise     = true,
+		screen    = awful.screen.preferred,
+		placement = awful.placement.no_overlap+awful.placement.no_offscreen
+	}
+}
+
+-- Floating clients.
+ruled.client.append_rule {
+	id       = "floating",
+	rule_any = {
+		instance = { "copyq", "pinentry" },
+		class    = {
+			"Arandr", "Blueman-manager", "Gpick", "Kruler", "Sxiv",
+			"Tor Browser", "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.
+		},
+		role    = {
+			"AlarmWindow",    -- Thunderbird's calendar.
+			"ConfigManager",  -- Thunderbird's about:config.
+			"pop-up",         -- e.g. Google Chrome's (detached) Developer Tools.
+		}
+	},
+	properties = { floating = true }
+}
+
+-- Set Firefox to always map on the tag named "2" on screen 1.
+-- ruled.client.append_rule {
+--     rule       = { class = "Firefox"     },
+--     properties = { screen = 1, tag = "2" }
+-- }
+end)
+

defs/theme.lua

@@ -0,0 +1,10 @@
+local gears = require("gears")
+local beautiful = require("beautiful")
+
+-- Themes define colours, icons, font and wallpapers.
+theme = "default"
+
+beautiful.init(gears.filesystem.get_themes_dir() .. theme .. "/theme.lua")
+
+-- per-theme wallpaper config
+require("themes." .. theme .. ".wallpaper")

defs/vars.lua

@@ -0,0 +1,7 @@
+-- This is used later as the default terminal and editor to run.
+terminal = "urxvt"
+editor = os.getenv("EDITOR") or "vim"
+editor_cmd = terminal .. " -e " .. editor
+
+-- Default modkey.
+modkey = "Mod4"

rc.lua

@@ -0,0 +1,45 @@
+-- awesome_mode: api-level=4:screen=on
+-- If LuaRocks is installed, make sure that packages installed through it are
+-- found (e.g. lgi). If LuaRocks is not installed, do nothing.
+pcall(require, "luarocks.loader")
+
+-- Standard awesome library
+local awful = require("awful")
+local naughty = require("naughty")
+
+-- {{{ 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)
+naughty.connect_signal("request::display_error", function(message, startup)
+naughty.notification {
+	urgency = "critical",
+	title   = "Oops, an error happened"..(startup and " during startup!" or "!"),
+	message = message
+}
+end)
+-- }}}
+
+-- Load global definitions
+require("defs.vars")
+require("defs.theme")
+require("defs.layouts")
+
+-- Load menus
+require("ui.promptmenu")
+require("ui.menubar")
+
+-- Load Wibar
+require("ui.wibar")
+
+-- Load bindings
+require("bindings.mouse")
+require("bindings.key")
+
+-- Load rules
+require("defs.rules")
+
+-- Load titlebars
+require("ui.titlebars")
+
+-- Load notifications
+require("ui.notifications")

themes/default/README

@@ -0,0 +1,3 @@
+Background images:
+    Mikael Eriksson <mikael_eriksson@miffe.org>
+    Licensed under CC-BY-SA-3.0

themes/default/theme.lua

@@ -0,0 +1,137 @@
+---------------------------
+-- Default awesome theme --
+---------------------------
+
+local theme_assets = require("beautiful.theme_assets")
+local xresources = require("beautiful.xresources")
+local rnotification = require("ruled.notification")
+local dpi = xresources.apply_dpi
+
+local gfs = require("gears.filesystem")
+local themes_path = gfs.get_themes_dir()
+
+local theme = {}
+
+theme.font          = "sans 8"
+
+theme.bg_normal     = "#222222"
+theme.bg_focus      = "#535d6c"
+theme.bg_urgent     = "#ff0000"
+theme.bg_minimize   = "#444444"
+theme.bg_systray    = theme.bg_normal
+
+theme.fg_normal     = "#aaaaaa"
+theme.fg_focus      = "#ffffff"
+theme.fg_urgent     = "#ffffff"
+theme.fg_minimize   = "#ffffff"
+
+theme.useless_gap         = dpi(0)
+theme.border_width        = dpi(1)
+theme.border_color_normal = "#000000"
+theme.border_color_active = "#535d6c"
+theme.border_color_marked = "#91231c"
+
+-- There are other variable sets
+-- overriding the default one when
+-- defined, the sets are:
+-- taglist_[bg|fg]_[focus|urgent|occupied|empty|volatile]
+-- tasklist_[bg|fg]_[focus|urgent]
+-- titlebar_[bg|fg]_[normal|focus]
+-- tooltip_[font|opacity|fg_color|bg_color|border_width|border_color]
+-- prompt_[fg|bg|fg_cursor|bg_cursor|font]
+-- hotkeys_[bg|fg|border_width|border_color|shape|opacity|modifiers_fg|label_bg|label_fg|group_margin|font|description_font]
+-- Example:
+--theme.taglist_bg_focus = "#ff0000"
+
+-- Generate taglist squares:
+local taglist_square_size = dpi(4)
+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
+)
+
+-- Variables set for theming notifications:
+-- notification_font
+-- notification_[bg|fg]
+-- notification_[width|height|margin]
+-- notification_[border_color|border_width|shape|opacity]
+
+-- Variables set for theming the menu:
+-- menu_[bg|fg]_[normal|focus]
+-- menu_[border_color|border_width]
+theme.menu_submenu_icon = themes_path.."default/submenu.png"
+theme.menu_height = dpi(15)
+theme.menu_width  = dpi(100)
+
+-- You can add as many variables as
+-- you wish and access them by using
+-- beautiful.variable in your rc.lua
+--theme.bg_widget = "#cc0000"
+
+-- Define the image to load
+theme.titlebar_close_button_normal = themes_path.."default/titlebar/close_normal.png"
+theme.titlebar_close_button_focus  = themes_path.."default/titlebar/close_focus.png"
+
+theme.titlebar_minimize_button_normal = themes_path.."default/titlebar/minimize_normal.png"
+theme.titlebar_minimize_button_focus  = themes_path.."default/titlebar/minimize_focus.png"
+
+theme.titlebar_ontop_button_normal_inactive = themes_path.."default/titlebar/ontop_normal_inactive.png"
+theme.titlebar_ontop_button_focus_inactive  = themes_path.."default/titlebar/ontop_focus_inactive.png"
+theme.titlebar_ontop_button_normal_active = themes_path.."default/titlebar/ontop_normal_active.png"
+theme.titlebar_ontop_button_focus_active  = themes_path.."default/titlebar/ontop_focus_active.png"
+
+theme.titlebar_sticky_button_normal_inactive = themes_path.."default/titlebar/sticky_normal_inactive.png"
+theme.titlebar_sticky_button_focus_inactive  = themes_path.."default/titlebar/sticky_focus_inactive.png"
+theme.titlebar_sticky_button_normal_active = themes_path.."default/titlebar/sticky_normal_active.png"
+theme.titlebar_sticky_button_focus_active  = themes_path.."default/titlebar/sticky_focus_active.png"
+
+theme.titlebar_floating_button_normal_inactive = themes_path.."default/titlebar/floating_normal_inactive.png"
+theme.titlebar_floating_button_focus_inactive  = themes_path.."default/titlebar/floating_focus_inactive.png"
+theme.titlebar_floating_button_normal_active = themes_path.."default/titlebar/floating_normal_active.png"
+theme.titlebar_floating_button_focus_active  = themes_path.."default/titlebar/floating_focus_active.png"
+
+theme.titlebar_maximized_button_normal_inactive = themes_path.."default/titlebar/maximized_normal_inactive.png"
+theme.titlebar_maximized_button_focus_inactive  = themes_path.."default/titlebar/maximized_focus_inactive.png"
+theme.titlebar_maximized_button_normal_active = themes_path.."default/titlebar/maximized_normal_active.png"
+theme.titlebar_maximized_button_focus_active  = themes_path.."default/titlebar/maximized_focus_active.png"
+
+-- You can use your own layout icons like this:
+theme.layout_fairh = themes_path.."default/layouts/fairhw.png"
+theme.layout_fairv = themes_path.."default/layouts/fairvw.png"
+theme.layout_floating  = themes_path.."default/layouts/floatingw.png"
+theme.layout_magnifier = themes_path.."default/layouts/magnifierw.png"
+theme.layout_max = themes_path.."default/layouts/maxw.png"
+theme.layout_fullscreen = themes_path.."default/layouts/fullscreenw.png"
+theme.layout_tilebottom = themes_path.."default/layouts/tilebottomw.png"
+theme.layout_tileleft   = themes_path.."default/layouts/tileleftw.png"
+theme.layout_tile = themes_path.."default/layouts/tilew.png"
+theme.layout_tiletop = themes_path.."default/layouts/tiletopw.png"
+theme.layout_spiral  = themes_path.."default/layouts/spiralw.png"
+theme.layout_dwindle = themes_path.."default/layouts/dwindlew.png"
+theme.layout_cornernw = themes_path.."default/layouts/cornernww.png"
+theme.layout_cornerne = themes_path.."default/layouts/cornernew.png"
+theme.layout_cornersw = themes_path.."default/layouts/cornersww.png"
+theme.layout_cornerse = themes_path.."default/layouts/cornersew.png"
+
+-- Generate Awesome icon:
+theme.awesome_icon = theme_assets.awesome_icon(
+    theme.menu_height, theme.bg_focus, theme.fg_focus
+)
+
+-- 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.
+theme.icon_theme = nil
+
+-- Set different colors for urgent notifications.
+rnotification.connect_signal('request::rules', function()
+    rnotification.append_rule {
+        rule       = { urgency = 'critical' },
+        properties = { bg = '#ff0000', fg = '#ffffff' }
+    }
+end)
+
+return theme
+
+-- vim: filetype=lua:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:textwidth=80

themes/default/wallpaper.lua

@@ -0,0 +1,29 @@
+local awful = require("awful")
+local gears = require("gears")
+local beautiful = require("beautiful")
+local wibox = require("wibox")
+
+local themes_path = gears.filesystem.get_themes_dir()
+
+-- image, change to whatever
+-- alternatively, you could use this as some sort of manager by linking files to background.png
+local background = themes_path .. theme .. "/background.png"
+
+-- configure how the wallpaper is applied here
+screen.connect_signal("request::wallpaper", function(s)
+    awful.wallpaper {
+        screen = s,
+        widget = {
+            {
+                image     = background,
+                upscale   = true,
+                downscale = true,
+                widget    = wibox.widget.imagebox,
+            },
+            valign = "center",
+            halign = "center",
+            tiled  = false,
+            widget = wibox.container.tile,
+        }
+    }
+end)

themes/gtk/theme.lua

@@ -0,0 +1,358 @@
+----------------------------------------------
+-- Awesome theme which follows GTK+ 3 theme --
+--   by Yauhen Kirylau                      --
+----------------------------------------------
+
+local theme_assets = require("beautiful.theme_assets")
+local dpi = require("beautiful.xresources").apply_dpi
+local rnotification = require("ruled.notification")
+local gfs = require("gears.filesystem")
+local themes_path = gfs.get_themes_dir()
+local gears_shape = require("gears.shape")
+local wibox = require("wibox")
+local awful_widget_clienticon = require("awful.widget.clienticon")
+local gtk = require("beautiful.gtk")
+
+
+-- Helper functions for modifying hex colors:
+--
+local hex_color_match = "[a-fA-F0-9][a-fA-F0-9]"
+local function darker(color_value, darker_n)
+    local result = "#"
+    local channel_counter = 1
+    for s in color_value:gmatch(hex_color_match) do
+        local bg_numeric_value = tonumber("0x"..s)
+        if channel_counter <= 3 then
+            bg_numeric_value = bg_numeric_value - darker_n
+        end
+        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("%02x", bg_numeric_value)
+        channel_counter = channel_counter + 1
+    end
+    return result
+end
+local function is_dark(color_value)
+    local bg_numeric_value = 0;
+    local channel_counter = 1
+    for s in color_value:gmatch(hex_color_match) do
+        bg_numeric_value = bg_numeric_value + tonumber("0x"..s);
+        if channel_counter == 3 then
+            break
+        end
+        channel_counter = channel_counter + 1
+    end
+    local is_dark_bg = (bg_numeric_value < 383)
+    return is_dark_bg
+end
+local function mix(color1, color2, ratio)
+    ratio = ratio or 0.5
+    local result = "#"
+    local channels1 = color1:gmatch(hex_color_match)
+    local channels2 = color2:gmatch(hex_color_match)
+    for _ = 1,3 do
+        local bg_numeric_value = math.ceil(
+          tonumber("0x"..channels1())*ratio +
+          tonumber("0x"..channels2())*(1-ratio)
+        )
+        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("%02x", bg_numeric_value)
+    end
+    return result
+end
+local function reduce_contrast(color, ratio)
+    ratio = ratio or 50
+    return darker(color, is_dark(color) and -ratio or ratio)
+end
+
+local function choose_contrast_color(reference, candidate1, candidate2)  -- luacheck: no unused
+    if is_dark(reference) then
+        if not is_dark(candidate1) then
+            return candidate1
+        else
+            return candidate2
+        end
+    else
+        if is_dark(candidate1) then
+            return candidate1
+        else
+            return candidate2
+        end
+    end
+end
+
+
+-- inherit xresources theme:
+local theme = dofile(themes_path.."xresources/theme.lua")
+-- load and prepare for use gtk theme:
+theme.gtk = gtk.get_theme_variables()
+if not theme.gtk then
+    local gears_debug = require("gears.debug")
+    gears_debug.print_warning("Can't load GTK+3 theme. Using 'xresources' theme as a fallback.")
+    return theme
+end
+theme.gtk.button_border_radius = dpi(theme.gtk.button_border_radius or 0)
+theme.gtk.button_border_width = dpi(theme.gtk.button_border_width or 1)
+theme.gtk.bold_font = theme.gtk.font_family .. ' Bold ' .. theme.gtk.font_size
+theme.gtk.menubar_border_color = mix(
+    theme.gtk.menubar_bg_color,
+    theme.gtk.menubar_fg_color,
+    0.7
+)
+
+
+theme.font          = theme.gtk.font_family .. ' ' .. theme.gtk.font_size
+
+theme.bg_normal     = theme.gtk.bg_color
+theme.fg_normal     = theme.gtk.fg_color
+
+theme.wibar_bg      = theme.gtk.menubar_bg_color
+theme.wibar_fg      = theme.gtk.menubar_fg_color
+
+theme.bg_focus      = theme.gtk.selected_bg_color
+theme.fg_focus      = theme.gtk.selected_fg_color
+
+theme.bg_urgent     = theme.gtk.error_bg_color
+theme.fg_urgent     = theme.gtk.error_fg_color
+
+theme.bg_minimize   = mix(theme.wibar_fg, theme.wibar_bg, 0.3)
+theme.fg_minimize   = mix(theme.wibar_fg, theme.wibar_bg, 0.9)
+
+theme.bg_systray    = theme.wibar_bg
+
+theme.border_color_normal = theme.gtk.wm_border_unfocused_color
+theme.border_color_active = theme.gtk.wm_border_focused_color
+theme.border_color_marked = theme.gtk.success_color
+
+theme.border_width  = dpi(theme.gtk.button_border_width or 1)
+theme.border_radius = theme.gtk.button_border_radius
+
+theme.useless_gap   = dpi(3)
+
+local rounded_rect_shape = function(cr,w,h)
+    gears_shape.rounded_rect(
+        cr, w, h, theme.border_radius
+    )
+end
+
+-- There are other variable sets
+-- overriding the default one when
+-- defined, the sets are:
+-- taglist_[bg|fg|shape|shape_border_color|shape_border_width]_[focus|urgent|occupied|empty|volatile]
+-- tasklist_[bg|fg|shape|shape_border_color|shape_border_width]_[focus|urgent|minimized]
+-- titlebar_[bg|fg]_[normal|focus]
+-- tooltip_[font|opacity|fg_color|bg_color|border_width|border_color]
+
+theme.tasklist_fg_normal = theme.wibar_fg
+theme.tasklist_bg_normal = theme.wibar_bg
+theme.tasklist_fg_focus = theme.tasklist_fg_normal
+theme.tasklist_bg_focus = theme.tasklist_bg_normal
+
+theme.tasklist_font_focus = theme.gtk.bold_font
+
+theme.tasklist_shape_minimized = rounded_rect_shape
+theme.tasklist_shape_border_color_minimized = mix(
+    theme.bg_minimize,
+    theme.fg_minimize,
+    0.85
+)
+theme.tasklist_shape_border_width_minimized = theme.gtk.button_border_width
+
+theme.tasklist_spacing = theme.gtk.button_border_width
+
+--[[ Advanced taglist and tasklist styling: {{{
+
+--- In order to get taglist and tasklist to follow GTK theme you need to
+-- modify your rc.lua in the following way:
+
+diff --git a/rc.lua b/rc.lua
+index 231a2f68c..533a859d2 100644
+--- a/rc.lua
++++ b/rc.lua
+@@ -217,24 +217,12 @@ awful.screen.connect_for_each_screen(function(s)
+         filter  = awful.widget.taglist.filter.all,
+         buttons = taglist_buttons
+     }
++    -- and apply shape to it
++    if beautiful.taglist_shape_container then
++        local background_shape_wrapper = wibox.container.background(s.mytaglist)
++        background_shape_wrapper._do_taglist_update_now = s.mytaglist._do_taglist_update_now
++        background_shape_wrapper._do_taglist_update = s.mytaglist._do_taglist_update
++        background_shape_wrapper.shape = beautiful.taglist_shape_container
++        background_shape_wrapper.shape_clip = beautiful.taglist_shape_clip_container
++        background_shape_wrapper.shape_border_width = beautiful.taglist_shape_border_width_container
++        background_shape_wrapper.shape_border_color = beautiful.taglist_shape_border_color_container
++        s.mytaglist = background_shape_wrapper
++    end
+
+     -- Create a tasklist widget
+     s.mytasklist = awful.widget.tasklist {
+         screen  = s,
+         filter  = awful.widget.tasklist.filter.currenttags,
++        buttons = tasklist_buttons,
++        widget_template = beautiful.tasklist_widget_template
+-        buttons = tasklist_buttons
+     }
+
+--]]
+theme.tasklist_widget_template = {
+    {
+        {
+            {
+                {
+                    id     = 'clienticon',
+                    widget = awful_widget_clienticon,
+                },
+                margins = dpi(4),
+                widget  = wibox.container.margin,
+            },
+            {
+                id     = 'text_role',
+                widget = wibox.widget.textbox,
+            },
+            layout = wibox.layout.fixed.horizontal,
+        },
+        left  = dpi(2),
+        right = dpi(4),
+        widget = wibox.container.margin
+    },
+    id     = 'background_role',
+    widget = wibox.container.background,
+    create_callback = function(self, c)
+        self:get_children_by_id('clienticon')[1].client = c
+    end,
+}
+
+theme.taglist_shape_container = rounded_rect_shape
+theme.taglist_shape_clip_container = true
+theme.taglist_shape_border_width_container = theme.gtk.button_border_width * 2
+theme.taglist_shape_border_color_container = theme.gtk.header_button_border_color
+-- }}}
+
+theme.taglist_bg_occupied = theme.gtk.header_button_bg_color
+theme.taglist_fg_occupied = theme.gtk.header_button_fg_color
+
+theme.taglist_bg_empty = mix(
+    theme.gtk.menubar_bg_color,
+    theme.gtk.header_button_bg_color,
+    0.3
+)
+theme.taglist_fg_empty = mix(
+    theme.gtk.menubar_bg_color,
+    theme.gtk.header_button_fg_color
+)
+
+theme.titlebar_font_normal = theme.gtk.bold_font
+theme.titlebar_bg_normal = theme.gtk.wm_border_unfocused_color
+theme.titlebar_fg_normal = theme.gtk.wm_title_unfocused_color
+--theme.titlebar_fg_normal = choose_contrast_color(
+    --theme.titlebar_bg_normal,
+    --theme.gtk.menubar_fg_color,
+    --theme.gtk.menubar_bg_color
+--)
+
+theme.titlebar_font_focus = theme.gtk.bold_font
+theme.titlebar_bg_focus = theme.gtk.wm_border_focused_color
+theme.titlebar_fg_focus = theme.gtk.wm_title_focused_color
+--theme.titlebar_fg_focus = choose_contrast_color(
+    --theme.titlebar_bg_focus,
+    --theme.gtk.menubar_fg_color,
+    --theme.gtk.menubar_bg_color
+--)
+
+theme.tooltip_fg = theme.gtk.tooltip_fg_color
+theme.tooltip_bg = theme.gtk.tooltip_bg_color
+
+-- Variables set for theming the menu:
+-- menu_[bg|fg]_[normal|focus]
+-- menu_[border_color|border_width]
+
+theme.menu_border_width = theme.gtk.button_border_width
+theme.menu_border_color = theme.gtk.menubar_border_color
+theme.menu_bg_normal = theme.gtk.menubar_bg_color
+theme.menu_fg_normal = theme.gtk.menubar_fg_color
+
+-- @TODO: get from gtk menu height
+theme.menu_height = dpi(24)
+theme.menu_width  = dpi(150)
+theme.menu_submenu_icon = nil
+theme.menu_submenu = "▸ "
+
+-- You can add as many variables as
+-- you wish and access them by using
+-- beautiful.variable in your rc.lua
+--theme.bg_widget = "#cc0000"
+
+
+-- Recolor Layout icons:
+theme = theme_assets.recolor_layout(theme, theme.wibar_fg)
+
+-- Recolor titlebar icons:
+--
+theme = theme_assets.recolor_titlebar(
+    theme, theme.titlebar_fg_normal, "normal"
+)
+theme = theme_assets.recolor_titlebar(
+    theme, reduce_contrast(theme.titlebar_fg_normal, 50), "normal", "hover"
+)
+theme = theme_assets.recolor_titlebar(
+    theme, theme.gtk.error_bg_color, "normal", "press"
+)
+theme = theme_assets.recolor_titlebar(
+    theme, theme.titlebar_fg_focus, "focus"
+)
+theme = theme_assets.recolor_titlebar(
+    theme, reduce_contrast(theme.titlebar_fg_focus, 50), "focus", "hover"
+)
+theme = theme_assets.recolor_titlebar(
+    theme, theme.gtk.error_bg_color, "focus", "press"
+)
+
+-- 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.
+theme.icon_theme = nil
+
+-- Generate Awesome icon:
+theme.awesome_icon = theme_assets.awesome_icon(
+    theme.menu_height, mix(theme.bg_focus, theme.fg_normal), theme.wibar_bg
+)
+
+-- Generate taglist squares:
+--local taglist_square_size = dpi(4)
+--theme.taglist_squares_sel = theme_assets.taglist_squares_sel(
+    --taglist_square_size, theme.gtk.header_button_border_color
+--)
+--theme.taglist_squares_unsel = theme_assets.taglist_squares_unsel(
+    --taglist_square_size, theme.gtk.header_button_border_color
+--)
+-- Or disable them:
+theme.taglist_squares_sel = nil
+theme.taglist_squares_unsel = nil
+
+-- Generate wallpaper:
+local wallpaper_bg = theme.gtk.base_color
+local wallpaper_fg = theme.gtk.bg_color
+local wallpaper_alt_fg = theme.gtk.selected_bg_color
+if not is_dark(theme.bg_normal) then
+    wallpaper_bg, wallpaper_fg = wallpaper_fg, wallpaper_bg
+end
+wallpaper_bg = reduce_contrast(wallpaper_bg, 50)
+wallpaper_fg = reduce_contrast(wallpaper_fg, 30)
+wallpaper_fg = mix(wallpaper_fg, wallpaper_bg, 0.4)
+wallpaper_alt_fg = mix(wallpaper_alt_fg, wallpaper_fg, 0.4)
+theme.wallpaper = function(s)
+    return theme_assets.wallpaper(wallpaper_bg, wallpaper_fg, wallpaper_alt_fg, s)
+end
+
+-- Set different colors for urgent notifications.
+rnotification.connect_signal('request::rules', function()
+    rnotification.append_rule {
+        rule       = { urgency = 'critical' },
+        properties = { bg = '#ff0000', fg = '#ffffff' }
+    }
+end)
+
+return theme
+
+-- vim: filetype=lua:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:textwidth=80:foldmethod=marker

themes/sky/theme.lua

@@ -0,0 +1,112 @@
+-------------------------------
+--    "Sky" awesome theme    --
+--  By Andrei "Garoth" Thorp --
+-------------------------------
+-- If you want SVGs and extras, get them from garoth.com/awesome/sky-theme
+
+local theme_assets = require("beautiful.theme_assets")
+local xresources = require("beautiful.xresources")
+local rnotification = require("ruled.notification")
+local dpi = xresources.apply_dpi
+local themes_path = require("gears.filesystem").get_themes_dir()
+
+
+-- BASICS
+local theme = {}
+theme.font          = "sans 8"
+
+theme.bg_focus      = "#e2eeea"
+theme.bg_normal     = "#729fcf"
+theme.bg_urgent     = "#fce94f"
+theme.bg_minimize   = "#0067ce"
+theme.bg_systray    = theme.bg_normal
+
+theme.fg_normal     = "#2e3436"
+theme.fg_focus      = "#2e3436"
+theme.fg_urgent     = "#2e3436"
+theme.fg_minimize   = "#2e3436"
+
+theme.useless_gap   = dpi(0)
+theme.border_width  = dpi(2)
+theme.border_color_normal = "#dae3e0"
+theme.border_color_active = "#729fcf"
+theme.border_color_marked = "#eeeeec"
+
+-- IMAGES
+theme.layout_fairh           = themes_path .. "sky/layouts/fairh.png"
+theme.layout_fairv           = themes_path .. "sky/layouts/fairv.png"
+theme.layout_floating        = themes_path .. "sky/layouts/floating.png"
+theme.layout_magnifier       = themes_path .. "sky/layouts/magnifier.png"
+theme.layout_max             = themes_path .. "sky/layouts/max.png"
+theme.layout_fullscreen      = themes_path .. "sky/layouts/fullscreen.png"
+theme.layout_tilebottom      = themes_path .. "sky/layouts/tilebottom.png"
+theme.layout_tileleft        = themes_path .. "sky/layouts/tileleft.png"
+theme.layout_tile            = themes_path .. "sky/layouts/tile.png"
+theme.layout_tiletop         = themes_path .. "sky/layouts/tiletop.png"
+theme.layout_spiral          = themes_path .. "sky/layouts/spiral.png"
+theme.layout_dwindle         = themes_path .. "sky/layouts/dwindle.png"
+theme.layout_cornernw        = themes_path .. "sky/layouts/cornernw.png"
+theme.layout_cornerne        = themes_path .. "sky/layouts/cornerne.png"
+theme.layout_cornersw        = themes_path .. "sky/layouts/cornersw.png"
+theme.layout_cornerse        = themes_path .. "sky/layouts/cornerse.png"
+
+theme.awesome_icon           = themes_path .. "sky/awesome-icon.png"
+
+-- from default for now...
+theme.menu_submenu_icon     = themes_path .. "default/submenu.png"
+
+-- Generate taglist squares:
+local taglist_square_size = dpi(4)
+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
+)
+
+-- MISC
+theme.wallpaper             = themes_path .. "sky/sky-background.png"
+theme.taglist_squares       = "true"
+theme.titlebar_close_button = "true"
+theme.menu_height = dpi(15)
+theme.menu_width  = dpi(100)
+
+-- Define the image to load
+theme.titlebar_close_button_normal = themes_path .. "default/titlebar/close_normal.png"
+theme.titlebar_close_button_focus = themes_path .. "default/titlebar/close_focus.png"
+
+theme.titlebar_minimize_button_normal = themes_path .. "default/titlebar/minimize_normal.png"
+theme.titlebar_minimize_button_focus  = themes_path .. "default/titlebar/minimize_focus.png"
+
+theme.titlebar_ontop_button_normal_inactive = themes_path .. "default/titlebar/ontop_normal_inactive.png"
+theme.titlebar_ontop_button_focus_inactive = themes_path .. "default/titlebar/ontop_focus_inactive.png"
+theme.titlebar_ontop_button_normal_active = themes_path .. "default/titlebar/ontop_normal_active.png"
+theme.titlebar_ontop_button_focus_active = themes_path .. "default/titlebar/ontop_focus_active.png"
+
+theme.titlebar_sticky_button_normal_inactive = themes_path .. "default/titlebar/sticky_normal_inactive.png"
+theme.titlebar_sticky_button_focus_inactive = themes_path .. "default/titlebar/sticky_focus_inactive.png"
+theme.titlebar_sticky_button_normal_active = themes_path .. "default/titlebar/sticky_normal_active.png"
+theme.titlebar_sticky_button_focus_active = themes_path .. "default/titlebar/sticky_focus_active.png"
+
+theme.titlebar_floating_button_normal_inactive = themes_path .. "default/titlebar/floating_normal_inactive.png"
+theme.titlebar_floating_button_focus_inactive = themes_path .. "default/titlebar/floating_focus_inactive.png"
+theme.titlebar_floating_button_normal_active = themes_path .. "default/titlebar/floating_normal_active.png"
+theme.titlebar_floating_button_focus_active = themes_path .. "default/titlebar/floating_focus_active.png"
+
+theme.titlebar_maximized_button_normal_inactive = themes_path .. "default/titlebar/maximized_normal_inactive.png"
+theme.titlebar_maximized_button_focus_inactive = themes_path .. "default/titlebar/maximized_focus_inactive.png"
+theme.titlebar_maximized_button_normal_active = themes_path .. "default/titlebar/maximized_normal_active.png"
+theme.titlebar_maximized_button_focus_active = themes_path .. "default/titlebar/maximized_focus_active.png"
+
+
+-- Set different colors for urgent notifications.
+rnotification.connect_signal('request::rules', function()
+    rnotification.append_rule {
+        rule       = { urgency = 'critical' },
+        properties = { bg = '#ff0000', fg = '#ffffff' }
+    }
+end)
+
+return theme
+
+-- vim: filetype=lua:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:textwidth=80

themes/sky/wallpaper.lua

@@ -0,0 +1,29 @@
+local awful = require("awful")
+local gears = require("gears")
+local beautiful = require("beautiful")
+local wibox = require("wibox")
+
+local themes_path = gears.filesystem.get_themes_dir()
+
+-- image, change to whatever
+-- alternatively, you could use this as some sort of manager by linking files to background.png
+local background = themes_path .. theme .. "/sky-background.png"
+
+-- configure how the wallpaper is applied here
+screen.connect_signal("request::wallpaper", function(s)
+    awful.wallpaper {
+        screen = s,
+        widget = {
+            {
+                image     = background,
+                upscale   = true,
+                downscale = true,
+                widget    = wibox.widget.imagebox,
+            },
+            valign = "center",
+            halign = "center",
+            tiled  = false,
+            widget = wibox.container.tile,
+        }
+    }
+end)

themes/xresources/assets.lua

@@ -0,0 +1,2 @@
+require("gears.debug").deprecate("Use beautiful.theme_assets instead.", {raw=true})
+return require("beautiful.theme_assets")

themes/xresources/theme.lua

@@ -0,0 +1,176 @@
+---------------------------------------------
+-- Awesome theme which follows xrdb config --
+--   by Yauhen Kirylau                    --
+---------------------------------------------
+
+local theme_assets = require("beautiful.theme_assets")
+local xresources = require("beautiful.xresources")
+local rnotification = require("ruled.notification")
+local dpi = xresources.apply_dpi
+local xrdb = xresources.get_current_theme()
+local gdebug = require("gears.debug")
+local gfs = require("gears.filesystem")
+local themes_path = gfs.get_themes_dir()
+
+-- inherit default theme
+local theme = dofile(themes_path.."default/theme.lua")
+-- load vector assets' generators for this theme
+
+theme.font          = "sans 8"
+
+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   = dpi(3)
+theme.border_width  = dpi(2)
+theme.border_color_normal = xrdb.color0
+theme.border_color_active = theme.bg_focus
+theme.border_color_marked = xrdb.color10
+
+-- There are other variable sets
+-- overriding the default one when
+-- defined, the sets are:
+-- taglist_[bg|fg]_[focus|urgent|occupied|empty|volatile]
+-- tasklist_[bg|fg]_[focus|urgent]
+-- titlebar_[bg|fg]_[normal|focus]
+-- tooltip_[font|opacity|fg_color|bg_color|border_width|border_color]
+-- Example:
+--theme.taglist_bg_focus = "#ff0000"
+
+theme.tooltip_fg = theme.fg_normal
+theme.tooltip_bg = theme.bg_normal
+
+-- Variables set for theming the menu:
+-- menu_[bg|fg]_[normal|focus]
+-- menu_[border_color|border_width]
+theme.menu_submenu_icon = themes_path.."default/submenu.png"
+theme.menu_height = dpi(16)
+theme.menu_width  = dpi(100)
+
+-- You can add as many variables as
+-- you wish and access them by using
+-- beautiful.variable in your rc.lua
+--theme.bg_widget = "#cc0000"
+
+-- Recolor Layout icons:
+theme = theme_assets.recolor_layout(theme, theme.fg_normal)
+
+-- Recolor titlebar icons:
+--
+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"
+)
+
+-- 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.
+theme.icon_theme = nil
+
+-- Generate Awesome icon:
+theme.awesome_icon = theme_assets.awesome_icon(
+    theme.menu_height, theme.bg_focus, theme.fg_focus
+)
+
+-- Generate taglist squares:
+local taglist_square_size = dpi(4)
+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
+)
+
+-- Try to determine if we are running light or dark colorscheme:
+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)
+
+-- Generate wallpaper:
+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
+
+local rsvg = pcall(function() return require("lgi").Rsvg end)
+
+if rsvg then
+    local handle = require("lgi").Rsvg.Handle.new_from_file(
+        themes_path.."xresources/wallpaper.svg"
+    )
+
+    if handle then
+        handle:set_stylesheet([[
+            .normal {
+                fill: ]]..wallpaper_fg..[[;
+            }
+            .background {
+                fill: ]]..wallpaper_bg..[[;
+                stroke: ]]..wallpaper_bg..[[;
+            }
+            .logo {
+                fill: ]]..wallpaper_alt_fg..[[;
+            }
+        ]])
+
+        theme.wallpaper = handle
+    end
+else
+    gdebug.print_warning("Could not load the wallpaper: librsvg is not installed.")
+end
+
+if not theme.wallpaper then
+    gdebug.print_warning("Loading fallback wallpaper.")
+    theme.wallpaper = function(s)
+        return theme_assets.wallpaper(wallpaper_bg, wallpaper_fg, wallpaper_alt_fg, s)
+    end
+end
+
+theme.wallpaper_bg = wallpaper_bg
+
+-- Set different colors for urgent notifications.
+rnotification.connect_signal('request::rules', function()
+    rnotification.append_rule {
+        rule       = { urgency = 'critical' },
+        properties = { bg = '#ff0000', fg = '#ffffff' }
+    }
+end)
+
+return theme
+
+-- vim: filetype=lua:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:textwidth=80

themes/xresources/wallpaper.svg

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="1280pt" height="720pt" viewBox="0 0 1280 720" version="1.1">
+    <rect x="0" y="0" width="1280" height="720" style="stroke:none;" class="background"/>
+    <path style=" stroke:none;fill-rule:nonzero;fill:rgb(27.843137%,47.843137%,70.196078%);fill-opacity:1;" d="M 1152 72 L 1224 72 L 1224 144 L 1152 144 Z M 1152 72 " class="logo"/>
+    <path style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;" d="M 0 24 L 48 24 " transform="matrix(1,0,0,1,1152,72)" class="background"/>
+    <path style=" stroke:none;fill-rule:nonzero;" d="M 1152 156 L 1224 156 L 1224 228 L 1152 228 Z M 1152 156 " class="normal"/>
+    <path style="fill:none !important;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;" d="M 24 48 L 48 48 L 48 72 " transform="matrix(1,0,0,1,1152,72)"  class="background"/>
+    <path style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;" d="M 24 84 L 24 132 " transform="matrix(1,0,0,1,1152,72)" class="background"/>
+    <path style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;" d="M 48 84 L 48 132 " transform="matrix(1,0,0,1,1152,72)" class="background"/>
+    <path style=" stroke:none;fill-rule:nonzero;" d="M 1152 240 L 1224 240 L 1224 312 L 1152 312 Z M 1152 240 " class="normal"/>
+    <path style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;" d="M 24 192 L 72 192 " transform="matrix(1,0,0,1,1152,72)" class="background"/>
+    <path style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;" d="M 24 216 L 72 216 " transform="matrix(1,0,0,1,1152,72)" class="background"/>
+    <path style=" stroke:none;fill-rule:nonzero;" d="M 1152 324 L 1224 324 L 1224 396 L 1152 396 Z M 1152 324 " class="normal"/>
+    <path style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;" d="M 24 276 L 72 276 " transform="matrix(1,0,0,1,1152,72)" class="background"/>
+    <path style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;" d="M 0 300 L 48 300 " transform="matrix(1,0,0,1,1152,72)" class="background"/>
+    <path style=" stroke:none;fill-rule:nonzero;" d="M 1152 408 L 1224 408 L 1224 480 L 1152 480 Z M 1152 408 " class="normal"/>
+    <path style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;" d="M 36 360 L 36 384 " transform="matrix(1,0,0,1,1152,72)" class="background"/>
+    <path style=" stroke:none;fill-rule:nonzero;" d="M 1152 492 L 1224 492 L 1224 564 L 1152 564 Z M 1152 492 " class="normal"/>
+    <path style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;" d="M 24 444 L 24 492 " transform="matrix(1,0,0,1,1152,72)" class="background"/>
+    <path style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;" d="M 48 444 L 48 492 " transform="matrix(1,0,0,1,1152,72)" class="background"/>
+    <path style=" stroke:none;fill-rule:nonzero;" d="M 1152 576 L 1224 576 L 1224 648 L 1152 648 Z M 1152 576 " class="normal"/>
+    <path style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;" d="M 24 528 L 72 528 " transform="matrix(1,0,0,1,1152,72)" class="background"/>
+    <path style="fill:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;" d="M 24 552 L 72 552 " transform="matrix(1,0,0,1,1152,72)" class="background"/>
+</svg>