From f1dbe75a9a55f6c07f1b49e25130e822cc57a7d0 Mon Sep 17 00:00:00 2001
From: coops <dcooper344@gmail.com>
Date: Tue, 3 Feb 2026 15:28:53 +1100
Subject: [PATCH 1/4] updated the  user_scripts/hypr/screen_rotate.sh script to
 only rotate the screen the mouse is active on and retains the monitor
 configurations for multi monitor setups

---
 user_scripts/hypr/screen_rotate.sh | 85 ++++++++++++++++++++++--------
 1 file changed, 62 insertions(+), 23 deletions(-)

diff --git a/user_scripts/hypr/screen_rotate.sh b/user_scripts/hypr/screen_rotate.sh
index a27168af..fa059917 100755
--- a/user_scripts/hypr/screen_rotate.sh
+++ b/user_scripts/hypr/screen_rotate.sh
@@ -67,48 +67,87 @@ esac
 
 # 5. Hardware Detection (Smart Query)
 # ------------------------------------------------------------------------------
-# We fetch the entire JSON blob once to minimize IPC calls (Performance).
-# We strictly select index [0] as per your "single monitor system" constraint.
+# Fetch all monitors to handle multi-monitor setups
 MON_STATE=$(hyprctl monitors -j)
 
-# Extract precise values using jq
-NAME=$(printf "%s" "$MON_STATE" | jq -r '.[0].name')
-SCALE=$(printf "%s" "$MON_STATE" | jq -r '.[0].scale')
-CURRENT_TRANSFORM=$(printf "%s" "$MON_STATE" | jq -r '.[0].transform')
+# Count number of monitors
+MON_COUNT=$(printf "%s" "$MON_STATE" | jq 'length')
 
-# Validation: Ensure we actually found a monitor
-if [[ -z "$NAME" || "$NAME" == "null" ]]; then
+# Validation: Ensure we actually found monitors
+if [[ "$MON_COUNT" -eq 0 ]]; then
     printf "%s[ERROR]%s No active monitors detected via Hyprland IPC.\n" \
         "$C_RED" "$C_RESET" >&2
     exit 1
 fi
 
-# 6. Transformation Logic (Modulo Arithmetic)
+# 6. Detect Active Monitor (where mouse cursor is)
 # ------------------------------------------------------------------------------
-# Hyprland Transforms: 0=Normal, 1=90, 2=180, 3=270
-# The '+ 4' ensures we handle negative wraparounds correctly in Bash logic.
-NEW_TRANSFORM=$(( (CURRENT_TRANSFORM + DIRECTION + 4) % 4 ))
+# Get cursor position
+CURSOR_INFO=$(hyprctl cursorpos)
+CURSOR_X=$(echo "$CURSOR_INFO" | awk '{print $1}' | tr -d ',')
+CURSOR_Y=$(echo "$CURSOR_INFO" | awk '{print $2}')
+
+printf "%s[INFO]%s Cursor position: %d, %d\n" \
+    "$C_BLUE" "$C_RESET" "$CURSOR_X" "$CURSOR_Y"
+
+# Find which monitor contains the cursor
+ACTIVE_MONITOR=""
+for i in $(seq 0 $((MON_COUNT - 1))); do
+    MON_NAME=$(printf "%s" "$MON_STATE" | jq -r ".[$i].name")
+    MON_X=$(printf "%s" "$MON_STATE" | jq -r ".[$i].x")
+    MON_Y=$(printf "%s" "$MON_STATE" | jq -r ".[$i].y")
+    MON_WIDTH=$(printf "%s" "$MON_STATE" | jq -r ".[$i].width")
+    MON_HEIGHT=$(printf "%s" "$MON_STATE" | jq -r ".[$i].height")
+
+    # Check if cursor is within this monitor's bounds
+    if [[ $CURSOR_X -ge $MON_X ]] && [[ $CURSOR_X -lt $((MON_X + MON_WIDTH)) ]] && \
+       [[ $CURSOR_Y -ge $MON_Y ]] && [[ $CURSOR_Y -lt $((MON_Y + MON_HEIGHT)) ]]; then
+        ACTIVE_MONITOR="$i"
+        printf "%s[INFO]%s Detected active monitor: %s%s%s\n" \
+            "$C_BLUE" "$C_RESET" "$C_BOLD" "$MON_NAME" "$C_RESET"
+        break
+    fi
+done
+
+# Fallback to first monitor if detection fails
+if [[ -z "$ACTIVE_MONITOR" ]]; then
+    ACTIVE_MONITOR="0"
+    printf "%s[WARNING]%s Could not detect cursor monitor, using first monitor.\n" \
+        "$C_YELLOW" "$C_RESET"
+fi
 
-# 7. Execution (State overwrite)
+# 7. Rotate Only the Active Monitor
 # ------------------------------------------------------------------------------
-# We use 'preferred' and 'auto' to remain robust against resolution changes,
-# but we STRICTLY inject the detected $SCALE to prevent UI scaling issues.
+# Extract monitor details for the active monitor
+NAME=$(printf "%s" "$MON_STATE" | jq -r ".[$ACTIVE_MONITOR].name")
+SCALE=$(printf "%s" "$MON_STATE" | jq -r ".[$ACTIVE_MONITOR].scale")
+CURRENT_TRANSFORM=$(printf "%s" "$MON_STATE" | jq -r ".[$ACTIVE_MONITOR].transform")
+WIDTH=$(printf "%s" "$MON_STATE" | jq -r ".[$ACTIVE_MONITOR].width")
+HEIGHT=$(printf "%s" "$MON_STATE" | jq -r ".[$ACTIVE_MONITOR].height")
+REFRESH=$(printf "%s" "$MON_STATE" | jq -r ".[$ACTIVE_MONITOR].refreshRate")
+POS_X=$(printf "%s" "$MON_STATE" | jq -r ".[$ACTIVE_MONITOR].x")
+POS_Y=$(printf "%s" "$MON_STATE" | jq -r ".[$ACTIVE_MONITOR].y")
+
+# Calculate new transform using modulo arithmetic
+# Hyprland Transforms: 0=Normal, 1=90, 2=180, 3=270
+NEW_TRANSFORM=$(( (CURRENT_TRANSFORM + DIRECTION + 4) % 4 ))
 
 printf "%s[INFO]%s Rotating %s%s%s (Scale: %s): %d -> %d\n" \
     "$C_BLUE" "$C_RESET" "$C_BOLD" "$NAME" "$C_RESET" "$SCALE" "$CURRENT_TRANSFORM" "$NEW_TRANSFORM"
 
-# Apply the new configuration immediately via IPC
-if hyprctl keyword monitor "${NAME}, preferred, auto, ${SCALE}, transform, ${NEW_TRANSFORM}" > /dev/null; then
-    printf "%s[SUCCESS]%s Rotation applied successfully.\n" \
-        "$C_GREEN" "$C_RESET"
-    
-    # Notify user visually if notify-send is available (optional UX improvement)
+# Apply rotation while preserving position
+# Use exact resolution and position to maintain layout
+if hyprctl keyword monitor "${NAME}, ${WIDTH}x${HEIGHT}@${REFRESH}, ${POS_X}x${POS_Y}, ${SCALE}, transform, ${NEW_TRANSFORM}" > /dev/null; then
+    printf "%s[SUCCESS]%s Rotation applied for %s.\n" \
+        "$C_GREEN" "$C_RESET" "$NAME"
+
+    # Notify user visually if notify-send is available
     if command -v notify-send &> /dev/null; then
         notify-send -a "System" "Display Rotated" "Monitor: $NAME\nTransform: $NEW_TRANSFORM" -h string:x-canonical-private-synchronous:display-rotate
     fi
 else
-    printf "%s[ERROR]%s Failed to apply Hyprland keyword.\n" \
-        "$C_RED" "$C_RESET" >&2
+    printf "%s[ERROR]%s Failed to apply rotation for %s.\n" \
+        "$C_RED" "$C_RESET" "$NAME" >&2
     exit 1
 fi
 

From 8f6db54191546b9e94dc50bcb2b360b14ce6c104 Mon Sep 17 00:00:00 2001
From: coops <dcooper344@gmail.com>
Date: Tue, 3 Feb 2026 16:04:25 +1100
Subject: [PATCH 2/4] testing some update pre and post script functionality,
 this should give the users some finer control over their local changes.
 indended for stand alone optional scripts or if you like the functionality to
 be folded into the existing update_dusky.sh script

---
 .../TEST_PRE_POST_UPDATE_README.md            | 131 +++++++++++
 .../update_dusky/TEST_post_update_merge.sh    | 218 ++++++++++++++++++
 .../update_dusky/TEST_pre_update_check.sh     | 163 +++++++++++++
 3 files changed, 512 insertions(+)
 create mode 100644 user_scripts/update_dusky/TEST_PRE_POST_UPDATE_README.md
 create mode 100755 user_scripts/update_dusky/TEST_post_update_merge.sh
 create mode 100755 user_scripts/update_dusky/TEST_pre_update_check.sh

diff --git a/user_scripts/update_dusky/TEST_PRE_POST_UPDATE_README.md b/user_scripts/update_dusky/TEST_PRE_POST_UPDATE_README.md
new file mode 100644
index 00000000..c03fca79
--- /dev/null
+++ b/user_scripts/update_dusky/TEST_PRE_POST_UPDATE_README.md
@@ -0,0 +1,131 @@
+# Dusky Update Helper Scripts
+
+These scripts help you manage local changes to tracked files when running dusky system updates.
+
+## Problem
+
+When you run the dusky update, it does a `git reset --hard` to get the latest upstream changes. This can overwrite your local customizations. While the update script stashes your changes, it's not always clear:
+- What you've changed locally
+- What changed upstream
+- Whether you need to merge changes
+
+## Solution
+
+These helper scripts give you visibility and control over the update process.
+
+## Usage
+
+### 1. Before Update: `pre_update_check.sh`
+
+Run this **BEFORE** running the dusky update:
+
+```bash
+~/user_scripts/update_dusky/pre_update_check.sh
+```
+
+**What it does:**
+- Shows all your local changes to tracked files
+- Categorizes them (Hyprland configs, scripts, desktop files, etc.)
+- Optionally shows detailed diffs
+- **Creates a timestamped backup** of all your changes
+- Saves a full diff patch for reference
+
+**Output:**
+- Backup directory: `~/Documents/dusky_update_backups/YYYYMMDD_HHMMSS/`
+- Modified files list
+- Full diff patch
+
+### 2. Run Dusky Update
+
+```bash
+~/user_scripts/update_dusky/update_dusky.sh
+```
+
+The update will proceed as normal, stashing and applying changes.
+
+### 3. After Update: `post_update_merge.sh`
+
+Run this **AFTER** the update completes:
+
+```bash
+~/user_scripts/update_dusky/post_update_merge.sh
+```
+
+**What it does:**
+- Compares your backed-up files with the current versions
+- Detects which files changed upstream
+- Identifies potential conflicts (both you and upstream modified the same file)
+- **Interactive conflict resolution** for each conflicting file
+
+**Options for each conflict:**
+1. Keep current version (from update)
+2. Restore your backed-up version
+3. Open 3-way merge editor (vimdiff)
+4. Skip and decide later
+
+## Example Workflow
+
+```bash
+# 1. Check what you've changed
+~/user_scripts/update_dusky/pre_update_check.sh
+
+# Review the output, see your changes
+
+# 2. Run the update
+~/user_scripts/update_dusky/update_dusky.sh
+
+# 3. Merge your changes back
+~/user_scripts/update_dusky/post_update_merge.sh
+
+# Review conflicts and choose how to resolve them
+```
+
+## File Categories
+
+The scripts categorize your changes into:
+- **Hyprland Config** - Files in `~/.config/hypr/`
+- **Other Config** - Other files in `~/.config/`
+- **User Scripts** - Files in `~/user_scripts/`
+- **Desktop Files** - Files in `~/.local/share/applications/`
+- **Other** - Everything else
+
+## Backup Location
+
+Backups are stored in:
+```
+~/Documents/dusky_update_backups/YYYYMMDD_HHMMSS/
+```
+
+Each backup contains:
+- All modified files (full copies)
+- `modified_files.txt` - List of files that were modified
+- `full_diff.patch` - Complete diff of all changes
+- `metadata.sh` - Timestamp and file count info
+
+## Manual Recovery
+
+You can always manually restore files from the backup:
+
+```bash
+# List backups
+ls -lt ~/Documents/dusky_update_backups/
+
+# Compare a specific file
+diff -u ~/Documents/dusky_update_backups/YYYYMMDD_HHMMSS/path/to/file ~/path/to/file
+
+# Restore a file
+cp ~/Documents/dusky_update_backups/YYYYMMDD_HHMMSS/path/to/file ~/path/to/file
+```
+
+## Tips
+
+- Run `pre_update_check.sh` every time before updating
+- Keep old backups - they're timestamped so you can track history
+- Use the detailed diff option to review your changes before updating
+- For complex merges, option 3 (vimdiff) gives you full control
+
+## Requirements
+
+- `git` (already required for dusky)
+- `diff` (standard on all Linux systems)
+- `vimdiff` (optional, for 3-way merge - install with `pacman -S vim`)
diff --git a/user_scripts/update_dusky/TEST_post_update_merge.sh b/user_scripts/update_dusky/TEST_post_update_merge.sh
new file mode 100755
index 00000000..d0f903ab
--- /dev/null
+++ b/user_scripts/update_dusky/TEST_post_update_merge.sh
@@ -0,0 +1,218 @@
+#!/usr/bin/env bash
+# ==============================================================================
+# POST-UPDATE HELPER: Compare and merge local changes after dusky update
+# ==============================================================================
+# Usage: Run this AFTER ~/user_scripts/update_dusky/update_dusky.sh
+# ==============================================================================
+
+set -euo pipefail
+
+# ANSI Colors
+readonly C_RED=$'\e[31m'
+readonly C_GREEN=$'\e[32m'
+readonly C_YELLOW=$'\e[33m'
+readonly C_BLUE=$'\e[34m'
+readonly C_CYAN=$'\e[36m'
+readonly C_MAGENTA=$'\e[35m'
+readonly C_BOLD=$'\e[1m'
+readonly C_RESET=$'\e[0m'
+
+# Paths
+readonly GIT_DIR="${HOME}/dusky"
+readonly WORK_TREE="${HOME}"
+readonly BACKUP_BASE="${HOME}/Documents/dusky_update_backups"
+
+# Git command
+GIT_CMD=(git --git-dir="$GIT_DIR" --work-tree="$WORK_TREE")
+
+# ==============================================================================
+# FUNCTIONS
+# ==============================================================================
+
+print_header() {
+    printf '\n%s%s%s\n' "$C_CYAN" "$1" "$C_RESET"
+    printf '%s\n' "$(printf '=%.0s' {1..80})"
+}
+
+print_section() {
+    printf '\n%s%s%s\n' "$C_BOLD" "$1" "$C_RESET"
+}
+
+# ==============================================================================
+# MAIN
+# ==============================================================================
+
+print_header "DUSKY POST-UPDATE MERGE HELPER"
+
+# Find the most recent backup
+if [[ ! -d "$BACKUP_BASE" ]]; then
+    printf '%s[ERROR]%s No backups found. Did you run pre_update_check.sh first?\n' "$C_RED" "$C_RESET" >&2
+    exit 1
+fi
+
+LATEST_BACKUP=$(find "$BACKUP_BASE" -maxdepth 1 -type d -name "2*" 2>/dev/null | sort -r | head -n1)
+
+if [[ -z "$LATEST_BACKUP" ]]; then
+    printf '%s[ERROR]%s No backup directories found in %s\n' "$C_RED" "$C_RESET" "$BACKUP_BASE" >&2
+    exit 1
+fi
+
+printf 'Using backup from: %s%s%s\n' "$C_BLUE" "$LATEST_BACKUP" "$C_RESET"
+
+# Load metadata
+if [[ -f "${LATEST_BACKUP}/metadata.sh" ]]; then
+    source "${LATEST_BACKUP}/metadata.sh"
+    printf 'Backed up %s%d%s files at %s%s%s\n' "$C_YELLOW" "$FILE_COUNT" "$C_RESET" "$C_CYAN" "$TIMESTAMP" "$C_RESET"
+fi
+
+# Read modified files list
+if [[ ! -f "${LATEST_BACKUP}/modified_files.txt" ]]; then
+    printf '%s[ERROR]%s Modified files list not found in backup\n' "$C_RED" "$C_RESET" >&2
+    exit 1
+fi
+
+mapfile -t MODIFIED_FILES < "${LATEST_BACKUP}/modified_files.txt"
+
+# Analyze each file
+print_section "Analyzing Changes..."
+
+declare -a unchanged_files=()
+declare -a upstream_changed=()
+declare -a user_only_changed=()
+declare -a both_changed=()
+
+for file in "${MODIFIED_FILES[@]}"; do
+    [[ -z "$file" ]] && continue
+
+    backup_file="${LATEST_BACKUP}/${file}"
+    current_file="${WORK_TREE}/${file}"
+
+    # Check if file exists in backup
+    if [[ ! -f "$backup_file" ]]; then
+        continue
+    fi
+
+    # Check if current file exists
+    if [[ ! -f "$current_file" ]]; then
+        user_only_changed+=("$file [DELETED UPSTREAM]")
+        continue
+    fi
+
+    # Compare backup with current
+    if diff -q "$backup_file" "$current_file" > /dev/null 2>&1; then
+        # Files are identical - your changes were preserved or upstream didn't change
+        unchanged_files+=("$file")
+    else
+        # Files differ - check if upstream changed
+        # Get the version from before the update (from git history)
+        old_upstream=$("${GIT_CMD[@]}" show "HEAD@{1}:${file}" 2>/dev/null || echo "")
+        new_upstream=$("${GIT_CMD[@]}" show "HEAD:${file}" 2>/dev/null || echo "")
+
+        if [[ "$old_upstream" != "$new_upstream" ]]; then
+            # Upstream changed
+            both_changed+=("$file")
+        else
+            # Only user changed (stash was applied successfully)
+            user_only_changed+=("$file")
+        fi
+    fi
+done
+
+# Display results
+print_header "ANALYSIS RESULTS"
+
+if [[ ${#unchanged_files[@]} -gt 0 ]]; then
+    printf '\n%s✓ Unchanged (%d files):%s\n' "$C_GREEN" "${#unchanged_files[@]}" "$C_RESET"
+    printf '%sYour changes were preserved (or upstream didn't change these files)%s\n' "$C_GREEN" "$C_RESET"
+    for file in "${unchanged_files[@]}"; do
+        printf '  • %s\n' "$file"
+    done
+fi
+
+if [[ ${#user_only_changed[@]} -gt 0 ]]; then
+    printf '\n%s⚠ Changed After Update (%d files):%s\n' "$C_YELLOW" "${#user_only_changed[@]}" "$C_RESET"
+    printf '%sThese files changed during the update (likely your stash was applied)%s\n' "$C_YELLOW" "$C_RESET"
+    for file in "${user_only_changed[@]}"; do
+        printf '  • %s\n' "$file"
+    done
+fi
+
+if [[ ${#both_changed[@]} -gt 0 ]]; then
+    printf '\n%s⚠ CONFLICTS (%d files):%s\n' "$C_RED" "${#both_changed[@]}" "$C_RESET"
+    printf '%sBoth you AND upstream modified these files - may need manual merge%s\n' "$C_RED" "$C_RESET"
+    for file in "${both_changed[@]}"; do
+        printf '  • %s\n' "$file"
+    done
+fi
+
+# Interactive merge for conflicting files
+if [[ ${#both_changed[@]} -gt 0 ]]; then
+    print_section "Conflict Resolution"
+
+    for file in "${both_changed[@]}"; do
+        printf '\n%s━━━ %s ━━━%s\n' "$C_MAGENTA" "$file" "$C_RESET"
+
+        backup_file="${LATEST_BACKUP}/${file}"
+        current_file="${WORK_TREE}/${file}"
+
+        printf '\n%sWhat changed upstream:%s\n' "$C_YELLOW" "$C_RESET"
+        "${GIT_CMD[@]}" diff "HEAD@{1}:${file}" "HEAD:${file}" 2>/dev/null || printf '%s[Unable to show upstream diff]%s\n' "$C_RED" "$C_RESET"
+
+        printf '\n%sYour changes (backed up version vs current):%s\n' "$C_YELLOW" "$C_RESET"
+        diff -u "$backup_file" "$current_file" 2>/dev/null || printf '%s[Files are different]%s\n' "$C_RED" "$C_RESET"
+
+        printf '\n%sOptions:%s\n' "$C_BOLD" "$C_RESET"
+        printf '  1. Keep current (from update, your stash may have been applied)\n'
+        printf '  2. Restore your version (overwrite with backup)\n'
+        printf '  3. Open 3-way merge editor (if available)\n'
+        printf '  4. Skip (decide later)\n'
+        printf '\nChoice [1-4, default: 4]: '
+
+        read -r choice
+        choice="${choice:-4}"
+
+        case "$choice" in
+            1)
+                printf '%s✓ Keeping current version%s\n' "$C_GREEN" "$C_RESET"
+                ;;
+            2)
+                cp "$backup_file" "$current_file"
+                printf '%s✓ Restored your version from backup%s\n' "$C_GREEN" "$C_RESET"
+                ;;
+            3)
+                if command -v vimdiff &>/dev/null; then
+                    upstream_old=$(mktemp)
+                    upstream_new=$(mktemp)
+                    "${GIT_CMD[@]}" show "HEAD@{1}:${file}" > "$upstream_old" 2>/dev/null || true
+                    "${GIT_CMD[@]}" show "HEAD:${file}" > "$upstream_new" 2>/dev/null || true
+
+                    printf '%sOpening vimdiff...%s\n' "$C_CYAN" "$C_RESET"
+                    vimdiff "$backup_file" "$current_file" "$upstream_new"
+
+                    rm -f "$upstream_old" "$upstream_new"
+                else
+                    printf '%s[ERROR]%s vimdiff not found. Install vim for 3-way merge.%s\n' "$C_RED" "$C_RESET"
+                fi
+                ;;
+            4)
+                printf '%sSkipped - backup available at:%s\n' "$C_YELLOW" "$C_RESET"
+                printf '  %s\n' "$backup_file"
+                ;;
+            *)
+                printf '%s[Invalid choice]%s Skipping...\n' "$C_RED" "$C_RESET"
+                ;;
+        esac
+    done
+fi
+
+# Final summary
+print_header "SUMMARY"
+
+printf '\n%sBackup location:%s %s\n' "$C_BLUE" "$C_RESET" "$LATEST_BACKUP"
+printf '\n%sYou can manually compare files using:%s\n' "$C_CYAN" "$C_RESET"
+printf '  diff -u %s/<file> ~/<file>\n' "$LATEST_BACKUP"
+
+printf '\n%sTo restore any file from backup:%s\n' "$C_CYAN" "$C_RESET"
+printf '  cp %s/<file> ~/<file>\n' "$LATEST_BACKUP"
+
+printf '\n%sDone!%s\n\n' "$C_GREEN" "$C_RESET"
diff --git a/user_scripts/update_dusky/TEST_pre_update_check.sh b/user_scripts/update_dusky/TEST_pre_update_check.sh
new file mode 100755
index 00000000..b0f037ad
--- /dev/null
+++ b/user_scripts/update_dusky/TEST_pre_update_check.sh
@@ -0,0 +1,163 @@
+#!/usr/bin/env bash
+# ==============================================================================
+# PRE-UPDATE HELPER: Check and backup local changes before dusky update
+# ==============================================================================
+# Usage: Run this BEFORE ~/user_scripts/update_dusky/update_dusky.sh
+# ==============================================================================
+
+set -euo pipefail
+
+# ANSI Colors
+readonly C_RED=$'\e[31m'
+readonly C_GREEN=$'\e[32m'
+readonly C_YELLOW=$'\e[33m'
+readonly C_BLUE=$'\e[34m'
+readonly C_CYAN=$'\e[36m'
+readonly C_BOLD=$'\e[1m'
+readonly C_RESET=$'\e[0m'
+
+# Paths
+readonly GIT_DIR="${HOME}/dusky"
+readonly WORK_TREE="${HOME}"
+readonly BACKUP_BASE="${HOME}/Documents/dusky_update_backups"
+readonly TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+readonly BACKUP_DIR="${BACKUP_BASE}/${TIMESTAMP}"
+
+# Git command
+GIT_CMD=(git --git-dir="$GIT_DIR" --work-tree="$WORK_TREE")
+
+# ==============================================================================
+# FUNCTIONS
+# ==============================================================================
+
+print_header() {
+    printf '\n%s%s%s\n' "$C_CYAN" "$1" "$C_RESET"
+    printf '%s\n' "$(printf '=%.0s' {1..80})"
+}
+
+print_section() {
+    printf '\n%s%s%s\n' "$C_BOLD" "$1" "$C_RESET"
+}
+
+# ==============================================================================
+# MAIN
+# ==============================================================================
+
+print_header "DUSKY PRE-UPDATE CHECK - ${TIMESTAMP}"
+
+# Check if we're in a dusky repo
+if [[ ! -d "$GIT_DIR" ]]; then
+    printf '%s[ERROR]%s Dusky git directory not found: %s\n' "$C_RED" "$C_RESET" "$GIT_DIR" >&2
+    exit 1
+fi
+
+# Get list of modified files
+print_section "Checking for local changes..."
+
+MODIFIED_FILES=$("${GIT_CMD[@]}" diff --name-only 2>/dev/null || true)
+
+if [[ -z "$MODIFIED_FILES" ]]; then
+    printf '%s✓ No local changes detected%s\n' "$C_GREEN" "$C_RESET"
+    printf 'You can safely run the dusky update.\n'
+    exit 0
+fi
+
+# Count files
+FILE_COUNT=$(echo "$MODIFIED_FILES" | wc -l)
+printf '%s⚠ Found %d modified file(s)%s\n\n' "$C_YELLOW" "$FILE_COUNT" "$C_RESET"
+
+# Show modified files by category
+print_section "Modified Files by Category:"
+
+# Categorize files
+declare -A categories
+while IFS= read -r file; do
+    if [[ "$file" =~ ^\.config/hypr/ ]]; then
+        categories["Hyprland Config"]+="$file"$'\n'
+    elif [[ "$file" =~ ^\.config/ ]]; then
+        categories["Other Config"]+="$file"$'\n'
+    elif [[ "$file" =~ ^user_scripts/ ]]; then
+        categories["User Scripts"]+="$file"$'\n'
+    elif [[ "$file" =~ ^\.local/share/applications/ ]]; then
+        categories["Desktop Files"]+="$file"$'\n'
+    else
+        categories["Other"]+="$file"$'\n'
+    fi
+done <<< "$MODIFIED_FILES"
+
+# Print categorized files
+for category in "${!categories[@]}"; do
+    printf '\n%s%s:%s\n' "$C_BLUE" "$category" "$C_RESET"
+    echo "${categories[$category]}" | while IFS= read -r file; do
+        [[ -z "$file" ]] && continue
+        printf '  • %s\n' "$file"
+    done
+done
+
+# Ask if user wants to see detailed diffs
+printf '\n%sWould you like to see detailed diffs? [y/N]%s ' "$C_YELLOW" "$C_RESET"
+read -r show_diff
+
+if [[ "$show_diff" =~ ^[Yy]$ ]]; then
+    print_section "Detailed Changes:"
+
+    while IFS= read -r file; do
+        [[ -z "$file" ]] && continue
+        printf '\n%s━━━ %s ━━━%s\n' "$C_CYAN" "$file" "$C_RESET"
+        "${GIT_CMD[@]}" diff --color=always "$file" 2>/dev/null || printf '%s[ERROR reading diff]%s\n' "$C_RED" "$C_RESET"
+    done <<< "$MODIFIED_FILES"
+fi
+
+# Create backup
+print_section "Creating Backup..."
+
+if mkdir -p "$BACKUP_DIR" 2>/dev/null; then
+    # Save file list
+    echo "$MODIFIED_FILES" > "${BACKUP_DIR}/modified_files.txt"
+
+    # Backup each file
+    backup_count=0
+    while IFS= read -r file; do
+        [[ -z "$file" ]] && continue
+
+        src="${WORK_TREE}/${file}"
+        dest="${BACKUP_DIR}/${file}"
+
+        if [[ -f "$src" ]]; then
+            mkdir -p "$(dirname "$dest")" 2>/dev/null || true
+            if cp -a "$src" "$dest" 2>/dev/null; then
+                ((backup_count++))
+            fi
+        fi
+    done <<< "$MODIFIED_FILES"
+
+    # Save full diff
+    "${GIT_CMD[@]}" diff > "${BACKUP_DIR}/full_diff.patch" 2>/dev/null || true
+
+    printf '%s✓ Backed up %d file(s) to:%s\n' "$C_GREEN" "$backup_count" "$C_RESET"
+    printf '  %s\n' "$BACKUP_DIR"
+else
+    printf '%s[ERROR]%s Failed to create backup directory\n' "$C_RED" "$C_RESET" >&2
+    exit 1
+fi
+
+# Summary
+print_header "SUMMARY"
+
+printf '%s• Modified files:%s %d\n' "$C_YELLOW" "$C_RESET" "$FILE_COUNT"
+printf '%s• Backup location:%s %s\n' "$C_GREEN" "$C_RESET" "$BACKUP_DIR"
+
+printf '\n%sNext Steps:%s\n' "$C_BOLD" "$C_RESET"
+printf '1. Review the changes above\n'
+printf '2. Run the dusky update: %s~/user_scripts/update_dusky/update_dusky.sh%s\n' "$C_CYAN" "$C_RESET"
+printf '3. After update, run: %s~/user_scripts/update_dusky/post_update_merge.sh%s\n' "$C_CYAN" "$C_RESET"
+
+# Create metadata for post-update script
+cat > "${BACKUP_DIR}/metadata.sh" <<EOF
+# Metadata for post-update merge
+TIMESTAMP="${TIMESTAMP}"
+FILE_COUNT="${FILE_COUNT}"
+BACKUP_DIR="${BACKUP_DIR}"
+EOF
+
+printf '\n'

From 9a43c6eb1e9c70c4eae154bb02c81870893f6981 Mon Sep 17 00:00:00 2001
From: coops <dcooper344@gmail.com>
Date: Thu, 5 Feb 2026 22:07:22 +1100
Subject: [PATCH 3/4] for testing of Single gpu pass through. this is untested
 and will need someone to test, gaving issues with virt man and cant get a vm
 up

---
 .../GPU-PASSTHROUGH-TESTING-GUIDE.md          | 427 +++++++++
 .../IMPLEMENTATION-SUMMARY.md                 | 387 ++++++++
 .../PATH-VERIFICATION.md                      | 103 ++
 .../README-GPU-PASSTHROUGH.md                 | 148 +++
 .../gpu-passthrough-preflight-check.sh        | 227 +++++
 .../install-gpu-passthrough-hooks.sh          | 109 +++
 .../libvirt-hooks/qemu                        |  24 +
 .../win11/prepare/begin/start.sh              | 128 +++
 .../libvirt-hooks/win11/release/end/stop.sh   |  83 ++
 .../single-gpu-passthrough-guide.md           | 887 ++++++++++++++++++
 .../test-gpu-bind-unbind.sh                   | 158 ++++
 .../validate-gpu-passthrough-ready.sh         | 175 ++++
 12 files changed, 2856 insertions(+)
 create mode 100644 user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/GPU-PASSTHROUGH-TESTING-GUIDE.md
 create mode 100644 user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/IMPLEMENTATION-SUMMARY.md
 create mode 100644 user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/PATH-VERIFICATION.md
 create mode 100644 user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/README-GPU-PASSTHROUGH.md
 create mode 100755 user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/gpu-passthrough-preflight-check.sh
 create mode 100755 user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/install-gpu-passthrough-hooks.sh
 create mode 100644 user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/qemu
 create mode 100644 user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/win11/prepare/begin/start.sh
 create mode 100644 user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/win11/release/end/stop.sh
 create mode 100644 user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/single-gpu-passthrough-guide.md
 create mode 100755 user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/test-gpu-bind-unbind.sh
 create mode 100755 user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/validate-gpu-passthrough-ready.sh

diff --git a/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/GPU-PASSTHROUGH-TESTING-GUIDE.md b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/GPU-PASSTHROUGH-TESTING-GUIDE.md
new file mode 100644
index 00000000..27cd42b4
--- /dev/null
+++ b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/GPU-PASSTHROUGH-TESTING-GUIDE.md
@@ -0,0 +1,427 @@
+# GPU Passthrough Testing Guide with Safety Timeout
+
+This guide will help you safely test GPU passthrough with automatic revert functionality.
+
+## System Configuration
+
+- **CPU:** Intel i7-14700KF (NO integrated graphics)
+- **GPU:** NVIDIA RTX 4090 (01:00.0)
+- **Audio:** NVIDIA Audio (01:00.1)
+- **Display Manager:** SDDM
+- **Local IP:** 10.10.10.9
+
+## Safety Features
+
+All scripts include:
+1. ✅ **Automatic timeout** - VM shuts down after specified minutes
+2. ✅ **Error handling** - Attempts to restore GPU if binding fails
+3. ✅ **Comprehensive logging** - All actions logged to journald
+4. ✅ **Cleanup traps** - Ensures restoration on script errors
+
+## Testing Phases
+
+### Phase 1: Pre-Flight Checks (5 minutes)
+
+Run the system verification script:
+
+```bash
+cd ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH
+./gpu-passthrough-preflight-check.sh
+```
+
+**Expected output:**
+- ✅ IOMMU enabled
+- ✅ GPU and Audio devices found
+- ✅ SSH running
+- ✅ virt-manager installed
+
+**If any errors:** Fix them before proceeding.
+
+---
+
+### Phase 2: Test GPU Bind/Unbind (2 minutes)
+
+This test verifies the GPU can be bound to vfio-pci and restored WITHOUT starting a VM.
+
+**IMPORTANT:** Your display will go BLACK for 30 seconds during this test!
+
+**Setup:**
+1. Have SSH ready on phone/laptop: `ssh coops@10.10.10.9`
+2. Save all work and close applications using GPU
+3. Run the test:
+
+```bash
+cd ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH
+sudo ./test-gpu-bind-unbind.sh 30  # 30 seconds test
+```
+
+**What happens:**
+1. Display goes BLACK (SDDM stops, nvidia unloads)
+2. GPU binds to vfio-pci
+3. Waits 30 seconds
+4. GPU returns to nvidia
+5. Display returns (SDDM starts)
+
+**Via SSH, monitor the test:**
+```bash
+# Watch logs in real-time
+sudo journalctl -f | grep -E "gpu|nvidia|vfio"
+
+# Check current GPU driver
+watch -n 1 'lspci -k -s 01:00.0 | grep "Kernel driver"'
+```
+
+**Success criteria:**
+- ✅ Display goes black, then returns after 30 seconds
+- ✅ No error messages in logs
+- ✅ Desktop fully functional after restoration
+
+**If it fails:**
+- Display doesn't return: Via SSH, run `sudo systemctl start sddm`
+- Check logs: `sudo journalctl -t vm-gpu-start -t vm-gpu-stop -n 100`
+
+---
+
+### Phase 3: Install Hooks (1 minute)
+
+Install the libvirt hooks for automatic GPU passthrough:
+
+```bash
+cd ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH
+sudo ./install-gpu-passthrough-hooks.sh win11
+sudo systemctl restart libvirtd
+```
+
+**Verify installation:**
+```bash
+ls -la /etc/libvirt/hooks/
+ls -la /etc/libvirt/hooks/qemu.d/win11/
+```
+
+Should show:
+```
+/etc/libvirt/hooks/qemu (executable)
+/etc/libvirt/hooks/qemu.d/win11/prepare/begin/start.sh (executable)
+/etc/libvirt/hooks/qemu.d/win11/release/end/stop.sh (executable)
+```
+
+---
+
+### Phase 4: Create Windows VM (30-45 minutes)
+
+Follow the documentation in:
+```
+/home/coops/git/dusky/Documents/pensive/linux/Important Notes/KVM/Windows/
+```
+
+**Key steps:**
+1. Launch virt-manager
+2. Create new VM with Windows 11 ISO
+3. Configure: Q35 chipset, UEFI firmware, TPM 2.0
+4. Set CPU to host-passthrough
+5. Use VirtIO for storage and network
+6. Attach virtio-win ISO
+7. Install Windows
+
+**DO NOT add GPU to VM XML yet!** First verify Windows boots without GPU passthrough.
+
+---
+
+### Phase 5: Add GPU to VM (5 minutes)
+
+Once Windows is installed and working with QXL display:
+
+```bash
+# Edit VM configuration
+sudo virsh edit win11
+```
+
+Add inside `<devices>` section (BEFORE the closing `</devices>` tag):
+
+```xml
+<!-- NVIDIA RTX 4090 GPU -->
+<hostdev mode='subsystem' type='pci' managed='yes'>
+  <source>
+    <address domain='0x0000' bus='0x01' slot='0x00' function='0x0'/>
+  </source>
+</hostdev>
+
+<!-- NVIDIA Audio -->
+<hostdev mode='subsystem' type='pci' managed='yes'>
+  <source>
+    <address domain='0x0000' bus='0x01' slot='0x00' function='0x1'/>
+  </source>
+</hostdev>
+```
+
+Save and exit (`:wq` in vi).
+
+**Verify XML:**
+```bash
+sudo virsh dumpxml win11 | grep -A5 hostdev
+```
+
+---
+
+### Phase 6: First GPU Passthrough Test (10 minutes)
+
+**CRITICAL SETUP:**
+
+1. **Open SSH session from another device:**
+   ```bash
+   ssh coops@10.10.10.9
+   ```
+
+2. **Set safety timeout (5 minutes for first test):**
+   ```bash
+   export GPU_PASSTHROUGH_TIMEOUT=5
+   echo "export GPU_PASSTHROUGH_TIMEOUT=5" >> ~/.bashrc
+   ```
+
+3. **Verify timeout is set:**
+   ```bash
+   echo $GPU_PASSTHROUGH_TIMEOUT  # Should show: 5
+   ```
+
+4. **Start monitoring logs (in SSH session):**
+   ```bash
+   sudo journalctl -f -t vm-gpu-start -t vm-gpu-stop -t vm-gpu-timeout
+   ```
+
+5. **From host desktop, start the VM:**
+   ```bash
+   virsh start win11
+   # OR use virt-manager GUI
+   ```
+
+**What happens:**
+
+```
+Time    Event
+----    -----
+0:00    Click "Start" in virt-manager
+0:02    Display goes BLACK (host loses graphics)
+0:05    Hook script completes
+0:10    Windows should appear on physical monitor
+0:15    Use Windows normally
+5:00    VM automatically shuts down (safety timeout)
+5:05    Display returns to Linux desktop
+```
+
+**Via SSH, monitor status:**
+```bash
+# Check if VM is running
+watch -n 2 'virsh list --all'
+
+# Check GPU driver
+watch -n 2 'lspci -k -s 01:00.0 | grep "Kernel driver"'
+
+# Should show: vfio-pci when VM is running
+#              nvidia when VM is stopped
+```
+
+**Success criteria:**
+- ✅ Linux display goes black within 5 seconds
+- ✅ Physical monitor shows Windows boot within 60 seconds
+- ✅ Windows is usable with GPU
+- ✅ After 5 minutes, VM shuts down automatically
+- ✅ Linux desktop returns within 10 seconds
+
+**If something goes wrong:**
+
+Via SSH:
+```bash
+# Force stop VM
+sudo virsh destroy win11
+
+# Run recovery
+gpu-recovery
+
+# Or manually restore
+sudo /etc/libvirt/hooks/qemu.d/win11/release/end/stop.sh
+
+# Check logs for errors
+sudo journalctl -t vm-gpu-start -t vm-gpu-stop -n 100
+```
+
+---
+
+## Phase 7: Extended Testing (Optional)
+
+Once the 5-minute test works perfectly, try longer durations:
+
+```bash
+# 15 minute test
+export GPU_PASSTHROUGH_TIMEOUT=15
+virsh start win11
+
+# 30 minute test
+export GPU_PASSTHROUGH_TIMEOUT=30
+virsh start win11
+
+# Disable timeout (use manually)
+export GPU_PASSTHROUGH_TIMEOUT=0
+virsh start win11
+# You must manually shut down Windows or run: virsh shutdown win11
+```
+
+---
+
+## Troubleshooting
+
+### Display never returns after VM shuts down
+
+**Via SSH:**
+```bash
+# Check if VM is actually stopped
+virsh list --all
+
+# Check GPU driver
+lspci -k -s 01:00.0 | grep "Kernel driver"
+
+# If still vfio-pci, manually run stop script
+sudo /etc/libvirt/hooks/qemu.d/win11/release/end/stop.sh
+
+# Force restart display manager
+sudo systemctl restart sddm
+```
+
+### VM doesn't show on monitor
+
+**Possible causes:**
+1. Windows hasn't installed NVIDIA drivers yet (first boot)
+2. Monitor input not switched correctly
+3. GPU ROM issue (rare)
+
+**Check via SSH:**
+```bash
+# Verify GPU is in VM
+sudo virsh dumpxml win11 | grep -A5 hostdev
+
+# Check VM is actually running
+virsh list --all
+
+# Check GPU driver
+lspci -k -s 01:00.0  # Should show: vfio-pci
+```
+
+### nvidia module won't unload
+
+**Via SSH:**
+```bash
+# Check what's using nvidia
+sudo lsof /dev/nvidia*
+
+# Common culprits:
+# - Docker containers with nvidia runtime
+# - Wayland compositor
+# - Steam, Discord with hardware acceleration
+
+# Stop those services first, then retry
+```
+
+### VM crashes or freezes
+
+**Via SSH:**
+```bash
+# Check VM logs
+sudo tail -f /var/log/libvirt/qemu/win11.log
+
+# Force destroy VM
+sudo virsh destroy win11
+
+# GPU should auto-restore via stop hook
+# If not, manually run:
+gpu-recovery
+```
+
+---
+
+## Log Locations
+
+```bash
+# Hook execution logs
+sudo journalctl -t vm-gpu-start
+sudo journalctl -t vm-gpu-stop
+sudo journalctl -t vm-gpu-timeout
+
+# Libvirt logs
+sudo journalctl -u libvirtd
+
+# VM console output
+sudo tail -f /var/log/libvirt/qemu/win11.log
+
+# All GPU-related logs from last boot
+sudo journalctl -b -t vm-gpu-start -t vm-gpu-stop -t vm-gpu-timeout
+```
+
+---
+
+## Quick Reference Commands
+
+```bash
+# Start VM with timeout
+export GPU_PASSTHROUGH_TIMEOUT=5
+virsh start win11
+
+# Stop VM manually
+virsh shutdown win11        # Graceful shutdown
+virsh destroy win11         # Force stop
+
+# Check VM status
+virsh list --all
+
+# Check GPU driver
+lspci -k -s 01:00.0 | grep "Kernel driver"
+
+# Emergency recovery
+gpu-recovery
+
+# Watch logs
+sudo journalctl -f -t vm-gpu-start -t vm-gpu-stop
+
+# Test bind/unbind without VM
+sudo ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/test-gpu-bind-unbind.sh 30
+```
+
+---
+
+## Safety Checklist
+
+Before EVERY test:
+- [ ] SSH accessible from another device
+- [ ] Know your IP address (10.10.10.9)
+- [ ] Timeout is set (`echo $GPU_PASSTHROUGH_TIMEOUT`)
+- [ ] All work saved
+- [ ] No other applications using GPU
+- [ ] Have phone/laptop ready for SSH
+
+---
+
+## Next Steps After Successful Testing
+
+1. **Install NVIDIA drivers in Windows VM**
+2. **Test gaming/applications**
+3. **Adjust timeout or disable it**
+4. **Consider network streaming (Sunshine/Moonlight) if you want to view VM from other devices**
+5. **Set up shared folders between host and VM**
+
+---
+
+## Removing GPU Passthrough
+
+If you want to go back to standard VM without GPU:
+
+```bash
+# Edit VM
+sudo virsh edit win11
+
+# Remove the <hostdev> blocks for GPU and Audio
+# Save and exit
+
+# Delete hooks (optional)
+sudo rm -rf /etc/libvirt/hooks/qemu.d/win11
+sudo systemctl restart libvirtd
+```
+
+The GPU will stay with the host (nvidia driver) all the time.
diff --git a/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/IMPLEMENTATION-SUMMARY.md b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/IMPLEMENTATION-SUMMARY.md
new file mode 100644
index 00000000..59f64ff4
--- /dev/null
+++ b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/IMPLEMENTATION-SUMMARY.md
@@ -0,0 +1,387 @@
+# GPU Passthrough Implementation Summary
+
+## What Has Been Completed ✓
+
+### 1. System Verification ✓
+- Confirmed i7-14700KF (NO integrated GPU)
+- NVIDIA RTX 4090 at PCI 01:00.0
+- IOMMU enabled and working
+- SSH daemon active at 10.10.10.9
+- SDDM display manager running
+
+### 2. Hook Scripts with Safety Timeout ✓
+
+Created and ready to install:
+- `/home/coops/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/qemu` - Main dispatcher
+- `/home/coops/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/win11/prepare/begin/start.sh` - Start hook
+- `/home/coops/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/win11/release/end/stop.sh` - Stop hook
+
+**Key Features:**
+- ✅ Automatic VM shutdown after timeout (default: 5 minutes)
+- ✅ Comprehensive error handling and recovery
+- ✅ Detailed logging to journald
+- ✅ Validation of PCI devices before operations
+- ✅ Cleanup traps to prevent stuck states
+
+### 3. Testing and Validation Scripts ✓
+
+Created in `/home/coops/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/`:
+- `gpu-passthrough-preflight-check.sh` - System readiness check
+- `test-gpu-bind-unbind.sh` - Test GPU binding without VM
+- `install-gpu-passthrough-hooks.sh` - Install hooks to /etc/libvirt/
+- `validate-gpu-passthrough-ready.sh` - Final readiness check
+
+### 4. Documentation ✓
+
+Created comprehensive guides:
+- `GPU-PASSTHROUGH-TESTING-GUIDE.md` - Complete testing procedure
+- `single-gpu-passthrough-guide.md` - Updated with corrections for no-iGPU systems
+- `single-gpu-passthrough-audit.md` - Technical audit findings
+
+---
+
+## What You Need to Do Next
+
+### Step 1: Test GPU Bind/Unbind (5 minutes)
+
+This tests the GPU can be bound to vfio-pci WITHOUT starting a VM:
+
+```bash
+# Have SSH ready on phone/laptop first!
+# ssh coops@10.10.10.9
+
+cd ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH
+sudo ./test-gpu-bind-unbind.sh 30
+```
+
+**What happens:**
+- Your display will go BLACK for 30 seconds
+- GPU binds to vfio-pci, then back to nvidia
+- Display returns automatically
+
+**Success = Ready to proceed. Failure = Check logs and troubleshoot.**
+
+---
+
+### Step 2: Install Hook Scripts (2 minutes)
+
+```bash
+cd ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/Single_GPU_KVM_PASSTHROUGH
+sudo ./install-gpu-passthrough-hooks.sh win11
+sudo systemctl restart libvirtd
+```
+
+Verify:
+```bash
+ls -la /etc/libvirt/hooks/
+ls -la /etc/libvirt/hooks/qemu.d/win11/
+```
+
+---
+
+### Step 3: Create Windows VM (30-45 minutes)
+
+Follow the documented procedure in:
+```
+~/Documents/pensive/linux/Important Notes/KVM/Windows/
++ MOC Windows Installation Through Virt Manager.md
+```
+
+**Key configuration:**
+- Name: win11 (must match hook directory name!)
+- Chipset: Q35
+- Firmware: UEFI with Secure Boot
+- CPU: host-passthrough
+- Storage: VirtIO (with virtio-win ISO)
+- Network: VirtIO
+- TPM: 2.0 emulated
+- Hyper-V enlightenments enabled
+
+**Important:** Test the VM works BEFORE adding GPU passthrough!
+
+---
+
+### Step 4: Add GPU to VM XML (5 minutes)
+
+Once Windows is installed and working:
+
+```bash
+sudo virsh edit win11
+```
+
+Add inside `<devices>`:
+
+```xml
+<!-- NVIDIA RTX 4090 -->
+<hostdev mode='subsystem' type='pci' managed='yes'>
+  <source>
+    <address domain='0x0000' bus='0x01' slot='0x00' function='0x0'/>
+  </source>
+</hostdev>
+
+<!-- NVIDIA Audio -->
+<hostdev mode='subsystem' type='pci' managed='yes'>
+  <source>
+    <address domain='0x0000' bus='0x01' slot='0x00' function='0x1'/>
+  </source>
+</hostdev>
+```
+
+---
+
+### Step 5: First GPU Passthrough Test (10 minutes)
+
+**CRITICAL PREPARATION:**
+
+1. **Open SSH on phone/laptop:**
+   ```bash
+   ssh coops@10.10.10.9
+   ```
+
+2. **Set safety timeout:**
+   ```bash
+   export GPU_PASSTHROUGH_TIMEOUT=5  # 5 minutes
+   echo 'export GPU_PASSTHROUGH_TIMEOUT=5' >> ~/.bashrc
+   ```
+
+3. **Validate readiness:**
+   ```bash
+   ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/validate-gpu-passthrough-ready.sh win11
+   ```
+
+4. **Start monitoring (in SSH session):**
+   ```bash
+   sudo journalctl -f -t vm-gpu-start -t vm-gpu-stop -t vm-gpu-timeout
+   ```
+
+5. **Start the VM:**
+   ```bash
+   virsh start win11
+   ```
+
+**What will happen:**
+
+| Time | Event | What You See |
+|------|-------|--------------|
+| 0:00 | VM starts | Linux desktop |
+| 0:05 | GPU unbinds | Display goes BLACK |
+| 0:10 | VM boots | Physical monitor shows Windows |
+| 0:15-5:00 | VM running | Windows on monitor, host is headless |
+| 5:00 | Timeout | VM shuts down |
+| 5:05 | GPU restores | Linux desktop returns |
+
+**Success criteria:**
+- ✅ Display goes black smoothly
+- ✅ Windows appears on monitor
+- ✅ VM is usable (install NVIDIA drivers in Windows if needed)
+- ✅ After 5 minutes, VM shuts down automatically
+- ✅ Linux desktop returns
+
+**If something goes wrong:**
+- Via SSH: `sudo virsh destroy win11` (force stop)
+- Via SSH: `gpu-recovery` (restore GPU to host)
+- Check logs: `sudo journalctl -t vm-gpu-start -n 50`
+
+---
+
+## Directory Structure Created
+
+```
+/home/coops/user_scripts_local/Single_GPU_KVM_PASSTHROUGH
+├── gpu-passthrough-preflight-check.sh          ← System check
+├── test-gpu-bind-unbind.sh                     ← Test without VM
+├── install-gpu-passthrough-hooks.sh            ← Install hooks
+├── validate-gpu-passthrough-ready.sh           ← Final check
+├── GPU-PASSTHROUGH-TESTING-GUIDE.md            ← Complete guide
+├── single-gpu-passthrough-guide.md             ← Updated guide
+├── single-gpu-passthrough-audit.md             ← Audit report
+└── libvirt-hooks/
+    ├── qemu                                     ← Main dispatcher
+    └── win11/
+        ├── prepare/begin/start.sh               ← VM start hook
+        └── release/end/stop.sh                  ← VM stop hook
+
+After installation:
+/etc/libvirt/hooks/                             ← Installed hooks
+```
+
+---
+
+## Safety Features Summary
+
+### Automatic Timeout
+- Default: 5 minutes (adjustable)
+- VM automatically shuts down after timeout
+- Prevents being stuck with headless host
+- Disable with: `export GPU_PASSTHROUGH_TIMEOUT=0`
+
+### Error Handling
+- Validates PCI devices exist
+- Checks nvidia modules unload successfully
+- Attempts to restore GPU if binding fails
+- Restarts display manager on errors
+
+### Logging
+- All actions logged to journald
+- View with: `sudo journalctl -t vm-gpu-start -t vm-gpu-stop`
+- Includes timestamps and error messages
+- Helps troubleshooting when things go wrong
+
+### Recovery Options
+1. Automatic cleanup on script errors
+2. Manual recovery via SSH: `gpu-recovery`
+3. Force stop VM: `virsh destroy win11`
+4. TTY access: Ctrl+Alt+F2
+5. Hard reboot (last resort)
+
+---
+
+## Configuration Summary
+
+| Setting | Value |
+|---------|-------|
+| VM Name | win11 |
+| GPU PCI | 0000:01:00.0 |
+| Audio PCI | 0000:01:00.1 |
+| Display Manager | sddm |
+| SSH IP | 10.10.10.9 |
+| Default Timeout | 5 minutes |
+| Current GPU Driver | nvidia |
+
+---
+
+## Important Reminders
+
+### ⚠️ Your System Has NO Integrated Graphics
+
+When the VM runs:
+- **Host becomes completely headless**
+- **NO display output from host**
+- **Monitor shows ONLY the VM**
+- **Control host ONLY via SSH**
+
+This is NOT like systems with iGPU where:
+- Host keeps display on integrated graphics
+- Looking Glass shows VM in a window
+- Both host and VM have displays simultaneously
+
+**Your workflow:**
+1. Linux desktop visible
+2. Start VM → display goes BLACK
+3. Monitor shows Windows
+4. Stop VM → Linux desktop returns
+
+### 🔒 SSH is MANDATORY
+
+You MUST have SSH access from another device:
+- Phone with Termux
+- Laptop on same network
+- Another computer
+
+Test SSH BEFORE attempting GPU passthrough!
+
+### ⏱️ Safety Timeout is Your Friend
+
+For testing, ALWAYS use a timeout:
+```bash
+export GPU_PASSTHROUGH_TIMEOUT=5  # 5 minutes
+```
+
+Once you're confident everything works, you can disable it:
+```bash
+export GPU_PASSTHROUGH_TIMEOUT=0  # No automatic shutdown
+```
+
+---
+
+## Next Steps Checklist
+
+- [ ] Run preflight check: `./gpu-passthrough-preflight-check.sh`
+- [ ] Test GPU bind/unbind: `sudo ./test-gpu-bind-unbind.sh 30`
+- [ ] Install hooks: `sudo ./install-gpu-passthrough-hooks.sh win11`
+- [ ] Create Windows VM using virt-manager
+- [ ] Test VM boots without GPU
+- [ ] Add GPU to VM XML: `sudo virsh edit win11`
+- [ ] Validate readiness: `./validate-gpu-passthrough-ready.sh win11`
+- [ ] Set timeout: `export GPU_PASSTHROUGH_TIMEOUT=5`
+- [ ] Have SSH ready on another device
+- [ ] First test: `virsh start win11`
+- [ ] Monitor via SSH: `sudo journalctl -f -t vm-gpu-start`
+- [ ] Verify VM appears on monitor
+- [ ] Wait for automatic shutdown (5 min)
+- [ ] Verify Linux desktop returns
+- [ ] Install NVIDIA drivers in Windows
+- [ ] Test gaming/applications
+- [ ] Adjust or disable timeout as needed
+
+---
+
+## Getting Help
+
+### View Logs
+```bash
+# Start hook logs
+sudo journalctl -t vm-gpu-start -n 50
+
+# Stop hook logs
+sudo journalctl -t vm-gpu-stop -n 50
+
+# Timeout logs
+sudo journalctl -t vm-gpu-timeout -n 50
+
+# All GPU passthrough logs
+sudo journalctl -b | grep -E "gpu|vfio|nvidia"
+
+# VM console output
+sudo tail -f /var/log/libvirt/qemu/win11.log
+```
+
+### Check Status
+```bash
+# Is VM running?
+virsh list --all
+
+# What driver is GPU using?
+lspci -k -s 01:00.0 | grep "Kernel driver"
+
+# Is SSH accessible?
+systemctl status sshd
+
+# What's the current timeout?
+echo $GPU_PASSTHROUGH_TIMEOUT
+```
+
+### Common Issues
+See `GPU-PASSTHROUGH-TESTING-GUIDE.md` Troubleshooting section
+
+---
+
+## Files Ready for Review
+
+Before running any tests, you may want to review:
+
+1. **Start hook:** `~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/win11/prepare/begin/start.sh`
+2. **Stop hook:** `~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/win11/release/end/stop.sh`
+3. **Testing guide:** `~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/GPU-PASSTHROUGH-TESTING-GUIDE.md`
+
+All scripts include comprehensive comments explaining each step.
+
+---
+
+## Ready to Begin
+
+When you're ready to start testing:
+
+```bash
+# Step 1: Preflight check
+cd ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH
+./gpu-passthrough-preflight-check.sh
+
+# Step 2: Test bind/unbind (DISPLAY WILL GO BLACK FOR 30 SEC)
+# Have SSH ready first!
+sudo ./test-gpu-bind-unbind.sh 30
+
+# If that works, proceed with VM creation and GPU passthrough!
+```
+
+Good luck! 🚀
diff --git a/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/PATH-VERIFICATION.md b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/PATH-VERIFICATION.md
new file mode 100644
index 00000000..447b9d3e
--- /dev/null
+++ b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/PATH-VERIFICATION.md
@@ -0,0 +1,103 @@
+# Path Verification Report
+
+## Status: ✅ ALL PATHS UPDATED
+
+All file paths have been verified and updated to include the new subdirectory:
+`/home/coops/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/`
+
+## Files Checked and Updated
+
+### Shell Scripts (.sh)
+- ✅ gpu-passthrough-preflight-check.sh
+- ✅ install-gpu-passthrough-hooks.sh
+  - Line 37: SOURCE_DIR updated
+- ✅ test-gpu-bind-unbind.sh
+- ✅ validate-gpu-passthrough-ready.sh
+  - Line 43: Error message path updated
+  - Line 141: Test script path updated
+  - Line 147: GPU recovery path updated
+
+### Hook Scripts
+- ✅ libvirt-hooks/qemu
+- ✅ libvirt-hooks/win11/prepare/begin/start.sh
+- ✅ libvirt-hooks/win11/release/end/stop.sh
+
+### Documentation (.md)
+- ✅ README-GPU-PASSTHROUGH.md
+  - All "cd ~/user_scripts_local" → "cd ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH"
+  - "Keep these in" line updated
+- ✅ IMPLEMENTATION-SUMMARY.md
+  - All "cd ~/user_scripts_local" → "cd ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH"
+  - "Created in" line updated
+  - All script reference paths updated
+- ✅ GPU-PASSTHROUGH-TESTING-GUIDE.md
+  - All "cd ~/user_scripts_local" → "cd ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH"
+  - sudo command path updated (line 384)
+- ✅ single-gpu-passthrough-guide.md
+  - (No user_scripts_local references - already correct)
+
+## Verification Commands Run
+
+```bash
+# Check for old paths without subdirectory
+grep -rn "user_scripts_local" . --include="*.sh" --include="*.md" | \
+  grep -E "(~/|/home/|HOME)" | \
+  grep -v "Single_GPU_KVM_PASSTHROUGH" | wc -l
+# Result: 0 (no old paths remaining)
+
+# Verify all paths include the subdirectory
+grep -rn "user_scripts_local/Single_GPU_KVM_PASSTHROUGH" . --include="*.sh" --include="*.md" | wc -l
+# Result: Multiple correct references found
+```
+
+## All Correct Path Formats
+
+The following path formats are now used consistently:
+
+1. **Absolute paths:**
+   - `/home/coops/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/`
+
+2. **Tilde paths:**
+   - `~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/`
+
+3. **$HOME paths:**
+   - `$HOME/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/`
+
+4. **$SUDO_USER paths (in root scripts):**
+   - `/home/$SUDO_USER/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/`
+
+## Quick Start (Updated)
+
+All commands now work with the new directory structure:
+
+```bash
+cd ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH
+
+# Check system
+./gpu-passthrough-preflight-check.sh
+
+# Test binding
+sudo ./test-gpu-bind-unbind.sh 30
+
+# Install hooks
+sudo ./install-gpu-passthrough-hooks.sh win11
+
+# Validate readiness
+./validate-gpu-passthrough-ready.sh win11
+```
+
+## Files Modified
+
+Total files updated: 5
+
+1. IMPLEMENTATION-SUMMARY.md (multiple path references)
+2. README-GPU-PASSTHROUGH.md (multiple path references)
+3. GPU-PASSTHROUGH-TESTING-GUIDE.md (multiple path references)
+4. validate-gpu-passthrough-ready.sh (3 path references)
+5. This file (PATH-VERIFICATION.md) - created
+
+## Verification Date
+
+Last verified: 2026-02-03
+
+Status: ✅ Ready to use
diff --git a/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/README-GPU-PASSTHROUGH.md b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/README-GPU-PASSTHROUGH.md
new file mode 100644
index 00000000..652d3fe5
--- /dev/null
+++ b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/README-GPU-PASSTHROUGH.md
@@ -0,0 +1,148 @@
+# GPU Passthrough Scripts and Documentation
+
+## Quick Start
+
+```bash
+cd ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH
+
+# 1. Check system readiness
+./gpu-passthrough-preflight-check.sh
+
+# 2. Test GPU binding (display will go black for 30 seconds!)
+#    Have SSH ready first: ssh coops@10.10.10.9
+sudo ./test-gpu-bind-unbind.sh 30
+
+# 3. If test passes, install hooks
+sudo ./install-gpu-passthrough-hooks.sh win11
+
+# 4. Create Windows VM (follow documentation)
+
+# 5. Validate everything is ready
+./validate-gpu-passthrough-ready.sh win11
+
+# 6. Start testing with safety timeout
+export GPU_PASSTHROUGH_TIMEOUT=5
+virsh start win11
+```
+
+## Available Scripts
+
+### System Checks
+- `gpu-passthrough-preflight-check.sh` - Comprehensive system verification
+- `validate-gpu-passthrough-ready.sh` - Final readiness check before testing
+
+### Testing
+- `test-gpu-bind-unbind.sh [seconds]` - Test GPU binding without starting VM
+  - Example: `sudo ./test-gpu-bind-unbind.sh 30`
+  - Display will go black for specified duration
+  - GPU binds to vfio-pci then returns to nvidia
+
+### Installation
+- `install-gpu-passthrough-hooks.sh [vm-name]` - Install libvirt hooks
+  - Example: `sudo ./install-gpu-passthrough-hooks.sh win11`
+  - Copies hooks to /etc/libvirt/hooks/
+  - Sets correct permissions
+
+### Hook Scripts (in libvirt-hooks/)
+- `qemu` - Main libvirt hook dispatcher
+- `win11/prepare/begin/start.sh` - Runs before VM starts (unbind GPU from host)
+- `win11/release/end/stop.sh` - Runs after VM stops (restore GPU to host)
+
+### Documentation
+- `IMPLEMENTATION-SUMMARY.md` - What has been done and next steps (READ THIS FIRST!)
+- `GPU-PASSTHROUGH-TESTING-GUIDE.md` - Complete testing procedure with troubleshooting
+- `single-gpu-passthrough-guide.md` - Full GPU passthrough guide (updated for no-iGPU)
+- `single-gpu-passthrough-audit.md` - Technical audit findings
+- `README-GPU-PASSTHROUGH.md` - This file
+
+## Safety Features
+
+### Automatic Timeout
+Set before starting VM:
+```bash
+export GPU_PASSTHROUGH_TIMEOUT=5  # Minutes
+```
+
+VM will automatically shut down after timeout, restoring GPU to host.
+
+### Recovery Commands
+```bash
+# Emergency recovery
+gpu-recovery
+
+# Force stop VM
+sudo virsh destroy win11
+
+# Manual GPU restore
+sudo /etc/libvirt/hooks/qemu.d/win11/release/end/stop.sh
+
+# Check logs
+sudo journalctl -t vm-gpu-start -t vm-gpu-stop -n 50
+```
+
+## Important Notes
+
+### ⚠️ Your CPU Has NO Integrated Graphics
+- i7-14700KF has no iGPU
+- When VM runs, host becomes HEADLESS
+- Monitor shows ONLY the VM
+- Control host via SSH only
+
+### 🔒 SSH is MANDATORY
+Test SSH access before any GPU passthrough:
+```bash
+ssh coops@10.10.10.9
+```
+
+### 📊 Monitoring
+```bash
+# Watch VM status
+watch -n 2 'virsh list --all'
+
+# Watch GPU driver
+watch -n 2 'lspci -k -s 01:00.0 | grep "Kernel driver"'
+
+# Follow logs
+sudo journalctl -f -t vm-gpu-start -t vm-gpu-stop
+```
+
+## Workflow
+
+**Normal Operation:**
+1. Linux desktop (GPU using nvidia)
+2. Start VM → Display goes BLACK
+3. Monitor shows Windows (GPU using vfio-pci)
+4. Stop VM → Linux desktop returns
+
+**With Safety Timeout:**
+1. Set: `export GPU_PASSTHROUGH_TIMEOUT=5`
+2. Start VM
+3. After 5 minutes, VM auto-shuts down
+4. GPU automatically returns to host
+
+## Configuration
+
+Current system:
+- VM Name: win11
+- GPU: 0000:01:00.0 (NVIDIA RTX 4090)
+- Audio: 0000:01:00.1
+- Display Manager: sddm
+- SSH IP: 10.10.10.9
+
+Edit hook scripts if your configuration differs:
+- `libvirt-hooks/win11/prepare/begin/start.sh` (lines 10-12)
+- `libvirt-hooks/win11/release/end/stop.sh` (lines 10-12)
+
+## Need Help?
+
+1. **Read documentation:** `IMPLEMENTATION-SUMMARY.md` and `GPU-PASSTHROUGH-TESTING-GUIDE.md`
+2. **Check logs:** `sudo journalctl -t vm-gpu-start -n 50`
+3. **Test without VM:** `sudo ./test-gpu-bind-unbind.sh 30`
+4. **Verify hooks:** `./validate-gpu-passthrough-ready.sh win11`
+
+## Files Not To Delete
+
+Keep these in ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/:
+- All .sh scripts (you might need them again)
+- All .md documentation
+- libvirt-hooks/ directory (source for reinstallation)
diff --git a/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/gpu-passthrough-preflight-check.sh b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/gpu-passthrough-preflight-check.sh
new file mode 100755
index 00000000..ab4f4dac
--- /dev/null
+++ b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/gpu-passthrough-preflight-check.sh
@@ -0,0 +1,227 @@
+#!/usr/bin/env bash
+#
+# GPU Passthrough Pre-Flight Check
+# Verifies system is ready for single GPU passthrough testing
+#
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+print_header() {
+    printf '\n%b=== %s ===%b\n' "$BLUE" "$1" "$NC"
+}
+
+print_ok() {
+    printf '%b✓%b %s\n' "$GREEN" "$NC" "$1"
+}
+
+print_warn() {
+    printf '%b⚠%b %s\n' "$YELLOW" "$NC" "$1"
+}
+
+print_error() {
+    printf '%b✗%b %s\n' "$RED" "$NC" "$1"
+}
+
+# Track overall status
+ERRORS=0
+WARNINGS=0
+
+print_header "System Information"
+printf 'CPU: %s\n' "$(lscpu | grep "Model name" | cut -d: -f2 | xargs)"
+printf 'Kernel: %s\n' "$(uname -r)"
+printf 'OS: %s\n' "$(cat /etc/os-release | grep PRETTY_NAME | cut -d= -f2 | tr -d '"')"
+
+print_header "1. Checking IOMMU Status"
+if grep -q "intel_iommu=on" /proc/cmdline; then
+    print_ok "Intel IOMMU enabled in kernel parameters"
+else
+    print_error "Intel IOMMU NOT enabled"
+    ((ERRORS++))
+fi
+
+if grep -q "iommu=pt" /proc/cmdline; then
+    print_ok "IOMMU passthrough mode enabled"
+else
+    print_warn "IOMMU passthrough mode not set (optional)"
+    ((WARNINGS++))
+fi
+
+print_header "2. Checking GPU Configuration"
+GPU_INFO=$(lspci -nn | grep -i "VGA.*NVIDIA")
+if [[ -n "$GPU_INFO" ]]; then
+    print_ok "NVIDIA GPU found: $GPU_INFO"
+    GPU_PCI=$(echo "$GPU_INFO" | cut -d' ' -f1)
+    printf '   PCI Address: %s\n' "$GPU_PCI"
+else
+    print_error "No NVIDIA GPU found"
+    ((ERRORS++))
+fi
+
+AUDIO_INFO=$(lspci -nn | grep -i "Audio.*NVIDIA")
+if [[ -n "$AUDIO_INFO" ]]; then
+    print_ok "NVIDIA Audio found: $AUDIO_INFO"
+    AUDIO_PCI=$(echo "$AUDIO_INFO" | cut -d' ' -f1)
+    printf '   PCI Address: %s\n' "$AUDIO_PCI"
+else
+    print_warn "No NVIDIA Audio device found"
+    ((WARNINGS++))
+fi
+
+# Check current driver
+CURRENT_DRIVER=$(lspci -k -s "$GPU_PCI" | grep "Kernel driver in use" | cut -d: -f2 | xargs)
+if [[ "$CURRENT_DRIVER" == "nvidia" ]]; then
+    print_ok "GPU currently using nvidia driver: $CURRENT_DRIVER"
+else
+    print_warn "GPU driver is: $CURRENT_DRIVER (expected nvidia)"
+    ((WARNINGS++))
+fi
+
+print_header "3. Checking Display Manager"
+if systemctl is-active --quiet sddm; then
+    print_ok "SDDM is active"
+    DM="sddm"
+elif systemctl is-active --quiet gdm; then
+    print_ok "GDM is active"
+    DM="gdm"
+elif systemctl is-active --quiet lightdm; then
+    print_ok "LightDM is active"
+    DM="lightdm"
+else
+    print_error "No known display manager is active"
+    ((ERRORS++))
+    DM="unknown"
+fi
+
+print_header "4. Checking SSH Configuration"
+if systemctl is-active --quiet sshd; then
+    print_ok "SSH daemon is running"
+else
+    print_error "SSH daemon is NOT running (CRITICAL for recovery!)"
+    ((ERRORS++))
+fi
+
+IP_ADDR=$(ip -4 addr show | grep "inet " | grep -v 127.0.0.1 | head -1 | awk '{print $2}' | cut -d/ -f1)
+if [[ -n "$IP_ADDR" ]]; then
+    print_ok "Local IP address: $IP_ADDR"
+    printf '   Test SSH with: ssh %s@%s\n' "$USER" "$IP_ADDR"
+else
+    print_warn "Could not determine local IP address"
+    ((WARNINGS++))
+fi
+
+print_header "5. Checking Virtualization"
+if command -v virt-manager >/dev/null 2>&1; then
+    print_ok "virt-manager is installed"
+else
+    print_error "virt-manager is NOT installed"
+    ((ERRORS++))
+fi
+
+if command -v virsh >/dev/null 2>&1; then
+    print_ok "virsh is installed"
+else
+    print_error "virsh is NOT installed"
+    ((ERRORS++))
+fi
+
+if systemctl is-active --quiet libvirtd; then
+    print_ok "libvirtd is running"
+else
+    print_warn "libvirtd is NOT running (will start when needed)"
+    printf '   Start with: sudo systemctl start libvirtd\n'
+    ((WARNINGS++))
+fi
+
+# Check if user is in libvirt group
+if groups | grep -q libvirt; then
+    print_ok "User is in libvirt group"
+else
+    print_warn "User is NOT in libvirt group"
+    printf '   Add with: sudo usermod -aG libvirt %s\n' "$USER"
+    ((WARNINGS++))
+fi
+
+print_header "6. Checking Required Directories"
+if [[ -d /etc/libvirt/hooks ]]; then
+    print_ok "/etc/libvirt/hooks exists"
+else
+    print_warn "/etc/libvirt/hooks does not exist (will be created)"
+    ((WARNINGS++))
+fi
+
+if [[ -d /var/lib/libvirt/images ]]; then
+    print_ok "/var/lib/libvirt/images exists"
+else
+    print_warn "/var/lib/libvirt/images does not exist"
+    ((WARNINGS++))
+fi
+
+print_header "7. Checking for ISOs"
+WIN_ISO=$(find ~ -iname "*win11*.iso" -o -iname "*windows*11*.iso" 2>/dev/null | head -1)
+if [[ -n "$WIN_ISO" ]]; then
+    print_ok "Windows ISO found: $WIN_ISO"
+else
+    print_warn "No Windows 11 ISO found in home directory"
+    ((WARNINGS++))
+fi
+
+VIRTIO_ISO=$(find /var/lib/libvirt /usr/share ~ -iname "*virtio*win*.iso" 2>/dev/null | head -1)
+if [[ -n "$VIRTIO_ISO" ]]; then
+    print_ok "VirtIO ISO found: $VIRTIO_ISO"
+else
+    print_warn "No VirtIO ISO found"
+    printf '   Download from: https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/latest-virtio/\n'
+    ((WARNINGS++))
+fi
+
+print_header "8. Checking Kernel Modules"
+if lsmod | grep -q "^nvidia "; then
+    print_ok "nvidia module is loaded"
+else
+    print_warn "nvidia module is not loaded"
+    ((WARNINGS++))
+fi
+
+if lsmod | grep -q "^vfio_pci"; then
+    print_warn "vfio_pci module is already loaded (should not be at boot)"
+    ((WARNINGS++))
+else
+    print_ok "vfio_pci module is not loaded (correct)"
+fi
+
+if lsmod | grep -q "^kvm_intel"; then
+    print_ok "kvm_intel module is loaded"
+else
+    print_error "kvm_intel module is NOT loaded"
+    ((ERRORS++))
+fi
+
+print_header "Summary"
+if [[ $ERRORS -eq 0 && $WARNINGS -eq 0 ]]; then
+    print_ok "All checks passed! System is ready for GPU passthrough."
+elif [[ $ERRORS -eq 0 ]]; then
+    print_warn "System is ready with $WARNINGS warning(s)"
+else
+    print_error "System has $ERRORS critical error(s) and $WARNINGS warning(s)"
+    printf '\nFix critical errors before attempting GPU passthrough!\n'
+    exit 1
+fi
+
+printf '\n%bConfiguration Summary:%b\n' "$BLUE" "$NC"
+printf 'GPU PCI:        0000:%s\n' "$GPU_PCI"
+printf 'Audio PCI:      0000:%s\n' "$AUDIO_PCI"
+printf 'Display Mgr:    %s\n' "$DM"
+printf 'SSH IP:         %s\n' "$IP_ADDR"
+printf 'Current Driver: %s\n' "$CURRENT_DRIVER"
+
+printf '\n%bNext Steps:%b\n' "$GREEN" "$NC"
+printf '1. Ensure SSH is accessible from another device\n'
+printf '2. Create hook scripts with timeout\n'
+printf '3. Set up Windows VM\n'
+printf '4. Test GPU passthrough with automatic revert\n'
diff --git a/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/install-gpu-passthrough-hooks.sh b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/install-gpu-passthrough-hooks.sh
new file mode 100755
index 00000000..0e8a9551
--- /dev/null
+++ b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/install-gpu-passthrough-hooks.sh
@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+#
+# Install GPU Passthrough Libvirt Hooks
+# This script copies the hook scripts to the correct location and sets permissions
+#
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+print_header() {
+    printf '\n%b=== %s ===%b\n' "$BLUE" "$1" "$NC"
+}
+
+print_ok() {
+    printf '%b✓%b %s\n' "$GREEN" "$NC" "$1"
+}
+
+print_error() {
+    printf '%b✗%b %s\n' "$RED" "$NC" "$1"
+}
+
+# Check if running as root
+if [[ $EUID -ne 0 ]]; then
+    print_error "This script must be run as root (use sudo)"
+    exit 1
+fi
+
+VM_NAME="${1:-win11}"
+
+print_header "Installing GPU Passthrough Hooks for VM: $VM_NAME"
+
+# Source directory (where we created the hooks)
+SOURCE_DIR="/home/$SUDO_USER/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/libvirt-hooks"
+
+# Target directory
+TARGET_DIR="/etc/libvirt/hooks"
+
+# Check if source files exist
+if [[ ! -f "$SOURCE_DIR/qemu" ]]; then
+    print_error "Source hook files not found in $SOURCE_DIR"
+    exit 1
+fi
+
+# Create target directories
+print_ok "Creating hook directories"
+mkdir -p "$TARGET_DIR/qemu.d/$VM_NAME/prepare/begin"
+mkdir -p "$TARGET_DIR/qemu.d/$VM_NAME/release/end"
+
+# Copy main dispatcher
+print_ok "Installing main QEMU hook dispatcher"
+cp "$SOURCE_DIR/qemu" "$TARGET_DIR/qemu"
+chmod +x "$TARGET_DIR/qemu"
+
+# Copy VM-specific hooks
+print_ok "Installing VM start hook"
+cp "$SOURCE_DIR/$VM_NAME/prepare/begin/start.sh" "$TARGET_DIR/qemu.d/$VM_NAME/prepare/begin/start.sh"
+chmod +x "$TARGET_DIR/qemu.d/$VM_NAME/prepare/begin/start.sh"
+
+print_ok "Installing VM stop hook"
+cp "$SOURCE_DIR/$VM_NAME/release/end/stop.sh" "$TARGET_DIR/qemu.d/$VM_NAME/release/end/stop.sh"
+chmod +x "$TARGET_DIR/qemu.d/$VM_NAME/release/end/stop.sh"
+
+# Verify installation
+print_header "Verifying Installation"
+
+if [[ -x "$TARGET_DIR/qemu" ]]; then
+    print_ok "Main hook is executable"
+else
+    print_error "Main hook is not executable"
+fi
+
+if [[ -x "$TARGET_DIR/qemu.d/$VM_NAME/prepare/begin/start.sh" ]]; then
+    print_ok "Start hook is executable"
+else
+    print_error "Start hook is not executable"
+fi
+
+if [[ -x "$TARGET_DIR/qemu.d/$VM_NAME/release/end/stop.sh" ]]; then
+    print_ok "Stop hook is executable"
+else
+    print_error "Stop hook is not executable"
+fi
+
+# Show directory structure
+print_header "Hook Directory Structure"
+tree -L 5 "$TARGET_DIR" 2>/dev/null || find "$TARGET_DIR" -type f -o -type d | sort
+
+print_header "Configuration Check"
+printf 'VM Name:        %s\n' "$VM_NAME"
+printf 'GPU PCI:        0000:01:00.0\n'
+printf 'Audio PCI:      0000:01:00.1\n'
+printf 'Display Mgr:    sddm\n'
+printf 'Safety Timeout: %s minutes (adjustable via GPU_PASSTHROUGH_TIMEOUT)\n' "${GPU_PASSTHROUGH_TIMEOUT:-5}"
+
+print_header "Next Steps"
+printf '1. Restart libvirtd: sudo systemctl restart libvirtd\n'
+printf '2. Create Windows VM (if not already created)\n'
+printf '3. Add GPU to VM XML: sudo virsh edit %s\n' "$VM_NAME"
+printf '4. Set timeout: export GPU_PASSTHROUGH_TIMEOUT=5  # minutes\n'
+printf '5. Test with: virsh start %s\n' "$VM_NAME"
+printf '\n%bIMPORTANT:%b Have SSH ready from another device!\n' "$YELLOW" "$NC"
+printf 'SSH: ssh %s@10.10.10.9\n' "$SUDO_USER"
+
+printf '\n%b✓ Installation complete!%b\n\n' "$GREEN" "$NC"
diff --git a/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/qemu b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/qemu
new file mode 100644
index 00000000..96e8ee61
--- /dev/null
+++ b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/qemu
@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+#
+# Libvirt QEMU Hook Dispatcher
+# Executes hook scripts based on VM lifecycle events
+#
+set -euo pipefail
+
+GUEST_NAME="$1"
+HOOK_NAME="$2"
+STATE_NAME="$3"
+
+BASEDIR="$(dirname "$0")"
+HOOK_PATH="$BASEDIR/qemu.d/$GUEST_NAME/$HOOK_NAME/$STATE_NAME"
+
+# Log the hook invocation
+logger -t "libvirt-qemu-hook" "VM: $GUEST_NAME, Hook: $HOOK_NAME, State: $STATE_NAME"
+
+if [[ -f "$HOOK_PATH" ]]; then
+    "$HOOK_PATH" "$@"
+elif [[ -d "$HOOK_PATH" ]]; then
+    while read -r file; do
+        [[ -x "$file" ]] && "$file" "$@"
+    done <<< "$(find -L "$HOOK_PATH" -maxdepth 1 -type f -executable | sort)"
+fi
diff --git a/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/win11/prepare/begin/start.sh b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/win11/prepare/begin/start.sh
new file mode 100644
index 00000000..a96a92e5
--- /dev/null
+++ b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/win11/prepare/begin/start.sh
@@ -0,0 +1,128 @@
+#!/usr/bin/env bash
+#
+# VM Prepare Hook - Unbind GPU from host, bind to vfio-pci
+# This script runs BEFORE the VM starts
+#
+# SAFETY TIMEOUT: Set TIMEOUT_MINUTES environment variable to auto-shutdown VM
+#
+set -euo pipefail
+
+# Configuration - ADJUST THESE FOR YOUR SYSTEM
+readonly GPU_PCI="0000:01:00.0"
+readonly GPU_AUDIO_PCI="0000:01:00.1"
+readonly DISPLAY_MANAGER="sddm"
+
+# Safety timeout (in minutes) - set via environment or default to 5
+readonly TIMEOUT_MINUTES="${GPU_PASSTHROUGH_TIMEOUT:-5}"
+readonly VM_NAME="$1"
+
+# Logging - logs go to journald, viewable with: journalctl -t vm-gpu-start
+exec 1> >(logger -s -t "vm-gpu-start") 2>&1
+
+printf '========================================\n'
+printf 'GPU Passthrough: Starting for VM %s\n' "$VM_NAME"
+printf 'Timeout: %d minutes\n' "$TIMEOUT_MINUTES"
+printf 'Time: %s\n' "$(date '+%Y-%m-%d %H:%M:%S')"
+printf '========================================\n'
+
+# Verify PCI devices exist
+if [[ ! -d "/sys/bus/pci/devices/$GPU_PCI" ]]; then
+    printf 'ERROR: GPU PCI device not found: %s\n' "$GPU_PCI" >&2
+    printf 'Run: lspci -nn | grep -i nvidia to find correct address\n' >&2
+    exit 1
+fi
+
+if [[ ! -d "/sys/bus/pci/devices/$GPU_AUDIO_PCI" ]]; then
+    printf 'ERROR: GPU Audio PCI device not found: %s\n' "$GPU_AUDIO_PCI" >&2
+    exit 1
+fi
+
+# Stop display manager
+printf 'Stopping display manager: %s\n' "$DISPLAY_MANAGER"
+if ! systemctl stop "$DISPLAY_MANAGER"; then
+    printf 'ERROR: Failed to stop %s\n' "$DISPLAY_MANAGER" >&2
+    exit 1
+fi
+
+# Wait for display manager to fully stop
+sleep 3
+
+# Unbind VT consoles
+printf 'Unbinding VT consoles\n'
+echo 0 > /sys/class/vtconsole/vtcon0/bind || true
+echo 0 > /sys/class/vtconsole/vtcon1/bind 2>/dev/null || true
+
+# Unbind EFI framebuffer
+echo efi-framebuffer.0 > /sys/bus/platform/drivers/efi-framebuffer/unbind 2>/dev/null || true
+
+# Check what's using nvidia before unloading
+printf 'Checking for processes using nvidia\n'
+if lsof /dev/nvidia* 2>/dev/null; then
+    printf 'WARNING: Processes are using the GPU. Attempting to unload anyway...\n'
+fi
+
+# Unload nvidia modules
+printf 'Unloading nvidia modules\n'
+if ! modprobe -r nvidia_drm nvidia_modeset nvidia_uvm nvidia; then
+    printf 'ERROR: Failed to unload nvidia modules\n' >&2
+    printf 'Processes using GPU:\n' >&2
+    lsof /dev/nvidia* >&2 || true
+    printf 'Restoring display manager\n' >&2
+    systemctl start "$DISPLAY_MANAGER"
+    exit 1
+fi
+
+# Unbind GPU from host driver
+printf 'Unbinding GPU from host driver\n'
+if [[ -e "/sys/bus/pci/devices/$GPU_PCI/driver" ]]; then
+    echo "$GPU_PCI" > "/sys/bus/pci/devices/$GPU_PCI/driver/unbind"
+fi
+
+if [[ -e "/sys/bus/pci/devices/$GPU_AUDIO_PCI/driver" ]]; then
+    echo "$GPU_AUDIO_PCI" > "/sys/bus/pci/devices/$GPU_AUDIO_PCI/driver/unbind"
+fi
+
+# Load vfio modules
+printf 'Loading vfio modules\n'
+modprobe vfio
+modprobe vfio_pci
+modprobe vfio_iommu_type1
+
+# Bind GPU to vfio-pci
+printf 'Binding GPU to vfio-pci\n'
+echo vfio-pci > "/sys/bus/pci/devices/$GPU_PCI/driver_override"
+echo vfio-pci > "/sys/bus/pci/devices/$GPU_AUDIO_PCI/driver_override"
+
+if ! echo "$GPU_PCI" > /sys/bus/pci/drivers/vfio-pci/bind; then
+    printf 'ERROR: Failed to bind GPU to vfio-pci\n' >&2
+    # Attempt to restore host display
+    echo "" > "/sys/bus/pci/devices/$GPU_PCI/driver_override"
+    modprobe nvidia
+    systemctl start "$DISPLAY_MANAGER"
+    exit 1
+fi
+
+if ! echo "$GPU_AUDIO_PCI" > /sys/bus/pci/drivers/vfio-pci/bind; then
+    printf 'ERROR: Failed to bind GPU audio to vfio-pci\n' >&2
+    exit 1
+fi
+
+printf 'GPU successfully bound to vfio-pci\n'
+
+# Start safety timeout timer (runs in background)
+if (( TIMEOUT_MINUTES > 0 )); then
+    printf 'Starting safety timeout timer (%d minutes)\n' "$TIMEOUT_MINUTES"
+    (
+        sleep $((TIMEOUT_MINUTES * 60))
+        logger -t "vm-gpu-timeout" "Safety timeout reached for VM $VM_NAME - forcing shutdown"
+        virsh shutdown "$VM_NAME" || virsh destroy "$VM_NAME"
+    ) &
+    TIMEOUT_PID=$!
+    printf 'Safety timer PID: %d\n' "$TIMEOUT_PID"
+    # Store PID for potential cleanup
+    echo "$TIMEOUT_PID" > "/tmp/gpu-passthrough-timeout-${VM_NAME}.pid"
+fi
+
+printf 'VM can now start. Display will be BLACK on host.\n'
+printf 'Monitor will show VM output when VM boots.\n'
+printf '========================================\n'
diff --git a/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/win11/release/end/stop.sh b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/win11/release/end/stop.sh
new file mode 100644
index 00000000..2d4abbc4
--- /dev/null
+++ b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/libvirt-hooks/win11/release/end/stop.sh
@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+#
+# VM Release Hook - Unbind GPU from vfio-pci, return to host
+# This script runs AFTER the VM stops
+#
+set -euo pipefail
+
+# Configuration - ADJUST THESE FOR YOUR SYSTEM
+readonly GPU_PCI="0000:01:00.0"
+readonly GPU_AUDIO_PCI="0000:01:00.1"
+readonly DISPLAY_MANAGER="sddm"
+readonly VM_NAME="$1"
+
+# Logging - logs go to journald, viewable with: journalctl -t vm-gpu-stop
+exec 1> >(logger -s -t "vm-gpu-stop") 2>&1
+
+printf '========================================\n'
+printf 'GPU Passthrough: Stopping for VM %s\n' "$VM_NAME"
+printf 'Time: %s\n' "$(date '+%Y-%m-%d %H:%M:%S')"
+printf '========================================\n'
+
+# Kill safety timeout timer if it exists
+if [[ -f "/tmp/gpu-passthrough-timeout-${VM_NAME}.pid" ]]; then
+    TIMEOUT_PID=$(cat "/tmp/gpu-passthrough-timeout-${VM_NAME}.pid")
+    if kill -0 "$TIMEOUT_PID" 2>/dev/null; then
+        printf 'Stopping safety timeout timer (PID: %d)\n' "$TIMEOUT_PID"
+        kill "$TIMEOUT_PID" || true
+    fi
+    rm -f "/tmp/gpu-passthrough-timeout-${VM_NAME}.pid"
+fi
+
+# Unbind from vfio-pci
+printf 'Unbinding GPU from vfio-pci\n'
+echo "$GPU_PCI" > /sys/bus/pci/drivers/vfio-pci/unbind 2>/dev/null || true
+echo "$GPU_AUDIO_PCI" > /sys/bus/pci/drivers/vfio-pci/unbind 2>/dev/null || true
+
+# Clear driver override
+printf 'Clearing driver override\n'
+echo "" > "/sys/bus/pci/devices/$GPU_PCI/driver_override"
+echo "" > "/sys/bus/pci/devices/$GPU_AUDIO_PCI/driver_override"
+
+# Unload vfio modules
+printf 'Unloading vfio modules\n'
+modprobe -r vfio_pci || true
+modprobe -r vfio_iommu_type1 || true
+modprobe -r vfio || true
+
+# Rescan PCI bus to detect GPU
+printf 'Rescanning PCI bus\n'
+echo 1 > /sys/bus/pci/rescan
+
+# Wait for device detection
+sleep 3
+
+# Reload nvidia modules
+printf 'Loading nvidia modules\n'
+if ! modprobe nvidia; then
+    printf 'ERROR: Failed to load nvidia module\n' >&2
+    exit 1
+fi
+modprobe nvidia_modeset
+modprobe nvidia_uvm
+modprobe nvidia_drm
+
+# Rebind VT consoles
+printf 'Rebinding VT consoles\n'
+echo 1 > /sys/class/vtconsole/vtcon0/bind || true
+echo 1 > /sys/class/vtconsole/vtcon1/bind 2>/dev/null || true
+
+# Rebind EFI framebuffer
+echo efi-framebuffer.0 > /sys/bus/platform/drivers/efi-framebuffer/bind 2>/dev/null || true
+
+# Start display manager
+printf 'Starting display manager: %s\n' "$DISPLAY_MANAGER"
+if ! systemctl start "$DISPLAY_MANAGER"; then
+    printf 'ERROR: Failed to start %s\n' "$DISPLAY_MANAGER" >&2
+    printf 'Try manually: sudo systemctl start %s\n' "$DISPLAY_MANAGER" >&2
+    exit 1
+fi
+
+printf 'GPU successfully returned to host\n'
+printf 'Display should be restored within 10 seconds\n'
+printf '========================================\n'
diff --git a/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/single-gpu-passthrough-guide.md b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/single-gpu-passthrough-guide.md
new file mode 100644
index 00000000..08ee736d
--- /dev/null
+++ b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/single-gpu-passthrough-guide.md
@@ -0,0 +1,887 @@
+# Single GPU Passthrough Guide
+
+Pass your only GPU to a VM on-demand, without breaking host boot.
+
+## ⚠️ Know Your Hardware First
+
+**Do you have integrated graphics?**
+
+Run this command to check:
+```bash
+lscpu | grep "Model name"
+lspci | grep -i vga
+```
+
+**If you see:**
+- Intel CPU ending in **F** (i7-14700KF, i5-13600KF): ❌ **NO** integrated GPU
+- Intel CPU without F (i7-14700K, i9-13900K): ✅ **HAS** integrated GPU
+- AMD CPU ending in **G** (5600G, 5700G): ✅ **HAS** integrated GPU (APU)
+- AMD CPU without G (5800X, 7950X): ❌ **NO** integrated GPU
+- Only one entry in `lspci | grep -i vga`: ❌ Single GPU system
+
+### What This Means for You
+
+| Your System | When VM Runs | Host Display | Best Viewing Method |
+|-------------|--------------|--------------|---------------------|
+| **No iGPU** (F-series Intel, most AMD) | Host becomes headless | ❌ None | Physical monitor shows VM directly |
+| **Has iGPU** (non-F Intel, AMD APU) | Host keeps display on iGPU | ✅ Working | Looking Glass (view VM in window) |
+
+**If you have no iGPU:** Read Step 0 carefully and set up SSH BEFORE attempting passthrough.
+
+## How It Works
+
+Instead of binding the GPU to vfio-pci at boot (which breaks display), we:
+1. Boot normally with nvidia driver
+2. When starting the VM: stop display manager → unbind nvidia → bind vfio-pci → start VM
+3. When stopping the VM: unbind vfio-pci → bind nvidia → start display manager
+
+This is achieved with **libvirt hooks** - scripts that run before/after VM start/stop.
+
+## Prerequisites
+
+- IOMMU enabled in BIOS (VT-d for Intel, AMD-Vi for AMD)
+- libvirt, qemu, virt-manager installed
+- Your VM already configured (we'll add the GPU later)
+
+## ⚠️ CRITICAL: Systems WITHOUT Integrated Graphics
+
+**If your CPU has NO integrated GPU (Intel F-series like i7-14700KF, or AMD CPUs without graphics):**
+
+When you pass through your only GPU to the VM:
+- **Your host display will go COMPLETELY BLACK**
+- The host becomes **headless** (cannot render any graphics)
+- Your physical monitor will show **only the VM's output**
+- You **MUST** set up SSH access for emergency recovery
+
+**This is NOT optional.** Read Step 0 below before proceeding.
+
+## Step 0: Emergency Recovery Setup (MANDATORY for No-iGPU Systems)
+
+### 1. Enable and Test SSH
+
+```bash
+# Enable SSH daemon
+sudo systemctl enable --now sshd
+
+# Verify it's running
+sudo systemctl status sshd
+
+# Get your local IP address (write this down!)
+ip -4 addr show | grep "inet " | grep -v 127.0.0.1
+# Example output: inet 192.168.1.100/24
+```
+
+### 2. Test SSH from Another Device
+
+From a phone (using Termux), laptop, or another computer on the same network:
+
+```bash
+ssh your-username@192.168.1.100  # Use your actual IP
+```
+
+If this doesn't work, **DO NOT proceed** with GPU passthrough until SSH is working.
+
+### 3. Create Emergency Recovery Script
+
+```bash
+mkdir -p ~/.local/bin
+
+cat > ~/.local/bin/gpu-recovery << 'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+sudo /etc/libvirt/hooks/qemu.d/win11/release/end/stop.sh
+sudo systemctl start sddm  # Change to your display manager
+EOF
+
+chmod +x ~/.local/bin/gpu-recovery
+
+# Add to PATH if not already
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
+```
+
+### 4. Test the Recovery Script
+
+```bash
+source ~/.bashrc
+gpu-recovery  # Should run without errors
+```
+
+**Recovery procedure if display goes black:**
+1. SSH from another device: `ssh user@192.168.1.100`
+2. Run: `gpu-recovery`
+3. Your display should return
+
+## Step 1: Enable IOMMU (Keep This)
+
+The `intel_iommu=on iommu=pt` kernel parameters are fine to keep. They enable IOMMU without binding anything to vfio.
+
+Verify IOMMU is working:
+```bash
+dmesg | grep -i iommu
+# Should show IOMMU enabled messages
+```
+
+## Step 2: DO NOT Configure Early vfio-pci Binding
+
+**This is what caused your boot issue.** Make sure these are NOT set:
+
+```bash
+# /etc/mkinitcpio.conf - MODULES should be empty or not include vfio
+MODULES=()
+
+# /etc/modprobe.d/vfio.conf - should NOT exist or be empty
+# DELETE this file if it exists
+```
+
+## Step 3: Identify Your GPU's PCI Addresses
+
+```bash
+# Find your GPU
+lspci -nn | grep -i nvidia
+# Example output:
+# 01:00.0 VGA compatible controller [0300]: NVIDIA Corporation AD102 [GeForce RTX 4090] [10de:2684]
+# 01:00.1 Audio device [0403]: NVIDIA Corporation AD102 High Definition Audio Controller [10de:22ba]
+```
+
+Note the addresses: `01:00.0` (GPU) and `01:00.1` (audio). The full PCI path is `pci_0000_01_00_0`.
+
+## Step 4: Create the Libvirt Hooks Directory Structure
+
+```bash
+sudo mkdir -p /etc/libvirt/hooks/qemu.d/win11/prepare/begin
+sudo mkdir -p /etc/libvirt/hooks/qemu.d/win11/release/end
+```
+
+Replace `win11` with your VM's exact name as shown in virt-manager.
+
+## Step 5: Create the Main Hook Script
+
+```bash
+sudo nano /etc/libvirt/hooks/qemu
+```
+
+```bash
+#!/usr/bin/env bash
+#
+# Libvirt QEMU Hook Dispatcher
+# Executes hook scripts based on VM lifecycle events
+#
+set -euo pipefail
+
+GUEST_NAME="$1"
+HOOK_NAME="$2"
+STATE_NAME="$3"
+
+BASEDIR="$(dirname "$0")"
+HOOK_PATH="$BASEDIR/qemu.d/$GUEST_NAME/$HOOK_NAME/$STATE_NAME"
+
+if [[ -f "$HOOK_PATH" ]]; then
+    "$HOOK_PATH" "$@"
+elif [[ -d "$HOOK_PATH" ]]; then
+    while read -r file; do
+        "$file" "$@"
+    done <<< "$(find -L "$HOOK_PATH" -maxdepth 1 -type f -executable | sort)"
+fi
+```
+
+```bash
+sudo chmod +x /etc/libvirt/hooks/qemu
+```
+
+## Step 6: Create the VM Start Script
+
+```bash
+sudo nano /etc/libvirt/hooks/qemu.d/win11/prepare/begin/start.sh
+```
+
+```bash
+#!/usr/bin/env bash
+#
+# VM Prepare Hook - Unbind GPU from host, bind to vfio-pci
+# This script runs BEFORE the VM starts
+#
+set -euo pipefail
+
+# Configuration - ADJUST THESE FOR YOUR SYSTEM
+readonly GPU_PCI="0000:01:00.0"
+readonly GPU_AUDIO_PCI="0000:01:00.1"
+readonly DISPLAY_MANAGER="sddm"  # or gdm, lightdm, etc.
+
+# Logging - logs go to journald, viewable with: journalctl -t vm-gpu-start
+exec 1> >(logger -s -t "vm-gpu-start") 2>&1
+
+printf 'Starting GPU passthrough preparation\n'
+
+# Verify PCI devices exist
+if [[ ! -d "/sys/bus/pci/devices/$GPU_PCI" ]]; then
+    printf 'ERROR: GPU PCI device not found: %s\n' "$GPU_PCI" >&2
+    printf 'Run: lspci -nn | grep -i nvidia to find correct address\n' >&2
+    exit 1
+fi
+
+if [[ ! -d "/sys/bus/pci/devices/$GPU_AUDIO_PCI" ]]; then
+    printf 'ERROR: GPU Audio PCI device not found: %s\n' "$GPU_AUDIO_PCI" >&2
+    exit 1
+fi
+
+# Stop display manager
+printf 'Stopping display manager: %s\n' "$DISPLAY_MANAGER"
+systemctl stop "$DISPLAY_MANAGER" || {
+    printf 'ERROR: Failed to stop %s\n' "$DISPLAY_MANAGER" >&2
+    exit 1
+}
+
+# Wait for display manager to fully stop
+sleep 3
+
+# Unbind VT consoles
+printf 'Unbinding VT consoles\n'
+echo 0 > /sys/class/vtconsole/vtcon0/bind || true
+echo 0 > /sys/class/vtconsole/vtcon1/bind 2>/dev/null || true
+
+# Unbind EFI framebuffer
+echo efi-framebuffer.0 > /sys/bus/platform/drivers/efi-framebuffer/unbind 2>/dev/null || true
+
+# Unload nvidia modules
+printf 'Unloading nvidia modules\n'
+modprobe -r nvidia_drm nvidia_modeset nvidia_uvm nvidia || {
+    printf 'ERROR: Failed to unload nvidia modules. Check what is using the GPU:\n' >&2
+    lsof /dev/nvidia* >&2 || true
+    printf 'Close all applications using the GPU and try again\n' >&2
+    systemctl start "$DISPLAY_MANAGER"  # Restore display
+    exit 1
+}
+
+# Unbind GPU from host driver
+printf 'Unbinding GPU from host driver\n'
+if [[ -e "/sys/bus/pci/devices/$GPU_PCI/driver" ]]; then
+    echo "$GPU_PCI" > "/sys/bus/pci/devices/$GPU_PCI/driver/unbind"
+fi
+
+if [[ -e "/sys/bus/pci/devices/$GPU_AUDIO_PCI/driver" ]]; then
+    echo "$GPU_AUDIO_PCI" > "/sys/bus/pci/devices/$GPU_AUDIO_PCI/driver/unbind"
+fi
+
+# Load vfio modules
+printf 'Loading vfio modules\n'
+modprobe vfio
+modprobe vfio_pci
+modprobe vfio_iommu_type1
+
+# Bind GPU to vfio-pci
+printf 'Binding GPU to vfio-pci\n'
+echo vfio-pci > "/sys/bus/pci/devices/$GPU_PCI/driver_override"
+echo vfio-pci > "/sys/bus/pci/devices/$GPU_AUDIO_PCI/driver_override"
+
+echo "$GPU_PCI" > /sys/bus/pci/drivers/vfio-pci/bind || {
+    printf 'ERROR: Failed to bind GPU to vfio-pci\n' >&2
+    # Attempt to restore host display
+    echo "" > "/sys/bus/pci/devices/$GPU_PCI/driver_override"
+    modprobe nvidia
+    systemctl start "$DISPLAY_MANAGER"
+    exit 1
+}
+
+echo "$GPU_AUDIO_PCI" > /sys/bus/pci/drivers/vfio-pci/bind || {
+    printf 'ERROR: Failed to bind GPU audio to vfio-pci\n' >&2
+    exit 1
+}
+
+printf 'GPU successfully bound to vfio-pci. VM can now start.\n'
+```
+
+```bash
+sudo chmod +x /etc/libvirt/hooks/qemu.d/win11/prepare/begin/start.sh
+```
+
+## Step 7: Create the VM Stop Script
+
+```bash
+sudo nano /etc/libvirt/hooks/qemu.d/win11/release/end/stop.sh
+```
+
+```bash
+#!/usr/bin/env bash
+#
+# VM Release Hook - Unbind GPU from vfio-pci, return to host
+# This script runs AFTER the VM stops
+#
+set -euo pipefail
+
+# Configuration - ADJUST THESE FOR YOUR SYSTEM
+readonly GPU_PCI="0000:01:00.0"
+readonly GPU_AUDIO_PCI="0000:01:00.1"
+readonly DISPLAY_MANAGER="sddm"  # or gdm, lightdm, etc.
+
+# Logging - logs go to journald, viewable with: journalctl -t vm-gpu-stop
+exec 1> >(logger -s -t "vm-gpu-stop") 2>&1
+
+printf 'Starting GPU return to host\n'
+
+# Unbind from vfio-pci
+printf 'Unbinding GPU from vfio-pci\n'
+echo "$GPU_PCI" > /sys/bus/pci/drivers/vfio-pci/unbind 2>/dev/null || true
+echo "$GPU_AUDIO_PCI" > /sys/bus/pci/drivers/vfio-pci/unbind 2>/dev/null || true
+
+# Clear driver override
+printf 'Clearing driver override\n'
+echo "" > "/sys/bus/pci/devices/$GPU_PCI/driver_override"
+echo "" > "/sys/bus/pci/devices/$GPU_AUDIO_PCI/driver_override"
+
+# Unload vfio modules
+printf 'Unloading vfio modules\n'
+modprobe -r vfio_pci
+modprobe -r vfio_iommu_type1
+modprobe -r vfio
+
+# Rescan PCI bus to detect GPU
+printf 'Rescanning PCI bus\n'
+echo 1 > /sys/bus/pci/rescan
+
+# Wait for device detection
+sleep 3
+
+# Reload nvidia modules
+printf 'Loading nvidia modules\n'
+modprobe nvidia || {
+    printf 'ERROR: Failed to load nvidia module\n' >&2
+    exit 1
+}
+modprobe nvidia_modeset
+modprobe nvidia_uvm
+modprobe nvidia_drm
+
+# Rebind VT consoles
+printf 'Rebinding VT consoles\n'
+echo 1 > /sys/class/vtconsole/vtcon0/bind || true
+echo 1 > /sys/class/vtconsole/vtcon1/bind 2>/dev/null || true
+
+# Rebind EFI framebuffer
+echo efi-framebuffer.0 > /sys/bus/platform/drivers/efi-framebuffer/bind 2>/dev/null || true
+
+# Start display manager
+printf 'Starting display manager: %s\n' "$DISPLAY_MANAGER"
+systemctl start "$DISPLAY_MANAGER" || {
+    printf 'ERROR: Failed to start %s\n' "$DISPLAY_MANAGER" >&2
+    printf 'Try manually: sudo systemctl start %s\n' "$DISPLAY_MANAGER" >&2
+    exit 1
+}
+
+printf 'GPU successfully returned to host. Display should be restored.\n'
+```
+
+```bash
+sudo chmod +x /etc/libvirt/hooks/qemu.d/win11/release/end/stop.sh
+```
+
+## Step 8: Add GPU to VM Configuration
+
+Edit your VM's XML configuration:
+
+```bash
+sudo virsh edit win11
+```
+
+Add the GPU and audio devices inside the `<devices>` section:
+
+```xml
+<hostdev mode='subsystem' type='pci' managed='yes'>
+  <source>
+    <address domain='0x0000' bus='0x01' slot='0x00' function='0x0'/>
+  </source>
+  <address type='pci' domain='0x0000' bus='0x06' slot='0x00' function='0x0'/>
+</hostdev>
+<hostdev mode='subsystem' type='pci' managed='yes'>
+  <source>
+    <address domain='0x0000' bus='0x01' slot='0x00' function='0x1'/>
+  </source>
+  <address type='pci' domain='0x0000' bus='0x07' slot='0x00' function='0x0'/>
+</hostdev>
+```
+
+Adjust the bus/slot/function to match your `lspci` output (01:00.0 = bus 0x01, slot 0x00, function 0x0).
+
+## Step 9: Restart libvirtd
+
+```bash
+sudo systemctl restart libvirtd
+```
+
+## Step 10: Test It
+
+**Before starting:** Have an SSH session ready on another device, or accept that your monitor will show the VM directly.
+
+### For Systems WITHOUT iGPU (i7-14700KF):
+
+1. **Open an SSH session from another device** (phone/laptop):
+   ```bash
+   ssh user@192.168.1.100  # Your host's IP
+   ```
+
+2. **From virt-manager on the host, start your Windows VM**
+
+3. **Your display will go BLACK** - this is normal! The host no longer has graphics capability.
+
+4. **Wait 30-60 seconds** - your monitor should show the Windows boot screen
+
+5. **Your monitor now displays the VM directly** - use it like a normal Windows PC
+
+6. **To control the host:** Use the SSH session from step 1
+
+7. **To stop the VM:** Either shut down Windows normally, or from SSH:
+   ```bash
+   sudo virsh shutdown win11
+   ```
+
+8. **After VM stops:** Your Linux desktop should return automatically
+
+### For Systems WITH iGPU:
+
+1. Open virt-manager
+2. Start your Windows VM
+3. Your display might flicker briefly
+4. Use Looking Glass or physical monitor to see the VM
+5. When you shut down the VM, your Linux desktop continues normally
+
+### Expected Timeline:
+
+```
+0s:   Click "Start" in virt-manager
+2s:   Display manager stops, screen goes black
+5s:   Hook script completes, VM begins booting
+15s:  Windows boot logo appears on monitor
+30s:  Windows desktop ready
+```
+
+### If Something Goes Wrong:
+
+**Display stays black after 2 minutes:**
+
+From SSH:
+```bash
+# Check if VM is running
+sudo virsh list --all
+
+# If VM is running but no display:
+# Check VM logs
+sudo tail -f /var/log/libvirt/qemu/win11.log
+
+# Force stop VM and restore display
+sudo virsh destroy win11
+gpu-recovery
+```
+
+**Can't SSH in:**
+
+1. Press `Ctrl+Alt+F2` to try accessing a TTY
+2. Login and run: `gpu-recovery`
+3. If TTY doesn't work, hard reboot (hold power button)
+
+## Viewing the VM Display
+
+Since your GPU is passed to the VM, you need a way to see the VM's output.
+
+**The method you choose depends on whether your CPU has integrated graphics:**
+
+### For CPUs WITHOUT Integrated Graphics (i7-14700KF, AMD F-series)
+
+When the VM starts, your host becomes **completely headless** (no display capability at all).
+
+#### Option 1: Physical Monitor (Recommended - Zero Latency)
+
+**This is the standard approach for single GPU passthrough.**
+
+- Your physical monitor(s) connected to the GPU will display the VM directly
+- When VM starts: monitor goes black → shows Windows boot screen
+- When VM stops: monitor shows Linux desktop again
+- To control the host while VM is running: SSH from another device
+
+**Setup:** None needed - just use your existing monitor(s).
+
+#### Option 2: Network Streaming (Sunshine + Moonlight)
+
+Stream the VM's display to another device over your local network.
+
+**In the Windows VM:**
+1. Download and install [Sunshine](https://github.com/LizardByte/Sunshine/releases)
+2. Configure Sunshine and set a PIN
+
+**On your viewing device (phone/tablet/laptop):**
+1. Install Moonlight client
+2. Connect to the VM's IP address
+3. Enter the PIN
+
+**Latency:** Adds ~10-20ms, suitable for most gaming.
+
+#### Option 3: Remote Desktop (RDP)
+
+**In Windows VM:**
+- Enable Remote Desktop in Windows Settings
+- Note the VM's IP address
+
+**From another device:**
+```bash
+# Linux
+rdesktop <vm-ip>
+
+# Or use Remmina GUI
+```
+
+**Latency:** Higher (~50-100ms), not ideal for gaming.
+
+---
+
+### ❌ Looking Glass - NOT Compatible Without iGPU
+
+**Looking Glass REQUIRES the host to have display capability** (integrated GPU or second discrete GPU).
+
+If your CPU has no iGPU (F-series Intel, many AMD chips), Looking Glass **will not work** because:
+- The host cannot render the Looking Glass window (no GPU available)
+- When your only GPU passes to the VM, the host becomes headless
+
+**Looking Glass is only for:**
+- Dual GPU systems (iGPU + dGPU passing through)
+- Systems with multiple discrete GPUs (one for host, one for VM)
+
+If you have an iGPU, Looking Glass is excellent. If not, use physical monitor or network streaming.
+
+---
+
+### For CPUs WITH Integrated Graphics (Most Intel non-F, AMD APUs)
+
+#### Option: Looking Glass (Recommended - Low Latency)
+
+Looking Glass lets you view the VM in a window on your host desktop.
+
+**Install in VM:** [Looking Glass Host](https://looking-glass.io/downloads)
+
+**Install on host:**
+```bash
+paru -S looking-glass  # or build from source
+```
+
+**Add shared memory to VM XML:**
+```bash
+sudo virsh edit win11
+```
+
+Add inside `<devices>`:
+```xml
+<shmem name='looking-glass'>
+  <model type='ivshmem-plain'/>
+  <size unit='M'>64</size>
+</shmem>
+```
+
+**Create shared memory file:**
+```bash
+sudo touch /dev/shm/looking-glass
+sudo chown $USER:kvm /dev/shm/looking-glass
+sudo chmod 660 /dev/shm/looking-glass
+```
+
+**Make it persistent (create systemd tmpfile):**
+```bash
+echo 'f /dev/shm/looking-glass 0660 $USER kvm -' | sudo tee /etc/tmpfiles.d/looking-glass.conf
+```
+
+**Run Looking Glass client:**
+```bash
+looking-glass-client
+```
+
+The VM will display in a window on your host desktop.
+
+## Troubleshooting
+
+### Viewing Logs
+
+The hook scripts now log to journald. View them with:
+
+```bash
+# View start hook logs
+sudo journalctl -t vm-gpu-start -n 50
+
+# View stop hook logs
+sudo journalctl -t vm-gpu-stop -n 50
+
+# Follow logs in real-time
+sudo journalctl -t vm-gpu-start -t vm-gpu-stop -f
+
+# View libvirt logs
+sudo journalctl -u libvirtd -n 50
+
+# View VM console output
+sudo tail -f /var/log/libvirt/qemu/win11.log
+```
+
+### VM won't start, display manager keeps restarting
+
+**Symptom:** Display flickers black, then returns to login screen immediately.
+
+**Cause:** Another process is using the GPU.
+
+**Fix:**
+```bash
+# Check what's using the GPU
+lsof /dev/nvidia*
+
+# Common culprits:
+# - Wayland compositors (use X11 instead, or stop compositor first)
+# - Steam
+# - Discord (hardware acceleration)
+# - Chrome/Firefox (hardware acceleration)
+# - Conky or other desktop widgets
+
+# Close those apps, then try again
+# Or add a longer sleep in start.sh:
+sleep 5  # After stopping display manager
+```
+
+### "vfio-pci: failed to bind" error
+
+**Cause:** IOMMU groups incorrect, or device still in use.
+
+**Check IOMMU groups:**
+```bash
+#!/usr/bin/env bash
+for d in /sys/kernel/iommu_groups/*/devices/*; do
+    n=${d#*/iommu_groups/*}; n=${n%%/*}
+    printf 'IOMMU Group %s: ' "$n"
+    lspci -nns "${d##*/}"
+done | grep -E "VGA|Audio"
+```
+
+**Your GPU and its audio device should be in the same IOMMU group, OR in separate groups.**
+
+If other devices (USB controllers, SATA controllers) are in the same group, you have two options:
+1. Pass through ALL devices in that group to the VM
+2. Enable ACS override patch (breaks IOMMU isolation - research first!)
+
+### Black screen after VM shutdown
+
+**Symptom:** VM shuts down, but Linux desktop doesn't return.
+
+**Cause:** Stop hook script failed.
+
+**Fix via SSH:**
+```bash
+ssh user@your-host-ip
+
+# Check if VM is actually stopped
+sudo virsh list --all
+
+# Check logs to see what failed
+sudo journalctl -t vm-gpu-stop -n 50
+
+# Manually run the stop script
+sudo /etc/libvirt/hooks/qemu.d/win11/release/end/stop.sh
+
+# If that fails, manually restart display manager
+sudo systemctl start sddm
+```
+
+**Fix via TTY:**
+```
+Ctrl+Alt+F2
+login
+gpu-recovery
+Ctrl+Alt+F1
+```
+
+### nvidia module won't unload
+
+**Symptom:** Hook script fails with "module nvidia is in use"
+
+**Cause:** Application is using the GPU.
+
+**Fix:**
+```bash
+# Check what's using nvidia
+lsof /dev/nvidia*
+
+# Common issues:
+# - Docker containers using nvidia runtime
+# - Persistent nvidia daemon
+# - Background apps (Steam, Discord)
+
+# Stop nvidia-persistenced if running
+sudo systemctl stop nvidia-persistenced
+
+# Kill processes using GPU
+sudo fuser -k /dev/nvidia*
+
+# Try unloading again
+sudo modprobe -r nvidia_drm nvidia_modeset nvidia_uvm nvidia
+```
+
+### VM starts but no display output
+
+**Symptom:** VM is running (virsh list shows it), but monitor shows "No Signal"
+
+**Possible causes:**
+
+1. **Windows hasn't installed GPU drivers yet**
+   - First boot: Windows uses generic display driver
+   - Install NVIDIA drivers in Windows
+   - Reboot VM
+
+2. **Monitor input not switching**
+   - Manually switch monitor input to the correct port
+   - Try a different cable (DisplayPort vs HDMI)
+
+3. **GPU ROM issue**
+   - Some GPUs need VBIOS ROM dumping
+   - Add to VM XML:
+   ```xml
+   <hostdev mode='subsystem' type='pci' managed='yes'>
+     <source>
+       <address domain='0x0000' bus='0x01' slot='0x00' function='0x0'/>
+     </source>
+     <rom file='/path/to/vbios.rom'/>
+   </hostdev>
+   ```
+
+### Check if passthrough is working
+
+**From host (via SSH while VM is running):**
+```bash
+# GPU should be bound to vfio-pci
+lspci -k -s 01:00.0  # Use your GPU address
+# Should show: Kernel driver in use: vfio-pci
+
+# VM should be using the GPU
+sudo virsh dumpxml win11 | grep -A5 hostdev
+```
+
+**From Windows VM:**
+1. Open Device Manager
+2. Look for your GPU under "Display adapters"
+3. Install NVIDIA drivers if not present
+
+## Complete Directory Structure
+
+```
+/etc/libvirt/hooks/
+├── qemu                          # Main hook dispatcher (executable)
+└── qemu.d/
+    └── win11/                    # Your VM name
+        ├── prepare/
+        │   └── begin/
+        │       └── start.sh      # Runs before VM starts (executable)
+        └── release/
+            └── end/
+                └── stop.sh       # Runs after VM stops (executable)
+```
+
+## AMD GPU Users
+
+Replace nvidia modules with amdgpu:
+
+In start.sh:
+```bash
+modprobe -r amdgpu
+```
+
+In stop.sh:
+```bash
+modprobe amdgpu
+```
+
+## Quick Reference
+
+### System Workflow (No iGPU)
+
+| Action | What Happens | What You See |
+|--------|--------------|--------------|
+| **Boot host** | Normal boot with nvidia driver | Linux desktop |
+| **Start VM** | SDDM stops → nvidia unloads → vfio-pci binds → VM starts | Display goes BLACK → Windows boot screen |
+| **VM running** | Host is headless, GPU in VM | Monitor shows Windows |
+| **Stop VM** | vfio-pci unbinds → nvidia loads → SDDM starts | Brief black screen → Linux desktop |
+
+### Where Is the GPU?
+
+| Scenario | GPU Bound To | Host Display | Monitor Shows | Control Host Via |
+|----------|--------------|--------------|---------------|------------------|
+| Host booted | nvidia | ✅ Working | Linux desktop | Keyboard/mouse |
+| VM starting | (transition) | ❌ BLACK | Nothing | Wait... |
+| VM running | vfio-pci (VM) | ❌ No graphics | Windows VM | SSH only |
+| VM stopping | (transition) | ❌ BLACK | Nothing | Wait... |
+| VM stopped | nvidia | ✅ Working | Linux desktop | Keyboard/mouse |
+
+## Emergency Recovery
+
+If something goes wrong and your display doesn't return, you have several options:
+
+### Method 1: SSH (Recommended)
+
+From another device on the same network:
+
+```bash
+# SSH into your host
+ssh user@192.168.1.100  # Use your actual IP
+
+# Check if VM is running
+sudo virsh list --all
+
+# Force stop the VM
+sudo virsh destroy win11  # Replace win11 with your VM name
+
+# Run the recovery script
+gpu-recovery
+
+# Or manually run the stop script
+sudo /etc/libvirt/hooks/qemu.d/win11/release/end/stop.sh
+
+# Check what went wrong
+sudo journalctl -t vm-gpu-start -t vm-gpu-stop -n 100
+```
+
+### Method 2: TTY Console
+
+If you can't SSH but the system is responsive:
+
+1. Press `Ctrl+Alt+F2` (or F3, F4, etc.) to switch to a TTY
+2. Login with your username and password
+3. Run: `gpu-recovery`
+4. Press `Ctrl+Alt+F1` to return to graphical interface
+
+### Method 3: Hard Reset (Last Resort)
+
+If nothing else works:
+
+1. Hold the power button for 10 seconds to force shutdown
+2. Boot normally - the GPU will bind to nvidia driver as usual
+3. Check logs after boot: `sudo journalctl -t vm-gpu-start -n 100`
+
+### Viewing Logs
+
+Check what went wrong:
+
+```bash
+# Hook script logs
+sudo journalctl -t vm-gpu-start -t vm-gpu-stop -n 100
+
+# Libvirt logs
+sudo journalctl -u libvirtd -n 100
+
+# VM-specific logs
+sudo tail -f /var/log/libvirt/qemu/win11.log
+```
+
+### Common Issues and Fixes
+
+**Display never comes back after VM shutdown:**
+```bash
+# Via SSH:
+sudo systemctl start sddm  # Or your display manager
+```
+
+**VM fails to start, display is black:**
+```bash
+# Via SSH:
+sudo virsh destroy win11
+gpu-recovery
+# Check logs to see what failed
+sudo journalctl -t vm-gpu-start -n 50
+```
diff --git a/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/test-gpu-bind-unbind.sh b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/test-gpu-bind-unbind.sh
new file mode 100755
index 00000000..97829d3d
--- /dev/null
+++ b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/test-gpu-bind-unbind.sh
@@ -0,0 +1,158 @@
+#!/usr/bin/env bash
+#
+# Test GPU Bind/Unbind Without VM
+# This script simulates the GPU passthrough process without starting a VM
+# It will bind the GPU to vfio-pci, wait for a timeout, then restore it
+#
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+print_header() {
+    printf '\n%b=== %s ===%b\n' "$BLUE" "$1" "$NC"
+}
+
+print_ok() {
+    printf '%b✓%b %s\n' "$GREEN" "$NC" "$1"
+}
+
+print_warn() {
+    printf '%b⚠%b %s\n' "$YELLOW" "$NC" "$1"
+}
+
+print_error() {
+    printf '%b✗%b %s\n' "$RED" "$NC" "$1"
+}
+
+# Check if running as root
+if [[ $EUID -ne 0 ]]; then
+    print_error "This script must be run as root (use sudo)"
+    exit 1
+fi
+
+# Configuration
+readonly GPU_PCI="0000:01:00.0"
+readonly GPU_AUDIO_PCI="0000:01:00.1"
+readonly DISPLAY_MANAGER="sddm"
+readonly TEST_DURATION="${1:-30}"  # Seconds to stay in vfio-pci mode
+
+print_header "GPU Bind/Unbind Test"
+printf 'Test Duration: %d seconds\n' "$TEST_DURATION"
+printf 'GPU: %s\n' "$GPU_PCI"
+printf 'Audio: %s\n' "$GPU_AUDIO_PCI"
+printf '\n%bWARNING: Your display will go BLACK during this test!%b\n' "$YELLOW" "$NC"
+printf 'Have SSH ready on another device: ssh %s@10.10.10.9\n' "$SUDO_USER"
+printf '\nPress Ctrl+C now to abort, or Enter to continue...'
+read -r
+
+# Cleanup function
+cleanup() {
+    printf '\n%bRestoring GPU to host...%b\n' "$YELLOW" "$NC"
+
+    # Unbind from vfio-pci
+    echo "$GPU_PCI" > /sys/bus/pci/drivers/vfio-pci/unbind 2>/dev/null || true
+    echo "$GPU_AUDIO_PCI" > /sys/bus/pci/drivers/vfio-pci/unbind 2>/dev/null || true
+
+    # Clear driver override
+    echo "" > "/sys/bus/pci/devices/$GPU_PCI/driver_override"
+    echo "" > "/sys/bus/pci/devices/$GPU_AUDIO_PCI/driver_override"
+
+    # Unload vfio modules
+    modprobe -r vfio_pci || true
+    modprobe -r vfio_iommu_type1 || true
+    modprobe -r vfio || true
+
+    # Rescan PCI bus
+    echo 1 > /sys/bus/pci/rescan
+    sleep 3
+
+    # Reload nvidia
+    modprobe nvidia
+    modprobe nvidia_modeset
+    modprobe nvidia_uvm
+    modprobe nvidia_drm
+
+    # Rebind consoles
+    echo 1 > /sys/class/vtconsole/vtcon0/bind || true
+    echo 1 > /sys/class/vtconsole/vtcon1/bind 2>/dev/null || true
+    echo efi-framebuffer.0 > /sys/bus/platform/drivers/efi-framebuffer/bind 2>/dev/null || true
+
+    # Start display manager
+    systemctl start "$DISPLAY_MANAGER"
+
+    print_ok "GPU restored to host"
+}
+
+# Set trap for cleanup on exit
+trap cleanup EXIT INT TERM
+
+print_header "Phase 1: Unbinding GPU from Host"
+
+# Stop display manager
+print_ok "Stopping display manager"
+systemctl stop "$DISPLAY_MANAGER"
+sleep 3
+
+# Unbind consoles
+print_ok "Unbinding VT consoles"
+echo 0 > /sys/class/vtconsole/vtcon0/bind || true
+echo 0 > /sys/class/vtconsole/vtcon1/bind 2>/dev/null || true
+echo efi-framebuffer.0 > /sys/bus/platform/drivers/efi-framebuffer/unbind 2>/dev/null || true
+
+# Unload nvidia
+print_ok "Unloading nvidia modules"
+modprobe -r nvidia_drm nvidia_modeset nvidia_uvm nvidia
+
+# Unbind GPU
+print_ok "Unbinding GPU from driver"
+if [[ -e "/sys/bus/pci/devices/$GPU_PCI/driver" ]]; then
+    echo "$GPU_PCI" > "/sys/bus/pci/devices/$GPU_PCI/driver/unbind"
+fi
+if [[ -e "/sys/bus/pci/devices/$GPU_AUDIO_PCI/driver" ]]; then
+    echo "$GPU_AUDIO_PCI" > "/sys/bus/pci/devices/$GPU_AUDIO_PCI/driver/unbind"
+fi
+
+print_header "Phase 2: Binding GPU to vfio-pci"
+
+# Load vfio
+print_ok "Loading vfio modules"
+modprobe vfio
+modprobe vfio_pci
+modprobe vfio_iommu_type1
+
+# Bind to vfio-pci
+print_ok "Binding GPU to vfio-pci"
+echo vfio-pci > "/sys/bus/pci/devices/$GPU_PCI/driver_override"
+echo vfio-pci > "/sys/bus/pci/devices/$GPU_AUDIO_PCI/driver_override"
+echo "$GPU_PCI" > /sys/bus/pci/drivers/vfio-pci/bind
+echo "$GPU_AUDIO_PCI" > /sys/bus/pci/drivers/vfio-pci/bind
+
+# Verify binding
+DRIVER=$(lspci -k -s "01:00.0" | grep "Kernel driver in use" | cut -d: -f2 | xargs)
+if [[ "$DRIVER" == "vfio-pci" ]]; then
+    print_ok "GPU successfully bound to vfio-pci"
+else
+    print_error "GPU binding failed! Driver is: $DRIVER"
+    exit 1
+fi
+
+print_header "Phase 3: Waiting"
+printf 'GPU is now bound to vfio-pci (VM would use it now)\n'
+printf 'Waiting %d seconds before restoring...\n' "$TEST_DURATION"
+
+for ((i=TEST_DURATION; i>0; i--)); do
+    printf '\rRestoring in %2d seconds... ' "$i"
+    sleep 1
+done
+printf '\n'
+
+print_header "Phase 4: Restoring GPU to Host"
+printf 'Cleanup trap will restore the GPU...\n'
+
+# Exit will trigger cleanup trap
+exit 0
diff --git a/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/validate-gpu-passthrough-ready.sh b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/validate-gpu-passthrough-ready.sh
new file mode 100755
index 00000000..0a915990
--- /dev/null
+++ b/user_scripts/TEST_Single_GPU_KVM_PASSTHROUGH/validate-gpu-passthrough-ready.sh
@@ -0,0 +1,175 @@
+#!/usr/bin/env bash
+#
+# Validate GPU Passthrough Readiness
+# Checks if system is ready for first GPU passthrough test
+#
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+print_header() {
+    printf '\n%b=== %s ===%b\n' "$BLUE" "$1" "$NC"
+}
+
+print_ok() {
+    printf '%b✓%b %s\n' "$GREEN" "$NC" "$1"
+}
+
+print_warn() {
+    printf '%b⚠%b %s\n' "$YELLOW" "$NC" "$1"
+}
+
+print_error() {
+    printf '%b✗%b %s\n' "$RED" "$NC" "$1"
+}
+
+ERRORS=0
+WARNINGS=0
+VM_NAME="${1:-win11}"
+
+print_header "GPU Passthrough Readiness Check for VM: $VM_NAME"
+
+# Check 1: Hooks installed
+print_header "1. Checking Hook Scripts"
+if [[ -x "/etc/libvirt/hooks/qemu" ]]; then
+    print_ok "Main hook dispatcher installed"
+else
+    print_error "Main hook NOT installed"
+    printf '   Run: sudo ~/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/install-gpu-passthrough-hooks.sh %s\n' "$VM_NAME"
+    ((ERRORS++))
+fi
+
+if [[ -x "/etc/libvirt/hooks/qemu.d/$VM_NAME/prepare/begin/start.sh" ]]; then
+    print_ok "VM start hook installed"
+else
+    print_error "VM start hook NOT installed"
+    ((ERRORS++))
+fi
+
+if [[ -x "/etc/libvirt/hooks/qemu.d/$VM_NAME/release/end/stop.sh" ]]; then
+    print_ok "VM stop hook installed"
+else
+    print_error "VM stop hook NOT installed"
+    ((ERRORS++))
+fi
+
+# Check 2: VM exists
+print_header "2. Checking VM Configuration"
+if virsh list --all 2>/dev/null | grep -q "$VM_NAME"; then
+    print_ok "VM '$VM_NAME' exists"
+
+    # Check if VM has GPU passthrough configured
+    if virsh dumpxml "$VM_NAME" 2>/dev/null | grep -q "bus='0x01' slot='0x00'"; then
+        print_ok "GPU passthrough configured in VM XML"
+    else
+        print_warn "GPU NOT configured in VM XML yet"
+        printf '   Add GPU with: sudo virsh edit %s\n' "$VM_NAME"
+        ((WARNINGS++))
+    fi
+else
+    print_warn "VM '$VM_NAME' does not exist yet"
+    printf '   Create VM using virt-manager first\n'
+    ((WARNINGS++))
+fi
+
+# Check 3: libvirtd running
+print_header "3. Checking Libvirt Service"
+if systemctl is-active --quiet libvirtd; then
+    print_ok "libvirtd is running"
+else
+    print_warn "libvirtd is not running"
+    printf '   Start with: sudo systemctl start libvirtd\n'
+    ((WARNINGS++))
+fi
+
+# Check 4: SSH accessible
+print_header "4. Checking SSH Access"
+if systemctl is-active --quiet sshd; then
+    print_ok "SSH daemon is running"
+    IP=$(ip -4 addr show | grep "inet " | grep -v 127.0.0.1 | head -1 | awk '{print $2}' | cut -d/ -f1)
+    printf '   Test from another device: ssh %s@%s\n' "$USER" "$IP"
+else
+    print_error "SSH daemon is NOT running (CRITICAL!)"
+    printf '   Enable: sudo systemctl enable --now sshd\n'
+    ((ERRORS++))
+fi
+
+# Check 5: Timeout configured
+print_header "5. Checking Safety Timeout"
+if [[ -n "${GPU_PASSTHROUGH_TIMEOUT:-}" ]]; then
+    print_ok "Safety timeout is set: $GPU_PASSTHROUGH_TIMEOUT minutes"
+else
+    print_warn "Safety timeout NOT set"
+    printf '   Set with: export GPU_PASSTHROUGH_TIMEOUT=5\n'
+    printf '   Add to ~/.bashrc for persistence\n'
+    ((WARNINGS++))
+fi
+
+# Check 6: GPU status
+print_header "6. Checking GPU Status"
+DRIVER=$(lspci -k -s 01:00.0 | grep "Kernel driver in use" | cut -d: -f2 | xargs)
+if [[ "$DRIVER" == "nvidia" ]]; then
+    print_ok "GPU is using nvidia driver (correct for host)"
+elif [[ "$DRIVER" == "vfio-pci" ]]; then
+    print_warn "GPU is using vfio-pci (VM might be running or test in progress)"
+else
+    print_warn "GPU is using: $DRIVER"
+fi
+
+# Check 7: Required modules
+print_header "7. Checking Kernel Modules"
+if lsmod | grep -q "^kvm_intel"; then
+    print_ok "kvm_intel loaded"
+else
+    print_error "kvm_intel NOT loaded"
+    ((ERRORS++))
+fi
+
+if lsmod | grep -q "^nvidia "; then
+    print_ok "nvidia loaded"
+else
+    print_warn "nvidia NOT loaded (might be OK if GPU is in vfio mode)"
+fi
+
+# Check 8: Test scripts available
+print_header "8. Checking Test Scripts"
+if [[ -x "$HOME/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/test-gpu-bind-unbind.sh" ]]; then
+    print_ok "Bind/unbind test script available"
+else
+    print_warn "Test script not found or not executable"
+fi
+
+if [[ -x "$HOME/user_scripts_local/Single_GPU_KVM_PASSTHROUGH/gpu-recovery" ]] || [[ -x "$HOME/.local/bin/gpu-recovery" ]]; then
+    print_ok "GPU recovery script available"
+else
+    print_warn "Recovery script not found"
+    printf '   Create with instructions from guide\n'
+    ((WARNINGS++))
+fi
+
+# Summary
+print_header "Readiness Summary"
+if [[ $ERRORS -eq 0 && $WARNINGS -eq 0 ]]; then
+    printf '%b✓ ALL CHECKS PASSED%b\n' "$GREEN" "$NC"
+    printf '\nYour system is READY for GPU passthrough testing!\n\n'
+    printf '%bRecommended first test:%b\n' "$BLUE" "$NC"
+    printf '1. Have SSH ready: ssh %s@%s\n' "$USER" "$(ip -4 addr show | grep "inet " | grep -v 127.0.0.1 | head -1 | awk '{print $2}' | cut -d/ -f1)"
+    printf '2. Set timeout: export GPU_PASSTHROUGH_TIMEOUT=5\n'
+    printf '3. Start VM: virsh start %s\n' "$VM_NAME"
+    printf '4. Monitor logs via SSH: sudo journalctl -f -t vm-gpu-start -t vm-gpu-stop\n'
+    printf '5. Wait for automatic shutdown after 5 minutes\n'
+    exit 0
+elif [[ $ERRORS -eq 0 ]]; then
+    printf '%b⚠ READY WITH WARNINGS%b (%d warning(s))\n' "$YELLOW" "$NC" "$WARNINGS"
+    printf '\nYou can proceed, but review warnings above.\n'
+    exit 0
+else
+    printf '%b✗ NOT READY%b (%d error(s), %d warning(s))\n' "$RED" "$NC" "$ERRORS" "$WARNINGS"
+    printf '\nFix critical errors before testing!\n'
+    exit 1
+fi

From f7173dd6f6d16053f3cec593a0d94869425bfc33 Mon Sep 17 00:00:00 2001
From: coops <dcooper344@gmail.com>
Date: Thu, 5 Feb 2026 22:09:14 +1100
Subject: [PATCH 4/4] new auto scale script, keeps scale and screen position
 for multi screen set ups

---
 user_scripts/hypr/TEST-auto-scale.sh | 338 +++++++++++++++++++++++++++
 user_scripts/llm/TEST_glm-ocr.sh     |  74 ++++++
 2 files changed, 412 insertions(+)
 create mode 100644 user_scripts/hypr/TEST-auto-scale.sh
 create mode 100755 user_scripts/llm/TEST_glm-ocr.sh

diff --git a/user_scripts/hypr/TEST-auto-scale.sh b/user_scripts/hypr/TEST-auto-scale.sh
new file mode 100644
index 00000000..ca473f8e
--- /dev/null
+++ b/user_scripts/hypr/TEST-auto-scale.sh
@@ -0,0 +1,338 @@
+#!/usr/bin/env bash                                                                                                       
+  # ==============================================================================                                          
+  # UNIVERSAL HYPRLAND MONITOR SCALER (V17 - AUTO-REPOSITION)                                                               
+  # ==============================================================================                                          
+  # Fixes "Rejection Loops" on low-resolution or virtual monitors by enforcing                                              
+  # strict pixel alignment (0.01 tolerance instead of 0.05).                                                                
+  #                                                                                                                         
+  # V17 Updates:                                                                                                            
+  # - Automatic monitor repositioning after scale changes                                                                   
+  # - Prevents monitor overlap by calculating effective widths                                                              
+  # - Persists position changes to monitors.conf                                                                            
+  # ==============================================================================                                          
+                                                                                                                            
+  set -euo pipefail                                                                                                         
+  export LC_ALL=C                                                                                                           
+                                                                                                                            
+  # --- Immutable Configuration ---                                                                                         
+  readonly CONFIG_DIR="${HOME}/.config/hypr/edit_here/source"                                                               
+  readonly NOTIFY_TAG="hypr_scale_adjust"                                                                                   
+  readonly NOTIFY_TIMEOUT=2000                                                                                              
+  readonly MIN_LOGICAL_WIDTH=640                                                                                            
+  readonly MIN_LOGICAL_HEIGHT=360                                                                                           
+                                                                                                                            
+  # --- Runtime State ---                                                                                                   
+  DEBUG="${DEBUG:-0}"                                                                                                       
+  TARGET_MONITOR="${HYPR_SCALE_MONITOR:-}"                                                                                  
+  CONFIG_FILE=""                                                                                                            
+                                                                                                                            
+  # --- Logging ---                                                                                                         
+  log_err()   { printf '\033[0;31m[ERROR]\033[0m %s\n' "$1" >&2; }                                                          
+  log_warn()  { printf '\033[0;33m[WARN]\033[0m %s\n'  "$1" >&2; }                                                          
+  log_info()  { printf '\033[0;32m[INFO]\033[0m %s\n'  "$1" >&2; }                                                          
+  log_debug() { [[ "${DEBUG}" != "1" ]] || printf '\033[0;34m[DEBUG]\033[0m %s\n' "$1" >&2; }                               
+                                                                                                                            
+  die() {                                                                                                                   
+      log_err "$1"                                                                                                          
+      notify-send -u critical "Monitor Scale Failed" "$1" 2>/dev/null || true                                               
+      exit 1                                                                                                                
+  }                                                                                                                         
+                                                                                                                            
+  trim() {                                                                                                                  
+      local s="$1"                                                                                                          
+      s="${s#"${s%%[![:space:]]*}"}"                                                                                        
+      s="${s%"${s##*[![:space:]]}"}"                                                                                        
+      printf '%s' "$s"                                                                                                      
+  }                                                                                                                         
+                                                                                                                            
+  # --- Initialization ---                                                                                                  
+  init_config_file() {                                                                                                      
+      # STRICTLY monitors.conf only                                                                                         
+      if [[ -f "${CONFIG_DIR}/monitors.conf" ]]; then                                                                       
+          CONFIG_FILE="${CONFIG_DIR}/monitors.conf"                                                                         
+          log_debug "Selected config: monitors.conf"                                                                        
+      else                                                                                                                  
+          CONFIG_FILE="${CONFIG_DIR}/monitors.conf"                                                                         
+          log_debug "Creating new config: monitors.conf"                                                                    
+          mkdir -p -- "${CONFIG_DIR}"                                                                                       
+          : > "$CONFIG_FILE"                                                                                                
+      fi                                                                                                                    
+  }                                                                                                                         
+                                                                                                                            
+  check_dependencies() {                                                                                                    
+      local missing=() cmd                                                                                                  
+      for cmd in hyprctl jq awk notify-send; do                                                                             
+          command -v "$cmd" &>/dev/null || missing+=("$cmd")                                                                
+      done                                                                                                                  
+      ((${#missing[@]} == 0)) || die "Missing dependencies: ${missing[*]}"                                                  
+  }                                                                                                                         
+                                                                                                                            
+  notify_user() {                                                                                                           
+      local scale="$1" monitor="$2" extra="${3:-}"                                                                          
+      log_info "Monitor: ${monitor} | Scale: ${scale}${extra:+ | ${extra}}"                                                 
+      local body="Monitor: ${monitor}"                                                                                      
+      [[ -n "$extra" ]] && body+=$'\n'"${extra}"                                                                            
+      notify-send -h "string:x-canonical-private-synchronous:${NOTIFY_TAG}" \                                               
+          -u low -t "$NOTIFY_TIMEOUT" "Display Scale: ${scale}" "$body" 2>/dev/null || true                                 
+  }                                                                                                                         
+                                                                                                                            
+  # --- Scale Calculation (Strict Mode) ---                                                                                 
+  compute_next_scale() {                                                                                                    
+      local current="$1" direction="$2" phys_w="$3" phys_h="$4"                                                             
+                                                                                                                            
+      awk -v cur="$current" -v dir="$direction" \                                                                           
+          -v w="$phys_w" -v h="$phys_h" \                                                                                   
+          -v min_w="$MIN_LOGICAL_WIDTH" -v min_h="$MIN_LOGICAL_HEIGHT" '                                                    
+      BEGIN {                                                                                                               
+          # Hyprland "Golden List"                                                                                          
+          n = split("0.5 0.6 0.75 0.8 0.9 1.0 1.0625 1.1 1.125 1.15 1.2 1.25 1.33 1.4 1.5 1.6 1.67 1.75 1.8 1.88 2.0 2.25   
+  2.4 2.5 2.67 2.8 3.0", raw)                                                                                               
+          count = 0                                                                                                         
+                                                                                                                            
+          for (i = 1; i <= n; i++) {                                                                                        
+              s = raw[i] + 0                                                                                                
+                                                                                                                            
+              # Check 1: Minimum logical size                                                                               
+              lw = w / s; lh = h / s                                                                                        
+              if (lw < min_w || lh < min_h) continue                                                                        
+                                                                                                                            
+              # Check 2: STRICT Integer Alignment                                                                           
+              # Fixes loop where 1.15 was allowed on 1280x800 despite 0.04px error                                          
+              frac = lw - int(lw)                                                                                           
+              if (frac > 0.5) frac = 1.0 - frac                                                                             
+                                                                                                                            
+              # TOLERANCE TIGHTENED: 0.05 -> 0.01                                                                           
+              if (frac > 0.01) continue                                                                                     
+                                                                                                                            
+              valid[++count] = s                                                                                            
+          }                                                                                                                 
+                                                                                                                            
+          if (count == 0) { valid[1] = 1.0; count = 1 }                                                                     
+                                                                                                                            
+          # Find position                                                                                                   
+          best = 1; mindiff = 1e9                                                                                           
+          for (i = 1; i <= count; i++) {                                                                                    
+              d = cur - valid[i]                                                                                            
+              if (d < 0) d = -d                                                                                             
+              if (d < mindiff) { mindiff = d; best = i }                                                                    
+          }                                                                                                                 
+                                                                                                                            
+          # Calculate target                                                                                                
+          target = (dir == "+") ? best + 1 : best - 1                                                                       
+          if (target < 1) target = 1                                                                                        
+          if (target > count) target = count                                                                                
+                                                                                                                            
+          ns = valid[target]                                                                                                
+          changed = (((ns - cur)^2) > 0.000001) ? 1 : 0                                                                     
+                                                                                                                            
+          fmt = sprintf("%.6f", ns)                                                                                         
+          sub(/0+$/, "", fmt); sub(/\.$/, "", fmt)                                                                          
+          printf "%s %d %d %d\n", fmt, int(w/ns + 0.5), int(h/ns + 0.5), changed                                            
+      }'                                                                                                                    
+  }                                                                                                                         
+                                                                                                                            
+  # --- Config Manager ---                                                                                                  
+  update_config_file() {                                                                                                    
+      local monitor="$1" new_scale="$2"                                                                                     
+      local tmpfile found=0                                                                                                 
+                                                                                                                            
+      tmpfile=$(mktemp) || die "Failed to create temp file"                                                                 
+      trap 'rm -f -- "$tmpfile"' EXIT                                                                                       
+                                                                                                                            
+      log_debug "Updating config: ${monitor} -> ${new_scale}"                                                               
+                                                                                                                            
+      while IFS= read -r line || [[ -n "$line" ]]; do                                                                       
+          if [[ "$line" =~ ^[[:space:]]*monitor[[:space:]]*= ]]; then                                                       
+              local content="${line#*=}"                                                                                    
+              content="${content%%#*}" # Strip comments                                                                     
+              content="$(trim "$content")"                                                                                  
+                                                                                                                            
+              local -a fields                                                                                               
+              IFS=',' read -ra fields <<< "$content"                                                                        
+              local mon_name                                                                                                
+              mon_name="$(trim "${fields[0]}")"                                                                             
+                                                                                                                            
+              if [[ "$mon_name" == "$monitor" ]]; then                                                                      
+                  found=1                                                                                                   
+                  local new_line="monitor = ${mon_name}"                                                                    
+                  new_line+=", $(trim "${fields[1]:-preferred}")"                                                           
+                  new_line+=", $(trim "${fields[2]:-auto}")"                                                                
+                  new_line+=", ${new_scale}"                                                                                
+                                                                                                                            
+                  local i                                                                                                   
+                  for ((i = 4; i < ${#fields[@]}; i++)); do                                                                 
+                      new_line+=", $(trim "${fields[i]}")"                                                                  
+                  done                                                                                                      
+                                                                                                                            
+                  printf '%s\n' "$new_line" >> "$tmpfile"                                                                   
+                  continue                                                                                                  
+              fi                                                                                                            
+          fi                                                                                                                
+          printf '%s\n' "$line" >> "$tmpfile"                                                                               
+      done < "$CONFIG_FILE"                                                                                                 
+                                                                                                                            
+      if ((found == 0)); then                                                                                               
+          log_info "Appending new entry for: ${monitor}"                                                                    
+          printf 'monitor = %s, preferred, auto, %s\n' "$monitor" "$new_scale" >> "$tmpfile"                                
+      fi                                                                                                                    
+                                                                                                                            
+      mv -f -- "$tmpfile" "$CONFIG_FILE"                                                                                    
+      trap - EXIT                                                                                                           
+  }                                                                                                                         
+                                                                                                                            
+  # --- Monitor Position Calculator ---                                                                                     
+  recalculate_monitor_positions() {                                                                                         
+      log_debug "Recalculating monitor positions..."                                                                        
+                                                                                                                            
+      # Get all monitors with their current config                                                                          
+      local monitors_json                                                                                                   
+      monitors_json=$(hyprctl -j monitors) || return 1                                                                      
+                                                                                                                            
+      # Sort monitors by X position (left to right)                                                                         
+      local sorted_monitors                                                                                                 
+      sorted_monitors=$(jq -r 'sort_by(.x) | .[] | "\(.name) \(.width) \(.height) \(.scale) \(.refreshRate) \(.x) \(.y)"'   
+  <<< "$monitors_json")                                                                                                     
+                                                                                                                            
+      local cumulative_x=0                                                                                                  
+      local prev_name=""                                                                                                    
+                                                                                                                            
+      while IFS= read -r line; do                                                                                           
+          [[ -z "$line" ]] && continue                                                                                      
+                                                                                                                            
+          local name width height scale refresh curr_x curr_y                                                               
+          read -r name width height scale refresh curr_x curr_y <<< "$line"                                                 
+                                                                                                                            
+          # Calculate effective width (scaled width)                                                                        
+          local effective_width                                                                                             
+          effective_width=$(awk -v w="$width" -v s="$scale" 'BEGIN { printf "%.0f", w / s }')                               
+                                                                                                                            
+          local new_x="$cumulative_x"                                                                                       
+          local refresh_fmt rule                                                                                            
+          refresh_fmt=$(format_refresh "$refresh")                                                                          
+                                                                                                                            
+          # Only update if position changed                                                                                 
+          if [[ "$curr_x" != "$new_x" ]]; then                                                                              
+              rule="${name},${width}x${height}@${refresh_fmt},${new_x}x${curr_y},${scale}"                                  
+              log_info "Repositioning: ${name} from ${curr_x}x${curr_y} to ${new_x}x${curr_y}"                              
+              hyprctl keyword monitor "$rule" &>/dev/null || log_warn "Failed to reposition ${name}"                        
+                                                                                                                            
+              # Update config file with new position                                                                        
+              update_monitor_position "$name" "${new_x}x${curr_y}"                                                          
+          fi                                                                                                                
+                                                                                                                            
+          # Update cumulative position for next monitor                                                                     
+          cumulative_x=$((cumulative_x + effective_width))                                                                  
+                                                                                                                            
+      done <<< "$sorted_monitors"                                                                                           
+  }                                                                                                                         
+                                                                                                                            
+  # --- Update Monitor Position in Config ---                                                                               
+  update_monitor_position() {                                                                                               
+      local monitor="$1" new_position="$2"                                                                                  
+      local tmpfile found=0                                                                                                 
+                                                                                                                            
+      tmpfile=$(mktemp) || return 1                                                                                         
+      trap 'rm -f -- "$tmpfile"' RETURN                                                                                     
+                                                                                                                            
+      while IFS= read -r line || [[ -n "$line" ]]; do                                                                       
+          if [[ "$line" =~ ^[[:space:]]*monitor[[:space:]]*= ]]; then                                                       
+              local content="${line#*=}"                                                                                    
+              content="${content%%#*}"                                                                                      
+              content="$(trim "$content")"                                                                                  
+                                                                                                                            
+              local -a fields                                                                                               
+              IFS=',' read -ra fields <<< "$content"                                                                        
+              local mon_name                                                                                                
+              mon_name="$(trim "${fields[0]}")"                                                                             
+                                                                                                                            
+              if [[ "$mon_name" == "$monitor" ]]; then                                                                      
+                  found=1                                                                                                   
+                  local new_line="monitor = ${mon_name}"                                                                    
+                  new_line+=", $(trim "${fields[1]:-preferred}")"                                                           
+                  new_line+=", ${new_position}"                                                                             
+                  new_line+=", $(trim "${fields[3]:-1}")"                                                                   
+                                                                                                                            
+                  local i                                                                                                   
+                  for ((i = 4; i < ${#fields[@]}; i++)); do                                                                 
+                      new_line+=", $(trim "${fields[i]}")"                                                                  
+                  done                                                                                                      
+                                                                                                                            
+                  printf '%s\n' "$new_line" >> "$tmpfile"                                                                   
+                  continue                                                                                                  
+              fi                                                                                                            
+          fi                                                                                                                
+          printf '%s\n' "$line" >> "$tmpfile"                                                                               
+      done < "$CONFIG_FILE"                                                                                                 
+                                                                                                                            
+      if ((found == 1)); then                                                                                               
+          mv -f -- "$tmpfile" "$CONFIG_FILE"                                                                                
+      fi                                                                                                                    
+  }                                                                                                                         
+                                                                                                                            
+  # --- Main ---                                                                                                            
+  format_refresh() { awk -v r="$1" 'BEGIN { fmt = sprintf("%.2f", r); sub(/\.00$/, "", fmt); print fmt }'; }                
+                                                                                                                            
+  main() {                                                                                                                  
+      check_dependencies                                                                                                    
+      init_config_file                                                                                                      
+                                                                                                                            
+      if [[ $# -ne 1 ]] || [[ "$1" != "+" && "$1" != "-" ]]; then                                                           
+          printf 'Usage: %s [+|-]\n' "${0##*/}" >&2; exit 1                                                                 
+      fi                                                                                                                    
+      local direction="$1"                                                                                                  
+                                                                                                                            
+      local monitors_json                                                                                                   
+      monitors_json=$(hyprctl -j monitors) || die "Cannot connect to Hyprland"                                              
+                                                                                                                            
+      local monitor="${TARGET_MONITOR}"                                                                                     
+      [[ -n "$monitor" ]] || monitor=$(jq -r '.[] | select(.focused) | .name // empty' <<< "$monitors_json")                
+      [[ -n "$monitor" ]] || monitor=$(jq -r '.[0].name // empty' <<< "$monitors_json")                                     
+      [[ -n "$monitor" ]] || die "No active monitors found"                                                                 
+                                                                                                                            
+      local props                                                                                                           
+      props=$(jq -r --arg m "$monitor" '.[] | select(.name == $m) | "\(.width) \(.height) \(.scale) \(.refreshRate) \(.x)   
+  \(.y)"' <<< "$monitors_json")                                                                                             
+      [[ -n "$props" ]] || die "Monitor '${monitor}' details not found"                                                     
+                                                                                                                            
+      local width height current_scale refresh pos_x pos_y                                                                  
+      read -r width height current_scale refresh pos_x pos_y <<< "$props"                                                   
+                                                                                                                            
+      local scale_output new_scale logic_w logic_h changed                                                                  
+      scale_output=$(compute_next_scale "$current_scale" "$direction" "$width" "$height")                                   
+      read -r new_scale logic_w logic_h changed <<< "$scale_output"                                                         
+                                                                                                                            
+      if ((changed == 0)); then                                                                                             
+          log_warn "Limit reached: ${new_scale}"                                                                            
+          notify_user "$new_scale" "$monitor" "(Limit Reached)"                                                             
+          exit 0                                                                                                            
+      fi                                                                                                                    
+                                                                                                                            
+      update_config_file "$monitor" "$new_scale"                                                                            
+                                                                                                                            
+      local refresh_fmt rule                                                                                                
+      refresh_fmt=$(format_refresh "$refresh")                                                                              
+      rule="${monitor},${width}x${height}@${refresh_fmt},${pos_x}x${pos_y},${new_scale}"                                    
+                                                                                                                            
+      log_info "Applying: ${rule}"                                                                                          
+                                                                                                                            
+      if hyprctl keyword monitor "$rule" &>/dev/null; then                                                                  
+          sleep 0.15                                                                                                        
+          local actual_scale                                                                                                
+          actual_scale=$(hyprctl -j monitors | jq -r --arg m "$monitor" '.[] | select(.name == $m) | .scale')               
+                                                                                                                            
+          if awk -v a="$actual_scale" -v b="$new_scale" 'BEGIN { exit !(((a - b)^2) > 0.000001) }'; then                    
+              log_warn "Hyprland auto-adjusted: ${new_scale} -> ${actual_scale}"                                            
+              notify_user "Adjusted" "$monitor" "Requested ${new_scale}, got ${actual_scale}"                               
+              update_config_file "$monitor" "$actual_scale"                                                                 
+          else                                                                                                              
+              notify_user "$new_scale" "$monitor" "Logical: ${logic_w}x${logic_h}"                                          
+          fi                                                                                                                
+                                                                                                                            
+          # Recalculate positions to prevent overlap                                                                        
+          sleep 0.1                                                                                                         
+          recalculate_monitor_positions                                                                                     
+      else                                                                                                                  
+          die "Hyprland rejected rule: ${rule}"                                                                             
+      fi                                                                                                                    
+  }                                                                                                 
+  main "$@"
diff --git a/user_scripts/llm/TEST_glm-ocr.sh b/user_scripts/llm/TEST_glm-ocr.sh
new file mode 100755
index 00000000..a5a21958
--- /dev/null
+++ b/user_scripts/llm/TEST_glm-ocr.sh
@@ -0,0 +1,74 @@
+#!/bin/bash                                                                                                        
+                                                                                                                     
+  # GLM-OCR Selection Script                                                                                         
+  # Alternative to tesseract with better accuracy on complex documents                                               
+                                                                                                                     
+  # Configuration                                                                                                    
+  MODEL="glm-ocr:bf16"                                                                                               
+  TEMP_DIR="/tmp/glm-ocr"                                                                                            
+  TEMP_IMAGE="$TEMP_DIR/screenshot.png"                                                                              
+                                                                                                                     
+  # Create temp directory if it doesn't exist                                                                        
+  mkdir -p "$TEMP_DIR"                                                                                               
+                                                                                                                     
+  # Get OCR mode from argument (default: text)                                                                       
+  MODE="${1:-text}"                                                                                                  
+                                                                                                                     
+  case "$MODE" in                                                                                                    
+      text|t)                                                                                                        
+          PROMPT="Text Recognition"                                                                                  
+          ;;                                                                                                         
+      table|tb)                                                                                                      
+          PROMPT="Table Recognition"                                                                                 
+          ;;                                                                                                         
+      figure|fig|f)                                                                                                  
+          PROMPT="Figure Recognition"                                                                                
+          ;;                                                                                                         
+      *)                                                                                                             
+          PROMPT="Text Recognition"                                                                                  
+          ;;                                                                                                         
+  esac                                                                                                               
+                                                                                                                     
+  # Check if ollama is installed                                                                                     
+  if ! command -v ollama &> /dev/null; then                                                                          
+      notify-send "GLM-OCR Error" "Ollama is not installed"                                                          
+      exit 1                                                                                                         
+  fi                                                                                                                 
+                                                                                                                     
+  # Check if model is available                                                                                      
+  if ! ollama list | grep -q "$MODEL"; then                                                                          
+      notify-send "GLM-OCR" "Downloading model... This may take a moment"                                            
+      ollama pull "$MODEL"                                                                                           
+  fi                                                                                                                 
+                                                                                                                     
+  # Use slurp to select area, grim to capture, save to temp file                                                     
+  if slurp | grim -g - "$TEMP_IMAGE"; then                                                                           
+      # Show notification that OCR is processing                                                                     
+      notify-send "GLM-OCR" "Processing ${MODE}..."                                                                  
+                                                                                                                     
+      # Run GLM-OCR and filter out status messages                                                                   
+      RESULT=$(ollama run "$MODEL" "${PROMPT}: $TEMP_IMAGE" 2>&1 | \                                                 
+          grep -v "^Added image" | \                                                                                 
+          grep -v "^⠙" | \                                                                                           
+          grep -v "^⠹" | \                                                                                           
+          grep -v "^⠸" | \                                                                                           
+          grep -v "^⠼" | \                                                                                           
+          grep -v "^⠴" | \                                                                                           
+          grep -v "^⠦" | \                                                                                           
+          grep -v "^⠧" | \                                                                                           
+          grep -v "^⠇" | \                                                                                           
+          grep -v "^⠏" | \                                                                                           
+          sed 's/^[[:space:]]*//;s/[[:space:]]*$//')                                                                 
+                                                                                                                     
+      if [ -n "$RESULT" ]; then                                                                                      
+          echo -n "$RESULT" | wl-copy                                                                                
+          notify-send "GLM-OCR" "Copied to clipboard!"                                                               
+      else                                                                                                           
+          notify-send "GLM-OCR Error" "No text detected"                                                             
+      fi                                                                                                             
+                                                                                                                     
+      # Clean up                                                                                                     
+      rm -f "$TEMP_IMAGE"                                                                                            
+  else                                                                                                               
+      notify-send "GLM-OCR" "Selection cancelled"                                                                    
+  fi