██╗    ██╗██╗███╗   ██╗██████╗  █████╗ ████████╗██╗  ██╗
██║    ██║██║████╗  ██║██╔══██╗██╔══██╗╚══██╔══╝██║  ██║
██║ █╗ ██║██║██╔██╗ ██║██████╔╝███████║   ██║   ███████║
██║███╗██║██║██║╚██╗██║██╔═══╝ ██╔══██║   ██║   ██╔══██║
╚███╔███╔╝██║██║ ╚████║██║     ██║  ██║   ██║   ██║  ██║
 ╚══╝╚══╝ ╚═╝╚═╝  ╚═══╝╚═╝     ╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═╝
    

WinPATH Manager

A mouse-enabled terminal UI for managing Windows PATH environment variables. Click it. Type it. Either way, it just works.

Python 3.10+ Windows 10 / 11 Textual TUI
Get Started View on GitHub

See It in Action

WinPath Manager — USER PATH (20 entries)
── View ── #  Path                                     Status
Load USER PATH 1  C:\Windows\system32                      OK
Load SYSTEM PATH 2  C:\Windows                               OK
Refresh Display 3  C:\Python314\Scripts                     OK
Toggle Expanded 4  C:\Windows\system32                      DUPLICATE 5  C:\Old\SDK\bin                           MISSING
── Edit ── 6  C:\Users\dev\.cargo\bin                  OK
Remove Duplicates 7  C:\Program Files\nodejs                  OK
Remove Invalid 8  C:\Go\bin                                OK
Move a PathAdd a Path           │──────────────────────────────────────────────
Remove Selected      │  USER PATH · 20 entries · all paths valid
                     │
── Save ──Save to Registryq Quit · u USER · y SYSTEM · ^S Save
Backup to FileRestore from File    │
                     │
Exit

Features

🖱️

Mouse + Keyboard

Click sidebar buttons or use keyboard shortcuts. Full TUI built with Textual — works in any Windows terminal.

🔍

Duplicate Detection

Instantly highlights duplicate PATH entries in yellow. Remove them all with a single click.

Invalid Path Detection

Flags paths that don't exist on disk in red. Clean them up in one action.

↕️

Reorder Entries

Move paths to any position with source/destination prompts. Priority order matters for PATH resolution.

💾

Auto-Backup on Save

Every registry write creates a timestamped backup file first. Restore from backup at any time.

🛡️

UAC Elevation

SYSTEM PATH edits automatically request admin privileges via UAC. No need to run as admin upfront.

📡

Environment Broadcast

Sends WM_SETTINGCHANGE after saving so running apps pick up changes without a reboot.

🔎

Expanded View

Toggle to see %VAR% references resolved to their actual values side-by-side.

📋

Backup & Restore

Export PATH entries to a plain text file. Restore from any backup with a single action.

Keyboard Shortcuts

KeyAction
uLoad USER PATH
yLoad SYSTEM PATH
Ctrl+SSave to registry
eToggle expanded view
dRemove duplicates
iRemove invalid paths
qQuit

Quick Start

# Clone and set up
$ git clone https://github.com/krypdoh/winpath.git
$ cd winpath

# Create venv and install
$ python -m venv .venv
$ .venv\Scripts\activate
$ pip install -r requirements.txt

# Run it
$ python winpath.py