machineconfig 5.15__tar.gz → 5.17__tar.gz

{machineconfig-5.15 → machineconfig-5.17}/MANIFEST.in

@@ -3,5 +3,5 @@ graft ./src/machineconfig/settings/*
 graft ./src/machineconfig/jobs/*
 graft ./src/machineconfig/profile/*
 graft ./src/machineconfig/scripts/*
-graft ./src/machineconfig/setup_linux/*
-graft ./src/machineconfig/setup_windows/*
+graft ./src/machineconfig/setup_linux
+graft ./src/machineconfig/setup_windows

{machineconfig-5.15/src/machineconfig.egg-info → machineconfig-5.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: machineconfig
-Version: 5.15
+Version: 5.17
 Summary: Dotfiles management package
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0

{machineconfig-5.15 → machineconfig-5.17}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "machineconfig"
-version = "5.15"
+version = "5.17"
 description = "Dotfiles management package"
 readme = "README.md"
 license = {text = "Apache 2.0"}
@@ -76,6 +76,7 @@ croshell = "machineconfig.scripts.python.croshell:arg_parser"
 
 [tool.setuptools]
 package-dir = {"" = "src"}
+include-package-data = true
 license-files = []
 
 [tool.setuptools.packages.find]
@@ -84,6 +85,7 @@ where = ["src"]
 [dependency-groups]
 dev = [
     "aider>=0.2.6",
+    "build>=1.3.0",
     "cleanpy>=0.5.1",
     "cowsay>=6.1",
     "ipdb>=0.13.13",

machineconfig-5.17/src/machineconfig/scripts/python/ai/solutions/opencode/opencode.py

@@ -0,0 +1 @@
+

{machineconfig-5.15 → machineconfig-5.17}/src/machineconfig/scripts/python/devops.py

@@ -4,11 +4,11 @@ import machineconfig.utils.installer_utils.installer as installer_entry_point
 import machineconfig.scripts.python.share_terminal as share_terminal
 import machineconfig.scripts.python.repos as repos
 
-from machineconfig import __version__
+from machineconfig.utils.installer import get_machineconfig_version
 import typer
 
 
-app = typer.Typer(help=f"🛠️ DevOps operations @ machineconfig {__version__}", no_args_is_help=True)
+app = typer.Typer(help=f"🛠️ DevOps operations @ machineconfig {get_machineconfig_version()}", no_args_is_help=True)
 app.command(name="install", help="📦 Install essential packages")(installer_entry_point.main)
 app.command(name="share-terminal", help="📡 Share terminal via web browser")(share_terminal.main)
 app.add_typer(repos.app, name="repos", help="📁 Manage git repositories")

{machineconfig-5.15 → machineconfig-5.17}/src/machineconfig/scripts/python/interactive.py

@@ -34,7 +34,8 @@ console = Console()
 
 
 def display_header() -> None:
-    header_text = Text("MACHINE CONFIGURATION", style="bold magenta")
+    from machineconfig.utils.installer import get_machineconfig_version
+    header_text = Text(f"MACHINE CONFIGURATION {get_machineconfig_version()}", style="bold magenta")
     subtitle_text = Text("Interactive Installation Script", style="italic cyan")
     console.print(Panel(f"📦 {header_text}\n{subtitle_text}", border_style="blue", padding=(1, 2)))
 def display_completion_message() -> None:
@@ -188,7 +189,6 @@ Set-Service -Name sshd -StartupType 'Automatic'"""
 
 
 def main() -> None:
-    """Main function to run the interactive installation."""
     display_header()
     selected_options = get_installation_choices()
     if not selected_options:

machineconfig-5.17/src/machineconfig/setup_linux/apps.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+
+
+# --GROUP:ESSENTIAL_SYSTEM:git,nano,net-utils,wget,curl,nala,nvm,nodejs
+echo "🔄 Updating apt package lists..."
+echo "📥 Installing nala package manager..."
+echo "📥 Installing essential network tools..."
+echo "📥 Installing Node Version Manager (NVM)..."
+sudo apt update -y || true
+sudo apt install nala -y || true
+sudo nala install curl wget gpg lsb-release apt-transport-https -y || true
+sudo nala install git net-tools htop nano -y || true
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
+echo "🔧 Configuring NVM environment..."
+export NVM_DIR="$HOME/.nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
+echo "📥 Installing latest Node.js..."
+nvm install node || true
+
+# --GROUP:TerminalEyeCandy:fortune,toilet,sl,aafire,cmatrix,hollywood,chafa
+echo "📥 Installing fortune - random wisdom generator..."
+echo "📥 Installing toilet - large ASCII text generator..."
+echo "📥 Installing sl - steam locomotive animation..."
+echo "📥 Installing aafire - ASCII art fire animation..."
+echo "📥 Installing cmatrix - Matrix-style terminal animation..."
+echo "📥 Installing hollywood - Hollywood hacker terminal effect..."
+echo "📥 Installing chafa - terminal image viewer..."
+sudo nala install cowsay -y || true
+sudo nala install lolcat -y || true
+sudo nala install boxes -y || true
+sudo nala install figlet -y || true
+sudo nala install fortune -y || true
+sudo nala install toilet -y || true
+sudo nala install chafa -y
+sudo nala install sl -y || true
+sudo nala install libaa-bin -y
+echo 'keyboard-configuration keyboard-configuration/layout select US English' | sudo debconf-set-selections
+echo 'keyboard-configuration keyboard-configuration/layoutcode string us' | sudo debconf-set-selections
+sudo DEBIAN_FRONTEND=noninteractive nala install -y cmatrix
+sudo nala install hollywood -y || true
+
+# --GROUP:NetworkTools: sshfs,samba,fuse3,nfs-common
+echo "📥 Installing sshfs - mount remote filesystems over SSH..."
+echo "📥 Installing Samba - LAN-based file sharing..."
+sudo nala install sshfs
+sudo nala install samba
+sudo nala install fuse3 -y || true
+sudo nala install nfs-common -y || true
+
+# --GROUP:DEV_SYSTEM: graphviz,make,rust,libssl-dev,sqlite3,postgresql-client,redis-tools
+echo "📥 Installing Graphviz - graph visualization software..."
+echo "📥 Installing make - build automation tool..."
+echo "📥 Installing SSL development libraries for Rust..."
+echo "📥 Installing Rust programming language and toolchain..."
+sudo nala install graphviz -y || true
+sudo nala install ffmpeg -y || true  # Required by some dev tools
+sudo nala install make -y || true  # Required by LunarVim and SpaceVim
+(curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh) || true
+sudo nala install libssl-dev -y
+
+
+# --GROUP:DATABASES: sqlite3,postgresql-client,redis-tools
+echo "📥 Installing SQLite - lightweight SQL database..."
+echo "📥 Installing PostgreSQL client..."
+echo "📥 Installing Redis command-line tools..."
+sudo nala install sqlite3 -y || true
+sudo nala install postgresql-client -y || true
+sudo nala install redis-tools -y || true

machineconfig-5.17/src/machineconfig/setup_linux/apps_desktop.sh

@@ -0,0 +1,113 @@
+#!/usr/bin/bash
+#=======================================================================
+# 🖥️ DESKTOP APPLICATIONS INSTALLATION SCRIPT
+#=======================================================================
+# This script installs desktop applications for a Linux workstation
+
+echo """#=======================================================================
+🌐 WEB BROWSERS | Installing browser applications
+#=======================================================================
+"""
+# Google Chrome installation (commented reference)
+# echo "📥 Installing Google Chrome..."
+# wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
+# sudo dpkg -i google-chrome-stable_current_amd64.deb
+
+echo """#=======================================================================
+📝 TEXT EDITORS | Installing Neovim editor
+#=======================================================================
+"""
+echo "📥 Installing Neovim via Homebrew..."
+/home/linuxbrew/.linuxbrew/bin/brew install neovim
+
+echo """#=======================================================================
+📧 EMAIL CLIENT | Installing Thunderbird
+#=======================================================================
+"""
+echo "📥 Installing Thunderbird via Flatpak..."
+flatpak install flathub org.mozilla.Thunderbird
+
+echo """#=======================================================================
+🖲️ TERMINAL EMULATOR | Installing WezTerm
+#=======================================================================
+"""
+echo "📥 Installing WezTerm via Flatpak..."
+flatpak install flathub org.wezfurlong.wezterm
+echo "🚀 Launching WezTerm..."
+flatpak run org.wezfurlong.wezterm
+
+echo """#=======================================================================
+✏️ SCREEN ANNOTATION | Installing Gromit-MPX
+#=======================================================================
+"""
+echo "📥 Installing Gromit-MPX via Flatpak..."
+flatpak install net.christianbeier.Gromit-MPX
+
+echo """#=======================================================================
+📋 CLIPBOARD MANAGERS | Installing CopyQ
+#=======================================================================
+"""
+echo "📥 Installing CopyQ via Flatpak..."
+flatpak install flathub com.github.hluk.copyq --noninteractive
+
+echo """#=======================================================================
+🔗 REMOTE DESKTOP | Installing Remmina
+#=======================================================================
+"""
+echo "📥 Installing Remmina and RDP plugin..."
+sudo nala install remmina remmina-plugin-rdp -y
+
+# Alternative Remmina installation via flatpak (reference)
+# echo "📥 Setting up Flatpak repositories..."
+# flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
+# flatpak install org.freedesktop.Platform
+# flatpak install org.freedesktop.Platform.openh264
+# flatpak install --user flathub org.remmina.Remmina
+# flatpak run --user org.remmina.Remmina
+
+echo """#=======================================================================
+🚀 APPLICATION LAUNCHER | Installing Rofi
+#=======================================================================
+"""
+echo "📥 Installing Rofi application launcher..."
+sudo nala install rofi -y
+
+echo """#=======================================================================
+📎 CLIPBOARD HISTORY | Installing Greenclip
+#=======================================================================
+"""
+# Session type detection (reference)
+# session_type=$(echo $XDG_SESSION_TYPE)
+# if [ "$session_type" == "x11" ]; then
+#     echo "Detected X11 session. Installing X11-related packages and tools..."
+#     sudo nala install xdotool xsel xclip -y
+# elif [ "$session_type" == "wayland" ]; then
+#     echo "Detected Wayland session. Installing Wayland-related packages and tools..."
+#     sudo nala install wl-copy wtype -y
+# else
+#     echo "Unknown session type: $session_type"
+#     exit 1
+# fi
+
+echo "📥 Downloading and installing Greenclip clipboard manager..."
+wget -P ~/Downloads https://github.com/erebe/greenclip/releases/download/v4.2/greenclip
+chmod +x ~/Downloads/greenclip
+sudo mv ~/Downloads/greenclip /usr/bin/
+
+echo "ℹ️ Usage instructions:"
+echo "- Start daemon: greenclip daemon &"
+echo "- With Rofi: rofi -modi \"clipboard:greenclip print\" -show clipboard -run-command '{cmd}'"
+echo "- For emoji picker: rofi -modi \"emoji:rofimoji\" -show emoji"
+echo "- Application launcher: rofi -show drun"
+
+echo """#=======================================================================
+🔄 APPLICATION LINKING | Linking applications to user space
+#=======================================================================
+"""
+echo "🔗 Creating application symlinks..."
+ln -s /home/$USER/.nix-profile/share/applications/* /home/$USER/.local/share/applications/
+
+echo """#=======================================================================
+✅ INSTALLATION COMPLETE | Desktop applications have been installed
+#=======================================================================
+"""

machineconfig-5.17/src/machineconfig/setup_linux/apps_gui.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+#=======================================================================
+# 🖥️ GUI APPLICATIONS AND DESKTOP ENVIRONMENT SETUP SCRIPT
+#=======================================================================
+# This script installs graphical user interfaces and desktop environments
+
+echo """#=======================================================================
+📦 INSTALLING GUI COMPONENTS | Setting up desktop environment
+#=======================================================================
+"""
+
+# echo "📥 Installing Nautilus file manager..."
+# sudo nala install nautilus -y  # 📂 graphical file manager
+# sudo nala install x11-apps  # 🎨 few graphical test apps like xeyes
+
+echo "📥 Installing XRDP - Remote Desktop Protocol server..."
+sudo nala install xrdp -y  # 🔌 remote desktop protocol
+
+# echo "📥 Installing X.Org server and components..."
+# sudo nala install xorg -y  # 🎯 xorg server
+# sudo nala install xinit -y  # 🚀 xorg init
+# sudo nala install xserver-xorg -y  # 🖼️ xorg server
+
+echo "📥 Installing XFCE4 desktop environment..."
+sudo nala install xfce4 -y  # 🏠 xfce4 desktop environment
+
+echo "📥 Installing XFCE4 additional components..."
+sudo nala install xfce4-goodies -y  # ✨ xfce4 desktop environment extras
+
+echo """#=======================================================================
+🔧 CONFIGURING XRDP | Setting up Remote Desktop service
+#=======================================================================
+"""
+
+# Back up original configuration
+echo "📄 Creating backup of XRDP configuration..."
+sudo cp /etc/xrdp/xrdp.ini /etc/xrdp/xrdp.ini.bak
+
+# Change default port to avoid conflict with Windows RDP
+echo "🔢 Changing XRDP port to 3391..."
+sudo sed -i 's/3389/3391/g' /etc/xrdp/xrdp.ini
+
+# Configure color depth and display settings
+echo "🎨 Configuring display quality settings..."
+sudo sed -i 's/max_bpp=32/#max_bpp=32\nmax_bpp=128/g' /etc/xrdp/xrdp.ini
+sudo sed -i 's/xserverbpp=24/#xserverbpp=24\nxserverbpp=128/g' /etc/xrdp/xrdp.ini
+
+# Set default session
+echo "🖥️ Setting up default XFCE4 session..."
+echo xfce4-session > ~/.xsession
+
+# Configure startup window manager
+echo "🚀 Configuring window manager startup..."
+sudo sed -i 's/test/#test/g' /etc/xrdp/startwm.sh
+sudo sed -i 's/exec/#exec/g' /etc/xrdp/startwm.sh
+echo "startxfce4" | sudo tee -a /etc/xrdp/startwm.sh
+
+echo """#=======================================================================
+🚀 STARTING SERVICES | Initializing XRDP service
+#=======================================================================
+"""
+
+echo "🔄 Starting XRDP service..."
+sudo /etc/init.d/xrdp start
+
+echo """#=======================================================================
+✅ SETUP COMPLETE | GUI environment has been configured
+#=======================================================================
+"""
+echo "ℹ️ Connect to this machine via Remote Desktop using port 3391"
+# Alternative commands:
+# sudo systemctl restart xrdp
+# sudo service xrdp restart
+

machineconfig-5.17/src/machineconfig/setup_linux/openssh_all.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/bash
+# 🔐 OpenSSH Server Setup and Configuration
+
+# Common pitfalls: 
+# 🚫 Wrong line endings (LF/CRLF) in config files
+# 🌐 Network port conflicts (try 2222 -> 2223) between WSL and Windows
+
+# 📁 Setup SSH directory and permissions
+mkdir -p ~/.ssh
+echo $pubkey_string >> ~/.ssh/authorized_keys
+sudo chmod 600 ~/.ssh/*
+sudo chmod 700 ~/.ssh
+echo "✅ FINISHED modifying .ssh folder attributes."
+
+# 🔄 Clean install OpenSSH server
+sudo nala purge openssh-server -y
+sudo nala install openssh-server -y
+echo "✅ FINISHED installing openssh-server."
+
+# 📝 Additional commands if needed:
+# sudo service ssh status
+# sudo nano /etc/ssh/sshd_config
+# sudo service ssh restart
+# For tunnels see: https://www.youtube.com/watch?v=Wp7boqm3Xts

machineconfig-5.17/src/machineconfig/setup_linux/openssh_wsl.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/bash
+# 🐧 WSL2 SSH Configuration for LAN Access 🌐
+# Purpose: Enable SSH access to WSL2 from LAN (requires wsl_server.ps1 in Windows)
+# Common pitfall: sshd fails after config changes due to wrong line endings/permissions
+
+# 🔍 Check if running in WSL
+if [[ $(uname -a) == *"icrosoft"* ]]; then
+  echo "✅ Running inside WSL"
+else
+  echo "❌ Not running inside WSL, no need for this script"
+  exit 0
+fi
+
+# 🔢 Set SSH port
+if [ -z "$port" ]; then
+  port=2222
+  echo "📝 Port variable not defined, setting it to $port"
+fi
+
+# 🛠️ Configure SSH
+sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak
+sudo sed -i 's/#Port 22/Port '$port'/g' /etc/ssh/sshd_config
+sudo sed -i 's/#ListenAddress 0.0.0.0/ListenAddress 0.0.0.0/g' /etc/ssh/sshd_config
+sudo sed -i 's/#PubkeyAuthentication yes/PubkeyAuthentication yes/g' /etc/ssh/sshd_config
+sudo sed -i 's/PasswordAuthentication no/PasswordAuthentication yes/g' /etc/ssh/sshd_config
+
+# 🔑 Generate host keys and restart service
+sudo service ssh start
+sudo ssh-keygen -A
+sudo service ssh --full-restart
+sudo service ssh status
+
+echo "✨ FINISHED configuring SSH in WSL2."
+
+# 📚 References:
+# Service startup: https://superuser.com/questions/1701853/how-to-enable-a-service-to-start-with-wsl2
+# WSL config: https://learn.microsoft.com/en-us/windows/wsl/networking#accessing-a-wsl-2-distribution-from-your-local-area-network-lan
+

machineconfig-5.17/src/machineconfig/setup_linux/repos.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/bash
+
+
+echo """
+#=======================================================================
+🔄 REPOSITORIES SETUP | Cloning project codebases
+#=======================================================================
+"""
+
+echo """📥 Setting up repositories...
+   🐊 crocodile     - Main utility package
+   🔧 machineconfig - System configuration tools
+"""
+
+mkdir -p $HOME/code
+cd $HOME/code
+# Setup crocodile repository
+if [ -d "crocodile" ]; then
+    echo """🔄 crocodile directory exists, updating...
+    """
+    cd crocodile
+    git reset --hard
+    git pull
+    cd ..
+else
+    echo """⏳ Cloning crocodile repository...
+    """
+    git clone https://github.com/thisismygitrepo/crocodile.git --depth 4
+fi
+
+# Setup machineconfig repository
+cd $HOME/code
+if [ -d "machineconfig" ]; then
+    echo """🔄 machineconfig directory exists, updating...
+    """
+    cd machineconfig
+    git reset --hard
+    git pull
+    cd ..
+else
+    echo """⏳ Cloning machineconfig repository...
+    """
+    git clone https://github.com/thisismygitrepo/machineconfig --depth 4  # Choose browser-based authentication.
+fi
+
+cd $HOME/code/machineconfig
+$HOME/.local/bin/uv sync --no-dev
+$HOME/.local/bin/uv cache clean

machineconfig-5.17/src/machineconfig/setup_linux/ve.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/bash
+
+if [ ! -f "$HOME/.local/bin/uv" ]; then
+    echo """📦 uv binary not found
+   ⏳ Installing uv package manager..."""
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+else
+    echo """🔄 Updating uv package manager..."""
+    $HOME/.local/bin/uv self update
+fi
+# Add uv to PATH if not already there
+if ! command -v uv &> /dev/null; then
+    echo """🔍 uv command not found in PATH
+   ➕ Adding uv to system PATH...
+"""
+    export PATH="$HOME/.local/bin:$PATH"
+fi
+echo """✅ uv is installed and ready to use."""
+
+$HOME/.local/bin/uv python install 3.13

machineconfig-5.17/src/machineconfig/setup_windows/apps.ps1

@@ -0,0 +1,61 @@
+
+# to get exact version of an app in winget, head to: https://winget.run
+
+# --GROUP:ESSENTIAL_SYSTEM:WT+Brave+VSCode+WezTerm+OhMyPosh+Powershell+Starship+Git+Neovim+GNU Nano+Terminal-Icons+PSFzf
+winget install --no-upgrade --name "Windows Terminal"             --Id "Microsoft.WindowsTerminal"  --source winget --scope user --accept-package-agreements --accept-source-agreements  # Terminal is is installed by default on W 11
+winget install --no-upgrade --name "Brave"                        --Id "Brave.Brave"                --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Microsoft Visual Studio Code" --Id "Microsoft.VisualStudioCode" --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "WezTerm"                      --Id "wez.wezterm"                --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Oh My Posh"                   --Id "JanDeDobbeleer.OhMyPosh"    --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Powershell"                   --Id "Microsoft.PowerShell"       --source winget --scope user --accept-package-agreements --accept-source-agreements  # powershell require admin
+winget install --no-upgrade --name "Starship"                     --Id "Starship.Starship"          --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Git"                          --Id "Git.Git"                    --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Neovim"                       --Id "Neovim.Neovim"              --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "GNU Nano"                     --Id "GNU.Nano"                   --source winget --scope user --accept-package-agreements --accept-source-agreements
+Install-Module -Name Terminal-Icons -Repository PSGallery -Force -AcceptLicense -PassThru -Confirm  # -RequiredVersion 2.5.10
+Install-Module -Name PSFzf  -SkipPublisherCheck  # -AcceptLicense -PassThru -Confirm  #  -RequiredVersion 2.5.10
+
+
+# --GROUP:DEV_SYSTEM:VSRedistrib+VSBuildTools+Codeblocks+GnuWin32: Make+GnuPG+graphviz+WinFsp+SSHFS-win+xming+Node.js+Rustup+Cloudflare+Cloudflare WARP+Microsoft Garage Mouse without Borders
+winget install --no-upgrade --name "VSRedistrib"                   --Id "Microsoft.VC++2015-2022Redist-x64"      --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "VSBuildTools"                  --Id "Microsoft.VisualStudio.2022.BuildTools" --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Codeblocks"                    --Id "Codeblocks.Codeblocks"                  --source winget --scope user --accept-package-agreements --accept-source-agreements  # IDE for C/C++
+winget install --no-upgrade --name "GnuWin32: Make"                --Id "GnuWin32.Make"                          --source winget --scope user --accept-package-agreements --accept-source-agreements  # required for building some python packages with native extensions, like dlib
+winget install --no-upgrade --name "GnuPG"                         --Id "GnuPG.GnuPG"                            --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "graphviz"                      --Id "Graphviz.Graphviz"                      --source winget --scope user --accept-package-agreements --accept-source-agreements  # required by pygraphviz. Used in Base.viz_object_hirarchy and Model.plot_model()
+winget install --no-upgrade --name "WinFsp"                        --Id "WinFsp.WinFsp"                          --source winget --scope user --accept-package-agreements --accept-source-agreements  # mount remote filesystems and required by rclone
+winget install --no-upgrade --name "SSHFS-win"                     --Id "SSHFS-Win.SSHFS-Win"                    --source winget --scope user --accept-package-agreements --accept-source-agreements  # mount remote filesystems  # as per https://github.com/winfsp/sshfs-win
+winget install --no-upgrade --name "xming"                         --Id "xming.xming"                            --source winget --scope user --accept-package-agreements --accept-source-agreements  # X11 server. you need this while using wsl with gui, otherwise plt.show() returns: ImportError: Cannot load backend 'TkAgg' which requires the 'tk' interactive framework, as 'headless' is currently running
+winget install --no-upgrade --name "Node.js"                       --Id "OpenJS.NodeJS"                          --source winget --scope user --accept-package-agreements --accept-source-agreements  # ncessary for nvim plugins.
+winget install --no-upgrade --name "Rustup"                        --Id "Rustlang.Rustup"                        --source winget --scope user --accept-package-agreements --accept-source-agreements  # rust compiler, necessary for some nvim plugins
+winget install --no-upgrade --name "Cloudflare"                    --Id "Cloudflare.cloudflared"                 --source winget --scope user --accept-package-agreements --accept-source-agreements  # cloudflare tunnel client, alternative to ngrok
+winget install --no-upgrade --name "Cloudflare WARP"               --Id "Cloudflare.Warp"                        --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Microsoft Garage Mouse without Borders" --Id "Microsoft.MouseWithoutBorders" --source winget --scope user --accept-package-agreements --accept-source-agreements
+
+
+# --GROUP:OTHER_WINDOWS:nu+Chrome+ChromeRemoteDesktop+Zoom+7zip+Firefox+Thunderbird+StreamlabsOBS+OBSStudio+MiKTeX+TexMaker+notepad+++Lapce+TesseractOCR+perl+DB Browser for SQLite+sql server management studio+Adobe Acrobat Reader DC+julia+Chafa+bottom+onefetch+Just+hyperfine+AWS CLI
+winget install --no-upgrade --name "nu"                                 --Id "Nushell.Nushell"                   --source winget --scope user --accept-package-agreements --accept-source-agreements  # add to userpath C:\Program Files\nu\bin, done in symlinks
+winget install --no-upgrade --name "Google Chrome"                      --Id "Google.Chrome"                     --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Chrome Remote Desktop Host"         --Id "Google.ChromeRemoteDesktop"        --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Zoom"                               --Id "Zoom.Zoom"                         --source winget    --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "7-zip"                              --Id "7zip.7zip"                         --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Mozilla Firefox"                    --Id "Mozilla.Firefox" --source winget   --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Mozilla Thunderbird (en-US)"        --Id "Mozilla.Thunderbird"               --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "StreamlabsOBS"                      --Id "Streamlabs.StreamlabsOBS"          --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "OBSStudio"                          --Id "OBSProject.OBSStudio"              --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "MiKTeX"                             --Id "MiKTeX.MiKTeX"                     --source winget   --scope user  # library / lanugage
+winget install --no-upgrade --name "TexMaker"                           --Id "Texmaker.Texmaker"                 --source winget --scope user  # IDE better than simple TexWorks shipped with MikTex. IDE is basically GUI for cmd interface of Tex
+winget install --no-upgrade --name "notepad++"                          --Id "Notepad++.Notepad++"               --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Lapce"                              --Id "Lapce.Lapce"                       --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "TesseractOCR"                       --Id "UB-Mannheim.TesseractOCR"          --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "perl"                               --Id "StrawbgnogerryPerl.StrawberryPerl"     --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "DB Browser for SQLite"              --Id "DBBrowserForSQLite.DBBrowserForSQLite" --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "sql server management studio"       --Id "Microsoft.SQLServerManagementStudio"   --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Adobe Acrobat Reader DC"            --Id "Adobe.Acrobat.Reader.64-bit"       --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "julia"                               --Id "Julialang.Julia" --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Chafa"                               --Id "hpjansson.Chafa" --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "bottom"                              --Id "Clement.bottom" --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "onefetch"                            --Id "o2sh.onefetch" --source winget --scope user  # repo-version of system fastfetch, see also tokei
+winget install --no-upgrade --name "Just"                               --Id "Casey.Just" --source winget --scope user  # commandline runner
+winget install --no-upgrade --name "hyperfine"                          --Id "sharkdp.hyperfine" --source winget --scope user  # benchmarking tool
+winget install --no-upgrade --name "AWS Command Line Interface"         --Id "Amazon.AWSCLI" --source winget --scope user --accept-package-agreements --accept-source-agreements

machineconfig-5.17/src/machineconfig/setup_windows/openssh-server.ps1

@@ -0,0 +1,39 @@
+
+$ErrorActionPreference = "Stop"
+# ALL of the following require admin priviliages:
+Set-ExecutionPolicy Bypass
+# PowerShell.exe -ExecutionPolicy Bypass -File "C:\bypass\prompt\standard.ps1" 2>&1>$null
+
+# Install SSH-Server on a windows machine. see this one below if this one didn't work:
+# to install: winget install --Id Microsoft.OpenSSH.Preview --source winget --scope user  # from: https://github.com/PowerShell/Win32-OpenSSH/wiki/Install-Win32-OpenSSH
+# the result is installed in C:\Program Files\OpenSSH as opposed to C:\Windows\System32\OpenSSH which is the case if openssh is added as a feature/capability to windows
+# However, notice the new path is not in PATH as is the cases with system variant, so it needs to be added manually.
+# finally, ssh config files are always @ "$env:ProgramData\ssh" irrespective of installation method.
+# if ssh key is created on windows, it doesn't work on linux and gives a cryptlib error. It must be read again and saved in non DOS format.
+
+Add-WindowsCapability -Online -Name OpenSSH.Server
+Add-WindowsCapability -Online -Name OpenSSH.Client
+
+#New-NetFirewallRule -Name sshd -DisplayName 'OpenSSH SSH Server' -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22 -Program "%WINDIR%\System32\OpenSSH\sshd.exe"
+
+# Must Enable ssh-agent before starting. But even before that, one need to update path so that same shell has access to the NEWLY added ssh program
+$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
+
+Set-Service -Name sshd -StartupType Automatic
+
+#Get-Service -Name ssh-agent | Set-Service -StartupType Automatic
+
+#Set-Service -Name ssh-agent -StartupType Automatic
+#Start-Service ssh-agent
+# Starting the service for the first time will populate the directory with config files.
+Start-Service sshd
+
+# Next up, change default shell to powershell, becuse CMD is lame
+# following: https://github.com/PowerShell/Win32-OpenSSH/wiki/DefaultShell
+$shell = "C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe"  # "C:\Windows\System32\wsl.exe"
+# $shell = "C:\Program Files\PowerShell\7\pwsh.exe"  # it slows SSH down because of startup time, one can still use it by running it explicitly
+New-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShell -Value $shell -PropertyType String -Force
+New-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShellCommandOption -Value "/c" -PropertyType String -Force
+
+cd ~
+mkdir .ssh -ErrorAction SilentlyContinue

machineconfig-5.17/src/machineconfig/setup_windows/openssh-server_add-sshkey.ps1

@@ -0,0 +1,32 @@
+
+# This script adds a public key to the authorized_keys file for the sshd service
+# as a result, a remote can connet to the machine if they got the corresponding private key (identity).
+
+# https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_keymanagement
+# http://woshub.com/using-ssh-key-based-authentication-on-windows/
+
+$ErrorActionPreference = "Stop"
+$sshd_dir = "$env:ProgramData\ssh"
+
+$sshfile = "$env:USERPROFILE\.ssh\pubkey.pub"  # this directory is for normal users, not admins.
+# Once they are populated, we can create administrators_authorized_keys
+
+Get-Content $sshfile >> "$sshd_dir\administrators_authorized_keys"
+
+# set appropirate persmissions for this file
+Set-Location $sshd_dir
+icacls administrators_authorized_keys /inheritance:r /grant "Administrators:F" /grant "SYSTEM:F"
+
+# Lastly, enabling public key authentication.
+$sshd_config = "$sshd_dir\sshd_config"
+(Get-Content $sshd_config) -replace '#PubkeyAuthentication', 'PubkeyAuthentication' | Out-File -encoding ASCII $sshd_config
+#(Get-Content $sshd_dir\sshd_config) -replace 'AuthorizedKeysFile __PROGRAMDATA__', '#AuthorizedKeysFile __PROGRAMDATA__' | Out-File -encoding ASCII $sshd_config
+#(Get-Content $sshd_dir\sshd_config) -replace 'Match Group administrators', '#Match Group administrators' | Out-File -encoding ASCII $sshd_config
+#cat C:\ProgramData\ssh\sshd_config
+
+# to load the fresh settings, we need to restart the service:
+Restart-Service sshd -Force
+
+#Write-Host "Use this to Login/test Now"
+#write-host ssh $env:UserName@localhost
+# debug tip: use nano editor to inspect files above, if unreadable max-text format is used, ssh won't work.

machineconfig-5.17/src/machineconfig/setup_windows/openssh-server_add_identity.ps1

@@ -0,0 +1,11 @@
+
+# on the side of the local machine, you need to sort out the following:
+# if the $sshfile doesn't have a standard name, you will need to explicitly specify the identity while SSHing (e.g. ssh u@s -i ~/.ssh/my_id)
+# However, this must be done every time. For permanent solutions, use .ssh/config
+
+$sshfile = "$env:USERPROFILE\.ssh\id_rsa"
+
+Set-Service ssh-agent -StartupType Manual  # allow the service to be started manually
+ssh-agent  # start the service
+ssh-add.exe $sshfile # add the key to the agent
+