Edit the show facts parameter to exit after it runs. Also fix its spacing in the usage.

Reviewed-on: #7

README.md

@@ -1,4 +1,5 @@
 # ansible
+
 Getting real with system management via ansible-pull.
 
 Per-system configuration is handled via local files to the provisioned machine,
@@ -10,59 +11,124 @@ accessed via the show-config and edit-config aliases.
 This setup is specific to the maintainer's devices and needs. You're welcome to
 use it as an example for your needs, but do not expect it to work as-is.
 
-## Currently Supported Linux Systems
+## Currently Supported Systems
+
+This information is as of 2025-11-21.
+
+### Primary
+
+These are the operating systems used as my daily driver.
+
+#### Debian Trixie
+
+This has been used as my primary server and workstation OS since at least 2024.
+The `apt` version of `ansible` in both Bookworm and Trixie are sufficient,
+no longer need to use `ansible` out of `pip`.
+
+### Secondary
+
+These are tested via my Docker project's `ProvisionsTests` container but not currently used as daily drivers.
+
+#### Arch
+
+TBD
+
+#### Fedora
+
+TBD
+
+#### OpenSUSE
+
+TBD
+
+#### Ubuntu
+
+TBD
+
+## Previusly Supported Systems
+
 ### Debian Family
+
 #### Debian
+
 100%, but only if using a recent enough version of Ansible. `pip` usually has a
 better version than `apt`.
+
 #### Ubuntu
+
 100%, both server and desktop.
+
 #### Pop!_OS
+
 100%, have not used for a while though.
+
 #### Mint
+
 100%, but not really used, just tested once for fun.
+
 #### Parrot Security OS (MATE)
+
 100% for a while, but OS did not serve maintainer's needs and 404 errors were
 terrible while updating. Ubuntu Rolling Rhino filled the gap.
 
 ### Arch Family
+
+#### Arch
+
+100% at some point, including installation and configuration of a Desktop Environment.
+
 #### Manjaro
+
 100% at some point.
 
 ### Fedora Family
+
 #### Fedora 35
-Workstation: 100%
+
+Workstation: 100%,
 Server: 100%
 
 ## Suse Family
+
 ### openSUSE Tumbleweed v2022-02-17
-Generic: 100%
+
+Generic: 100%,
 Workstation: 100%
 
 ### openSUSE Leap 15.4
+
 Generic: 100%
 Workstation: Currently failing at `[Workstation | Linux | Flatpak Distro | Package Manager | Install From Repo]` with message `Problem: nothing provides libedataserver-1.2.so.24 needed by the to be installed evolution-data-server-32bit-3.34.4-3.3.1.x86_64`.
 
 ### NixOS
+
 99%, still need to get Telegraf going and refactor local.yml but everything else
 is working well. It is automatically implementing git.hyperling.com/me/env-nixos.
 
-## Currently Supported Unix Systems
 ### FreeBSD 12, 13
+
 100%, although GUI is not working completely on 13 yet (dash-to-dock doesn't compile).
 Software choices are slightly more limited since not `flatpak`-enabled and not feeling a `ports` setup.
 
 ## Waiting To Be Tested
+
 ### Kali Linux
+
 ### Arch Linux ARM
+
 Specifically for the Pinephone.
+
 ### Arch Linux x86
+
 Would be great to have Arch get built up by this. Used for many years but left
 after update problems due to a long computer hiatus.
+
 ### Fedora Mobile
+
 Specifically for the Pinephone.
 
 ## Future Goals
+
 Eventually some of the scripts and install files will be put into the files
 folder. This will allow initializing systems outside of the maintainer's home
 network.
@@ -74,6 +140,8 @@ benefit has yet to be seen for some tasks. Shared facts will definitely continue
 to exist under the facts tree.
 
 ## Other Notes
+
 ### Get Setup Values
+
 Use this command to see the variables for a system:
 `ansible localhost -m setup --connection=local`.

files/scripts/backup_system.sh

@@ -39,7 +39,7 @@ echo "*** Creating backup at '$BACKUP' ***"
 sudo zip -rv "$BACKUP" \
 	/etc /var/{log,mail,spool} /srv /boot \
 	/usr/local/etc $EXTRA \
-	-x "/srv/backup/*"
+	-x "/srv/backup/*" -x "/srv/sftp/*"
 status="$?"
 
 if [[ "$status" != 0 ]]; then

files/scripts/compress_image.sh

@@ -15,6 +15,7 @@ size=2000
 
 # Strings
 tag="shrunk"
+use_tag="Y"
 date_YYYYMMDD="`date "+%Y%m%d"`"
 location="."
 search="ls"
@@ -28,7 +29,7 @@ function usage() {
 	# Parameters:
 	#   1) The exit status to use.
 	status=$1
-	echo "Usage: $PROG [-s SIZE] [-l LOCATION] [-A | [-r] [-f] [-d] [-c]] [-h] [-x]" >&2
+	echo "Usage: $PROG [-s SIZE] [-l LOCATION] [-A | [-r] [-f] [-d] [-c] [-e | -t] [-h] [-x] [-n]" >&2
 	cat <<- EOF
 		  Compress JPG or PNG image(s). Can handle folders and work recursively.
 
@@ -42,16 +43,18 @@ function usage() {
 		  -F : FORCE the image to be shrunk even if the file is already shrunk.
 		  -d : Delete the original image if the compressed image is smaller.
 		  -c : Clean the filename of underscores, dashes, 'IMG', etc.
+		  -e | -t : Format timestamp to the expanded model.
 		  -A : Resursively Force, Delete, and Clean.
 		  -h : Display this usage text.
 		  -x : Enable BASH debugging.
+		  -n : No file extension.
 	EOF
 	exit $status
 }
 
 ## Parameters ##
 
-while getopts ":s:l:rfFdcAhx" opt; do
+while getopts ":s:l:rfFdcetAhxn" opt; do
 	case $opt in
 		s) in_size="$OPTARG" && size="$in_size" ;;
 		l) location="$OPTARG" ;;
@@ -61,9 +64,11 @@ while getopts ":s:l:rfFdcAhx" opt; do
 		d) delete="Y" ;;
 		c) clean="Y" ;;
 		e) expand="Y" ;;
-		A) recurse="Y" && search="find" && force="Y" && delete="Y" && expand="Y" ;;
+		t) expand="Y" ;;
+		A) recurse="Y" && search="find" && force="Y" && delete="Y" ;;
 		h) usage 0 ;;
 		x) set -x ;;
+		n) use_tag="N" ;;
 		*) echo "ERROR: Option $OPTARG not recognized." >&2 && usage 1 ;;
 	esac
 done
@@ -112,6 +117,12 @@ $search "$location" | sort | while read image; do
 	fi
 
 	new_image="${image//.$extension/}.$tag-$date_YYYYMMDD.$size.$extension"
+	if [[ "$use_tag" == "N" ]]; then
+		new_image="$image"
+		new_image="${new_image//.$extension/}"
+		new_image="${new_image//.$tag/}"
+		new_image="$new_image.$tag.$extension"
+	fi
 
 	## Clean Filename ##
 	# Prevent directory from having its name cleaned too.
@@ -152,7 +163,7 @@ $search "$location" | sort | while read image; do
 	fi
 
 	# Skip if a compressed image was already created today.
-	if [[ -e "$new_image" || -e $new_image_clean ]]; then
+	if [[ (-e "$new_image" || -e $new_image_clean) && $use_tag == "Y" ]]; then
 		echo "  SKIP: Image has already been shrunk previously, moving on."
 		continue
 	fi

setup.sh

@@ -32,7 +32,7 @@ function usage {
 	      -g : Enable the General config with test contents.
 	      -w : Enable the Workstation config with test contents.
 	      -s : Enable the Server config with test contents.
-			-f : Display this system's facts.
+	      -f : Display this system's facts.
 	      -h : Display this help text.
 
 	EOF
@@ -130,6 +130,7 @@ echo "Installed!"
 if [[ "$show_facts" == "Y" ]]; then
 	echo "Showing Ansible Facts"
 	ansible localhost -m setup --connection=local
+	exit 0
 fi
 
 #echo "Adding Ansible Collections..."

tasks/general/acct_mgmt/provision_config.yml

@@ -144,6 +144,11 @@
     prod_port: "{{ lookup('ini', 'prod_port   file={{gen_file}} default=22') }}"
     prod_user: "{{ lookup('ini', 'prod_user   file={{gen_file}} default=user') }}"
 
+- name: General | Account Management | Provisioning Configuration | General | Boolean Check | Swap Block
+  set_fact:
+    swap_block: "{{ swap_block | bool }}"
+  when: swap_block in ("true", "false")
+
 - name: General | Account Management | Provisioning Configuration | General | List
   set_fact:
     provision_variables: "{{ provision_variables | combine(item) }}"
@@ -223,6 +228,11 @@
     mobile:      "{{ lookup('ini', 'mobile  file={{wrk_file}} default=false') | bool }}"
     redmode:     "{{ lookup('ini', 'redmode file={{wrk_file}} default=true' ) | bool }}"
 
+- name: General | Account Management | Provisioning Configuration | Workstation | Boolean Check | Editing
+  set_fact:
+    editing: "{{ editing | bool }}"
+  when: editing in ("true", "false")
+
 - name: General | Account Management | Provisioning Configuration | Workstation | List
   set_fact:
     provision_variables: "{{ provision_variables | combine(item) }}"

tasks/general/acct_mgmt/users.yml

@@ -145,7 +145,50 @@
         fi
         curl "https://wttr.in/${1//\ /+}"
       }
-    export_PS1: export PS1='[\u@\h \w]\$ '
+    export_PS1: |
+      ## Prompts ##
+
+      # Old Trusty
+      #export PS1='[\u@\h \w]\$ '
+
+      # 20251201 - Add time.
+      #export PS1='[\t \u@\h \w]\$ '
+
+      # 20251201 - Add colors.
+      # This helps to determine the color palette numbers:
+      #  https://robotmoon.com/bash-prompt-generator/
+      PURPLE=`tput setaf 5`
+      ORANGE=`tput setaf 214`
+      GREEN=`tput setaf 2`
+
+      RED=`tput setaf 9`
+      SCARLET=`tput setaf 1`
+      YELLOW=`tput setaf 226` # 11 does not seem to work
+
+      GRAY=`tput setaf 8`
+
+      RESET=`tput sgr0`
+      BOLD=`tput bold`
+
+      if [[ "$USER" == "root" || $UID == 0 ]]; then
+        CLR_BRACKETS=$BOLD$YELLOW
+        CLR_TIME=$BOLD$ORANGE
+        CLR_USER=$BOLD$SCARLET
+        CLR_DIR=$BOLD$RED
+        CLR_PROMPT=$BOLD$GRAY
+      else
+        CLR_BRACKETS=$RESET
+        CLR_TIME=$BOLD$PURPLE
+        CLR_USER=$BOLD$ORANGE
+        CLR_DIR=$BOLD$GREEN
+        CLR_PROMPT=$RESET
+      fi
+
+      export PS1='\[$CLR_BRACKETS\][\[$CLR_TIME\]\t \[$CLR_USER\]\u@\h \[$CLR_DIR\]\w\[$CLR_BRACKETS\]]\[$CLR_PROMPT\]\$ \[$RESET\]'
+
+      export PS2='\[$CLR_BRACKETS\](\[$CLR_TIME\]>\[$CLR_USER\]^\[$CLR_DIR\].\[$CLR_USER\]^\[$CLR_BRACKETS\])\[$CLR_TIME\]> \[$RESET\]'
+
+      ## End Prompts ##
     alias_remount: |
       alias remount='
         sudo umount /mnt/*
@@ -453,8 +496,8 @@
           return 0
         fi
 
-        docker compose down &&
         docker compose build &&
+        docker compose down &&
         docker compose up -d
 
         if [[ -n "$1" ]]; then
@@ -475,9 +518,9 @@
           return 0
         fi
 
-        docker compose down &&
         docker compose pull &&
         docker compose build &&
+        docker compose down &&
         docker compose up -d
 
         if [[ -n "$1" ]]; then
@@ -519,12 +562,12 @@
           docker ps
           return;
         fi
-        echo "*** Going Down ***" &&
-          docker compose down &&
         echo "*** Upgrading Images ***" &&
           docker compose pull &&
         echo "*** Building Containers ***" &&
           docker compose build &&
+        echo "*** Going Down ***" &&
+          docker compose down &&
         echo "*** Starting Daemons ***" &&
           docker compose up -d &&
         echo "*** Following Log ***" &&
@@ -554,6 +597,10 @@
 
         return 0
       }
+    alias_docker_other: |
+      alias docker-stop="docker compose down"
+      alias docker-start="docker compose up -d && docker compose start"
+      alias docker-prep="docker compose pull && docker compose build"
     alias_code_check: |
       alias code-check='
         echo "Checking ~/Code directory for git changes."
@@ -953,7 +1000,7 @@
 
         if [[ "$rcvr" == "main" ]]; then
           echo "*** ERROR: Are you nuts, fool!? Not main! Do it manually! ***"
-          exit 1
+          return 1
         fi
 
         if [[ -z "$base" ]]; then
@@ -963,7 +1010,7 @@
             base="dev"
           else
             echo "* Unsure which branch to use for '$rcvr'. Please specify."
-            exit 1
+            return 1
           fi
           echo "* Base was not specified, using '$base' for '$rcvr'."
         else
@@ -1007,6 +1054,18 @@
       alias reset-prod="load-branch prod main"
       alias reset-stage="load-branch stage main"
       alias reset-dev="load-branch dev main"
+      function check-code-branches {
+        for dir in ~/Code/*/; do
+          cd $dir
+          pwd
+          git ls-remote --heads
+          echo " "
+          cd ..
+        done
+      }
+      alias check-branches="check-code-branches"
+      alias check-branch="git ls-remote --heads"
+      alias branch-check="check-branch"
     alias_reload_bash: |
       alias reload-bash="source ~/.bashrc"
       alias bash-reload="reload-bash"
@@ -1024,6 +1083,38 @@
           . "$global_function"
         fi
       done
+    alias_flatpak_clean: |
+      alias flatpak-clean="flatpak uninstall --unused"
+    alias_commit: |
+      function commit_usage {
+        echo 'Usage: commit "This is a commit message"'
+      }
+      function commit {
+        if [[ -z "$1" ]]; then
+          echo "ERROR: Message must be provided."
+          commit_usage
+          return 1
+        fi
+        if [[ "$1" == "-h"* || "$1" == "--h"* ]]; then
+          commit_usage
+        fi
+        message="$1"
+        git add . &&
+        git commit -m "$message" &&
+        git push
+
+        status="$?"
+        return "$status"
+      }
+    function_loop: |
+      function loop {
+        cmd="$1"
+        while true; do
+          $cmd
+        done;
+      }
+      alias try="loop "
+
 
 - name: General | Account Management | Users | Files | Common Variable
   set_fact:
@@ -1104,6 +1195,10 @@
       {{ alias_reload_bash }}
       {{ alias_hugo_server }}
       {{ global_functions }}
+      {{ alias_docker_other }}
+      {{ alias_flatpak_clean }}
+      {{ alias_commit }}
+      {{ function_loop }}
 
 - name: General | Account Management | Users | Files | .bashrc
   blockinfile:

tasks/workstation/linux/software/flatpaks.yml

@@ -36,7 +36,6 @@
     flatpaks_generic:
       - { app: "org.mozilla.firefox", name: "firefox-flatpak", extra: "" }
       - { app: "io.gitlab.librewolf-community", name: "librewolf", extra: "" }
-      - { app: "chat.simplex.simplex", name: "simplex", extra: "" }
       - { app: "org.signal.Signal", name: "signal", extra: "" }
       - { app: "im.riot.Riot", name: "element", extra: "" }
       - { app: "org.telegram.desktop", name: "telegram", extra: "" }
@@ -44,6 +43,7 @@
       - { app: "org.libreoffice.LibreOffice", name: "office", extra: "" }
       - { app: "com.transmissionbt.Transmission", name: "transmission", extra: "" }
       - { app: "app.grayjay.Grayjay", name: "grayjay", extra: "" }
+      - { app: "com.github.xournalpp.xournalpp", name: "xournal", extra: "" }
     flatpaks_coding:
       - { app: "com.vscodium.codium", name: "codium-flatpak", extra: "" }
       - { app: "com.google.AndroidStudio", name: "android-studio", extra: "" }
@@ -57,6 +57,7 @@
       - { app: "org.tenacityaudio.Tenacity", name: "tenacity", extra: "" }
       - { app: "io.lmms.LMMS", name: "lmms", extra: "" }
       - { app: "net.sourceforge.VMPK", name: "vmpk", extra: "" }
+      - { app: "org.musicbrainz.Picard", name: "picard", extra: "" }
     flatpaks_gaming:
       - { app: "com.valvesoftware.Steam", name: "steam", extra: "" }
       - { app: "com.play0ad.zeroad", name: "zeroad", extra: "" }
@@ -72,11 +73,12 @@
       # 2022-11-20 No longer using any of these and they're taking up a lot of space. #
       - { app: "com.jetbrains.PyCharm-Community", name: "pycharm", extra: "" }
       # End 2022-11-20 #
-      - { app: "io.lbry.lbry-app", name: "lbry", extra: "dbus-launch" } # No longer supported, noticed 2023-09-01.
-      - { app: "chat.delta.desktop", name: "deltachat", extra: "" } # No longer used, removed 2023-12-18.
-      - { app: "org.gnome.Geary", name: "geary", extra: "" } # No longer used, removed 2024-12-15
+      - { app: "io.lbry.lbry-app", name: "lbry", extra: "dbus-launch" } # 2023-09-01, Noticed it is no longer supported.
+      - { app: "chat.delta.desktop", name: "deltachat", extra: "" } # 2023-12-18, No longer used.
+      - { app: "org.gnome.Geary", name: "geary", extra: "" } # 2024-12-15, No longer used.
       - { app: "org.rncbc.qsynth", name: "qsynth", extra: "" } # 2024-12-15, Not worth the setup, use LMMS or VMPK.
-      - { app: "org.godotengine.Godot", name: "godot", extra: "" } # 20250831 Stopped playing with this months / years ago.
+      - { app: "org.godotengine.Godot", name: "godot", extra: "" } # 2025-08-31, Stopped playing with this months / years ago. Seemed cool but Flutter is working well for this purpose.
+      - { app: "chat.simplex.simplex", name: "simplex", extra: "" } # 2025-11-22, Takes a ton of space and does not work without interacting with phone.
 
 # Generic #
 

tasks/workstation/linux/software/packages.yml

@@ -40,6 +40,7 @@
       - "{{ evolution }}*"
       - gparted
       - hugo
+      - wireless-tools
     state: present
 
 - name: Workstation | Linux | Software | Packages | GS Connect (KDE Connect, Android Tool)

tasks/workstation/shared/settings/gnome.yml

@@ -12,9 +12,6 @@
                       , 'org.gnome.Nautilus.desktop'
                       , 'io.gitlab.librewolf-community.desktop', 'librewolf.desktop'
                       , 'org.mozilla.firefox.desktop', 'firefox.desktop'
-                      , 'org.signal.Signal.desktop', 'signal-desktop.desktop'
-                      , 'org.telegram.desktop.desktop'
-                      , 'com.discordapp.Discord.desktop'
                       , 'com.vscodium.codium.desktop'
                       , 'codium.desktop'
                       , 'org.shotcut.Shotcut.desktop'
@@ -24,6 +21,9 @@
                       , 'com.valvesoftware.Steam.desktop'
                       , 'net.lutris.Lutris.desktop'
                       , 'mullvad-vpn.desktop'
+                      , 'org.signal.Signal.desktop', 'signal-desktop.desktop'
+                      , 'org.telegram.desktop.desktop'
+                      , 'com.discordapp.Discord.desktop'
                       ]"
     dconf_terminal: gnome-terminal
     dconf_theme: Adwaita-dark
@@ -274,6 +274,13 @@
 
       dconf write /org/gnome/desktop/media-handling/autorun-never true && inc_dconf &&
 
+      ## Gnome Terminal ##
+
+      # TBD: Do not start new tabs in previous tab's directory.
+      # The profile ID is likely unique and will need to be retrieved first.
+      #/org/gnome/terminal/legacy/profiles:/:b1dcc9dd-5262-4d8d-a863-c897e6d979b9/preserve-working-directory
+      #'never'
+
       ## Success ##
 
       sleep 0 ||