vdtree

A standalone CLI that acts like 'ls' for your Windows Virtual Desktops.

Python πŸ“„ MIT ⭐ …
Screenshot of vdtree

vdtree is a lightweight command-line utility for Windows 10/11. It translates undocumented internal Windows COM IDs to map out your Virtual Desktops, listing every open window, its exact X/Y coordinates, size, and whether it’s pinned across multiple workspaces. You can view the output as a clean table or export it as JSON.

I originally started building this as part of a much larger, overly complex C# window session manager. After hitting a wall with fragile Windows internal APIs that break on every OS update, I decided to embrace the Unix Philosophy: β€œDo one thing, and do it well.” I rewrote the core read-only mapping logic into a single-file Python script and packaged it using PyInstaller.

It is delightful because it requires absolutely zero setup. You just download the standalone .exe and run it. It’s the perfect little tool for hunting down a window that got lost off-screen after unplugging a monitor, or for scripters who want to map their workspace topology!

Copilot says: AI-generated

Ever lost a sneaky window on a virtual desktop? This tool maps out all your Windows Virtual Desktops and open apps with a neat, readable CLI, making off-screen chaos a thing of the past!

Key features:

  • πŸ”₯ Standalone executable with zero setup fuss
  • ⚑ Converts cryptic desktop IDs into friendly numbers
  • 🎯 Detects pinned apps visible on all desktops
  • πŸ—ΊοΈ Tracks exact window positions and dimensions for easy rescue

This summary was generated by GitHub Copilot based on the project README.