please consider a donation :)
+ +
+
+If you would like to show your appreciation for this project,
please consider a donation :)
+
+
+
+
+**N.B. This branch is for Awesome v4.3 git. [You can find the branch for Awesome v4.3 stable here](https://github.com/mut-ex/awesome-wm-nice/tree/awesome-4v3-stable)**
+
+nice is an easy to use, highly configurable extension for **[Awesome WM](https://awesomewm.org/)** that adds beautiful window decorations (and extra functionality!) to clients. It...
+
+* ...adds a **subtle 3D look**, and soft, **rounded anti-aliased, corners** to windows
+* ...picks the window **decoration color based on the client content for a seamless look** , and adjusts the window title text color accordingly
+* ...**auto-generates titlebar buttons** (and their states) for you based on the colors your pick *or* you can let it pick the colors for you!
+* ...allows you to customize which titlebar buttons to include, their order, and their layout
+* ...adds the **ability to maximize/unmaximize** floating windows by **double clicking the titlebar**, and of course, **moving them by clicking and holding**
+* ...adds the ability to **"roll up"** and **"roll down"** the client window like a **window shade**! Scroll up over the titlebar to **instantly hide the window contents but keep the title bar** right where it is. And then either scroll down or click the titlebar to make the window contents visible again!
+
+
+
+## Getting Started
+
+### Prerequisites
+
+* You need **[Awesome WM](https://awesomewm.org/)** with a working basic configuration. **This branch is for Awesome v4.3 git. [You can find the branch for Awesome v4.3 stable here](https://github.com/mut-ex/awesome-wm-nice/tree/awesome-4v3-stable)**
+
+* You also need **[picom](https://github.com/yshui/picom)**. Make sure you have `shadow-ignore-shaped = false` in your configuration otherwise picom will not draw shadows. My recommended shadow settings are given below:
+
+ ```
+ shadow = true;
+ shadow-radius = 40;
+ shadow-opacity = .55;
+ shadow-offset-x = -40;
+ shadow-offset-y = -20;
+ shadow-exclude = [
+ "_NET_WM_WINDOW_TYPE:a = '_NET_WM_WINDOW_TYPE_NOTIFICATION'",
+ "_NET_WM_STATE@:32a *= '_NET_WM_STATE_HIDDEN'",
+ "_GTK_FRAME_EXTENTS@:c"
+ ];
+ shadow-ignore-shaped = false
+ ```
+
+* For **GTK** applications add the following line to **~/.config/gtk-3.0/settings.ini** under the **[Settings]** section to hide client-side window control buttons:
+
+ ```
+ gtk-decoration-layout=menu:
+ ```
+
+* Within you Awesome configuration, make sure that you do not already have code in place that request default titlebars for clients. Something like this:
+
+```lua
+client.connect_signal("request::titlebars", function(c) ... end) -- Remove this
+```
+
+* Additionally, nice only adds window decorations to clients that have the `titlebars_enabled` property set to true. So configure your client rules accordingly.
+
+### Installation
+
+The easiest and quickest way to get started is by cloning this repository to your awesome configuration directory
+
+```shell
+$ cd ~/.config/awesome
+$ git clone https://github.com/mut-ex/awesome-wm-nice.git nice
+```
+
+
+
+## Usage
+
+To use nice, you first need to load the module. To do that, put the following line right after `beautiful.init(...)`
+
+```lua
+local nice = require("nice")
+nice()
+```
+
+If you are fine using the default configuration, you are all done!
+
+nice will automatically detect and change the window decoration color to match the client. However...
+
+* To pick the window decoration color yourself, right-click the titlebar and select **'Manually Pick Color'**
+* To update the window decoration colors, right-click on the titlebar and select **'Redo Window Decorations'**
+* Scroll-up with your mouse over the titlebar to "roll up" the window shade. Scroll-down over the titlebar, or left-click to "roll down" the window shade
+* nice saves its color rules in the **color_rules** file within the module directory. If you wish you can manually edit it, or delete the file if you want to start again.
+
+
+
+## Configuration
+
+You can override the defaults by passing your own configuration. For example
+
+```lua
+local nice = require("nice")
+nice {
+ titlebar_color = "#00ff00",
+
+ -- You only need to pass the parameter you are changing
+ context_menu_theme = {
+ width = 300,
+ },
+
+ -- Swap the designated buttons for resizing, and opening the context menu
+ mb_resize = nice.MB_MIDDLE,
+ mb_contextmenu = nice.MB_RIGHT,
+}
+```
+
+Below you will find further details explaining the configuration parameters for nice.
+
+| Parameter | Type | Description | Default |
+| --------------------- | :--: | ----------- | ------------------- |
+| `titlebar_height` | integer | The height of the titlebar | `38` |
+| `titlebar_radius` | integer | The radius of the top left and top right corners of the titlebar. Should be `>= 3` and `<= titlebar_height` | `9` |
+| `titlebar_color` | string | The default color of the titlebar and window decorations. Should be a hex color string | `"#1e1e24"` |
+| `titlebar_padding_left` | integer | The padding on the left side of the titlebar | `0` |
+| `titlebar_padding_right` | integer | The padding on the right side of the titlebar | `0` |
+| `titlebar_font` | string | The font and font size for text within the titlebar. See the default value for an example of the format | `"Sans 11"` |
+| `win_shade_enabled` | boolean | Whether the window shade feature should be enabled | `true` |
+| `no_titlebar_maximized` | boolean | Whether the titlebar should be hidden for maximized windows | `false` |
+| `mb_move` | integer or named constant | Mouse button to move a window. | `nice.MB_LEFT` |
+| `mb_contextmenu` | integer or named constant | Mouse button to open the nice context menu | `nice.MB_MIDDLE` |
+| `mb_resize` | integer or named constant | Mouse button to resize a window | `nice.MB_RIGHT` |
+| `mb_win_shade_rollup` | integer or named constant | Mouse button to roll up/hide window contents | `nice.MB_SCROLL_UP` |
+| `mb_win_shade_rolldown` | integer or named constant | Mouse button to roll down/show window contents | `nice.MB_SCROLL_DOWN` |
+| `button_size` | integer | The size (diameter) of the titlebar buttons | 16 |
+| `button_margin_horizontal` | integer | The horizontal margin around each titlebar button. `button_margin_left` and `button_margin_right`can override this parameter. | 5 |
+| `button_margin_vertical` | integer | The vertical margin above and below each titlebar button. `button_margin_top` and `button_margin_bottom` can override this parameter. | nil |
+| `button_margin_top` | integer | The margin above each titlebar button | 2 |
+| `button_margin_bottom` | integer | The margin below each titlebar button | nil |
+| `button_margin_left` | integer | The margin to the left of each titlebar button | 0 |
+| `button_margin_right` | integer | The margin to the right of each titlebar button | 0 |
+| `tooltips_enabled` | boolean | If tooltip hints should be shown when the mouse cursor is hovered over a titlebar button | nil |
+| `close_color` | string | The base color for the close button | "#ee4266" |
+| `minimize_color` | string | The base color for the minimize button | "#ffb400" |
+| `maximize_color` | string | The base color for the maximize button | "#4cbb17" |
+| `floating_color` | string | The base color for the floating mode toggle button | "#f6a2ed" |
+| `ontop_color` | string | The base color for the on top mode toggle button | "#f6a2ed" |
+| `sticky_color` | string | The base color for the sticky mode toggle button | "#f6a2ed" |
+
+In addition to the above mentioned parameters, there some more parameters that require a little more explanation:
+
+### titlebar_items
+
+`titlebar_items` — Specifies the titlebar items to include
+
+* It should be a table with the following keys:
+ * `left` — Specifies the item(s) to place on the left side of the titlebar
+ * `middle` — Specifies the item(s) to place in the middle of the titlebar
+ * `right` — Specifies the items(s) to place on the right side of the titlebar
+* Multiple items should be passed as an array of identifiers. For a single item simply passing the identifier is sufficient
+* Valid titlebar item identifiers are:
+ * `"close"`
+ * `"minimize"`
+ * `"maximize"`
+ * `"floating"`
+ * `"ontop"`
+ * `"sticky"`
+ * `"title"`
+* Default value for `titlebar_items` is:
+
+```lua
+titlebar_items = {
+ left = {"close", "minimize", "maximize"},
+ middle = "title",
+ right = {"sticky", "ontop", "floating"},
+}
+```
+
+### context_menu_theme
+
+`context_menu_theme` — Specifies theming parameters for the context (default right-click) menu
+
+* It should be a table with the following keys:
+ * `bg_focus` — Background color of focused menu item
+ * `bg_normal` — Background color of not-focused menu items
+ * `border_color` — Color of the border around the entire menu
+ * `border_width` — Width of the border around the entire menu
+ * `fg_focus` — Foreground color of focused menu item
+ * `fg_normal` — Foreground color of not-focused menu items
+ * `font` — Font used for menu text
+ * `height` — Height of each menu list item
+ * `width` — Width of the menu
+* Default value for `context_menu_theme` is:
+
+```lua
+context_menu_theme = {
+ bg_focus = "#aed9e0",
+ bg_normal = "#5e6472",
+ border_color = "#00000000",
+ border_width = 0,
+ fg_focus = "#242424",
+ fg_normal = "#fefefa",
+ font = "Sans 11",
+ height = 27.5,
+ width = 250,
+}
+```
+
+### tooltip_messages
+
+`tooltip_messages` — Specifies the hints that are shown when the mouse cursor is hovered over a titlebar button
+
+* It should be a table with the following keys:
+ * `close` — Text shown when hovering over the close button
+ * `minimize` — Text shown when hovering over the minimize button
+ * `maximize_active` — Text shown when hovering over the maximize button when the window is maximized
+ * `maximize_inactive` — Text shown when hovering over the maximize button when the window is not maximized
+ * `floating_active` — Text shown when hovering over the floating button when the window is floating
+ * `floating_inactive` — Text shown when hovering over the floating button when the window is tiled
+ * `ontop_active` — Text shown when hovering over the ontop button when the window is set to be above other windows
+ * `ontop_inactive` — Text shown when hovering over the ontop button when the window is not set to be above other windows
+ * `sticky_active` — Text shown when hovering over the sticky button when the window is set to be available on all tags
+ * `sticky_inactive` — Text shown when hovering over the sticky button when the window is not to be available on all tags
+
+The default value for `tooltip_messages` is:
+
+```lua
+tooltip_messages = {
+ close = "close",
+ minimize = "minimize",
+ maximize_active = "unmaximize",
+ maximize_inactive = "maximize",
+ floating_active = "enable tiling mode",
+ floating_inactive = "enable floating mode",
+ ontop_active = "don't keep above other windows",
+ ontop_inactive = "keep above other windows",
+ sticky_active = "disable sticky mode",
+ sticky_inactive = "enable sticky mode",
+}
+```
+
+
+
+## Using
+
+nice will automatically detect and change the window decoration color to match the client. However...
+
+* If nice doesn't pick the right color or you want to specify it yourself, right-click the titlebar and select 'Manually Pick Color'
+* If the client theme changes (for example if you change your terminal emulator colors), to update the window decoration colors, right-click on the titlebar and select 'Redo Window Decorations'
+* Scroll-up with your mouse over the titlebar to "roll-up" the window shade. Scroll-down over the titlebar, or left-click to "roll-down" the window shade
+* nice saves its color rules in the color_rules file within the module directory. If you wish you can manually edit it, or delete the file if you want to start again.
+
+
+
+## Issues
+
+If you face any bugs or issues (or have a feature request), please feel free to open an issue on here
+
+
+
+## License
+
+[](http://doge.mit-license.org)
+
+
+
diff --git a/src/awesome-wm-nice/colors.lua b/src/awesome-wm-nice/colors.lua
new file mode 100644
index 0000000..f29096b
--- /dev/null
+++ b/src/awesome-wm-nice/colors.lua
@@ -0,0 +1,164 @@
+-- => Colors
+-- Provides utility functions for handling colors
+-- ============================================================
+local math = math
+local floor = math.floor
+local max = math.max
+local min = math.min
+local random = math.random
+local gcolor = require "gears.color"
+local parse_color = gcolor.parse_color
+
+-- Returns a value that is clipped to interval edges if it falls outside the interval
+local function clip(num, min_num, max_num)
+ return max(min(num, max_num), min_num)
+end
+
+-- Converts the given hex color to normalized rgba
+local function hex2rgb(color)
+ -- color = color:gsub("#", "")
+ -- local strlen = color:len()
+ -- if strlen == 6 then
+ -- return tonumber("0x" .. color:sub(1, 2)) / 255,
+ -- tonumber("0x" .. color:sub(3, 4)) / 255,
+ -- tonumber("0x" .. color:sub(5, 6)) / 255, 1
+ -- end
+ -- if strlen == 8 then
+ -- return tonumber("0x" .. color:sub(1, 2)) / 255,
+ -- tonumber("0x" .. color:sub(3, 4)) / 255,
+ -- tonumber("0x" .. color:sub(5, 6)) / 255,
+ -- tonumber("0x" .. color:sub(7, 8)) / 255
+ -- end
+ return parse_color(color)
+end
+
+-- Converts the given hex color to hsv
+local function hex2hsv(color)
+ local r, g, b = hex2rgb(color)
+ local C_max = max(r, g, b)
+ local C_min = min(r, g, b)
+ local delta = C_max - C_min
+ local H, S, V
+ if delta == 0 then
+ H = 0
+ elseif C_max == r then
+ H = 60 * (((g - b) / delta) % 6)
+ elseif C_max == g then
+ H = 60 * (((b - r) / delta) + 2)
+ elseif C_max == b then
+ H = 60 * (((r - g) / delta) + 4)
+ end
+ if C_max == 0 then
+ S = 0
+ else
+ S = delta / C_max
+ end
+ V = C_max
+ return H, S * 100, V * 100
+end
+
+-- Converts the given hsv color to hex
+local function hsv2hex(H, S, V)
+ S = S / 100
+ V = V / 100
+ if H > 360 then
+ H = 360
+ end
+ if H < 0 then
+ H = 0
+ end
+ local C = V * S
+ local X = C * (1 - math.abs(((H / 60) % 2) - 1))
+ local m = V - C
+ local r_, g_, b_ = 0, 0, 0
+ if H >= 0 and H < 60 then
+ r_, g_, b_ = C, X, 0
+ elseif H >= 60 and H < 120 then
+ r_, g_, b_ = X, C, 0
+ elseif H >= 120 and H < 180 then
+ r_, g_, b_ = 0, C, X
+ elseif H >= 180 and H < 240 then
+ r_, g_, b_ = 0, X, C
+ elseif H >= 240 and H < 300 then
+ r_, g_, b_ = X, 0, C
+ elseif H >= 300 and H < 360 then
+ r_, g_, b_ = C, 0, X
+ end
+ local r, g, b = (r_ + m) * 255, (g_ + m) * 255, (b_ + m) * 255
+ return ("#%02x%02x%02x"):format(floor(r), floor(g), floor(b))
+end
+
+-- Calculates the relative luminance of the given color
+local function relative_luminance(color)
+ local r, g, b = hex2rgb(color)
+ local function from_sRGB(u)
+ return u <= 0.0031308 and 25 * u / 323 or ((200 * u + 11) / 211) ^ (12 / 5)
+ end
+ return 0.2126 * from_sRGB(r) + 0.7152 * from_sRGB(g) + 0.0722 * from_sRGB(b)
+end
+
+-- Calculates the contrast ratio between the two given colors
+local function contrast_ratio(fg, bg)
+ return (relative_luminance(fg) + 0.05) / (relative_luminance(bg) + 0.05)
+end
+
+-- Returns true if the contrast between the two given colors is suitable
+local function is_contrast_acceptable(fg, bg)
+ return contrast_ratio(fg, bg) >= 7 and true
+end
+
+-- Returns a bright-ish, saturated-ish, color of random hue
+local function rand_hex(lb_angle, ub_angle)
+ return hsv2hex(random(lb_angle or 0, ub_angle or 360), 70, 90)
+end
+
+-- Rotates the hue of the given hex color by the specified angle (in degrees)
+local function rotate_hue(color, angle)
+ local H, S, V = hex2hsv(color)
+ angle = clip(angle or 0, 0, 360)
+ H = (H + angle) % 360
+ return hsv2hex(H, S, V)
+end
+
+-- Lightens a given hex color by the specified amount
+local function lighten(color, amount)
+ local r, g, b
+ r, g, b = hex2rgb(color)
+ r = 255 * r
+ g = 255 * g
+ b = 255 * b
+ r = r + floor(2.55 * amount)
+ g = g + floor(2.55 * amount)
+ b = b + floor(2.55 * amount)
+ r = r > 255 and 255 or r
+ g = g > 255 and 255 or g
+ b = b > 255 and 255 or b
+ return ("#%02x%02x%02x"):format(r, g, b)
+end
+
+-- Darkens a given hex color by the specified amount
+local function darken(color, amount)
+ local r, g, b
+ r, g, b = hex2rgb(color)
+ r = 255 * r
+ g = 255 * g
+ b = 255 * b
+ r = max(0, r - floor(r * (amount / 100)))
+ g = max(0, g - floor(g * (amount / 100)))
+ b = max(0, b - floor(b * (amount / 100)))
+ return ("#%02x%02x%02x"):format(r, g, b)
+end
+
+return {
+ clip = clip,
+ hex2rgb = hex2rgb,
+ hex2hsv = hex2hsv,
+ hsv2hex = hsv2hex,
+ relative_luminance = relative_luminance,
+ contrast_ratio = contrast_ratio,
+ is_contrast_acceptable = is_contrast_acceptable,
+ rand_hex = rand_hex,
+ rotate_hue = rotate_hue,
+ lighten = lighten,
+ darken = darken,
+}
diff --git a/src/awesome-wm-nice/config.ld b/src/awesome-wm-nice/config.ld
new file mode 100644
index 0000000..2484d5d
--- /dev/null
+++ b/src/awesome-wm-nice/config.ld
@@ -0,0 +1,22 @@
+project = "awesome-wm-nice"
+title = "An Awesome WM module that add MacOS-like window decorations"
+
+all = false
+dir = "doc"
+format = "markdown"
+pretty = "lua"
+prettify_files = true
+backtick_references = true
+merge = true
+use_markdown_titles = true
+wrap = true
+sort_modules = true
+not_luadoc = true
+
+file = {
+ "init.lua",
+}
+
+-- Define some new ldoc tags from the AwesomeWM doc
+new_type("constructorfct", "Constructor", false, "Parameters")
+new_type("staticfct", "Static functions", false, "Parameters")
diff --git a/src/awesome-wm-nice/config.lua b/src/awesome-wm-nice/config.lua
new file mode 100644
index 0000000..38290ca
--- /dev/null
+++ b/src/awesome-wm-nice/config.lua
@@ -0,0 +1,95 @@
+local abutton = require "awful.button"
+local gtable = require "gears.table"
+
+local config = { mt = {}, _private = {} }
+
+-- Titlebar
+config._private.titlebar_height = 38
+config._private.titlebar_radius = 9
+config._private.titlebar_color = "#1E1E24"
+config._private.titlebar_margin_left = 0
+config._private.titlebar_margin_right = 0
+config._private.titlebar_font = "Sans 11"
+config._private.titlebar_items = {
+ left = { "close", "minimize", "maximize" },
+ middle = "title",
+ right = { "sticky", "ontop", "floating" },
+}
+config._private.context_menu_theme = {
+ bg_focus = "#aed9e0",
+ bg_normal = "#5e6472",
+ border_color = "#00000000",
+ border_width = 0,
+ fg_focus = "#242424",
+ fg_normal = "#fefefa",
+ font = "Sans 11",
+ height = 27.5,
+ width = 250,
+}
+config._private.win_shade_enabled = true
+config._private.no_titlebar_maximized = false
+config._private.mb_move = abutton.names.LEFT
+config._private.mb_contextmenu = abutton.names.MIDDLE
+config._private.mb_resize = abutton.names.RIGHT
+config._private.mb_win_shade_rollup = abutton.names.SCROLL_UP
+config._private.mb_win_shade_rolldown = abutton.names.SCROLL_DOWN
+
+-- Titlebar Items
+config._private.button_size = 16
+config._private.button_margin_horizontal = 5
+-- _private.button_margin_vertical
+config._private.button_margin_top = 2
+-- _private.button_margin_bottom = 0
+-- _private.button_margin_left = 0
+-- _private.button_margin_right = 0
+config._private.tooltips_enabled = true
+config._private.tooltip_messages = {
+ close = "close",
+ minimize = "minimize",
+ maximize_active = "unmaximize",
+ maximize_inactive = "maximize",
+ floating_active = "enable tiling mode",
+ floating_inactive = "enable floating mode",
+ ontop_active = "don't keep above other windows",
+ ontop_inactive = "keep above other windows",
+ sticky_active = "disable sticky mode",
+ sticky_inactive = "enable sticky mode",
+}
+config._private.close_color = "#ee4266"
+config._private.minimize_color = "#ffb400"
+config._private.maximize_color = "#4CBB17"
+config._private.floating_color = "#f6a2ed"
+config._private.ontop_color = "#f6a2ed"
+config._private.sticky_color = "#f6a2ed"
+
+function config.init(args)
+ -- properties that are table
+ local table_args = {
+ titlebar_items = true,
+ context_menu_theme = true,
+ tooltip_messages = true,
+ }
+
+ -- Apply changes to our _private properties
+ if args then
+ for prop, value in pairs(args) do
+ if table_args[prop] == true then
+ gtable.crush(config._private[prop], value)
+ elseif prop == "titlebar_radius" then
+ config._private[prop] = math.max(3, value)
+ else
+ config._private[prop] = value
+ end
+ end
+ end
+end
+
+function config.mt:__index(k)
+ return config._private[k]
+end
+
+function config.mt:__newindex(k, v)
+ config._private[k] = v
+end
+
+return setmetatable(config, config.mt)
diff --git a/src/awesome-wm-nice/init.lua b/src/awesome-wm-nice/init.lua
new file mode 100644
index 0000000..33fd1ac
--- /dev/null
+++ b/src/awesome-wm-nice/init.lua
@@ -0,0 +1,472 @@
+--[[
+███╗ ██╗██╗ ██████╗███████╗
+████╗ ██║██║██╔════╝██╔════╝
+██╔██╗ ██║██║██║ █████╗
+██║╚██╗██║██║██║ ██╔══╝
+██║ ╚████║██║╚██████╗███████╗
+╚═╝ ╚═══╝╚═╝ ╚═════╝╚══════╝
+Author: mu-tex
+License: MIT
+Repository: https://github.com/mut-ex/awesome-wm-nice
+]]
+
+local awful = require "awful"
+local abutton = awful.button
+local wibox = require "wibox"
+-- Widgets
+local imagebox = wibox.widget.imagebox
+-- Layouts
+local wlayout = wibox.layout
+local wlayout_align_horizontal = wlayout.align.horizontal
+local wlayout_flex_horizontal = wlayout.flex.horizontal
+-- Containers
+local wcontainer = wibox.container
+local wcontainer_background = wcontainer.background
+local wcontainer_margin = wcontainer.margin
+-- Gears
+local gtimer = require "gears.timer"
+local gtimer_weak_start_new = gtimer.weak_start_new
+local gtable = require "gears.table"
+-- ------------------------------------------------------------
+
+-- => Math + standard Lua methods
+-- ============================================================
+local math = math
+local abs = math.abs
+
+-- ------------------------------------------------------------
+
+-- => LGI
+-- ============================================================
+local lgi = require "lgi"
+local gdk = lgi.require("Gdk", "3.0")
+-- ------------------------------------------------------------
+
+-- => nice
+-- ============================================================
+-- Config
+local config = require "awesome-wm-nice.config"
+-- Colors
+local colors = require "awesome-wm-nice.colors"
+local color_darken = colors.darken
+local color_lighten = colors.lighten
+local relative_luminance = colors.relative_luminance
+-- Client Shade
+local shade = require "awesome-wm-nice.shade"
+-- Shapes
+local shapes = require "awesome-wm-nice.shapes"
+local create_corner_top_left = shapes.create_corner_top_left
+local create_edge_left = shapes.create_edge_left
+local create_edge_top_middle = shapes.create_edge_top_middle
+local gradient = shapes.duotone_gradient_vertical
+-- Utils
+local utils = require "awesome-wm-nice.utils"
+-- Widgets builder
+local widgets = require "awesome-wm-nice.widgets"
+-- ------------------------------------------------------------
+
+gdk.init {}
+
+-- => Local settings
+-- ============================================================
+local bottom_edge_height = 3
+local double_click_jitter_tolerance = 4
+local double_click_time_window_ms = 250
+local stroke_inner_bottom_lighten_mul = 0.4
+local stroke_inner_sides_lighten_mul = 0.4
+local stroke_outer_top_darken_mul = 0.7
+local titlebar_gradient_c1_lighten = 1
+local titlebar_gradient_c2_offset = 0.5
+
+-- ------------------------------------------------------------
+
+local nice = {}
+
+-- => Defaults
+-- ============================================================
+
+-- ------------------------------------------------------------
+
+-- => Saving and loading of color rules
+-- ============================================================
+local t = require "awesome-wm-nice.table"
+
+-- Load the color rules or create an empty table if there aren't any
+local gfilesys = require "gears.filesystem"
+local config_dir = gfilesys.get_configuration_dir()
+local color_rules_filename = "color_rules"
+local color_rules_filepath = config_dir .. "/nice/" .. color_rules_filename
+config.color_rules = t.load(color_rules_filepath) or {}
+
+-- Saves the contents of config.color_rules table to file
+local function save_color_rules()
+ t.save(config.color_rules, color_rules_filepath)
+end
+
+-- Adds a color rule entry to the color_rules table for the given client and saves to file
+local function set_color_rule(c, color)
+ config.color_rules[c.instance] = color
+ save_color_rules()
+end
+
+-- Fetches the color rule for the given client instance
+local function get_color_rule(c)
+ return config.color_rules[c.instance]
+end
+-- ------------------------------------------------------------
+
+function nice.get_titlebar_mouse_bindings(c)
+ local shade_enabled = config.win_shade_enabled
+ -- Add functionality for double click to (un)maximize, and single click and hold to move
+ local clicks = 0
+ local tolerance = double_click_jitter_tolerance
+ local buttons = {
+ abutton({}, config.mb_move, function()
+ local cx, cy = _G.mouse.coords().x, _G.mouse.coords().y
+ local delta = double_click_time_window_ms / 1000
+ clicks = clicks + 1
+ if clicks == 2 then
+ local nx, ny = _G.mouse.coords().x, _G.mouse.coords().y
+ -- The second click is only counted as a double click if it is
+ -- within the neighborhood of the first click's position, and
+ -- occurs within the set time window
+ if abs(cx - nx) <= tolerance and abs(cy - ny) <= tolerance then
+ if shade_enabled then
+ shade.shade_roll_down(c)
+ end
+ c.maximized = not c.maximized
+ end
+ else
+ if shade_enabled and c._nice_window_shade_up then
+ -- shade.shade_roll_down(c)
+ awful.mouse.wibox.move(c._nice_window_shade)
+ else
+ c:activate { context = "titlebar", action = "mouse_move" }
+ end
+ end
+ -- Start a timer to clear the click count
+ gtimer_weak_start_new(delta, function()
+ clicks = 0
+ end)
+ end),
+ abutton({}, config.mb_contextmenu, function()
+ local menu_items = {}
+ local function add_item(text, callback)
+ menu_items[#menu_items + 1] = { text, callback }
+ end
+ -- TODO: Add client control options as menu entries for options that haven't had their buttons added
+ add_item("Redo Window Decorations", function()
+ c._nice_base_color = utils.get_dominant_color(c)
+ set_color_rule(c, c._nice_base_color)
+ nice.add_window_decoration(c)
+ end)
+ add_item("Manually Pick Color", function()
+ _G.mousegrabber.run(function(m)
+ if m.buttons[1] then
+ c._nice_base_color = utils.get_pixel_at(m.x, m.y)
+ set_color_rule(c, c._nice_base_color)
+ nice.add_window_decoration(c)
+ return false
+ end
+ return true
+ end, "crosshair")
+ end)
+ add_item("Nevermind...", function() end)
+ if c._nice_right_click_menu then
+ c._nice_right_click_menu:hide()
+ end
+ c._nice_right_click_menu = awful.menu {
+ items = menu_items,
+ theme = config.context_menu_theme,
+ }
+ c._nice_right_click_menu:show()
+ end),
+ abutton({}, config.mb_resize, function()
+ c:activate { context = "mouse_click", action = "mouse_resize" }
+ end),
+ }
+
+ if config.win_shade_enabled then
+ buttons[#buttons + 1] = abutton({}, config.mb_win_shade_rollup, function()
+ shade.shade_roll_up(c)
+ end)
+ buttons[#buttons + 1] = abutton({}, config.mb_win_shade_rolldown, function()
+ shade.shade_roll_down(c)
+ end)
+ end
+ return buttons
+end
+
+-- ------------------------------------------------------------
+
+-- Puts all the pieces together and decorates the given client
+function nice.add_window_decoration(c)
+ local client_color = c._nice_base_color
+ local client_geometry = c:geometry()
+
+ -- Closures to avoid repitition
+ local lighten = function(amount)
+ return color_lighten(client_color, amount)
+ end
+ local darken = function(amount)
+ return color_darken(client_color, amount)
+ end
+ -- > Color computations
+ local luminance = relative_luminance(client_color)
+ local lighten_amount = utils.rel_lighten(luminance)
+ local darken_amount = utils.rel_darken(luminance)
+ -- Inner strokes
+ local stroke_color_inner_top = lighten(lighten_amount)
+ local stroke_color_inner_sides = lighten(lighten_amount * stroke_inner_sides_lighten_mul)
+ local stroke_color_inner_bottom = lighten(lighten_amount * stroke_inner_bottom_lighten_mul)
+ -- Outer strokes
+ local stroke_color_outer_top = darken(darken_amount * stroke_outer_top_darken_mul)
+ local stroke_color_outer_sides = darken(darken_amount)
+ local stroke_color_outer_bottom = darken(darken_amount)
+ local titlebar_height = config.titlebar_height
+ local background_fill_top =
+ gradient(lighten(titlebar_gradient_c1_lighten), client_color, titlebar_height, 0, titlebar_gradient_c2_offset)
+ -- The top left corner of the titlebar
+ local corner_top_left_img = create_corner_top_left {
+ background_source = background_fill_top,
+ color = client_color,
+ height = titlebar_height,
+ radius = config.titlebar_radius,
+ stroke_offset_inner = 1.5,
+ stroke_width_inner = 1,
+ stroke_offset_outer = 0.5,
+ stroke_width_outer = 1,
+ stroke_source_inner = gradient(stroke_color_inner_top, stroke_color_inner_sides, titlebar_height),
+ stroke_source_outer = gradient(stroke_color_outer_top, stroke_color_outer_sides, titlebar_height),
+ }
+ -- The top right corner of the titlebar
+ local corner_top_right_img = shapes.flip(corner_top_left_img, "horizontal")
+
+ -- The middle part of the titlebar
+ local top_edge = create_edge_top_middle {
+ background_source = background_fill_top,
+ color = client_color,
+ height = titlebar_height,
+ stroke_color_inner = stroke_color_inner_top,
+ stroke_color_outer = stroke_color_outer_top,
+ stroke_offset_inner = 1.25,
+ stroke_offset_outer = 0.5,
+ stroke_width_inner = 2,
+ stroke_width_outer = 1,
+ width = client_geometry.width,
+ }
+ -- Create the titlebar
+ local titlebar = awful.titlebar(c, { size = titlebar_height, bg = "transparent" })
+ -- Arrange the graphics
+ titlebar.widget = {
+ imagebox(corner_top_left_img, false),
+ {
+ {
+ {
+ utils.create_titlebar_items(c, config.titlebar_items.left),
+ widget = wcontainer_margin,
+ left = config.titlebar_margin_left,
+ },
+ {
+ utils.create_titlebar_items(c, config.titlebar_items.middle),
+ buttons = nice.get_titlebar_mouse_bindings(c),
+ layout = wlayout_flex_horizontal,
+ },
+ {
+ utils.create_titlebar_items(c, config.titlebar_items.right),
+ widget = wcontainer_margin,
+ right = config.titlebar_margin_right,
+ },
+ layout = wlayout_align_horizontal,
+ },
+ widget = wcontainer_background,
+ bgimage = top_edge,
+ },
+ imagebox(corner_top_right_img, false),
+ layout = wlayout_align_horizontal,
+ }
+
+ local resize_button = {
+ abutton({}, 1, function()
+ c:activate { context = "mouse_click", action = "mouse_resize" }
+ end),
+ }
+
+ -- The left side border
+ local left_border_img = create_edge_left {
+ client_color = client_color,
+ height = client_geometry.height,
+ stroke_offset_outer = 0.5,
+ stroke_width_outer = 1,
+ stroke_color_outer = stroke_color_outer_sides,
+ stroke_offset_inner = 1.5,
+ stroke_width_inner = 1.5,
+ inner_stroke_color = stroke_color_inner_sides,
+ }
+ -- The right side border
+ local right_border_img = shapes.flip(left_border_img, "horizontal")
+ local left_side_border = awful.titlebar(c, {
+ position = "left",
+ size = 2,
+ bg = client_color,
+ widget = wcontainer_background,
+ })
+ left_side_border:setup {
+ buttons = resize_button,
+ widget = wcontainer_background,
+ bgimage = left_border_img,
+ }
+ local right_side_border = awful.titlebar(c, {
+ position = "right",
+ size = 2,
+ bg = client_color,
+ widget = wcontainer_background,
+ })
+ right_side_border:setup {
+ widget = wcontainer_background,
+ bgimage = right_border_img,
+ buttons = resize_button,
+ }
+ local corner_bottom_left_img = shapes.flip(
+ create_corner_top_left {
+ color = client_color,
+ radius = bottom_edge_height,
+ height = bottom_edge_height,
+ background_source = background_fill_top,
+ stroke_offset_inner = 1.5,
+ stroke_offset_outer = 0.5,
+ stroke_source_outer = gradient(
+ stroke_color_outer_bottom,
+ stroke_color_outer_sides,
+ bottom_edge_height,
+ 0,
+ 0.25
+ ),
+ stroke_source_inner = gradient(stroke_color_inner_bottom, stroke_color_inner_sides, bottom_edge_height),
+ stroke_width_inner = 1.5,
+ stroke_width_outer = 2,
+ },
+ "vertical"
+ )
+ local corner_bottom_right_img = shapes.flip(corner_bottom_left_img, "horizontal")
+ local bottom_edge = shapes.flip(
+ create_edge_top_middle {
+ color = client_color,
+ height = bottom_edge_height,
+ background_source = background_fill_top,
+ stroke_color_inner = stroke_color_inner_bottom,
+ stroke_color_outer = stroke_color_outer_bottom,
+ stroke_offset_inner = 1.25,
+ stroke_offset_outer = 0.5,
+ stroke_width_inner = 1,
+ stroke_width_outer = 1,
+ width = client_geometry.width,
+ },
+ "vertical"
+ )
+ local bottom = awful.titlebar(c, {
+ size = bottom_edge_height,
+ bg = "transparent",
+ position = "bottom",
+ })
+ bottom.widget = wibox.widget {
+ imagebox(corner_bottom_left_img, false),
+ -- {widget = wcontainer_background, bgimage = bottom_edge},
+ imagebox(bottom_edge, false),
+
+ imagebox(corner_bottom_right_img, false),
+ layout = wlayout_align_horizontal,
+ buttons = resize_button,
+ }
+ if config.win_shade_enabled then
+ shade.add_window_shade(c, titlebar.widget, bottom.widget)
+ end
+
+ if config.no_titlebar_maximized then
+ c:connect_signal("property::maximized", function()
+ if c.maximized then
+ local curr_screen_workarea = client.focus.screen.workarea
+ awful.titlebar.hide(c)
+ c.shape = nil
+ c:geometry {
+ x = curr_screen_workarea.x,
+ y = curr_screen_workarea.y,
+ width = curr_screen_workarea.width,
+ height = curr_screen_workarea.height,
+ }
+ else
+ awful.titlebar.show(c)
+ -- Shape the client
+ c.shape = shapes.rounded_rect {
+ tl = config.titlebar_radius,
+ tr = config.titlebar_radius,
+ bl = 4,
+ br = 4,
+ }
+ end
+ end)
+ end
+
+ -- Clean up
+ collectgarbage "collect"
+end
+
+function nice.apply_client_shape(c)
+ c.shape = shapes.rounded_rect {
+ tl = config.titlebar_radius,
+ tr = config.titlebar_radius,
+ bl = 4,
+ br = 4,
+ }
+end
+
+function nice.initialize(args)
+ config.init(args)
+
+ utils.validate_mb_bindings(config)
+
+ _G.client.connect_signal("request::titlebars", function(c)
+ -- Callback
+ c._cb_add_window_decorations = function()
+ gtimer_weak_start_new(0.25, function()
+ c._nice_base_color = utils.get_dominant_color(c)
+ set_color_rule(c, c._nice_base_color)
+ nice.add_window_decoration(c)
+ -- table.save(config, config_dir .. "/nice/private")
+ c:disconnect_signal("request::activate", c._cb_add_window_decorations)
+ end)
+ end -- _cb_add_window_decorations
+
+ -- Check if a color rule already exists...
+ local base_color = get_color_rule(c)
+ if base_color then
+ -- If so, use that color rule
+ c._nice_base_color = base_color
+ nice.add_window_decoration(c)
+ else
+ -- Otherwise use the default titlebar temporarily
+ c._nice_base_color = config.titlebar_color
+ nice.add_window_decoration(c)
+ -- Connect a signal to determine the client color and then re-decorate it
+ c:connect_signal("request::activate", c._cb_add_window_decorations)
+ end
+
+ -- Shape the client
+ nice.apply_client_shape(c)
+ end)
+
+ -- Force the window decoration to be re-created when the client size change.
+ _G.client.connect_signal("property::size", function(c)
+ nice.add_window_decoration(c)
+ end)
+end
+
+return gtable.join(nice, {
+ colors = colors,
+ config = config,
+ shade = shade,
+ shapes = shapes,
+ table = t,
+ utils = utils,
+ widgets = widgets,
+})
diff --git a/src/awesome-wm-nice/shade.lua b/src/awesome-wm-nice/shade.lua
new file mode 100644
index 0000000..4c37de7
--- /dev/null
+++ b/src/awesome-wm-nice/shade.lua
@@ -0,0 +1,79 @@
+local config = require "awesome-wm-nice.config"
+local shapes = require "awesome-wm-nice.shapes"
+local wibox = require "wibox"
+local wlayout_manual = require "wibox.layout.manual"
+
+local shade = {}
+
+-- Legacy global variables
+local bottom_edge_height = 3
+
+-- Adds a window shade to the given client
+function shade.add_window_shade(c, src_top, src_bottom)
+ local geo = c:geometry()
+ local w = wibox()
+ w.width = geo.width
+ w.background = "transparent"
+ w.x = geo.x
+ w.y = geo.y
+ w.height = config.titlebar_height + bottom_edge_height
+ w.ontop = true
+ w.visible = false
+ w.shape = shapes.rounded_rect {
+ tl = config.titlebar_radius,
+ tr = config.titlebar_radius,
+ bl = 4,
+ br = 4,
+ }
+ -- Need to use a manual layout because layout fixed seems to introduce a thin gap
+ src_top.point = { x = 0, y = 0 }
+ src_top.forced_width = geo.width
+ src_bottom.point = { x = 0, y = config.titlebar_height }
+ w.widget = { src_top, src_bottom, layout = wlayout_manual }
+ -- Clean up resources when a client is killed
+ c:connect_signal("request::unmanage", function()
+ if c._nice_window_shade then
+ c._nice_window_shade.visible = false
+ c._nice_window_shade = nil
+ end
+ -- Clean up
+ collectgarbage "collect"
+ end)
+ c._nice_window_shade_up = false
+ c._nice_window_shade = w
+end
+
+-- Shows the window contents
+function shade.shade_roll_down(c)
+ if not c._nice_window_shade_up then
+ return
+ end
+ c:geometry { x = c._nice_window_shade.x, y = c._nice_window_shade.y }
+ c:activate()
+ c._nice_window_shade.visible = false
+ c._nice_window_shade_up = false
+end
+
+-- Hides the window contents
+function shade.shade_roll_up(c)
+ if c._nice_window_shade_up then
+ return
+ end
+ local w = c._nice_window_shade
+ local geo = c:geometry()
+ w.x = geo.x
+ w.y = geo.y
+ w.width = geo.width
+ c.minimized = true
+ w.visible = true
+ w.ontop = true
+ c._nice_window_shade_up = true
+end
+
+-- Toggles the window shade state
+function shade.shade_toggle(c)
+ c.minimized = not c.minimized
+ c._nice_window_shade.visible = c.minimized
+end
+
+return shade
diff --git a/src/awesome-wm-nice/shapes.lua b/src/awesome-wm-nice/shapes.lua
new file mode 100644
index 0000000..294f5b9
--- /dev/null
+++ b/src/awesome-wm-nice/shapes.lua
@@ -0,0 +1,247 @@
+-- => Shapes
+-- Provides utility functions for handling cairo shapes and geometry
+-- ============================================================
+--
+local colors = require "awesome-wm-nice.colors"
+local lgi = require "lgi"
+local hex2rgb = colors.hex2rgb
+local cairo = lgi.cairo
+local math = math
+local rad = math.rad
+
+-- Returns a shape function for a rounded rectangle with independently configurable corner radii
+local function rounded_rect(args)
+ local r1 = args.tl or 0
+ local r2 = args.bl or 0
+ local r3 = args.br or 0
+ local r4 = args.tr or 0
+ return function(cr, width, height)
+ cr:new_sub_path()
+ cr:arc(width - r1, r1, r1, rad(-90), rad(0))
+ cr:arc(width - r2, height - r2, r2, rad(0), rad(90))
+ cr:arc(r3, height - r3, r3, rad(90), rad(180))
+ cr:arc(r4, r4, r4, rad(180), rad(270))
+ cr:close_path()
+ end
+end
+
+-- Returns a circle of the specified size filled with the specified color
+local function circle_filled(color, size)
+ color = color or "#fefefa"
+ local surface = cairo.ImageSurface.create("ARGB32", size, size)
+ local cr = cairo.Context.create(surface)
+ cr:arc(size / 2, size / 2, size / 2, rad(0), rad(360))
+ cr:set_source_rgba(hex2rgb(color))
+ cr.antialias = cairo.Antialias.BEST
+ cr:fill()
+ -- cr:arc(
+ -- size / 2, size / 2, size / 2 - 0.5, rad(135), rad(270))
+ -- cr:set_source_rgba(hex2rgb(darken(color, 25)))
+ -- cr.line_width = 1
+ -- cr:stroke()
+
+ return surface
+end
+
+-- Returns a vertical gradient pattern going from cololr_1 -> color_2
+local function duotone_gradient_vertical(color_1, color_2, height, offset_1, offset_2)
+ local fill_pattern = cairo.Pattern.create_linear(0, 0, 0, height)
+ local r, g, b, a
+ r, g, b, a = hex2rgb(color_1)
+ fill_pattern:add_color_stop_rgba(offset_1 or 0, r, g, b, a)
+ r, g, b, a = hex2rgb(color_2)
+ fill_pattern:add_color_stop_rgba(offset_2 or 1, r, g, b, a)
+ return fill_pattern
+end
+
+-- Returns a horizontal gradient pattern going from cololr_1 -> color_2
+local function duotone_gradient_horizontal(color, width)
+ local fill_pattern = cairo.Pattern.create_linear(0, 0, width, 0)
+ local r, g, b, a
+ r, g, b, a = hex2rgb(color)
+ fill_pattern:add_color_stop_rgba(0, r, g, b, a)
+ r, g, b, a = hex2rgb(color)
+ fill_pattern:add_color_stop_rgba(0.5, r, g, b, a)
+ r, g, b, a = hex2rgb "#00000000"
+ fill_pattern:add_color_stop_rgba(0.6, r, g, b, a)
+ r, g, b, a = hex2rgb(color)
+ fill_pattern:add_color_stop_rgba(0.7, r, g, b, a)
+ r, g, b, a = hex2rgb(color)
+ fill_pattern:add_color_stop_rgba(1, r, g, b, a)
+ return fill_pattern
+end
+
+-- Flips the given surface around the specified axis
+local function flip(surface, axis)
+ local width = surface:get_width()
+ local height = surface:get_height()
+ local flipped = cairo.ImageSurface.create("ARGB32", width, height)
+ local cr = cairo.Context.create(flipped)
+ local source_pattern = cairo.Pattern.create_for_surface(surface)
+ if axis == "horizontal" then
+ source_pattern.matrix = cairo.Matrix { xx = -1, yy = 1, x0 = width }
+ elseif axis == "vertical" then
+ source_pattern.matrix = cairo.Matrix { xx = 1, yy = -1, y0 = height }
+ elseif axis == "both" then
+ source_pattern.matrix = cairo.Matrix {
+ xx = -1,
+ yy = -1,
+ x0 = width,
+ y0 = height,
+ }
+ end
+ cr.source = source_pattern
+ cr:rectangle(0, 0, width, height)
+ cr:paint()
+
+ return flipped
+end
+
+-- Draws the left corner of the titlebar
+local function create_corner_top_left(args)
+ local radius = args.radius
+ local height = args.height
+ local surface = cairo.ImageSurface.create("ARGB32", radius, height)
+ local cr = cairo.Context.create(surface)
+ -- Create the corner shape and fill it with a gradient
+ local radius_offset = 1 -- To soften the corner
+ cr:move_to(0, height)
+ cr:line_to(0, radius - radius_offset)
+ cr:arc(radius + radius_offset, radius + radius_offset, radius, rad(180), rad(270))
+ cr:line_to(radius, height)
+ cr:close_path()
+ cr.source = args.background_source
+ cr.antialias = cairo.Antialias.BEST
+ cr:fill()
+ -- Next add the subtle 3D look
+ local function add_stroke(nargs)
+ local arc_radius = nargs.radius
+ local offset_x = nargs.offset_x
+ local offset_y = nargs.offset_y
+ cr:new_sub_path()
+ cr:move_to(offset_x, height)
+ cr:line_to(offset_x, arc_radius + offset_y)
+ cr:arc(arc_radius + offset_x, arc_radius + offset_y, arc_radius, rad(180), rad(270))
+ cr.source = nargs.source
+ cr.line_width = nargs.width
+ cr.antialias = cairo.Antialias.BEST
+ cr:stroke()
+ end
+ -- Outer dark stroke
+ add_stroke {
+ offset_x = args.stroke_offset_outer,
+ offset_y = args.stroke_offset_outer,
+ radius = radius + 0.5,
+ source = args.stroke_source_outer,
+ width = args.stroke_width_outer,
+ }
+ -- Inner light stroke
+ add_stroke {
+ offset_x = args.stroke_offset_inner,
+ offset_y = args.stroke_offset_inner,
+ radius = radius,
+ width = args.stroke_width_inner,
+ source = args.stroke_source_inner,
+ }
+
+ return surface
+end
+
+-- Draws the middle of the titlebar
+local function create_edge_top_middle(args)
+ local height = args.height
+ local width = args.width
+ local surface = cairo.ImageSurface.create("ARGB32", width, height)
+ local cr = cairo.Context.create(surface)
+ -- Create the background shape and fill it with a gradient
+ cr:rectangle(0, 0, width, height)
+ cr.source = args.background_source
+ cr:fill()
+ -- Then add the light and dark strokes for that 3D look
+ local function add_stroke(stroke_width, stroke_offset, stroke_color)
+ cr:new_sub_path()
+ cr:move_to(0, stroke_offset)
+ cr:line_to(width, stroke_offset)
+ cr.line_width = stroke_width
+ cr:set_source_rgb(hex2rgb(stroke_color))
+ cr:stroke()
+ end
+ -- Inner light stroke
+ add_stroke(
+ args.stroke_width_inner, -- 2
+ args.stroke_offset_inner, -- 1.25
+ args.stroke_color_inner -- color_lighten(client_color, utils.rel_lighten(relative_luminance(client_color)))
+ )
+ -- Outer dark stroke
+ add_stroke(
+ args.stroke_width_outer, -- 1
+ args.stroke_offset_outer, -- 0.5
+ args.stroke_color_outer -- color_darken(client_color, utils.rel_darken(relative_luminance(client_color)) * 0.7)
+ )
+
+ return surface
+end
+
+local function create_edge_left(args)
+ local height = args.height
+ local width = 2
+ -- height = height or 1080
+ local surface = cairo.ImageSurface.create("ARGB32", width, height)
+ local cr = cairo.Context.create(surface)
+ cr:rectangle(0, 0, 2, args.height)
+ cr:set_source_rgb(hex2rgb(args.client_color))
+ cr:fill()
+ -- Inner light stroke
+ cr:new_sub_path()
+ cr:move_to(args.stroke_offset_inner, 0) -- 1/5
+ cr:line_to(args.stroke_offset_inner, height)
+ cr.line_width = args.stroke_width_inner -- 1.5
+ cr:set_source_rgb(hex2rgb(args.inner_stroke_color))
+ cr:stroke()
+ -- Outer dark stroke
+ cr:new_sub_path()
+ cr:move_to(args.stroke_offset_outer, 0)
+ cr:line_to(args.stroke_offset_outer, height)
+ cr.line_width = args.stroke_width_outer -- 1
+ cr:set_source_rgb(hex2rgb(args.stroke_color_outer))
+ cr:stroke()
+
+ return surface
+end
+
+local function set_font(cr, font)
+ cr:set_font_size(font.size)
+ cr:select_font_face(font.font or "Inter", font.italic and 1 or 0, font.bold and 1 or 0)
+end
+
+local function text_label(args)
+ local surface = cairo.ImageSurface.create("ARGB32", 1, 1)
+ local cr = cairo.Context.create(surface)
+ set_font(cr, args.font)
+ local text = args.text
+ local kern = args.font.kerning or 0
+ local ext = cr:text_extents(text)
+ surface = cairo.ImageSurface.create("ARGB32", ext.width + string.len(text) * kern, ext.height)
+ cr = cairo.Context.create(surface)
+ set_font(cr, args.font)
+ cr:move_to(0, ext.height)
+ cr:set_source_rgb(hex2rgb(args.color))
+ -- cr:show_text(text)
+ text:gsub(".", function(c)
+ -- do something with c
+ cr:show_text(c)
+ cr:rel_move_to(kern, 0)
+ end)
+ return surface
+end
+
+return {
+ rounded_rect = rounded_rect,
+ circle_filled = circle_filled,
+ duotone_gradient_vertical = duotone_gradient_vertical,
+ flip = flip,
+ create_corner_top_left = create_corner_top_left,
+ create_edge_top_middle = create_edge_top_middle,
+ create_edge_left = create_edge_left,
+ text_label = text_label,
+}
diff --git a/stylua.toml b/src/awesome-wm-nice/stylua.toml
similarity index 100%
rename from stylua.toml
rename to src/awesome-wm-nice/stylua.toml
diff --git a/src/awesome-wm-nice/table.lua b/src/awesome-wm-nice/table.lua
new file mode 100644
index 0000000..7305b7f
--- /dev/null
+++ b/src/awesome-wm-nice/table.lua
@@ -0,0 +1,108 @@
+--[[
+ Courtesy of: http://lua-users.org/wiki/SaveTableToFile
+]]
+local function exportstring(s)
+ return string.format("%q", s)
+end
+
+-- The Save Function
+local function save(tbl, filename)
+ local charS, charE = " ", "\n"
+ local file, err = io.open(filename, "wb")
+ if err then
+ return err
+ end
+
+ -- Initialize variables for save procedure
+ local tables, lookup = { tbl }, { [tbl] = 1 }
+ file:write("return {" .. charE)
+
+ for idx, t in ipairs(tables) do
+ file:write("-- Table: {" .. idx .. "}" .. charE)
+ file:write("{" .. charE)
+ local thandled = {}
+
+ for i, v in ipairs(t) do
+ thandled[i] = true
+ local stype = type(v)
+ -- only handle value
+ if stype == "table" then
+ if not lookup[v] then
+ table.insert(tables, v)
+ lookup[v] = #tables
+ end
+ file:write(charS .. "{" .. lookup[v] .. "}," .. charE)
+ elseif stype == "string" then
+ file:write(charS .. exportstring(v) .. "," .. charE)
+ elseif stype == "number" then
+ file:write(charS .. tostring(v) .. "," .. charE)
+ end
+ end
+
+ for i, v in pairs(t) do
+ -- escape handled values
+ if not thandled[i] then
+ local str = ""
+ local stype = type(i)
+ -- handle index
+ if stype == "table" then
+ if not lookup[i] then
+ table.insert(tables, i)
+ lookup[i] = #tables
+ end
+ str = charS .. "[{" .. lookup[i] .. "}]="
+ elseif stype == "string" then
+ str = charS .. "[" .. exportstring(i) .. "]="
+ elseif stype == "number" then
+ str = charS .. "[" .. tostring(i) .. "]="
+ end
+
+ if str ~= "" then
+ stype = type(v)
+ -- handle value
+ if stype == "table" then
+ if not lookup[v] then
+ table.insert(tables, v)
+ lookup[v] = #tables
+ end
+ file:write(str .. "{" .. lookup[v] .. "}," .. charE)
+ elseif stype == "string" then
+ file:write(str .. exportstring(v) .. "," .. charE)
+ elseif stype == "number" then
+ file:write(str .. tostring(v) .. "," .. charE)
+ end
+ end
+ end
+ end
+ file:write("}," .. charE)
+ end
+ file:write "}"
+ file:close()
+end
+
+-- The Load Function
+local function load(sfile)
+ local ftables, err = loadfile(sfile)
+ if err then
+ return nil, err
+ end
+ local tables = ftables()
+ for idx = 1, #tables do
+ local tolinki = {}
+ for i, v in pairs(tables[idx]) do
+ if type(v) == "table" then
+ tables[idx][i] = tables[v[1]]
+ end
+ if type(i) == "table" and tables[i[1]] then
+ table.insert(tolinki, { i, tables[i[1]] })
+ end
+ end
+ -- link indices
+ for _, v in ipairs(tolinki) do
+ tables[idx][v[2]], tables[idx][v[1]] = tables[idx][v[1]], nil
+ end
+ end
+ return tables[1]
+end
+
+return { save = save, load = load }
diff --git a/src/awesome-wm-nice/utils.lua b/src/awesome-wm-nice/utils.lua
new file mode 100644
index 0000000..d4b781d
--- /dev/null
+++ b/src/awesome-wm-nice/utils.lua
@@ -0,0 +1,149 @@
+local gsurface = require "gears.surface"
+local lgi = require "lgi"
+local wibox = require "wibox"
+local widgets = require "awesome-wm-nice.widgets"
+local wlayout_fixed = require "wibox.layout.fixed"
+
+local gdk = lgi.require("Gdk", "3.0")
+
+local utils = {}
+
+function utils.rel_lighten(lum)
+ return lum * 90 + 10
+end
+
+function utils.rel_darken(lum)
+ return -(lum * 70) + 100
+end
+
+-- Returns the hex color for the pixel at the given coordinates on the screen
+function utils.get_pixel_at(x, y)
+ local pixbuf = gdk.pixbuf_get_from_window(gdk.get_default_root_window(), x, y, 1, 1)
+ local bytes = pixbuf:get_pixels()
+ return "#" .. bytes:gsub(".", function(c)
+ return ("%02x"):format(c:byte())
+ end)
+end
+
+-- Determines the dominant color of the client's top region
+function utils.get_dominant_color(client)
+ local color
+ -- gsurface(client.content):write_to_png(
+ -- "/home/mutex/nice/" .. client.class .. "_" .. client.instance .. ".png")
+ local pb
+ local bytes
+ local tally = {}
+ local content = gsurface(client.content)
+ local cgeo = client:geometry()
+ local x_offset = 2
+ local y_offset = 2
+ local x_lim = math.floor(cgeo.width / 2)
+ for x_pos = 0, x_lim, 2 do
+ for y_pos = 0, 8, 1 do
+ pb = gdk.pixbuf_get_from_surface(content, x_offset + x_pos, y_offset + y_pos, 1, 1)
+ bytes = pb:get_pixels()
+ color = "#" .. bytes:gsub(".", function(c)
+ return ("%02x"):format(c:byte())
+ end)
+ if not tally[color] then
+ tally[color] = 1
+ else
+ tally[color] = tally[color] + 1
+ end
+ end
+ end
+ local mode
+ local mode_c = 0
+ for kolor, kount in pairs(tally) do
+ if kount > mode_c then
+ mode_c = kount
+ mode = kolor
+ end
+ end
+ color = mode
+ return color
+end
+
+-- Returns a titlebar item
+function utils.get_titlebar_item(c, name)
+ if name == "close" then
+ return widgets.create_titlebar_button(c, name, function()
+ c:kill()
+ end)
+ elseif name == "maximize" then
+ return widgets.create_titlebar_button(c, name, function()
+ c.maximized = not c.maximized
+ end, "maximized")
+ elseif name == "minimize" then
+ return widgets.create_titlebar_button(c, name, function()
+ c.minimized = true
+ end)
+ elseif name == "ontop" then
+ return widgets.create_titlebar_button(c, name, function()
+ c.ontop = not c.ontop
+ end, "ontop")
+ elseif name == "floating" then
+ return widgets.create_titlebar_button(c, name, function()
+ c.floating = not c.floating
+ if c.floating then
+ c.maximized = false
+ end
+ end, "floating")
+ elseif name == "sticky" then
+ return widgets.create_titlebar_button(c, name, function()
+ c.sticky = not c.sticky
+ return c.sticky
+ end, "sticky")
+ elseif name == "title" then
+ return widgets.create_titlebar_title(c)
+ end
+end
+
+-- Creates titlebar items for a given group of item names
+-- group can be a string (=item name) or a table (= array of "item-name"s)
+function utils.create_titlebar_items(c, group)
+ if not group then
+ return nil
+ end
+ if type(group) == "string" then
+ return utils.get_titlebar_item(c, group)
+ end
+ local titlebar_group_items = wibox.widget {
+ layout = wlayout_fixed.horizontal,
+ }
+ local item
+ for _, name in ipairs(group) do
+ item = utils.get_titlebar_item(c, name)
+ if item then
+ titlebar_group_items:add(item)
+ end
+ end
+ return titlebar_group_items
+end
+
+function utils.validate_mb_bindings(private)
+ local action_mbs = {
+ "mb_move",
+ "mb_contextmenu",
+ "mb_resize",
+ "mb_win_shade_rollup",
+ "mb_win_shade_rolldown",
+ }
+ local mb_specified = { false, false, false, false, false }
+ local mb
+ local mb_conflict_test
+ for _, action_mb in ipairs(action_mbs) do
+ mb = private[action_mb]
+ if mb then
+ assert(mb >= 1 and mb <= 5, "Invalid mouse button specified!")
+ mb_conflict_test = mb_specified[mb]
+ if not mb_conflict_test then
+ mb_specified[mb] = action_mb
+ else
+ error(("%s and %s can not be bound to the same mouse button"):format(action_mb, mb_conflict_test))
+ end
+ end
+ end
+end
+
+return utils
diff --git a/src/awesome-wm-nice/widgets.lua b/src/awesome-wm-nice/widgets.lua
new file mode 100644
index 0000000..9ce3450
--- /dev/null
+++ b/src/awesome-wm-nice/widgets.lua
@@ -0,0 +1,201 @@
+local abutton = require "awful.button"
+local atooltip = require "awful.tooltip"
+local colors = require "awesome-wm-nice.colors"
+local config = require "awesome-wm-nice.config"
+local get_font_height = require("beautiful").get_font_height
+local imagebox = require "wibox.widget.imagebox"
+local shapes = require "awesome-wm-nice.shapes"
+local textbox = require "wibox.widget.textbox"
+local wcontainer_constraint = require "wibox.container.constraint"
+local wcontainer_margin = require "wibox.container.margin"
+local wcontainer_place = require "wibox.container.place"
+local wibox = require "wibox"
+
+local widgets = {}
+local cache = {}
+
+-- Legacy global variables
+local title_color_dark = "#242424"
+local title_color_light = "#fefefa"
+local title_unfocused_opacity = 0.7
+
+-- Returns a color that is analogous to the last color returned
+-- To make sure that the "randomly" generated colors look cohesive, only the
+-- first color is truly random, the rest are generated by offseting the hue by
+-- +33 degrees
+local next_color = colors.rand_hex()
+local function get_next_color()
+ local prev_color = next_color
+ next_color = colors.rotate_hue(prev_color, 33)
+ return prev_color
+end
+
+-- Returns (or generates) a button image based on the given params
+function widgets.create_button_image(name, is_focused, event, is_on)
+ local focus_state = is_focused and "focused" or "unfocused"
+ local key_img
+ -- If it is a toggle button, then the key has an extra param
+ if is_on ~= nil then
+ local toggle_state = is_on and "on" or "off"
+ key_img = ("%s_%s_%s_%s"):format(name, toggle_state, focus_state, event)
+ else
+ key_img = ("%s_%s_%s"):format(name, focus_state, event)
+ end
+ -- If an image already exists, then we are done
+ if cache[key_img] then
+ return cache[key_img]
+ end
+ -- The color key just has _color at the end
+ local key_color = key_img .. "_color"
+ -- If the user hasn't provided a color, then we have to generate one
+ if not cache[key_color] then
+ local key_base_color = name .. "_color"
+ -- Maybe the user has at least provided a base color? If not we just pick a pesudo-random color
+ local base_color = config[key_base_color] or get_next_color()
+ cache[key_base_color] = base_color
+ local button_color = base_color
+ local H = colors.hex2hsv(base_color)
+ -- Unfocused buttons are desaturated and darkened (except when they are being hovered over)
+ if not is_focused and event ~= "hover" then
+ button_color = colors.hsv2hex(H, 0, 50)
+ end
+ -- Then the color is lightened if the button is being hovered over, or
+ -- darkened if it is being pressed, otherwise it is left as is
+ button_color = (event == "hover") and colors.lighten(button_color, 25)
+ or (event == "press") and colors.darken(button_color, 25)
+ or button_color
+ -- Save the generate color because why not lol
+ cache[key_color] = button_color
+ end
+ local button_size = config.button_size
+ -- If it is a toggle button, we create an outline instead of a filled shape if it is in off state
+ -- config[key_img] = (is_on ~= nil and is_on == false) and
+ -- shapes.circle_outline(
+ -- config[key_color], button_size,
+ -- config.button_border_width) or
+ -- shapes.circle_filled(
+ -- config[key_color], button_size)
+ cache[key_img] = shapes.circle_filled(cache[key_color], button_size)
+ return cache[key_img]
+end
+
+-- Creates a titlebar button widget
+function widgets.create_titlebar_button(c, name, button_callback, property)
+ local button_img = imagebox(nil, false)
+ if config.tooltips_enabled then
+ local tooltip = atooltip {
+ timer_function = function()
+ local prop = name .. (property and (c[property] and "_active" or "_inactive") or "")
+ return config.tooltip_messages[prop]
+ end,
+ delay_show = 0.5,
+ margins_leftright = 12,
+ margins_topbottom = 6,
+ timeout = 0.25,
+ align = "bottom_right",
+ }
+ tooltip:add_to_object(button_img)
+ end
+ local is_on, is_focused
+ local event = "normal"
+ local function update()
+ is_focused = c.active
+ -- If the button is for a property that can be toggled
+ if property then
+ is_on = c[property]
+ button_img.image = widgets.create_button_image(name, is_focused, event, is_on)
+ else
+ button_img.image = widgets.create_button_image(name, is_focused, event)
+ end
+ end
+ -- Update the button when the client gains/loses focus
+ c:connect_signal("unfocus", update)
+ c:connect_signal("focus", update)
+ -- If the button is for a property that can be toggled, update it accordingly
+ if property then
+ c:connect_signal("property::" .. property, update)
+ end
+ -- Update the button on mouse hover/leave
+ button_img:connect_signal("mouse::enter", function()
+ event = "hover"
+ update()
+ end)
+ button_img:connect_signal("mouse::leave", function()
+ event = "normal"
+ update()
+ end)
+ -- The button is updated on both click and release, but the call back is executed on release
+ button_img.buttons = abutton({}, abutton.names.LEFT, function()
+ event = "press"
+ update()
+ end, function()
+ if button_callback then
+ event = "normal"
+ button_callback()
+ else
+ event = "hover"
+ end
+ update()
+ end)
+ button_img.id = "button_image"
+ update()
+ return wibox.widget {
+ widget = wcontainer_place,
+ {
+ widget = wcontainer_margin,
+ top = config.button_margin_top or config.button_margin_vertical or config.button_margin,
+ bottom = config.button_margin_bottom or config.button_margin_vertical or config.button_margin,
+ left = config.button_margin_left or config.button_margin_horizontal or config.button_margin,
+ right = config.button_margin_right or config.button_margin_horizontal or config.button_margin,
+ {
+ button_img,
+ widget = wcontainer_constraint,
+ height = config.button_size,
+ width = config.button_size,
+ strategy = "exact",
+ },
+ },
+ }
+end
+
+-- Returns a titlebar widget for the given client
+function widgets.create_titlebar_title(c)
+ local client_color = c._nice_base_color
+
+ local title_widget = wibox.widget {
+ align = "center",
+ ellipsize = "middle",
+ opacity = c.active and 1 or title_unfocused_opacity,
+ valign = "center",
+ widget = textbox,
+ }
+
+ local function update()
+ local text_color = colors.is_contrast_acceptable(title_color_light, client_color) and title_color_light
+ or title_color_dark
+ title_widget.markup = ("%s"):format(
+ text_color,
+ config.titlebar_font,
+ c.name
+ )
+ end
+ c:connect_signal("property::name", update)
+ c:connect_signal("unfocus", function()
+ title_widget.opacity = title_unfocused_opacity
+ end)
+ c:connect_signal("focus", function()
+ title_widget.opacity = 1
+ end)
+ update()
+ local titlebar_font_height = get_font_height(config.titlebar_font)
+ local leftover_space = config.titlebar_height - titlebar_font_height
+ local margin_vertical = leftover_space > 1 and leftover_space / 2 or 0
+ return {
+ title_widget,
+ widget = wcontainer_margin,
+ top = margin_vertical,
+ bottom = margin_vertical,
+ }
+end
+
+return widgets
diff --git a/configuration/applications.lua b/src/awesomerc/configuration/applications.lua
similarity index 64%
rename from configuration/applications.lua
rename to src/awesomerc/configuration/applications.lua
index bf4cc29..d10204f 100644
--- a/configuration/applications.lua
+++ b/src/awesomerc/configuration/applications.lua
@@ -7,15 +7,15 @@ applications.browser = "firefox-nightly"
applications.web = "qutebrowser"
applications.open_terminal = function()
- return applications.terminal .. " -e tmux"
+ return applications.terminal .. " -e tmux"
end
applications.open_editor = function(file)
- return applications.terminal .. " -e " .. applications.editor .. " " .. file
+ return applications.terminal .. " -e " .. applications.editor .. " " .. file
end
applications.open_man = function(file)
- return applications.terminal .. " -e man " .. file
+ return applications.terminal .. " -e man " .. file
end
return applications
diff --git a/src/awesomerc/configuration/bindings/client_keybindings.lua b/src/awesomerc/configuration/bindings/client_keybindings.lua
new file mode 100644
index 0000000..02ed748
--- /dev/null
+++ b/src/awesomerc/configuration/bindings/client_keybindings.lua
@@ -0,0 +1,113 @@
+local aclient = require "awful.client"
+local akey = require "awful.key"
+
+local utils = require "awesomerc.configuration.bindings.utils"
+
+local client_keybindings = {
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ key = "f",
+ description = "toggle fullscreen",
+ group = utils.groups.client,
+ on_press = function(client)
+ client.fullscreen = not client.fullscreen
+ client:raise()
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ key = "c",
+ description = "close",
+ group = utils.groups.client,
+ on_press = function(client)
+ client:kill()
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey, utils.mods.control },
+ key = "space",
+ description = "toggle floating",
+ group = utils.groups.client,
+ on_press = aclient.floating.toggle,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey, utils.mods.control },
+ key = "Return",
+ description = "move to master",
+ group = utils.groups.client,
+ on_press = function(client)
+ client:swap(aclient.getmaster())
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ key = "o",
+ description = "move to screen",
+ group = utils.groups.client,
+ on_press = function(client)
+ client:move_to_screen()
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ key = "t",
+ description = "toggle keep on top",
+ group = utils.groups.client,
+ on_press = function(client)
+ client.ontop = not client.ontop
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ key = "n",
+ description = "minimize",
+ group = utils.groups.client,
+ on_press = function(client)
+ -- The client currently has the input focus, so it cannot be
+ -- minimized, since minimized clients can't have the focus.
+ client.minimized = true
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ key = "m",
+ description = "(un)maximize",
+ group = utils.groups.client,
+ on_press = function(client)
+ client.maximized = not client.maximized
+ client:raise()
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey, utils.mods.control },
+ key = "m",
+ description = "(un)maximize vertically",
+ group = utils.groups.client,
+ on_press = function(client)
+ client.maximized_vertical = not client.maximized_vertical
+ client:raise()
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey, utils.mods.shift },
+ key = "m",
+ description = "(un)maximize horizontally",
+ group = utils.groups.client,
+ on_press = function(client)
+ client.maximized_horizontal = not client.maximized_horizontal
+ client:raise()
+ end,
+ },
+}
+
+return client_keybindings
diff --git a/src/awesomerc/configuration/bindings/client_mousebindings.lua b/src/awesomerc/configuration/bindings/client_mousebindings.lua
new file mode 100644
index 0000000..ee5776e
--- /dev/null
+++ b/src/awesomerc/configuration/bindings/client_mousebindings.lua
@@ -0,0 +1,39 @@
+local abutton = require "awful.button"
+
+local utils = require "awesomerc.configuration.bindings.utils"
+
+local mousebindings = {
+ abutton {
+ modifiers = {},
+ button = abutton.names.LEFT,
+ on_press = function(client)
+ client:activate {
+ context = "mouse_click",
+ }
+ end,
+ },
+
+ abutton {
+ modifiers = { utils.mods.modkey },
+ button = abutton.names.LEFT,
+ on_press = function(client)
+ client:activate {
+ context = "mouse_click",
+ action = "mouse_move",
+ }
+ end,
+ },
+
+ abutton {
+ modifiers = { utils.mods.modkey },
+ button = abutton.names.RIGHT,
+ on_press = function(client)
+ client:activate {
+ context = "mouse_click",
+ action = "mouse_resize",
+ }
+ end,
+ },
+}
+
+return mousebindings
diff --git a/src/awesomerc/configuration/bindings/global_keybindings.lua b/src/awesomerc/configuration/bindings/global_keybindings.lua
new file mode 100644
index 0000000..216bd25
--- /dev/null
+++ b/src/awesomerc/configuration/bindings/global_keybindings.lua
@@ -0,0 +1,223 @@
+local aclient = require "awful.client"
+local akey = require "awful.key"
+local aprompt = require "awful.prompt"
+local ascreen = require "awful.screen"
+local aspawn = require "awful.spawn"
+local atag = require "awful.tag"
+local autil = require "awful.util"
+
+local menubar = require "menubar"
+
+local applications = require "awesomerc.configuration.applications"
+local desktop_bar = require "awesomerc.ui.desktop_decoration.bar"
+local hotkeys_popup = require "awesomerc.ui.hotkeys_popup"
+local mymainmenu = require "awesomerc.ui.menu.mymainmenu"
+
+local utils = require "awesomerc.configuration.bindings.utils"
+
+local capi = {
+ awesome = _G.awesome,
+ client = _G.client,
+}
+
+local global_keybindings = {
+
+ -- Awesome
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ key = "s",
+ description = "show help",
+ group = utils.groups.awesome,
+ on_press = function()
+ hotkeys_popup.show_help()
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ key = "w",
+ description = "show main menu",
+ group = utils.groups.awesome,
+ on_press = function()
+ mymainmenu():show()
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey, utils.mods.control },
+ key = "r",
+ description = "reload awesome",
+ group = utils.groups.awesome,
+ on_press = capi.awesome.restart,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey, utils.mods.shift },
+ key = "q",
+ description = "quit awesome",
+ group = utils.groups.awesome,
+ on_press = capi.awesome.quit,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ key = "x",
+ description = "lua execute prompt",
+ group = utils.groups.awesome,
+ on_press = function()
+ aprompt.run {
+ prompt = "Run Lua code: ",
+ textbox = desktop_bar(ascreen.focused()).promptbox.widget,
+ exe_callback = autil.eval,
+ history_path = autil.get_cache_dir() .. "/history_eval",
+ }
+ end,
+ },
+
+ -- Launcher
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ key = "Return",
+ description = "open a terminal",
+ group = utils.groups.launcher,
+ on_press = function()
+ aspawn(applications.open_terminal())
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ key = "r",
+ description = "run prompt",
+ group = utils.groups.launcher,
+ on_press = function()
+ desktop_bar(ascreen.focused()).promptbox:run()
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ key = "p",
+ description = "show the menubar",
+ group = utils.groups.launcher,
+ on_press = function()
+ menubar.show()
+ end,
+ },
+
+ -- Client focus
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ key = "j",
+ group = "client",
+ description = "Focus next client by index",
+ on_press = function()
+ aclient.focus.byidx(1)
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ key = "k",
+ group = "client",
+ description = "Focus previous by index",
+ on_press = function()
+ aclient.focus.byidx(-1)
+ end,
+ },
+
+ -- Layout manipulation
+
+ akey {
+ modifiers = { utils.mods.modkey, utils.mods.shift },
+ key = "j",
+ group = "client",
+ description = "Swap with next client",
+ on_press = function()
+ aclient.swap.byidx(1)
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey, utils.mods.shift },
+ key = "k",
+ group = "client",
+ description = "Swap with previous client",
+ on_press = function()
+ aclient.swap.byidx(-1)
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey, utils.mods.shift },
+ key = "Right",
+ description = "Increase master width factor",
+ group = "client",
+ on_press = function()
+ atag.incmwfact(0.01)
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey, utils.mods.shift },
+ key = "Left",
+ description = "Decrease master width factor",
+ group = "client",
+ on_press = function()
+ atag.incmwfact(-0.01)
+ end,
+ },
+
+ -- Tags manipulation
+
+ akey {
+ modifiers = { utils.mods.modkey },
+ keygroup = akey.keygroup.NUMROW,
+ description = "only view tag",
+ group = "tag",
+ on_press = function(index)
+ local screen = ascreen.focused()
+ local tag = screen.tags[index]
+
+ if tag then
+ tag:view_only()
+ end
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey, utils.mods.control },
+ keygroup = akey.keygroup.NUMROW,
+ description = "toggle tag",
+ group = "tag",
+ on_press = function(index)
+ local screen = ascreen.focused()
+ local tag = screen.tags[index]
+
+ if tag then
+ atag.viewtoggle(tag)
+ end
+ end,
+ },
+
+ akey {
+ modifiers = { utils.mods.modkey, utils.mods.shift },
+ keygroup = akey.keygroup.NUMROW,
+ description = "move focused client to tag",
+ group = "tag",
+ on_press = function(index)
+ local screen = ascreen.focused()
+ local client = capi.client.focus
+ local tag = screen.tags[index]
+
+ if client and tag then
+ client:move_to_tag(tag)
+ end
+ end,
+ },
+}
+
+return global_keybindings
diff --git a/src/awesomerc/configuration/bindings/global_mousebindings.lua b/src/awesomerc/configuration/bindings/global_mousebindings.lua
new file mode 100644
index 0000000..de11e88
--- /dev/null
+++ b/src/awesomerc/configuration/bindings/global_mousebindings.lua
@@ -0,0 +1,28 @@
+local abutton = require "awful.button"
+local atag = require "awful.tag"
+
+local mymainmenu = require "awesomerc.ui.menu.mymainmenu"
+
+local global_mousebindings = {
+ abutton {
+ modifiers = {},
+ button = abutton.names.RIGHT,
+ on_press = function()
+ mymainmenu():toggle()
+ end,
+ },
+
+ abutton {
+ modifiers = {},
+ button = abutton.names.SCROLL_UP,
+ on_press = tag.viewprev,
+ },
+
+ abutton {
+ modifiers = {},
+ button = abutton.names.SCROLL_DOWN,
+ on_press = atag.viewnext,
+ },
+}
+
+return global_mousebindings
diff --git a/src/awesomerc/configuration/bindings/init.lua b/src/awesomerc/configuration/bindings/init.lua
new file mode 100644
index 0000000..0ccff30
--- /dev/null
+++ b/src/awesomerc/configuration/bindings/init.lua
@@ -0,0 +1,9 @@
+local bindings = {}
+
+bindings.client_keybindings = require "awesomerc.configuration.bindings.client_keybindings"
+bindings.client_mousebindings = require "awesomerc.configuration.bindings.client_mousebindings"
+bindings.global_keybindings = require "awesomerc.configuration.bindings.global_keybindings"
+bindings.global_mousebindings = require "awesomerc.configuration.bindings.global_mousebindings"
+bindings.utils = require "awesomerc.configuration.bindings.utils"
+
+return bindings
diff --git a/src/awesomerc/configuration/bindings/utils.lua b/src/awesomerc/configuration/bindings/utils.lua
new file mode 100644
index 0000000..c2d3f76
--- /dev/null
+++ b/src/awesomerc/configuration/bindings/utils.lua
@@ -0,0 +1,16 @@
+local mods = {
+ control = "Control",
+ modkey = "Mod4",
+ shift = "Shift",
+}
+
+local groups = {
+ client = "client",
+ awesome = "awesome",
+ launcher = "launcher",
+}
+
+return {
+ mods = mods,
+ groups = groups,
+}
diff --git a/src/awesomerc/configuration/init.lua b/src/awesomerc/configuration/init.lua
new file mode 100644
index 0000000..16178e4
--- /dev/null
+++ b/src/awesomerc/configuration/init.lua
@@ -0,0 +1,10 @@
+local rc_configuration = {}
+
+rc_configuration.applications = require "awesomerc.configuration.applications"
+rc_configuration.bindings = require "awesomerc.configuration.bindings"
+rc_configuration.menu = require "awesomerc.configuration.menu"
+rc_configuration.rules = require "awesomerc.configuration.rules"
+rc_configuration.prompt_commands = require "awesomerc.configuration.prompt_commands"
+rc_configuration.tag_layouts = require "awesomerc.configuration.tag_layouts"
+
+return rc_configuration
diff --git a/src/awesomerc/configuration/menu/init.lua b/src/awesomerc/configuration/menu/init.lua
new file mode 100644
index 0000000..baa692a
--- /dev/null
+++ b/src/awesomerc/configuration/menu/init.lua
@@ -0,0 +1,6 @@
+local configuration_menu = {}
+
+configuration_menu.myawesomemenu = require "awesomerc.configuration.menu.myawesomemenu"
+configuration_menu.mymainmenu = require "awesomerc.configuration.menu.mymainmenu"
+
+return configuration_menu
diff --git a/src/awesomerc/configuration/menu/myawesomemenu.lua b/src/awesomerc/configuration/menu/myawesomemenu.lua
new file mode 100644
index 0000000..099576b
--- /dev/null
+++ b/src/awesomerc/configuration/menu/myawesomemenu.lua
@@ -0,0 +1,31 @@
+local applications = require "awesomerc.configuration.applications"
+local hotkeys_popup = require "awesomerc.ui.hotkeys_popup"
+
+local capi = {
+ awesome = _G.awesome,
+}
+
+local myawesomemenu = {
+ {
+ "hotkeys",
+ function()
+ hotkeys_popup.show_help()
+ end,
+ },
+ { "manual", applications.open_man "awesome" },
+ { "edit config", applications.open_editor(capi.awesome.conffile) },
+ {
+ "restart",
+ function()
+ capi.awesome.restart()
+ end,
+ },
+ {
+ "quit",
+ function()
+ capi.awesome.quit()
+ end,
+ },
+}
+
+return myawesomemenu
diff --git a/src/awesomerc/configuration/menu/mymainmenu.lua b/src/awesomerc/configuration/menu/mymainmenu.lua
new file mode 100644
index 0000000..95a5010
--- /dev/null
+++ b/src/awesomerc/configuration/menu/mymainmenu.lua
@@ -0,0 +1,11 @@
+local beautiful = require "beautiful"
+
+local applications = require "awesomerc.configuration.applications"
+local myawesomemenu = require "awesomerc.configuration.menu.myawesomemenu"
+
+local mymainmenu = {
+ { "awesome", myawesomemenu, beautiful.awesome_icon },
+ { "open terminal", applications.terminal },
+}
+
+return mymainmenu
diff --git a/src/awesomerc/configuration/prompt_commands.lua b/src/awesomerc/configuration/prompt_commands.lua
new file mode 100644
index 0000000..bbd45b3
--- /dev/null
+++ b/src/awesomerc/configuration/prompt_commands.lua
@@ -0,0 +1,52 @@
+local atag = require "awful.tag"
+local layout_suit = require "awful.layout.suit"
+
+local commands = {}
+
+commands["o"] = {
+ callback = function(parameters)
+ local tag_name = parameters[1] or "New-Tag"
+
+ atag
+ .add(tag_name, {
+ layout = layout_suit.tile,
+ })
+ :view_only()
+ end,
+}
+
+commands["O"] = {
+ callback = function(parameters)
+ local aspawn = require "awful.spawn"
+
+ local application = parameters[1]
+ local tag_name = parameters[2] or application
+
+ local t = atag.add(tag_name, {
+ layout = layout_suit.tile,
+ volatile = true,
+ })
+ t:view_only()
+ aspawn(application, { tag = t })
+ end,
+}
+
+commands["q"] = {
+ callback = function()
+ local ascreen = require "awful.screen"
+
+ local tags = ascreen.focused().selected_tags
+
+ for _, tag in ipairs(tags) do
+ tag.volatile = true
+
+ for _, client in ipairs(tag:clients()) do
+ client:kill()
+ end
+
+ tag:delete()
+ end
+ end,
+}
+
+return commands
diff --git a/src/awesomerc/configuration/rules/client/firefox.lua b/src/awesomerc/configuration/rules/client/firefox.lua
new file mode 100644
index 0000000..0954049
--- /dev/null
+++ b/src/awesomerc/configuration/rules/client/firefox.lua
@@ -0,0 +1,7 @@
+local firefox_rule = {
+ id = "firefox",
+ rule = { class = "Firefox" },
+ properties = { screen = 1, tag = "2" },
+}
+
+return firefox_rule
diff --git a/src/awesomerc/configuration/rules/client/floating.lua b/src/awesomerc/configuration/rules/client/floating.lua
new file mode 100644
index 0000000..f307fa3
--- /dev/null
+++ b/src/awesomerc/configuration/rules/client/floating.lua
@@ -0,0 +1,28 @@
+local floating_rule = {
+ id = "floating",
+ rule_any = {
+ instance = { "copyq", "pinentry" },
+ class = {
+ "Arandr",
+ "Blueman-manager",
+ "Gpick",
+ "Kruler",
+ "Sxiv",
+ "Tor Browser",
+ "Wpa_gui",
+ "veromix",
+ "xtightvncviewer",
+ },
+ 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 },
+}
+
+return floating_rule
diff --git a/src/awesomerc/configuration/rules/client/global.lua b/src/awesomerc/configuration/rules/client/global.lua
new file mode 100644
index 0000000..f8dee74
--- /dev/null
+++ b/src/awesomerc/configuration/rules/client/global.lua
@@ -0,0 +1,16 @@
+local aclient = require "awful.client"
+local aplacement = require "awful.placement"
+local ascreen = require "awful.screen"
+
+local global_rule = {
+ id = "global",
+ rule = {},
+ properties = {
+ focus = aclient.focus.filter,
+ raise = true,
+ screen = ascreen.preferred,
+ placement = aplacement.no_overlap + aplacement.no_offscreen,
+ },
+}
+
+return global_rule
diff --git a/src/awesomerc/configuration/rules/client/init.lua b/src/awesomerc/configuration/rules/client/init.lua
new file mode 100644
index 0000000..eb81f5f
--- /dev/null
+++ b/src/awesomerc/configuration/rules/client/init.lua
@@ -0,0 +1,8 @@
+local client_rules = {}
+
+client_rules.global = require "awesomerc.configuration.rules.client.global"
+client_rules.floating = require "awesomerc.configuration.rules.client.floating"
+client_rules.titlebar = require "awesomerc.configuration.rules.client.titlebars"
+-- client_rules.firefox = require 'awesomerc.configuration.rules.client.firefox'
+
+return client_rules
diff --git a/src/awesomerc/configuration/rules/client/titlebars.lua b/src/awesomerc/configuration/rules/client/titlebars.lua
new file mode 100644
index 0000000..631d885
--- /dev/null
+++ b/src/awesomerc/configuration/rules/client/titlebars.lua
@@ -0,0 +1,9 @@
+local titlebar_rule = {
+ id = "titlebars",
+ rule_any = {
+ type = { "normal", "dialog" },
+ },
+ properties = { titlebars_enabled = true },
+}
+
+return titlebar_rule
diff --git a/src/awesomerc/configuration/rules/init.lua b/src/awesomerc/configuration/rules/init.lua
new file mode 100644
index 0000000..962edb0
--- /dev/null
+++ b/src/awesomerc/configuration/rules/init.lua
@@ -0,0 +1,6 @@
+local rules = {}
+
+rules.client = require "awesomerc.configuration.rules.client"
+rules.notification = require "awesomerc.configuration.rules.notification"
+
+return rules
diff --git a/src/awesomerc/configuration/rules/notification/global.lua b/src/awesomerc/configuration/rules/notification/global.lua
new file mode 100644
index 0000000..1e3149f
--- /dev/null
+++ b/src/awesomerc/configuration/rules/notification/global.lua
@@ -0,0 +1,11 @@
+local ascreen = require "awful.screen"
+
+local global_rule = {
+ rule = {},
+ properties = {
+ screen = ascreen.preferred,
+ implicit_timeout = 5,
+ },
+}
+
+return global_rule
diff --git a/src/awesomerc/configuration/rules/notification/init.lua b/src/awesomerc/configuration/rules/notification/init.lua
new file mode 100644
index 0000000..b31518c
--- /dev/null
+++ b/src/awesomerc/configuration/rules/notification/init.lua
@@ -0,0 +1,5 @@
+local notification_rules = {}
+
+notification_rules.global = require "awesomerc.configuration.rules.notification.global"
+
+return notification_rules
diff --git a/src/awesomerc/configuration/tag_layouts.lua b/src/awesomerc/configuration/tag_layouts.lua
new file mode 100644
index 0000000..46776be
--- /dev/null
+++ b/src/awesomerc/configuration/tag_layouts.lua
@@ -0,0 +1,19 @@
+local alayout = require "awful.layout"
+
+local tag_layouts = {
+ alayout.suit.floating,
+ alayout.suit.tile,
+ alayout.suit.tile.left,
+ alayout.suit.tile.bottom,
+ alayout.suit.tile.top,
+ alayout.suit.fair,
+ alayout.suit.fair.horizontal,
+ alayout.suit.spiral,
+ alayout.suit.spiral.dwindle,
+ alayout.suit.max,
+ alayout.suit.max.fullscreen,
+ alayout.suit.magnifier,
+ alayout.suit.corner.nw,
+}
+
+return tag_layouts
diff --git a/src/awesomerc/init.lua b/src/awesomerc/init.lua
new file mode 100644
index 0000000..8ea0644
--- /dev/null
+++ b/src/awesomerc/init.lua
@@ -0,0 +1,162 @@
+local gtimer = require "gears.timer" -- cspell:ignore gtimer
+local legacy = require "awesome-legacy"
+local naughty = require "naughty"
+local ruled = require "ruled"
+local slot = require "awesome-slot"
+
+-- Load global awesome components from the C API
+local capi = {
+ client = _G.client,
+ screen = _G.screen,
+ tag = _G.tag,
+}
+
+-- Beautiful needs to be initialized as soon as possible to make theme
+-- variables available to the configuration module.
+legacy.beautiful {
+ base = "default",
+ theme = require "awesomerc.theme",
+}
+
+legacy.manage_error()
+legacy.autofocus()
+legacy.sloppy_focus()
+
+local configuration = require "awesomerc.configuration"
+local my_slots = require "awesomerc.slots"
+
+-- This needs to be run after awesome has completed C API initialization and
+-- the `root` object is available.
+gtimer.delayed_call(function()
+ legacy.global_mouse_bindings(configuration.bindings.global_mousebindings)
+ legacy.global_keybindings(configuration.bindings.global_keybindings)
+end)
+
+-- luacheck: ignore unused variable load_wallpaper
+local load_wallpaper = slot {
+ id = "LOAD_WALLPAPER",
+ connect = true,
+ target = capi.screen,
+ signal = "request::wallpaper",
+ slot = my_slots.wallpaper,
+}
+
+-- luacheck: ignore unused variable default_layout
+local default_layout = slot {
+ id = "DEFAULT_LAYOUTS",
+ connect = true,
+ target = capi.tag,
+ signal = "request::default_layouts",
+ slot = slot.slots.tag.default_layouts,
+ slot_params = {
+ layouts = configuration.tag_layouts,
+ },
+}
+
+-- luacheck: ignore unused variable create_tag
+local create_tag = slot {
+ id = "CREATE_TAGS",
+ connect = true,
+ target = capi.screen,
+ signal = "request::desktop_decoration",
+ slot = my_slots.create_tags,
+}
+
+-- luacheck: ignore unused variable desktop_decoration
+local desktop_decoration = slot {
+ id = "DESKTOP_DECORATION",
+ connect = true,
+ target = capi.screen,
+ signal = "request::desktop_decoration",
+ slot = my_slots.build_desktop_decoration,
+}
+
+-- luacheck: ignore unused variable client_mousebinding
+local client_mousebinding = slot {
+ id = "CLIENT_MOUSE_BINDINGS",
+ connect = true,
+ target = capi.client,
+ signal = "request::default_mousebindings",
+ slot = slot.slots.client.append_mousebindings,
+ slot_params = {
+ mousebindings = configuration.bindings.client_mousebindings,
+ },
+}
+
+-- luacheck: ignore unused variable client_keybinding
+local client_keybinding = slot {
+ id = "CLIENT_KEY_BINDINGS",
+ connect = true,
+ target = capi.client,
+ signal = "request::default_keybindings",
+ slot = slot.slots.client.append_keybindings,
+ slot_params = {
+ keybindings = configuration.bindings.client_keybindings,
+ },
+}
+
+-- luacheck: ignore unused variable ruled_client
+local ruled_client = slot {
+ id = "RULED_CLIENT",
+ connect = true,
+ target = ruled.client,
+ signal = "request::rules",
+ slot = slot.slots.ruled.append_client_rules,
+ slot_params = {
+ rules = configuration.rules.client,
+ },
+}
+
+-- luacheck: ignore unused variable client_titlebar
+local client_titlebar = slot {
+ id = "CLIENT_TITLEBAR",
+ connect = true,
+ target = capi.client,
+ signal = "request::titlebars",
+ slot = my_slots.build_titlebars,
+}
+
+gtimer.delayed_call(function()
+ local nice_config = require "awesome-wm-nice.config"
+ local nice_utils = require "awesome-wm-nice.utils"
+
+ nice_config.init()
+ nice_utils.validate_mb_bindings(nice_config)
+end)
+
+-- luacheck: ignore unused variable client_shape
+local client_shape = slot {
+ id = "CLIENT_SHAPE",
+ connect = true,
+ target = capi.client,
+ signal = "request::manage",
+ slot = my_slots.client_shape,
+}
+
+-- luacheck: ignore unused variable ruled_notification
+local ruled_notification = slot {
+ id = "RULED_NOTIFICATION",
+ connect = true,
+ target = ruled.notification,
+ signal = "request::rules",
+ slot = slot.slots.ruled.append_notification_rules,
+ slot_params = {
+ rules = configuration.rules.notification,
+ },
+}
+
+-- luacheck: ignore unused variable naughty_display
+local naughty_display = slot {
+ id = "NAUGHTY_DISPLAY",
+ connect = true,
+ target = naughty,
+ signal = "request::display",
+ slot = my_slots.naughty_display,
+}
+
+gtimer.delayed_call(function()
+ naughty.notify {
+ title = "Aire-One dots",
+ message = "Welcome to the Aire-One rc!",
+ }
+end)
diff --git a/src/awesomerc/slots/init.lua b/src/awesomerc/slots/init.lua
new file mode 100644
index 0000000..4d95cbf
--- /dev/null
+++ b/src/awesomerc/slots/init.lua
@@ -0,0 +1,86 @@
+local alayout = require "awful.layout"
+local atag = require "awful.tag"
+local awallpaper = require "awful.wallpaper"
+local beautiful = require "beautiful"
+local desktop_bar = require "awesomerc.ui.desktop_decoration.bar"
+local gcolor = require "gears.color"
+local gsurface = require "gears.surface"
+local gtimer = require "gears.timer"
+local imagebox = require "wibox.widget.imagebox"
+local lgi = require "lgi"
+local naughty = require "naughty"
+local nice_shapes = require "awesome-wm-nice.shapes"
+local titlebar = require "awesomerc.ui.titlebar"
+
+local cairo = lgi.cairo
+
+local slots = {}
+
+function slots.wallpaper(screen)
+ local screen_geo = screen.geometry
+ local source = cairo.ImageSurface(cairo.Format.RGB32, screen_geo.width, screen_geo.height)
+ local cr = cairo.Context(source)
+
+ -- Load base image
+ local image_surface = gsurface.load_uncached(beautiful.wallpaper)
+ local w, h = gsurface.get_size(image_surface)
+ cr:scale(screen_geo.width / w, screen_geo.height / h)
+ cr:set_source_surface(image_surface, 0, 0)
+ cr:paint()
+
+ -- Add color layer
+ local color_pattern = gcolor.create_linear_pattern {
+ from = { 0, 0 },
+ to = { screen.width, screen.height },
+ stops = {
+ { 0, "#26323840" },
+ },
+ }
+ cr:set_source(color_pattern)
+ cr:paint()
+
+ awallpaper {
+ screen = screen,
+ widget = {
+ image = source,
+ widget = imagebox,
+ },
+ }
+end
+
+function slots.create_tags(screen)
+ local first_tag = atag.add("home", {
+ screen = screen,
+ layout = alayout.suit.tile,
+ icon = beautiful.icon_hometag,
+ gap = beautiful.gaps_hometag,
+ })
+
+ gtimer.delayed_call(function()
+ first_tag:view_only()
+ -- spawn(apps.open_terminal(), { screen = screen, tag = first_tag })
+ end)
+end
+
+function slots.build_desktop_decoration(screen)
+ desktop_bar(screen)
+end
+
+function slots.build_titlebars(client)
+ titlebar(client)
+end
+
+function slots.client_shape(client)
+ client.shape = nice_shapes.rounded_rect {
+ tl = beautiful.client_corner_radius_top,
+ tr = beautiful.client_corner_radius_top,
+ bl = beautiful.client_corner_radius_bottom,
+ br = beautiful.client_corner_radius_bottom,
+ }
+end
+
+function slots.naughty_display(notification)
+ naughty.layout.box { notification = notification }
+end
+
+return slots
diff --git a/theme/init.lua b/src/awesomerc/theme/init.lua
similarity index 82%
rename from theme/init.lua
rename to src/awesomerc/theme/init.lua
index 0b5235e..9bf5b82 100644
--- a/theme/init.lua
+++ b/src/awesomerc/theme/init.lua
@@ -1,17 +1,18 @@
local gfs = require "gears.filesystem"
local config_dir = gfs.get_configuration_dir()
-local theme_dir = config_dir .. "theme/"
-local assets_dir = theme_dir .. "assets/"
+local assets_dir = config_dir .. "assets/"
local icons_dir = assets_dir .. "icons/"
local theme = {}
--- Basic
theme.font = "Noto Mono 9"
+theme.border_width = 0
---- Tags
-theme.hometag_master_width_factor = 0.65
+--- Clients
+theme.client_corner_radius_top = 9
+theme.client_corner_radius_bottom = 4
--- Icons
theme.icon_hometag = icons_dir .. "home-circle.svg"
@@ -32,7 +33,7 @@ theme.wibar_bg = "#0000"
--- Spacing and margins
-- Naming convention:
---