varied awesome changes

.gitignore

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

alacritty/alacritty.yml

@@ -1,19 +1,9 @@
-# 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. Some entries may override variables
-# set by alacritty itself.
+# environment variables.
 env:
   TERM: alacritty
 
@@ -22,29 +12,9 @@ window:
     columns: 65
     lines: 18
 
-  # 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: Windowed
 
-  # 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):
@@ -54,8 +24,6 @@ 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.
@@ -65,8 +33,6 @@ scrolling:
   history: 150
   transparent_background_colors: true
 
-# Bell
-#
 # The bell is rung every time the BEL control character is received.
 #bell:
   # Visual Bell Animation
@@ -114,72 +80,32 @@ scrolling:
   # When set to `true`, selected text will be copied to the primary clipboard.
   #save_to_clipboard: false
 
-#cursor:
-  # Cursor style
-  #style:
-    # Cursor shape
-    #
-    # Values for `shape`:
-    #   - ▇ Block
-    #   - _ Underline
-    #   - | Beam
-    #shape: Block
+cursor:
+  style:
+    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: 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
+    blinking: On
 
   # Cursor blinking interval in milliseconds.
-  #blink_interval: 750
+  blink_interval: 750
 
   # Time after which cursor stops blinking, in seconds.
-  #
-  # Specifying '0' will disable timeout for blinking.
-  #blink_timeout: 5
+  blink_timeout: 5
 
   # If this is `true`, the cursor will be rendered as a hollow box when the
   # window is not focused.
-  #unfocused_hollow: true
+  #unfocused_hollow: false
 
   # 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 (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
+live_config_reload: true
 
 # Offer IPC using `alacritty msg` (unix only)
 #ipc_socket: true
@@ -279,215 +205,6 @@ scrolling:
 #  - { 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           }
@@ -498,69 +215,6 @@ scrolling:
   #- { 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             }
@@ -578,28 +232,6 @@ scrolling:
   # (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.45
+  opacity: 0.58
 
 # Font configuration
 font:
@@ -12,29 +12,26 @@ font:
   builtin_box_drawing: true
 
 colors:
-  # Default colors
   primary:
     background: '0xffffff'
-    foreground: '0x233871'
+    foreground: '0x0f2356'
 
-  # Normal colors
   normal:
     black:   '0xe1e1e1'
-    red:     '0x9e5244'
-    green:   '0x687036'
-    yellow:  '0xb4744d'
-    blue:    '0x2d5278'
-    magenta: '0x6c3e8f'
+    red:     '0x5b0e00'
+    green:   '0x728100'
+    yellow:  '0xaf4200'
+    blue:    '0x004183'
+    magenta: '0x400090'
     cyan:    '0x2d6848'
-    white:   '0x5b6c99'
+    white:   '0x8e98b0'
 
-  # Bright colors
   bright:
     black:   '0xababab'
-    red:     '0xe17461'
-    green:   '0xcee161'
-    yellow:  '0xe1b661'
-    blue:    '0x4693e0'
-    magenta: '0xa961e1'
-    cyan:    '0x61e19c'
-    white:   '0x233871'
+    red:     '0xe75d21'
+    green:   '0xc3d607'
+    yellow:  '0xfaa500'
+    blue:    '0x007fff'
+    magenta: '0xbb00ff'
+    cyan:    '0x2eda7e'
+    white:   '0x141519'

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", {
-      cycle_filters = { cyclefocus.filters.same_screen, cyclefocus.filters.common_tag }},
-      {description = "cycle through clients from the same screen and tag", group = "client"})
+    -- cyclefocus.key({modkey,     }, "Tab", {
+    --   cycle_filters = { cyclefocus.filters.same_screen, cyclefocus.filters.common_tag }},
+    --   {description = "cycle through clients from the same screen and tag", group = "client"})
   )
 
   return clientkeys

awesome/binding/globalkeys.lua

@@ -142,9 +142,16 @@ function _M.get()
 
     --   -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
     -- Menubar
-    awful.key({ modkey }, "p", function() menubar.show() end,
-              {description = "show the menubar", group = "launcher"})
+    --awful.key({ modkey }, "p", function() menubar.show() end,
+    --          {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,17 +18,7 @@ function _M.get ()
     awful.layout.suit.fair,             -- 6:
     awful.layout.suit.fair.horizontal,  -- 7:   
 
---  awful.layout.suit.spiral,             
---  awful.layout.suit.spiral.dwindle,     
-
---  awful.layout.suit.max,                
---  awful.layout.suit.max.fullscreen,     
---  awful.layout.suit.magnifier,          
-
---  awful.layout.suit.corner.nw           
---  awful.layout.suit.corner.ne,
---  awful.layout.suit.corner.sw,
---  awful.layout.suit.corner.se,
+    awful.layout.suit.max,              -- 8:
   }
 
   return layouts

awesome/main/menu.lua

@@ -1,110 +1,147 @@
--- 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
+---------------------------------------------------------------------
 
--- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
-
--- This is used later as the default terminal and editor to run.
+-- import terminal variable from rc.lua -----------------------------
 local terminal = RC.vars.terminal
 
--- Variable definitions
--- This is used later as the default terminal and editor to run.
+-- import editor variable from OS environment -----------------------
 local editor     = os.getenv("EDITOR") or "nano"
 local editor_cmd = terminal .. " -e " .. editor
 
--- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
+---------------------------------------------------------------------
 
--- this is an attempt to make it harder to quit awesome accidentally.
--- my hand likes to twitch sometimes so i've accidentally quit on more
--- than one occasion
-M.quitmenu = {
+-- make it harder to quit awesome accidentally ----------------------
+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 .. " -e man awesome" },
-  { "edit config", editor_cmd .. " " .. awesome.conffile },
+  { "manual"      , terminal
+                      .. " -e man awesome" },
+  { "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 com.discordapp.Discord" },
+  { "discord"     ,  "flatpak run\
+                        com.discordapp.Discord"  },
   { "thunderbird" ,  "thunderbird"               },
-  { "steam", "flatpak run com.valvesoftware.Steam" },
+  { "steam"       ,  "steam"                     },
   { "qbittorrent" ,  "qbittorrent"               },
-  { "keepassxc", "keepassxc" },
+  { "keepassxc"   ,  "keepassxc"                 }
 }
 
+-- DEVELOPERS, DEVELOPERS, DEVELOPERS, DEVELOPERS -------------------
 M.develop = {
-  { "vs code", "flatpak run com.visualstudio.code" },
+  { "vs code"          ,  "flatpak run\
+                            com.visualstudio.code"     },
   { "bless"            ,  "bless"                      },
-  { "beekeeper studio", "flatpak run io.beekeeperstudio.Studio" },
+  { "beekeeper studio" ,  "flatpak run\
+                            io.beekeeperstudio.Studio" },
   { "sqlite browser"   ,    "sqlitebrowser"            }
 }
 
+-- emulators --------------------------------------------------------
 M.emulators = {
-  { "citra", "flatpak run org.citra_emu.citra" },
-  { "dolphin", "flatpak run org.DolphinEmu.dolphin-emu" },
-  { "yuzu", "flatpak run org.yuzu_emu.yuzu" },
-  { "duckstation", "flatpak run org.duckstation.DuckStation" },
-  { "PPSSPP", "flatpak run org.ppsspp.PPSSPP" }
+  { "citra"       ,  "flatpak run\
+                        org.citra_emu.citra"         },
+  { "dolphin"     ,  "flatpak run\
+                        org.DolphinEmu.dolphin-emu"  },
+  { "yuzu"        ,  "flatpak run\
+                        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", "mono /home/nu/ApplicationData/vintagestory/Vintagestory.exe" },
-  { "flatpak", "flatpak run at.vintagestory.VintageStory" }
+  { "latest"  ,  "vintagestory"  },
+  { "flatpak" ,  "flatpak run\
+                    at.vintagestory.VintageStory" }
 }
 
+-- videogames -------------------------------------------------------
 M.games = {
   { "emulators"             ,  M.emulators                         },
   { "vintage story"         ,  M.vtgstry                           },
-  { "team fortress 2", "steam steam://rungameid/440" },
-  { "ballisticNG", "steam steam://rungameid/473770" },
-  { "them's fightin' herds", "steam steam://rungameid/574980"},
-  { "osu!", "flatpak run sh.ppy.osu" },
-  { "minecraft", "flatpak run org.prismlauncher.PrismLauncher" },
+  { "team fortress 2"       ,  "steam\
+                                  steam://rungameid/440"           },
+  { "ballisticNG"           ,  "steam\
+                                  steam://rungameid/473770"        },
+  { "them's fightin' herds" ,  "steam\
+                                  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 com.github.liferooter.textpieces" },
-  { "menulibre", "menulibre" },
+  { "text pieces" ,  "flatpak run\
+                        com.github.liferooter.textpieces"     },
+  { "alacarte"    ,  "alacarte"                               },
   { "flatseal"    ,  "flatpak run com.github.tchx84.Flatseal" },
-  { "piper", "piper" }
+  { "xarchiver"   ,  "xarchiver"                              },
+  { "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 --profile-directory=Default --app-id=agimnkijcaahngcdmfeangaknmldooml"},
+  { "youtube" ,  "/usr/lib64/chromium-browser/chromium-browser.sh\
+                  --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, beautiful.awesome_subicon },
+  { "awesome"  ,  M.awesome,
+                    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                     }
 }
@@ -112,6 +149,6 @@ function _M.get()
   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 = {
-          "Event Tester",  -- xev.
-          "Steam",
+          "Friends List",
           "infinitefusion", -- Pokémon Infinite Fusion
+          "Picture-in-picture"
         },
         role = {
           "AlarmWindow",  -- Thunderbird's calendar.

awesome/main/signals.lua

@@ -11,9 +11,6 @@ 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,19 +9,16 @@ 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,18 +1,9 @@
--- {{{ 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",
-
-  -- user defined wallpaper
-  wallpaper = "/usr/share/backgrounds/custom/space_station.jpg",
+  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     = "#233871"
+theme.bg_urgent     = "#0f2356"
 theme.bg_minimize   = "#ffffff00"
 theme.bg_systray    = "#ffffff00"
 
-theme.fg_normal     = "#233871"
-theme.fg_focus      = "#233871"
+theme.fg_normal     = "#0f2356"
+theme.fg_focus      = "#0f2356"
 theme.fg_urgent     = "#e1b661"
-theme.fg_minimize   = "#23387180"
+theme.fg_minimize   = "#0f235680"
 
 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 = "#233871"
-theme.notification_border_color = "#233871"
+theme.notification_fg = "#0f2356"
+theme.notification_border_color = "#0f2356"
 
-theme.tooltip_fg_color = "#233871"
+theme.tooltip_fg_color = "#0f2356"
 theme.tooltip_bg_color = "#ffffff4f"
-theme.tooltip_border_color = "#233871"
+theme.tooltip_border_color = "#0f2356"
 
 theme.prompt_bg = "#ffffff4f"