machineconfig 3.99__py3-none-any.whl → 7.66__py3-none-any.whl

machineconfig/settings/shells/wt/settings.json

@@ -6,19 +6,19 @@
     "copyOnSelect": true,
     "defaultProfile": "{574e775e-4f2a-5b96-ac1e-a2962a402336}",
     "focusFollowMouse": true,
-    "keybindings":
+    "keybindings": 
     [
         {
-            "id": "Terminal.TogglePaneZoom",
-            "keys": "ctrl+shift+z"
+            "id": "Terminal.FindText",
+            "keys": "ctrl+shift+f"
         },
         {
             "id": "Terminal.PasteFromClipboard",
             "keys": "ctrl+v"
         },
         {
-            "id": "Terminal.FindText",
-            "keys": "ctrl+shift+f"
+            "id": "Terminal.TogglePaneZoom",
+            "keys": "ctrl+shift+z"
         },
         {
             "id": "Terminal.DuplicatePaneAuto",
@@ -38,27 +38,27 @@
         }
     ],
     "launchMode": "fullscreen",
-    "newTabMenu":
+    "newTabMenu": 
     [
         {
             "type": "remainingProfiles"
         }
     ],
-    "profiles":
+    "profiles": 
     {
-        "defaults":
+        "defaults": 
         {
             "colorScheme": "Campbell (modified)",
             "padding": "0",
             "useAcrylic": false
         },
-        "list":
+        "list": 
         [
             {
                 "commandline": "pwsh",
                 "cursorColor": "#D4D8E1",
                 "cursorShape": "filledBox",
-                "font":
+                "font": 
                 {
                     "face": "CaskaydiaCove Nerd Font"
                 },
@@ -70,7 +70,7 @@
                 "startingDirectory": "%USERPROFILE%"
             },
             {
-                "commandline": "powershell.exe -Command \"$HOME/scripts/croshell.ps1\"",
+                "commandline": "powershell.exe -Command \"rr\"",
                 "guid": "{1e951406-6597-48c7-8137-b967bed19572}",
                 "name": "croshell",
                 "startingDirectory": "%USERPROFILE%"
@@ -84,7 +84,7 @@
             },
             {
                 "commandline": "%SystemRoot%\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
-                "font":
+                "font": 
                 {
                     "face": "CaskaydiaCove Nerd Font"
                 },
@@ -99,13 +99,22 @@
                 "name": "Command Prompt"
             },
             {
-                "guid": "{b453ae62-4e3d-5e58-b989-0a998ec441b8}",
+                "guid": "{b1bc5929-2f8d-5b56-8c51-3e83379a5b63}",
                 "hidden": false,
-                "name": "Azure Cloud Shell",
-                "source": "Windows.Terminal.Azure"
+                "commandline": "nu.exe",
+                "name": "nushell"
+                // "source": "Windows.Terminal.Azure"
+            },
+            {
+                "guid": "{4b9d9cef-cb7d-4a8c-8b08-0de52621c3ff}",
+                "hidden": false,
+                "commandline": "nu.exe",
+                "name": "nushell2",
+                "font": {
+                    "face": "CaskaydiaCove Nerd Font"
+                }
             },
             {
-                "guid": "{2ddc9f1a-8263-557a-8652-3db9e80a7164}",
                 "hidden": false,
                 "name": "Developer Command Prompt for VS 2022",
                 "source": "Windows.Terminal.VisualStudio"
@@ -139,10 +148,16 @@
                 "hidden": false,
                 "name": "Ubuntu 22.04.3 LTS",
                 "source": "CanonicalGroupLimited.Ubuntu22.04LTS_79rhkp1fndgsc"
+            },
+            {
+                "guid": "{988a16a9-2179-5ba2-8367-4854ea3de17d}",
+                "hidden": false,
+                "name": "Ubuntu-24.04",
+                "source": "Microsoft.WSL"
             }
         ]
     },
-    "schemes":
+    "schemes": 
     [
         {
             "background": "#000000",

machineconfig/settings/shells/zsh/init.sh

@@ -0,0 +1,89 @@
+#!/bin/zsh
+# Record script start time for runtime measurement
+# _START_TIME_NS=$(date +%s%N)
+# _show_elapsed() {
+#     local _end_ns _elapsed_ns _secs _ms
+#     _end_ns=$(date +%s%N)
+#     _elapsed_ns=$((_end_ns - _START_TIME_NS))
+#     _secs=$((_elapsed_ns / 1000000000))
+#     _ms=$((_elapsed_ns / 1000000 % 1000))
+#     printf "Script runtime: %d.%03d seconds\n" "$_secs" "$_ms"
+# }
+
+# 🛠️ Zsh Shell Configuration and Initialization
+
+add_to_path_if_not_already() {
+    for dir in "$@"; do
+        if [[ ! $PATH =~ (^|:)"${dir}"(:|$) ]]; then
+            export PATH="$PATH:${dir}"
+        fi
+    done
+}
+CONFIG_ROOT="$HOME/.config/machineconfig"
+
+# 📂 Add directories to PATH
+add_to_path_if_not_already \
+    "$CONFIG_ROOT/scripts" \
+    "$HOME/dotfiles/scripts/linux" \
+    "$HOME/.local/bin" \
+    "$HOME/.cargo/bin" \
+    "/usr/games"
+# this way, if the script was run multiple times, e.g. due to nested shells in zellij, there will be no duplicates in the path
+# export DISPLAY=localhost:0.0  # xming server
+    # "$HOME/.nix-profile/bin" \
+    # "/home/linuxbrew/.linuxbrew/bin" \
+
+# echo "Sourcing scripts ..."
+. $CONFIG_ROOT/settings/broot/br.sh
+. $CONFIG_ROOT/settings/lf/linux/exe/lfcd.sh
+. $CONFIG_ROOT/settings/tere/terecd.sh
+. $CONFIG_ROOT/settings/yazi/shell/yazi_cd.sh
+. $CONFIG_ROOT/scripts/wrap_mcfg
+
+# check if file in ~/dotfiles/machineconfig/init_linux.sh exists and source it
+if [ -f "$HOME/dotfiles/machineconfig/init_linux.sh" ]; then
+    # echo "Sourcing $HOME/dotfiles/machineconfig/init_linux.sh"
+    source "$HOME/dotfiles/machineconfig/init_linux.sh"
+fi
+
+alias l='lsd -la'
+alias d='wrap_in_shell_script devops'
+alias c='wrap_in_shell_script cloud'
+alias a='wrap_in_shell_script agents'
+alias s='wrap_in_shell_script sessions'
+alias fx='wrap_in_shell_script ftpx'
+alias f='wrap_in_shell_script fire'
+alias r='wrap_in_shell_script croshell'
+alias u='wrap_in_shell_script utils'
+alias t='wrap_in_shell_script terminal'
+alias ms='wrap_in_shell_script msearch'
+alias x='. $CONFIG_ROOT/scripts/wrap_mcfg explore'
+
+# alias gcs='gh copilot suggest -t shell'
+# alias gcg='gh copilot suggest -t git'
+# alias gce='gh copilot explain'
+# Check uniqueness of aliases
+# type gcs
+# type gcg
+# type gce
+# gcd() {
+#   x=$(history -p '!!')
+#   y=$(eval "$x" 2>&1)
+#   gh copilot explain "Input command is: $x The output is this: $y"
+# }
+
+
+# https://github.com/atuinsh/atuin
+# eval "$(atuin init bash)"
+# source /home/alex/.config/broot/launcher/bash/br
+# eval "$(thefuck --alias)"
+# from https://github.com/ajeetdsouza/zoxide
+eval "$(zoxide init zsh)"
+# from https://github.com/starship/starship
+eval "$(starship init zsh)"
+# LEVE THIS IN THE END TO AVOID EXECUTION FAILURE OF THE REST OF THE SCRIPT
+# from https://github.com/cantino/mcfly
+eval "$(mcfly init zsh)"
+# Show elapsed runtime
+# _show_elapsed
+

machineconfig/settings/svim/linux/init.toml

@@ -35,10 +35,6 @@ name = 'shell'
 default_position = 'top'
 default_height = 30
 
-[[layers]]
-  name = "lang#python"
-  python_interpreter = 'C:/Users/alex/code/machineconfig/.venv/Scripts/python.exe'
-
 [[layers]]
   name = "colorscheme"
 

machineconfig/settings/svim/windows/init.toml

@@ -35,9 +35,6 @@ name = 'shell'
 default_position = 'top'
 default_height = 30
 
-[[layers]]
-  name = "lang#python"
-  python_interpreter = '~/code/machineconfig/.venv/Scripts/python.exe'
 
 [[layers]]
   name = "colorscheme"

machineconfig/settings/yazi/init.lua

@@ -0,0 +1,57 @@
+-- https://yazi-rs.github.io/docs/tips#symlink-in-status
+-- https://yazi-rs.github.io/docs/tips#user-group-in-status
+-- https://yazi-rs.github.io/docs/tips#username-hostname-in-header
+
+-- Load Status component
+function Status:render(area)
+	self.area = area
+
+	local left = ui.Line(self:mode())
+	local right = ui.Line {}
+	local center = ui.Line {}
+
+	-- Add symlink target
+	local h = self._current.hovered
+	if h and h.link_to then
+		center = center .. ui.Span(" -> " .. tostring(h.link_to)):fg("cyan")
+	end
+
+	-- Add user:group on Unix
+	if h and ya.target_family() == "unix" then
+		right = right .. ui.Span(ya.user_name(h.cha.uid) or tostring(h.cha.uid)):fg("magenta")
+		right = right .. ui.Span(":"):fg("magenta")
+		right = right .. ui.Span(ya.group_name(h.cha.gid) or tostring(h.cha.gid)):fg("magenta")
+		right = right .. ui.Span(" ")
+	end
+
+	-- Add default status elements
+	left = left .. self:size()
+	right = self:name() .. right .. self:percentage()
+
+	return {
+		ui.Paragraph(area, { left, center }),
+		ui.Paragraph(area, { right }):align(ui.Paragraph.RIGHT),
+	}
+end
+
+-- Load Header component  
+function Header:render(area)
+	self.area = area
+	
+	local left = ui.Line {}
+	local right = ui.Line {}
+
+	-- Add username@hostname on Unix
+	if ya.target_family() == "unix" then
+		left = left .. ui.Span(ya.user_name() .. "@" .. ya.host_name() .. ":"):fg("blue")
+	end
+
+	-- Add default header elements
+	left = left .. self:cwd()
+	right = self:tabs()
+
+	return {
+		ui.Paragraph(area, { left }),
+		ui.Paragraph(area, { right }):align(ui.Paragraph.RIGHT),
+	}
+end

machineconfig/settings/yazi/keymap_linux.toml

@@ -0,0 +1,79 @@
+
+[[mgr.prepend_keymap]]
+on   = "!"
+for  = "unix"
+run  = 'shell "$SHELL" --block'
+desc = "Open $SHELL here"
+
+# If you also using Yazi on Windows:
+[[mgr.prepend_keymap]]
+on   = "!"
+for  = "windows"
+run  = 'shell "powershell.exe" --block'
+desc = "Open PowerShell here"
+
+
+# FROM https://github.com/yazi-rs/plugins/tree/main/toggle-pane.yazi
+# keymap.toml
+# parent, current, preview
+[[mgr.prepend_keymap]]
+on   = "T"
+run  = "plugin toggle-pane min-preview"
+desc = "Show or hide the preview pane"
+# keymap.toml
+[[mgr.prepend_keymap]]
+on   = "T"
+run  = "plugin toggle-pane max-preview"
+desc = "Maximize or restore the preview pane"
+
+[[mgr.prepend_keymap]]
+on = "M"            # whatever key you choose
+run = "plugin toggle-pane"
+desc = "Toggle preview pane / maximize pane"
+
+
+# https://yazi-rs.github.io/docs/tips#macos-quick-look
+[[mgr.prepend_keymap]]
+on   = "<C-p>"
+run  = 'shell -- qlmanage -p "$@"'
+
+[[mgr.prepend_keymap]]
+on   = "F"
+run  = 'shell --block -- $HOME/.config/machineconfig/scripts/wrap_mcfg fire "$0"'
+desc = "Run fire on hovered file"
+
+
+[[mgr.prepend_keymap]]
+on = [ "g", "r" ]
+run = 'shell -- ya emit cd "$(git rev-parse --show-toplevel)"'
+desc = "go to repo root"
+
+[[mgr.prepend_keymap]]
+on   = ["R", "v"]
+run  = 'shell -- code "$0"'
+desc = "Read with vscode"
+
+[[mgr.prepend_keymap]]
+on   = ["R", "h"]
+run  = 'shell --block -- $HOME/.config/machineconfig/scripts/wrap_mcfg utils edit "$0"'
+desc = "Read with helix"
+
+[[mgr.prepend_keymap]]
+on   = ["R", "c"]
+run  = 'shell --block -- $HOME/.config/machineconfig/scripts/wrap_mcfg croshell "$0"'
+desc = "Read with croshell"
+
+
+[[mgr.prepend_keymap]]
+on   = ["R", "f"]
+run  = 'shell --block -- $HOME/.config/machineconfig/scripts/wrap_mcfg fire "$0"'
+desc = "Read with fire"
+
+[[mgr.prepend_keymap]]
+on   = ["R", "F"]
+run  = 'shell --block -- $HOME/.config/machineconfig/scripts/wrap_mcfg fire -i "$0"'
+desc = "Read with fire interactively"
+
+[[mgr.prepend_keymap]]
+on  = "y"
+run = [ 'shell -- echo "$@" | cb cp0', "yank" ]

machineconfig/settings/yazi/keymap_windows.toml

@@ -0,0 +1,78 @@
+
+[[mgr.prepend_keymap]]
+on   = "!"
+for  = "unix"
+run  = 'shell "$SHELL" --block'
+desc = "Open $SHELL here"
+
+# If you also using Yazi on Windows:
+[[mgr.prepend_keymap]]
+on   = "!"
+for  = "windows"
+run  = 'shell "powershell.exe" --block'
+desc = "Open PowerShell here"
+
+# FROM https://github.com/yazi-rs/plugins/tree/main/toggle-pane.yazi
+# keymap.toml
+# parent, current, preview
+[[mgr.prepend_keymap]]
+on   = "T"
+run  = "plugin toggle-pane min-preview"
+desc = "Show or hide the preview pane"
+# keymap.toml
+[[mgr.prepend_keymap]]
+on   = "T"
+run  = "plugin toggle-pane max-preview"
+desc = "Maximize or restore the preview pane"
+
+[[mgr.prepend_keymap]]
+on = "M"            # whatever key you choose
+run = "plugin toggle-pane"
+desc = "Toggle preview pane / maximize pane"
+
+
+# https://yazi-rs.github.io/docs/tips#macos-quick-look
+[[mgr.prepend_keymap]]
+on   = "<C-p>"
+run  = 'shell -- qlmanage -p "$@"'
+
+[[mgr.prepend_keymap]]
+on   = "F"
+run  = 'shell --block -- powershell "~\.config\machineconfig\scripts\wrap_mcfg"fire "$0"'
+desc = "Run fire on hovered file"
+
+
+[[mgr.prepend_keymap]]
+on = [ "g", "r" ]
+run = 'shell -- ya emit cd "$(git rev-parse --show-toplevel)"'
+desc = "go to repo root"
+
+[[mgr.prepend_keymap]]
+on   = ["R", "v"]
+run  = 'shell -- code "$0"'
+desc = "Read with vscode"
+
+[[mgr.prepend_keymap]]
+on   = ["R", "h"]
+run  = 'shell --block -- powershell "~\.config\machineconfig\scripts\wrap_mcfg" utils edit "$0"'
+desc = "Read with helix"
+
+[[mgr.prepend_keymap]]
+on   = ["R", "c"]
+run  = 'shell --block -- powershell "~\.config\machineconfig\scripts\wrap_mcfg" croshell "$0"'
+desc = "Read with croshell"
+
+
+[[mgr.prepend_keymap]]
+on   = ["R", "f"]
+run  = 'shell --block -- powershell "~\.config\machineconfig\scripts\wrap_mcfg"fire "$0"'
+desc = "Read with fire"
+
+[[mgr.prepend_keymap]]
+on   = ["R", "F"]
+run  = 'shell --block -- powershell "~\.config\machineconfig\scripts\wrap_mcfg"fire -i "$0"'
+desc = "Read with fire interactively"
+
+[[mgr.prepend_keymap]]
+on  = "y"
+run = [ 'shell -- echo "$@" | cb cp0', "yank" ]

machineconfig/settings/yazi/shell/yazi_cd.ps1

@@ -0,0 +1,33 @@
+# function y {
+#     $tmp = (New-TemporaryFile).FullName
+#     yazi $args --cwd-file="$tmp"
+#     $cwd = Get-Content -Path $tmp -Encoding UTF8
+#     if (-not [String]::IsNullOrEmpty($cwd) -and $cwd -ne $PWD.Path) {
+#         Set-Location -LiteralPath (Resolve-Path -LiteralPath $cwd).Path
+#     }
+#     Remove-Item -Path $tmp
+# }
+function y {
+    # Save + temporarily disable WezTerm/Starship prompt marking
+    $oldWez = $env:WEZTERM_SHELL_SKIP_ALL
+    $env:WEZTERM_SHELL_SKIP_ALL = "1"   # tells WezTerm integration to skip markers (supported knob)
+    $oldTransient = $env:STARSHIP_DISABLE_TRANSIENT_PROMPT
+    $env:STARSHIP_DISABLE_TRANSIENT_PROMPT = "true"
+
+    $tmp = (New-TemporaryFile).FullName
+    try {
+        yazi $args --cwd-file="$tmp"
+        $cwd = Get-Content -Path $tmp -Encoding UTF8
+        if (-not [string]::IsNullOrEmpty($cwd) -and $cwd -ne $PWD.Path) {
+            Set-Location -LiteralPath (Resolve-Path -LiteralPath $cwd).Path
+        }
+    } finally {
+        # Clean up temp file
+        Remove-Item -Path $tmp -ErrorAction SilentlyContinue
+        # Restore env
+        if ($null -ne $oldWez) { $env:WEZTERM_SHELL_SKIP_ALL = $oldWez } else { Remove-Item Env:\WEZTERM_SHELL_SKIP_ALL -ErrorAction SilentlyContinue }
+        if ($null -ne $oldTransient) { $env:STARSHIP_DISABLE_TRANSIENT_PROMPT = $oldTransient } else { Remove-Item Env:\STARSHIP_DISABLE_TRANSIENT_PROMPT -ErrorAction SilentlyContinue }
+        # Nudge terminal back to sane modes (cursor on, no mouse, no bracketed paste)
+        Write-Host -NoNewline "`e[0m`e[?25h`e[?1000l`e[?1002l`e[?1006l`e[?2004l"
+    }
+}

machineconfig/settings/yazi/shell/yazi_cd.sh

@@ -0,0 +1,8 @@
+
+function y() {
+	local tmp="$(mktemp -t "yazi-cwd.XXXXXX")" cwd
+	yazi "$@" --cwd-file="$tmp"
+	IFS= read -r -d '' cwd < "$tmp"
+	[ -n "$cwd" ] && [ "$cwd" != "$PWD" ] && builtin cd -- "$cwd"
+	rm -f -- "$tmp"
+}

machineconfig/settings/yazi/yazi.toml

@@ -2,3 +2,16 @@
 [mgr]
 show_hidden = true
 ratio = [1, 3, 5]
+
+[plugin]
+dir = "~/.config/yazi/plugins"
+
+[[plugin.load]]
+name = "toggle-pane"
+path = "toggle-pane.yazi"
+
+
+[preview]
+# Change them to your desired values
+max_width  = 1000
+max_height = 1000

machineconfig/setup_linux/__init__.py

@@ -0,0 +1,10 @@
+
+from pathlib import Path
+
+INTERACTIVE = Path(__file__).parent.joinpath("web_shortcuts/interactive.sh")
+UV = Path(__file__).parent.joinpath("uv.sh")
+
+APPS_DESKTOP = Path(__file__).parent.joinpath("apps_desktop.sh")
+APPS_GUI = Path(__file__).parent.joinpath("apps_gui.sh")
+
+SSH_SERVER = Path(__file__).parent.joinpath("ssh/openssh_server.sh")

machineconfig/setup_linux/apps_desktop.sh

@@ -0,0 +1,89 @@
+#!/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/setup_linux/apps_gui.sh

@@ -0,0 +1,64 @@
+#!/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
+