Development

.bin/maintenance.sh

@@ -24,9 +24,9 @@ delete_path() {
   fi
 }
 
-# ------------------------------------------------------------------------------
+# ---------------------------------------
 # 1. Remove known unnecessary dirs/files
-# ------------------------------------------------------------------------------
+# ---------------------------------------
 printf "${CYAN}[1/5] Removing unused files and directories...${RESET}\n"
 
 delete_path "${HOME}/.android"        # Android SDK leftovers
@@ -52,34 +52,34 @@ if [[ -d "${HOME}/Desktop" ]]; then
     printf "${GREEN}Removed empty directory:${RESET} %s\n" "${HOME}/Desktop"
 fi
 
-# ------------------------------------------------------------------------------
+# ------------------------
 # 2. Clear cliphist cache
-# ------------------------------------------------------------------------------
+# ------------------------
 printf "${CYAN}[2/5] Clearing cliphist cache...${RESET}\n"
 if command -v cliphist &>/dev/null; then
   cliphist wipe && printf "${GREEN}cliphist cache wiped${RESET}\n"
 else
   printf "${YELLOW}cliphist not installed; skipping${RESET}\n"
 fi
 
-# ------------------------------------------------------------------------------
+# -------------------------------
 # 3. Vacuum systemd journal logs
-# ------------------------------------------------------------------------------
+# -------------------------------
 printf "${CYAN}[3/5] Vacuuming journal logs older than 7 days...${RESET}\n"
 sudo journalctl --vacuum-time=7d &&
   printf "${GREEN}Journal logs vacuumed${RESET}\n"
 
-# ------------------------------------------------------------------------------
+# --------------------------
 # 4. Clean stale /tmp files
-# ------------------------------------------------------------------------------
+# --------------------------
 printf "${CYAN}[4/5] Cleaning stale /tmp files (older than 3 days)...${RESET}\n"
 sudo find /tmp -mindepth 1 -mtime +3 -print0 | while IFS= read -r -d '' file; do
   sudo rm -rf "$file" && printf "${GREEN}Deleted stale tmp:${RESET} %s\n" "$file"
 done
 
-# ------------------------------------------------------------------------------
+# ----------------------------------
 # 5. Run rmlint on selected folders
-# ------------------------------------------------------------------------------
+# ----------------------------------
 printf "${CYAN}[5/5] Running rmlint on select folders...${RESET}\n"
 RMLINT_TARGETS=(
   "${HOME}/Documents"

.config/bat/config

@@ -1,9 +1,9 @@
 # NOTE: bat — A modern `cat` clone with syntax highlighting & Git integration
 # INFO: Full docs: https://github.com/sharkdp/bat
 
-# =======================
-# 1. Appearance & Themes
-# =======================
+# --------------------
+# Appearance & Themes
+# --------------------
 
 # Set theme
 --theme="gruvbox-dark"
@@ -18,9 +18,9 @@
 # Enable italics.
 --italic-text="always"
 
-# =============================
-# 2. Whitespace & Line Control
-# =============================
+# --------------------------
+# Whitespace & Line Control
+# --------------------------
 
 # Squeeze multiple empty lines into one.
 --squeeze-blank
@@ -31,9 +31,9 @@
 # Preserve tabs exactly as in file, or expand them to N spaces.
 --tabs=2
 
-# ==============================
-# 3. Paging Behavior
-# ==============================
+# ----------------
+# Paging Behavior
+# ----------------
 
 # Automatically use a pager (`less -RF`) only when output is larger than one screen.
 --paging="auto"

.config/btop/btop.conf

@@ -1,4 +1,4 @@
-#? Config file for btop v. 1.4.3
+#? Config file for btop v. 1.4.4
 
 #* Name of a btop++/bpytop/bashtop formatted ".theme" file, "Default" and "TTY" for builtin themes.
 #* Themes should be placed in "../share/btop/themes" relative to binary or "$HOME/.config/btop/themes"
@@ -150,7 +150,7 @@ background_update = True
 custom_cpu_name = ""
 
 #* Optional filter for shown disks, should be full path of a mountpoint, separate multiple values with whitespace " ".
-#* Begin line with "exclude=" to change to exclude filter, otherwise defaults to "most include" filter. Example: disks_filter="exclude=/boot /home/user".
+#* Only disks matching the filter will be shown. Prepend exclude= to only show disks not matching the filter. Examples: disk_filter="/boot /home/user", disks_filter="exclude=/boot /home/user"
 disks_filter = ""
 
 #* Show graphs instead of meters for memory values.

.config/environment.d/envvars.conf

@@ -2,30 +2,30 @@
 # INFO: Apply by logging out/in or running:
 #   systemctl --user import-environment
 
-# --------------------------
-# 1. General Editor Settings
-# --------------------------
+# ------------------------
+# General Editor Settings
+# ------------------------
 # Default editor for CLI tools (git, crontab, etc.).
 # Use full path for reliability.
 EDITOR="/usr/bin/nvim"
 VISUAL="$EDITOR"
 
-# --------------------------------
-# 2. Java & AWT Window Management
-# --------------------------------
+# -----------------------------
+# Java & AWT Window Management
+# -----------------------------
 # Prevent Java AWT from reparenting windows under tiling WMs.
 _JAVA_AWT_WM_NONREPARENTING=1
 
-# -------------------------------
-# 3. Qt/GTK Integration & Theming
-# -------------------------------
+# -----------------------------
+# Qt/GTK Integration & Theming
+# -----------------------------
 # Make Qt apps use GTK3 file dialogs and icons.
 # Requires 'qt5ct' or 'qgnomeplatform-qt5' + style plugins.
 QT_QPA_PLATFORMTHEME="gtk3"
 
-# ----------------------------
-# 4. WebKit / Browser Settings
-# ----------------------------
+# --------------------------
+# WebKit / Browser Settings
+# --------------------------
 # Disable WebKit’s compositing; rely on WM compositor.
 WEBKIT_DISABLE_COMPOSITING_MODE=1
 

.config/fastfetch/config.jsonc

@@ -1,4 +1,5 @@
-// Based on https://github.com/fastfetch-cli/fastfetch/blob/dev/presets/examples/25.jsonc
+// NOTE: fastfetch config file, utility for displaying system information.
+// INFO: Based on https://github.com/fastfetch-cli/fastfetch/blob/dev/presets/examples/25.jsonc
 {
   "$schema": "https://github.com/fastfetch-cli/fastfetch/raw/dev/doc/json_schema.json",
   "logo": {
@@ -43,7 +44,9 @@
       "key": "│  {icon}  Locale    │{$3}│{$2}",
     },
 
+    // ---------
     // Hardware
+    // ---------
     {
       "type": "custom",
       "key": "│{#cyan}╭──────────────┬{$1}╮{#keys}│\u001b[37D",
@@ -85,7 +88,9 @@
       "format": "",
     },
 
+    // --------
     // Desktop
+    // --------
     {
       "type": "custom",
       "key": "│{#green}╭──────────────┬{$1}╮{#keys}│\u001b[37D",
@@ -115,7 +120,9 @@
       "format": "",
     },
 
+    // ---------
     // Terminal
+    // ---------
     {
       "type": "custom",
       "key": "│{#yellow}╭──────────────┬{$1}╮{#keys}│\u001b[37D",
@@ -148,7 +155,9 @@
       "format": "",
     },
 
+    // ------------
     // Development
+    // ------------
     {
       "type": "custom",
       "key": "│{#red}╭──────────────┬{$1}╮{#keys}│\u001b[39D",
@@ -213,7 +222,9 @@
       "format": "",
     },
 
+    // -------
     // Uptime
+    // -------
     {
       "type": "custom",
       "key": "│{#magenta}╭──────────────┬{$1}╮{#keys}│\u001b[36D",
@@ -247,7 +258,6 @@
       "format": "",
     },
 
-    // End
     "break",
   ],
 }

.config/fontconfig/fonts.conf

@@ -2,7 +2,7 @@
 <!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd">
 <fontconfig>
 
-  <!-- 1. Alias “my-queue” to preferred fonts -->
+  <!-- Alias “my-queue” to preferred fonts -->
   <alias>
     <family>my-queue</family>
     <prefer>
@@ -12,7 +12,7 @@
     </prefer>
   </alias>
 
-  <!-- 2. Prepend fallback fonts in the pattern phase -->
+  <!-- Prepend fallback fonts in the pattern phase -->
   <match target="pattern">
     <test name="family" qual="any">
       <string>my-queue</string>
@@ -24,7 +24,7 @@
     </edit>
   </match>
 
-  <!-- 3. Optionally append generic fallbacks after all user fallbacks -->
+  <!-- Optionally append generic fallbacks after all user fallbacks -->
   <match target="pattern">
     <test name="family" qual="any">
       <string>my-queue</string>

.config/gtk-3.0/settings.ini

@@ -1,7 +1,7 @@
 [Settings]
-# ================================
-# 1. Appearance: Theme & Icon Set
-# ================================
+# -----------------------------
+# Appearance: Theme & Icon Set
+# -----------------------------
 # The GTK theme to use for all GTK3/GTK4 applications.
 # Must match a folder under /usr/share/themes or ~/.themes
 gtk-theme-name = Gruvbox-Material-Dark
@@ -13,18 +13,18 @@ gtk-icon-theme-name = Gruvbox-Material-Dark
 # 0 = light, 1 = dark; some GTK4 themes ignore this if not supported.
 gtk-application-prefer-dark-theme = 1
 
-# ===================
-# 2. Icons & Cursors
-# ===================
+# ----------------
+# Icons & Cursors
+# ----------------
 # Set the pointer/cursor theme (folder under /usr/share/icons or ~/.icons).
 gtk-cursor-theme-name = Simp1e-Gruvbox-Dark
 
 # Cursor size in pixels (0 = use theme default; typically 24–48px).
 gtk-cursor-theme-size = 0
 
-# =========================
-# 3. Font Rendering & Size
-# =========================
+# ----------------------
+# Font Rendering & Size
+# ----------------------
 # The default font for GTK widgets (family + size in points).
 gtk-font-name = Cantarell 12
 
@@ -41,9 +41,9 @@ gtk-xft-hinting = 1
 # Enable or disable antialiasing (boolean).
 gtk-xft-antialias = 1
 
-# =====================================
-# 4. UI Behavior & Toolbar Preferences
-# =====================================
+# ----------------------------------
+# UI Behavior & Toolbar Preferences
+# ----------------------------------
 # Toolbar button layout: icons only, text only, both
 # Options: GTK_TOOLBAR_ICONS, GTK_TOOLBAR_TEXT, GTK_TOOLBAR_BOTH, GTK_TOOLBAR_BOTH_HORIZ
 gtk-toolbar-style = GTK_TOOLBAR_BOTH
@@ -59,9 +59,9 @@ gtk-menu-images   = 1
 gtk-enable-event-sounds         = 1
 gtk-enable-input-feedback-sounds = 1
 
-# =================================
-# 5. Accessibility & Miscellaneous
-# =================================
+# ------------------------------
+# Accessibility & Miscellaneous
+# ------------------------------
 # Enable primary selection copy/paste (middle-click).
 gtk-primary-button-warps-slider = 0
 

.config/imv/config

@@ -3,31 +3,31 @@
 
 [options]
 
-# =============================
-# 1. Window & Display Settings
-# =============================
+# --------------------------
+# Window & Display Settings
+# --------------------------
 background                = 32302f
 fullscreen                = false
 width                     = 1280
 height                    = 720
 initial_pan               = 50 50
 
-# =====================
-# 2. File & Navigation
-# =====================
+# ------------------
+# File & Navigation
+# ------------------
 recursively               = true
 loop_input                = true
 list_files_at_exit        = false
 
-# =======================
-# 3. Scaling & Slideshow
-# =======================
+# --------------------
+# Scaling & Slideshow
+# --------------------
 scaling_mode              = full
 slideshow_duration        = 0
 
-# =================
-# 4. Overlay & HUD
-# =================
+# --------------
+# Overlay & HUD
+# --------------
 overlay                   = true
 overlay_font              = Hack:10
 overlay_text_color        = d4be98
@@ -36,7 +36,7 @@ overlay_background_color  = 252423
 overlay_background_alpha  = 99
 overlay_position_bottom   = false
 
-# ===============
-# 5. Keybindings
-# ===============
+# ------------
+# Keybindings
+# ------------
 suppress_default_binds    = false