eGPU Auto-Enabler

The Problem

External GPUs via Thunderbolt/USB-C present a unique challenge on Windows:

1. Safe-removal workflow: NVIDIA Control Panel → “Safely remove GPU”
2. Physical disconnection: Unplug Thunderbolt cable
3. Reconnection issue: When you plug back in… GPU stays disabled
4. Manual intervention required: Device Manager → Find GPU → Enable device → Wait

This happens every single time after a long study session, gaming break, or travel disconnect. It’s frustrating, time-consuming, and completely unnecessary.

The Solution

eGPU Auto-Enabler runs silently in the background and automatically enables your eGPU whenever you reconnect it after safe-removal. No manual intervention required.

Key Features

1. Automatic Device Monitoring

Uses Get-PnpDevice to poll eGPU status:

$device = Get-PnpDevice -InstanceId $eGPU_InstanceId
$status = $device.Status  # OK, Error, Degraded, Unknown

Polls every 2 seconds with minimal CPU impact (<1%).

2. Intelligent Power Management

All preferences are user-configurable during installation:

• Display timeout duration (1-120 minutes, or system default)
• Lid close action when disconnected (Do Nothing/Sleep/Hibernate/Shutdown)

3. Crash Recovery

Implements robust state persistence:

{
  "originalPowerPlan": "381b4222-f694-41f0-9685-ff5bb260df2e",
  "originalDisplayTimeout": 10,
  "originalLidAction": "Sleep",
  "eGPUConnected": true,
  "lastUpdate": "2025-01-15T14:32:18Z"
}

If the script crashes while eGPU is connected, it automatically restores settings on restart. Handles reboots intelligently without false restorations.

4. Windows Notifications

Shows toast notifications for:

• ✅ eGPU successfully enabled
• 🔌 eGPU disconnected
• ⚡ Power plan switched
• ⚠️ Update available
• ❌ Enable failed (with troubleshooting steps)

5. Auto-Update System

Checks GitHub for updates once per day:

• Compares local version with latest release
• Shows notification if update available
• Preserves configuration during updates

Technical Implementation

Device State Detection

function Get-eGPUState {
    param([string]$InstanceId)
    
    try {
        $device = Get-PnpDevice -InstanceId $InstanceId -ErrorAction Stop
        
        switch ($device.Status) {
            'OK' { return 'present-ok' }
            'Error' { return 'present-disabled' }
            default { return 'unknown' }
        }
    }
    catch [Microsoft.PowerShell.Commands.GetPnpDeviceCommand+DeviceNotFoundException] {
        return 'absent'
    }
}

Power Management API

Uses powercfg.exe and Windows Power Management WMI:

# Create custom power plan
powercfg -duplicatescheme 8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c eGPU-HighPerf

# Optimize for eGPU performance
powercfg -setacvalueindex eGPU-HighPerf SUB_PROCESSOR PERFBOOSTMODE 2
powercfg -setacvalueindex eGPU-HighPerf SUB_PCIEXPRESS ASPM 0

Enable Command

Uses pnputil.exe - the same tool Windows Device Manager uses internally:

pnputil /enable-device $eGPU_InstanceId

This ensures maximum reliability and OS compatibility.

Performance Metrics

Resource Usage

• CPU: <0.5% average (2-second polling)
• Memory: ~50MB (PowerShell process)
• Disk: <1MB (logs auto-rotate at 500KB)
• Network: 0 (except daily update check: <1KB)

Installation & Configuration

One-Line Install

irm https://raw.githubusercontent.com/Bananz0/eGPUae/main/Install-eGPU-Startup.ps1 | iex

Interactive Setup

1. Select your eGPU from detected devices
2. Configure display timeout (1-120 min or system default)
3. Set lid close action when eGPU disconnected
4. Done! Starts automatically on every boot

Files Created

C:\Users\YourName\.egpu-manager\
├── eGPU.ps1                    # Monitor script
├── egpu-config.json            # Your configuration
├── runtime-state.json          # Crash recovery state
├── egpu-manager.log            # Current log
└── egpu-manager.old.log        # Previous log backup

Advanced Usage

View Live Monitor

pwsh "$env:USERPROFILE\.egpu-manager\eGPU.ps1"

Check Logs

# Last 50 entries
Get-Content "$env:USERPROFILE\.egpu-manager\egpu-manager.log" -Tail 50

Reconfigure

irm https://raw.githubusercontent.com/Bananz0/eGPUae/main/Install-eGPU-Startup.ps1 | iex
# Choose [1] Reconfigure

Uninstall

.\Install-eGPU-Startup.ps1 -Uninstall

Troubleshooting

Common Issues

Script Not Running

# Check scheduled task
Get-ScheduledTask -TaskName "eGPU-AutoEnable"

# Check task history
Get-ScheduledTaskInfo -TaskName "eGPU-AutoEnable"

# Manually start
Start-ScheduledTask -TaskName "eGPU-AutoEnable"

Enable Failures

If auto-enable fails:

1. Check logs for error details
2. Manually enable in Device Manager to verify hardware
3. Ensure no driver conflicts
4. Update graphics drivers

Compatibility

Supported

• ✅ Windows 10 (1909+)
• ✅ Windows 11 (all versions)
• ✅ PowerShell 7.0+
• ✅ All Thunderbolt 3/4 eGPU enclosures
• ✅ NVIDIA & AMD GPUs
• ✅ Multiple display configurations

Requirements

• Administrator privileges (for device enable)
• Thunderbolt/USB-C with eGPU support
• PowerShell 7.0+ installed

Roadmap

• Support for multiple eGPUs simultaneously
• GUI configuration utility
• Custom power plan profiles per-eGPU
• Integration with NVIDIA/AMD control panels
• Telemetry dashboard (opt-in, privacy-focused)

Why This Matters

This tool was born from frustration. After countless long study sessions at university, I’d pack up my laptop, safe-remove the eGPU, head home… and then have to manually enable it every single time.

That’s not how it should work. Technology should adapt to us, not the other way around.

Saved time: 30 seconds × 3 times/day × 365 days = 9+ hours per year reclaimed from Device Manager hell.

Made with ❤️ for the eGPU community

If this tool saved you time, star it on GitHub! ⭐