.gitignore

@@ -151,6 +151,3 @@ Temporary Items
 # awesome widgets/modules/etc that should not be included
 awesome/awesome-wm-widgets/
 awesome/cyclefocus/
-
-# VS Code
-.vscode/

alacritty/alacritty.yml

@@ -1,9 +1,19 @@
+# Configuration for Alacritty, the GPU enhanced terminal emulator.
+
 # Import additional configuration files
+#
+# Imports are loaded in order, skipping all missing files, with the importing
+# file being loaded last. If a field is already present in a previous import, it
+# will be replaced.
+#
+# All imports must either be absolute paths starting with `/`, or paths relative
+# to the user's home directory starting with `~/`.
 import:
   - ~/.config/alacritty/style_spaceship.yml
 
 # Any items in the `env` entry below will be added as
-# environment variables.
+# environment variables. Some entries may override variables
+# set by alacritty itself.
 env:
   TERM: alacritty
 
@@ -12,9 +22,29 @@ window:
     columns: 65
     lines: 18
 
-  startup_mode: Windowed
+  # Window position (changes require restart)
+  #
+  # Specified in number of pixels.
+  # If the position is not set, the window manager will handle the placement.
+  #position:
+  #  x: 0
+  #  y: 0
 
+  # Startup Mode (changes require restart)
+  #
+  # Values for `startup_mode`:
+  #   - Windowedhttps://raw.githubusercontent.com/alacritty/alacritty/master/alacritty.yml
+  #   - Maximized
+  #   - Fullscreen
+  #
+  # Values for `startup_mode` (macOS only):
+  #   - SimpleFullscreen
+  #startup_mode: Windowed
+
+  # Window title
   title: Alacritty
+
+  # Allow terminal applications to change Alacritty's window title.
   dynamic_title: true
 
   # Window class (Linux/BSD only):
@@ -24,6 +54,8 @@ window:
     # General application class
     general: Alacritty
 
+  # Decorations theme variant
+  #
   # Override the variant of the System theme/GTK theme/Wayland client side
   # decorations. Commonly supported values are `Dark`, `Light`, and `None` for
   # auto pick-up. Set this to `None` to use the default theme variant.
@@ -33,6 +65,8 @@ scrolling:
   history: 150
   transparent_background_colors: true
 
+# Bell
+#
 # The bell is rung every time the BEL control character is received.
 #bell:
   # Visual Bell Animation
@@ -80,32 +114,72 @@ scrolling:
   # When set to `true`, selected text will be copied to the primary clipboard.
   #save_to_clipboard: false
 
-cursor:
+#cursor:
-  style:
+  # Cursor style
-    shape: Block
+  #style:
+    # Cursor shape
+    #
+    # Values for `shape`:
+    #   - ▇ Block
+    #   - _ Underline
+    #   - | Beam
+    #shape: Block
 
     # Cursor blinking state
+    #
+    # Values for `blinking`:
     #   - Never: Prevent the cursor from ever blinking
     #   - Off: Disable blinking by default
     #   - On: Enable blinking by default
     #   - Always: Force the cursor to always blink
-    blinking: On
+    #blinking: Off
+
+  # Vi mode cursor style
+  #
+  # If the vi mode cursor style is `None` or not specified, it will fall back to
+  # the style of the active value of the normal cursor.
+  #
+  # See `cursor.style` for available options.
+  #vi_mode_style: None
 
   # Cursor blinking interval in milliseconds.
-  blink_interval: 750
+  #blink_interval: 750
 
   # Time after which cursor stops blinking, in seconds.
-  blink_timeout: 5
+  #
+  # Specifying '0' will disable timeout for blinking.
+  #blink_timeout: 5
 
   # If this is `true`, the cursor will be rendered as a hollow box when the
   # window is not focused.
-  #unfocused_hollow: false
+  #unfocused_hollow: true
 
   # Thickness of the cursor relative to the cell width as floating point number
   # from `0.0` to `1.0`.
   #thickness: 0.15
 
-live_config_reload: true
+# Live config reload (changes require restart)
+#live_config_reload: true
+
+# Shell
+#
+# You can set `shell.program` to the path of your favorite shell, e.g.
+# `/bin/fish`. Entries in `shell.args` are passed unmodified as arguments to the
+# shell.
+#
+# Default:
+#   - (Linux/BSD/macOS) `$SHELL` or the user's login shell, if `$SHELL` is unset
+#   - (Windows) powershell
+#shell:
+#  program: /bin/bash
+#  args:
+#    - --login
+
+# Startup directory
+#
+# Directory the shell is started in. If this is unset, or `None`, the working
+# directory of the parent process will be used.
+#working_directory: None
 
 # Offer IPC using `alacritty msg` (unix only)
 #ipc_socket: true
@@ -205,6 +279,215 @@ live_config_reload: true
 #  - { mouse: Right,  mods: Control, action: ExpandSelection }
 #  - { mouse: Middle, mode: ~Vi,     action: PasteSelection  }
 
+# Key bindings
+#
+# Key bindings are specified as a list of objects. For example, this is the
+# default paste binding:
+#
+# `- { key: V, mods: Control|Shift, action: Paste }`
+#
+# Each key binding will specify a:
+#
+# - `key`: Identifier of the key pressed
+#
+#    - A-Z
+#    - F1-F24
+#    - Key0-Key9
+#
+#    A full list with available key codes can be found here:
+#    https://docs.rs/winit/*/winit/event/enum.VirtualKeyCode.html#variants
+#
+#    Instead of using the name of the keys, the `key` field also supports using
+#    the scancode of the desired key. Scancodes have to be specified as a
+#    decimal number. This command will allow you to display the hex scancodes
+#    for certain keys:
+#
+#       `showkey --scancodes`.
+#
+# Then exactly one of:
+#
+# - `chars`: Send a byte sequence to the running application
+#
+#    The `chars` field writes the specified string to the terminal. This makes
+#    it possible to pass escape sequences. To find escape codes for bindings
+#    like `PageUp` (`"\x1b[5~"`), you can run the command `showkey -a` outside
+#    of tmux. Note that applications use terminfo to map escape sequences back
+#    to keys. It is therefore required to update the terminfo when changing an
+#    escape sequence.
+#
+# - `action`: Execute a predefined action
+#
+#   - ToggleViMode
+#   - SearchForward
+#       Start searching toward the right of the search origin.
+#   - SearchBackward
+#       Start searching toward the left of the search origin.
+#   - Copy
+#   - Paste
+#   - IncreaseFontSize
+#   - DecreaseFontSize
+#   - ResetFontSize
+#   - ScrollPageUp
+#   - ScrollPageDown
+#   - ScrollHalfPageUp
+#   - ScrollHalfPageDown
+#   - ScrollLineUp
+#   - ScrollLineDown
+#   - ScrollToTop
+#   - ScrollToBottom
+#   - ClearHistory
+#       Remove the terminal's scrollback history.
+#   - Hide
+#       Hide the Alacritty window.
+#   - Minimize
+#       Minimize the Alacritty window.
+#   - Quit
+#       Quit Alacritty.
+#   - ToggleFullscreen
+#   - ToggleMaximized
+#   - SpawnNewInstance
+#       Spawn a new instance of Alacritty.
+#   - CreateNewWindow
+#       Create a new Alacritty window from the current process.
+#   - ClearLogNotice
+#       Clear Alacritty's UI warning and error notice.
+#   - ClearSelection
+#       Remove the active selection.
+#   - ReceiveChar
+#   - None
+#
+# - Vi mode exclusive actions:
+#
+#   - Open
+#       Perform the action of the first matching hint under the vi mode cursor
+#       with `mouse.enabled` set to `true`.
+#   - ToggleNormalSelection
+#   - ToggleLineSelection
+#   - ToggleBlockSelection
+#   - ToggleSemanticSelection
+#       Toggle semantic selection based on `selection.semantic_escape_chars`.
+#   - CenterAroundViCursor
+#       Center view around vi mode cursor
+#
+# - Vi mode exclusive cursor motion actions:
+#
+#   - Up
+#       One line up.
+#   - Down
+#       One line down.
+#   - Left
+#       One character left.
+#   - Right
+#       One character right.
+#   - First
+#       First column, or beginning of the line when already at the first column.
+#   - Last
+#       Last column, or beginning of the line when already at the last column.
+#   - FirstOccupied
+#       First non-empty cell in this terminal row, or first non-empty cell of
+#       the line when already at the first cell of the row.
+#   - High
+#       Top of the screen.
+#   - Middle
+#       Center of the screen.
+#   - Low
+#       Bottom of the screen.
+#   - SemanticLeft
+#       Start of the previous semantically separated word.
+#   - SemanticRight
+#       Start of the next semantically separated word.
+#   - SemanticLeftEnd
+#       End of the previous semantically separated word.
+#   - SemanticRightEnd
+#       End of the next semantically separated word.
+#   - WordLeft
+#       Start of the previous whitespace separated word.
+#   - WordRight
+#       Start of the next whitespace separated word.
+#   - WordLeftEnd
+#       End of the previous whitespace separated word.
+#   - WordRightEnd
+#       End of the next whitespace separated word.
+#   - Bracket
+#       Character matching the bracket at the cursor's location.
+#   - SearchNext
+#       Beginning of the next match.
+#   - SearchPrevious
+#       Beginning of the previous match.
+#   - SearchStart
+#       Start of the match to the left of the vi mode cursor.
+#   - SearchEnd
+#       End of the match to the right of the vi mode cursor.
+#
+# - Search mode exclusive actions:
+#   - SearchFocusNext
+#       Move the focus to the next search match.
+#   - SearchFocusPrevious
+#       Move the focus to the previous search match.
+#   - SearchConfirm
+#   - SearchCancel
+#   - SearchClear
+#       Reset the search regex.
+#   - SearchDeleteWord
+#       Delete the last word in the search regex.
+#   - SearchHistoryPrevious
+#       Go to the previous regex in the search history.
+#   - SearchHistoryNext
+#       Go to the next regex in the search history.
+#
+# - macOS exclusive actions:
+#   - ToggleSimpleFullscreen
+#       Enter fullscreen without occupying another space.
+#
+# - Linux/BSD exclusive actions:
+#
+#   - CopySelection
+#       Copy from the selection buffer.
+#   - PasteSelection
+#       Paste from the selection buffer.
+#
+# - `command`: Fork and execute a specified command plus arguments
+#
+#    The `command` field must be a map containing a `program` string and an
+#    `args` array of command line parameter strings. For example:
+#       `{ program: "alacritty", args: ["-e", "vttest"] }`
+#
+# And optionally:
+#
+# - `mods`: Key modifiers to filter binding actions
+#
+#    - Command
+#    - Control
+#    - Option
+#    - Super
+#    - Shift
+#    - Alt
+#
+#    Multiple `mods` can be combined using `|` like this:
+#       `mods: Control|Shift`.
+#    Whitespace and capitalization are relevant and must match the example.
+#
+# - `mode`: Indicate a binding for only specific terminal reported modes
+#
+#    This is mainly used to send applications the correct escape sequences
+#    when in different modes.
+#
+#    - AppCursor
+#    - AppKeypad
+#    - Search
+#    - Alt
+#    - Vi
+#
+#    A `~` operator can be used before a mode to apply the binding whenever
+#    the mode is *not* active, e.g. `~Alt`.
+#
+# Bindings are always filled by default, but will be replaced when a new
+# binding with the same triggers is defined. To unset a default binding, it can
+# be mapped to the `ReceiveChar` action. Alternatively, you can use `None` for
+# a no-op if you do not wish to receive input characters for that binding.
+#
+# If the same trigger is assigned to multiple actions, all of them are executed
+# in the order they were defined in.
 #key_bindings:
   #- { key: Paste,                                       action: Paste          }
   #- { key: Copy,                                        action: Copy           }
@@ -215,6 +498,69 @@ live_config_reload: true
   #- { key: Home,      mods: Shift,   mode: ~Alt,        action: ScrollToTop    }
   #- { key: End,       mods: Shift,   mode: ~Alt,        action: ScrollToBottom }
 
+  # Vi Mode
+  #- { key: Space,  mods: Shift|Control, mode: ~Search,    action: ToggleViMode            }
+  #- { key: Space,  mods: Shift|Control, mode: Vi|~Search, action: ScrollToBottom          }
+  #- { key: Escape,                      mode: Vi|~Search, action: ClearSelection          }
+  #- { key: I,                           mode: Vi|~Search, action: ToggleViMode            }
+  #- { key: I,                           mode: Vi|~Search, action: ScrollToBottom          }
+  #- { key: C,      mods: Control,       mode: Vi|~Search, action: ToggleViMode            }
+  #- { key: Y,      mods: Control,       mode: Vi|~Search, action: ScrollLineUp            }
+  #- { key: E,      mods: Control,       mode: Vi|~Search, action: ScrollLineDown          }
+  #- { key: G,                           mode: Vi|~Search, action: ScrollToTop             }
+  #- { key: G,      mods: Shift,         mode: Vi|~Search, action: ScrollToBottom          }
+  #- { key: B,      mods: Control,       mode: Vi|~Search, action: ScrollPageUp            }
+  #- { key: F,      mods: Control,       mode: Vi|~Search, action: ScrollPageDown          }
+  #- { key: U,      mods: Control,       mode: Vi|~Search, action: ScrollHalfPageUp        }
+  #- { key: D,      mods: Control,       mode: Vi|~Search, action: ScrollHalfPageDown      }
+  #- { key: Y,                           mode: Vi|~Search, action: Copy                    }
+  #- { key: Y,                           mode: Vi|~Search, action: ClearSelection          }
+  #- { key: Copy,                        mode: Vi|~Search, action: ClearSelection          }
+  #- { key: V,                           mode: Vi|~Search, action: ToggleNormalSelection   }
+  #- { key: V,      mods: Shift,         mode: Vi|~Search, action: ToggleLineSelection     }
+  #- { key: V,      mods: Control,       mode: Vi|~Search, action: ToggleBlockSelection    }
+  #- { key: V,      mods: Alt,           mode: Vi|~Search, action: ToggleSemanticSelection }
+  #- { key: Return,                      mode: Vi|~Search, action: Open                    }
+  #- { key: Z,                           mode: Vi|~Search, action: CenterAroundViCursor    }
+  #- { key: K,                           mode: Vi|~Search, action: Up                      }
+  #- { key: J,                           mode: Vi|~Search, action: Down                    }
+  #- { key: H,                           mode: Vi|~Search, action: Left                    }
+  #- { key: L,                           mode: Vi|~Search, action: Right                   }
+  #- { key: Up,                          mode: Vi|~Search, action: Up                      }
+  #- { key: Down,                        mode: Vi|~Search, action: Down                    }
+  #- { key: Left,                        mode: Vi|~Search, action: Left                    }
+  #- { key: Right,                       mode: Vi|~Search, action: Right                   }
+  #- { key: Key0,                        mode: Vi|~Search, action: First                   }
+  #- { key: Key4,   mods: Shift,         mode: Vi|~Search, action: Last                    }
+  #- { key: Key6,   mods: Shift,         mode: Vi|~Search, action: FirstOccupied           }
+  #- { key: H,      mods: Shift,         mode: Vi|~Search, action: High                    }
+  #- { key: M,      mods: Shift,         mode: Vi|~Search, action: Middle                  }
+  #- { key: L,      mods: Shift,         mode: Vi|~Search, action: Low                     }
+  #- { key: B,                           mode: Vi|~Search, action: SemanticLeft            }
+  #- { key: W,                           mode: Vi|~Search, action: SemanticRight           }
+  #- { key: E,                           mode: Vi|~Search, action: SemanticRightEnd        }
+  #- { key: B,      mods: Shift,         mode: Vi|~Search, action: WordLeft                }
+  #- { key: W,      mods: Shift,         mode: Vi|~Search, action: WordRight               }
+  #- { key: E,      mods: Shift,         mode: Vi|~Search, action: WordRightEnd            }
+  #- { key: Key5,   mods: Shift,         mode: Vi|~Search, action: Bracket                 }
+  #- { key: Slash,                       mode: Vi|~Search, action: SearchForward           }
+  #- { key: Slash,  mods: Shift,         mode: Vi|~Search, action: SearchBackward          }
+  #- { key: N,                           mode: Vi|~Search, action: SearchNext              }
+  #- { key: N,      mods: Shift,         mode: Vi|~Search, action: SearchPrevious          }
+
+  # Search Mode
+  #- { key: Return,                mode: Search|Vi,  action: SearchConfirm         }
+  #- { key: Escape,                mode: Search,     action: SearchCancel          }
+  #- { key: C,      mods: Control, mode: Search,     action: SearchCancel          }
+  #- { key: U,      mods: Control, mode: Search,     action: SearchClear           }
+  #- { key: W,      mods: Control, mode: Search,     action: SearchDeleteWord      }
+  #- { key: P,      mods: Control, mode: Search,     action: SearchHistoryPrevious }
+  #- { key: N,      mods: Control, mode: Search,     action: SearchHistoryNext     }
+  #- { key: Up,                    mode: Search,     action: SearchHistoryPrevious }
+  #- { key: Down,                  mode: Search,     action: SearchHistoryNext     }
+  #- { key: Return,                mode: Search|~Vi, action: SearchFocusNext       }
+  #- { key: Return, mods: Shift,   mode: Search|~Vi, action: SearchFocusPrevious   }
+
   # (Windows, Linux, and BSD only)
   #- { key: V,              mods: Control|Shift, mode: ~Vi,        action: Paste            }
   #- { key: C,              mods: Control|Shift,                   action: Copy             }
@@ -232,6 +578,28 @@ live_config_reload: true
   # (Windows only)
   #- { key: Return,   mods: Alt,           action: ToggleFullscreen }
 
+  # (macOS only)
+  #- { key: K,              mods: Command, mode: ~Vi|~Search, chars: "\x0c"                 }
+  #- { key: K,              mods: Command, mode: ~Vi|~Search, action: ClearHistory          }
+  #- { key: Key0,           mods: Command,                    action: ResetFontSize         }
+  #- { key: Equals,         mods: Command,                    action: IncreaseFontSize      }
+  #- { key: Plus,           mods: Command,                    action: IncreaseFontSize      }
+  #- { key: NumpadAdd,      mods: Command,                    action: IncreaseFontSize      }
+  #- { key: Minus,          mods: Command,                    action: DecreaseFontSize      }
+  #- { key: NumpadSubtract, mods: Command,                    action: DecreaseFontSize      }
+  #- { key: V,              mods: Command,                    action: Paste                 }
+  #- { key: C,              mods: Command,                    action: Copy                  }
+  #- { key: C,              mods: Command, mode: Vi|~Search,  action: ClearSelection        }
+  #- { key: H,              mods: Command,                    action: Hide                  }
+  #- { key: H,              mods: Command|Alt,                action: HideOtherApplications }
+  #- { key: M,              mods: Command,                    action: Minimize              }
+  #- { key: Q,              mods: Command,                    action: Quit                  }
+  #- { key: W,              mods: Command,                    action: Quit                  }
+  #- { key: N,              mods: Command,                    action: CreateNewWindow       }
+  #- { key: F,              mods: Command|Control,            action: ToggleFullscreen      }
+  #- { key: F,              mods: Command, mode: ~Search,     action: SearchForward         }
+  #- { key: B,              mods: Command, mode: ~Search,     action: SearchBackward        }
+
 #debug:
   # Display the time it takes to redraw each frame.
   #render_timer: false

alacritty/style_spaceship.yml

@@ -2,7 +2,7 @@ window:
   padding:
     x: 8
     y: 8
-  opacity: 0.58
+  opacity: 0.45
 
 # Font configuration
 font:
@@ -12,26 +12,29 @@ font:
   builtin_box_drawing: true
 
 colors:
+  # Default colors
   primary:
     background: '0xffffff'
-    foreground: '0x0f2356'
+    foreground: '0x233871'
 
+  # Normal colors
   normal:
     black:   '0xe1e1e1'
-    red:     '0x5b0e00'
+    red:     '0x9e5244'
-    green:   '0x728100'
+    green:   '0x687036'
-    yellow:  '0xaf4200'
+    yellow:  '0xb4744d'
-    blue:    '0x004183'
+    blue:    '0x2d5278'
-    magenta: '0x400090'
+    magenta: '0x6c3e8f'
     cyan:    '0x2d6848'
-    white:   '0x8e98b0'
+    white:   '0x5b6c99'
 
+  # Bright colors
   bright:
     black:   '0xababab'
-    red:     '0xe75d21'
+    red:     '0xe17461'
-    green:   '0xc3d607'
+    green:   '0xcee161'
-    yellow:  '0xfaa500'
+    yellow:  '0xe1b661'
-    blue:    '0x007fff'
+    blue:    '0x4693e0'
-    magenta: '0xbb00ff'
+    magenta: '0xa961e1'
-    cyan:    '0x2eda7e'
+    cyan:    '0x61e19c'
-    white:   '0x141519'
+    white:   '0x233871'

awesome/binding/clientkeys.lua

@@ -53,11 +53,11 @@ function _M.get()
         c.maximized_horizontal = not c.maximized_horizontal
         c:raise()
       end ,
-      {description = "(un)maximize horizontally", group = "client"})
+      {description = "(un)maximize horizontally", group = "client"}),
 
-    -- cyclefocus.key({modkey,     }, "Tab", {
+    cyclefocus.key({modkey,     }, "Tab", {
-    --   cycle_filters = { cyclefocus.filters.same_screen, cyclefocus.filters.common_tag }},
+      cycle_filters = { cyclefocus.filters.same_screen, cyclefocus.filters.common_tag }},
-    --   {description = "cycle through clients from the same screen and tag", group = "client"})
+      {description = "cycle through clients from the same screen and tag", group = "client"})
   )
 
   return clientkeys

awesome/binding/globalkeys.lua

@@ -142,16 +142,9 @@ function _M.get()
 
     --   -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
     -- Menubar
-    --awful.key({ modkey }, "p", function() menubar.show() end,
+    awful.key({ modkey }, "p", function() menubar.show() end,
-    --          {description = "show the menubar", group = "launcher"})
+              {description = "show the menubar", group = "launcher"})
 
-    awful.key({ modkey, }, "p", function()
-      awful.util.spawn("rofi -show combi -modes combi,filebrowser -combi-modes \"drun,filebrowser,run\"") end,
-      {description = "open rofi runner", group = "launcher"}),
-
-    awful.key({ modkey, }, "y", function()
-      awful.util.spawn("scrot") end,
-      {description = "scrot", group = "launcher"})
   )
 
   return globalkeys

awesome/main/layouts.lua

@@ -18,7 +18,17 @@ function _M.get ()
     awful.layout.suit.fair,             -- 6:
     awful.layout.suit.fair.horizontal,  -- 7:
 
-    awful.layout.suit.max,              -- 8:
+--  awful.layout.suit.spiral,             
+--  awful.layout.suit.spiral.dwindle,     
+
+--  awful.layout.suit.max,                
+--  awful.layout.suit.max.fullscreen,     
+--  awful.layout.suit.magnifier,          
+
+--  awful.layout.suit.corner.nw           
+--  awful.layout.suit.corner.ne,
+--  awful.layout.suit.corner.sw,
+--  awful.layout.suit.corner.se,
   }
 
   return layouts

awesome/main/menu.lua

@@ -1,147 +1,110 @@
--- standard awesome library -----------------------------------------
+-- Standard awesome library
 local awful = require("awful")
 local hotkeys_popup = require("awful.hotkeys_popup").widget
--- theme handling library ------------------------------------------
+-- Theme handling library
 local beautiful = require("beautiful") -- for awesome.icon
 
 local M = {}  -- menu
 local _M = {} -- module
 
----------------------------------------------------------------------
+-- reading
+-- https://awesomewm.org/apidoc/popups%20and%20bars/awful.menu.html
 
--- import terminal variable from rc.lua -----------------------------
+-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
+
+-- This is used later as the default terminal and editor to run.
 local terminal = RC.vars.terminal
 
--- import editor variable from OS environment -----------------------
+-- Variable definitions
+-- This is used later as the default terminal and editor to run.
 local editor = os.getenv("EDITOR") or "nano"
 local editor_cmd = terminal .. " -e " .. editor
 
----------------------------------------------------------------------
+-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
 
--- make it harder to quit awesome accidentally ----------------------
+-- this is an attempt to make it harder to quit awesome accidentally.
-M.quitmenu =
+-- my hand likes to twitch sometimes so i've accidentally quit on more
-  {
+-- than one occasion
+M.quitmenu = {
   { "i mean it!", function() awesome.quit() end } 
 }
 
--- "awesome" menu ---------------------------------------------------
 M.awesome = {
-  { "hotkeys"     , function() hotkeys_popup.show_help(nil,awful.screen.focused())
+  { "hotkeys", function() 
+      hotkeys_popup.show_help(nil, awful.screen.focused()) 
     end },
-  { "manual"      , terminal
+  { "manual", terminal .. " -e man awesome" },
-                      .. " -e man awesome" },
+  { "edit config", editor_cmd .. " " .. awesome.conffile },
-  { "edit config" , editor_cmd
-                      .. " "
-                      .. awesome.conffile  },
   { "terminal", terminal },
   { "restart", awesome.restart },
   { "quit", M.quitmenu }
 }
 
--- browsers and other network-oriented software ---------------------
 M.network = {
   { "firefox", "firefox" },
-  { "discord"     ,  "flatpak run\
+  { "discord", "flatpak run com.discordapp.Discord" },
-                        com.discordapp.Discord"  },
   { "thunderbird", "thunderbird" },
-  { "steam"       ,  "steam"                     },
+  { "steam", "flatpak run com.valvesoftware.Steam" },
   { "qbittorrent", "qbittorrent" },
-  { "keepassxc"   ,  "keepassxc"                 }
+  { "keepassxc", "keepassxc" },
 }
 
--- DEVELOPERS, DEVELOPERS, DEVELOPERS, DEVELOPERS -------------------
 M.develop = {
-  { "vs code"          ,  "flatpak run\
+  { "vs code", "flatpak run com.visualstudio.code" },
-                            com.visualstudio.code"     },
   { "bless", "bless" },
-  { "beekeeper studio" ,  "flatpak run\
+  { "beekeeper studio", "flatpak run io.beekeeperstudio.Studio" },
-                            io.beekeeperstudio.Studio" },
   { "sqlite browser", "sqlitebrowser" }
 }
 
--- emulators --------------------------------------------------------
 M.emulators = {
-  { "citra"       ,  "flatpak run\
+  { "citra", "flatpak run org.citra_emu.citra" },
-                        org.citra_emu.citra"         },
+  { "dolphin", "flatpak run org.DolphinEmu.dolphin-emu" },
-  { "dolphin"     ,  "flatpak run\
+  { "yuzu", "flatpak run org.yuzu_emu.yuzu" },
-                        org.DolphinEmu.dolphin-emu"  },
+  { "duckstation", "flatpak run org.duckstation.DuckStation" },
-  { "yuzu"        ,  "flatpak run\
+  { "PPSSPP", "flatpak run org.ppsspp.PPSSPP" }
-                        org.yuzu_emu.yuzu"           },
-  { "duckstation" ,  "flatpak run\
-                        org.duckstation.DuckStation" },
-  { "PPSSPP"      ,  "flatpak run\
-                        org.ppsspp.PPSSPP"           }
 }
 
--- vintage story [different versions of VS for mods] ----------------
 M.vtgstry = {
-  { "latest"  ,  "vintagestory"  },
+  { "latest", "mono /home/nu/ApplicationData/vintagestory/Vintagestory.exe" },
-  { "flatpak" ,  "flatpak run\
+  { "flatpak", "flatpak run at.vintagestory.VintageStory" }
-                    at.vintagestory.VintageStory" }
 }
 
--- videogames -------------------------------------------------------
 M.games = {
   { "emulators", M.emulators },
   { "vintage story", M.vtgstry },
-  { "team fortress 2"       ,  "steam\
+  { "team fortress 2", "steam steam://rungameid/440" },
-                                  steam://rungameid/440"           },
+  { "ballisticNG", "steam steam://rungameid/473770" },
-  { "ballisticNG"           ,  "steam\
+  { "them's fightin' herds", "steam steam://rungameid/574980"},
-                                  steam://rungameid/473770"        },
+  { "osu!", "flatpak run sh.ppy.osu" },
-  { "them's fightin' herds" ,  "steam\
+  { "minecraft", "flatpak run org.prismlauncher.PrismLauncher" },
-                                  steam://rungameid/574980"        },
-  { "osu!"                  ,  "flatpak run\
-                                  sh.ppy.osu"                      },
-  { "minecraft"             ,  "flatpak run\
-                                  org.prismlauncher.PrismLauncher" }
 }
 
--- utilities [kind of a misc category] ------------------------------
 M.utils = {
   { "catfish", "catfish" },
   { "anki", "flatpak run net.ankiweb.Anki" },
-  { "text pieces" ,  "flatpak run\
+  { "text pieces", "flatpak run com.github.liferooter.textpieces" },
-                        com.github.liferooter.textpieces"     },
+  { "menulibre", "menulibre" },
-  { "alacarte"    ,  "alacarte"                               },
   { "flatseal", "flatpak run com.github.tchx84.Flatseal" },
-  { "xarchiver"   ,  "xarchiver"                              },
+  { "piper", "piper" }
-  { "piper"       ,  "piper"                                  },
-  { "wally"       ,  "wally"                                  }
 }
 
--- "media" programs [image viewers, video players, etc] -------------
 M.media = {
   { "hydrus", "flatpak run io.github.hydrusnetwork.hydrus" },
-  { "youtube" ,  "/usr/lib64/chromium-browser/chromium-browser.sh\
+  { "youtube", "/usr/lib64/chromium-browser/chromium-browser.sh --profile-directory=Default --app-id=agimnkijcaahngcdmfeangaknmldooml"},
-                  --profile-directory=Default\
-                  --app-id=agimnkijcaahngcdmfeangaknmldooml"       },
   { "spotify", "flatpak run com.spotify.Client" }
 }
-
+-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
--- "visual arts" stuff ----------------------------------------------
-M.vis = {
-  { "blender" ,  "steam\
-                    steam://rungameid/365670" },
-  { "krita"   ,  "krita"                      },
-  { "GIMP"    ,  "gimp-2.10"                  },
-  { "beeref"  ,  "flatpak run\
-                    org.beeref.BeeRef"        }
-}
-
----------------------------------------------------------------------
 
 function _M.get()
 
--- main menu --------------------------------------------------------
+  -- Main Menu
   local menu_items = {
-  { "awesome"  ,  M.awesome,
+    { "awesome", M.awesome, beautiful.awesome_subicon },
-                    beautiful.awesome_subicon },
     { "terminal", terminal },
     { "thunar", "Thunar" },
     { "www", M.network },
     { "media", M.media },
     { "dev", M.develop },
-  { "art"      ,  M.vis                       },
     { "games", M.games },
     { "utils", M.utils }
   }
@@ -149,6 +112,6 @@ local menu_items = {
   return menu_items
 end
 
----------------------------------------------------------------------
+-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
 
 return setmetatable({}, { __call = function(_, ...) return _M.get(...) end })

awesome/main/rules.lua

@@ -34,16 +34,16 @@ function _M.get(clientkeys, clientbuttons)
           "pinentry",
         },
         class = {
+          "MessageWin",  -- kalarm.
           "Tor Browser", -- Needs a fixed window size to avoid fingerprinting by screen size.
-          "steamwebhelper",
         },
 
         -- 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 = {
-          "Friends List",
+          "Event Tester",  -- xev.
+          "Steam",
           "infinitefusion", -- Pokémon Infinite Fusion
-          "Picture-in-picture"
         },
         role = {
           "AlarmWindow",  -- Thunderbird's calendar.

awesome/main/signals.lua

@@ -11,6 +11,9 @@ local beautiful = require("beautiful")
 -- Custom Local Library: Common Functional Decoration
 require("deco.titlebar")
 
+-- reading
+-- https://awesomewm.org/apidoc/classes/signals.html
+
 -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
 
 -- {{{ Signals

awesome/main/tags.lua

@@ -9,16 +9,19 @@ function _M.get ()
   local tags = {}
 
   awful.tag.add("➊ home",
-    { layout = awful.layout.suit.floating, })
+    {
+      layout = awful.layout.suit.floating,
+    })
 
   awful.tag.add("➋ code",
-    { layout = awful.layout.suit.tile, })
+    {
+      layout = awful.layout.suit.tile,
+    })
 
   awful.tag.add("➌ art",
-    { layout = awful.layout.suit.floating, })
+    {
-
+      layout = awful.layout.suit.floating,
-  awful.tag.add("➍ games", 
+    })
-    { layout = awful.layout.suit.floating, })
   
   return tags
 end

awesome/main/user-variables.lua

@@ -1,9 +1,18 @@
+-- {{{ Global Variable Definitions
+-- moved here in module as local variable
+-- }}}
+
 local home = os.getenv("HOME")
 
 local _M = {
+  -- This is used later as the default terminal and editor to run.
   terminal = "alacritty",
+   
+  -- Default modkey.
   modkey = "Mod4",
-  wallpaper = "/usr/share/backgrounds/custom/space_station.jpg"
+
+  -- user defined wallpaper
+  wallpaper = "/usr/share/backgrounds/custom/space_station.jpg",
 }
 
 return _M

awesome/themes/spacestation/theme.lua

@@ -15,14 +15,14 @@ theme.font          = "Fira Code 9"
 
 theme.bg_normal     = "#ffffff4f"
 theme.bg_focus      = "#e1b661"
-theme.bg_urgent     = "#0f2356"
+theme.bg_urgent     = "#233871"
 theme.bg_minimize   = "#ffffff00"
 theme.bg_systray    = "#ffffff00"
 
-theme.fg_normal     = "#0f2356"
+theme.fg_normal     = "#233871"
-theme.fg_focus      = "#0f2356"
+theme.fg_focus      = "#233871"
 theme.fg_urgent     = "#e1b661"
-theme.fg_minimize   = "#0f235680"
+theme.fg_minimize   = "#23387180"
 
 theme.border_width  = 0
 theme.border_normal = "#f0eef1"
@@ -32,12 +32,12 @@ theme.border_marked = "#ff8e9d"
 theme.taglist_bg_focus = "#e1b661"
 
 theme.notification_bg = "#ffffff4f"
-theme.notification_fg = "#0f2356"
+theme.notification_fg = "#233871"
-theme.notification_border_color = "#0f2356"
+theme.notification_border_color = "#233871"
 
-theme.tooltip_fg_color = "#0f2356"
+theme.tooltip_fg_color = "#233871"
 theme.tooltip_bg_color = "#ffffff4f"
-theme.tooltip_border_color = "#0f2356"
+theme.tooltip_border_color = "#233871"
 
 theme.prompt_bg = "#ffffff4f"