WSL Commander v1.2.0

WSL Commander v1.2.0

Release date: 2026-08-27

This release brings WSL container management to WSL Commander. Containers now live
alongside your distributions on a unified Distributions page, powered by Microsoft's
wslc.exe container CLI that ships with WSL 2.9.3+.

---

Highlights

• Manage WSL containers and distributions together on a single, filterable Distributions page
• Rich, expandable container details with ports, volumes, environment, network, and usage
• Container lifecycle actions: start, stop, remove, and a logs viewer
• Graceful degradation on older WSL versions — the app still manages distributions normally

Changes

WSL container support

• Added a unified Distributions page with an All / Distros Only / Containers Only filter.
• Added container cards showing name, image, status, and a published-port summary.
• Added expandable container details covering ID, ports, volumes, environment (with
  masked secrets), network, restart policy, created time, and best-effort CPU/memory usage.
• Added container actions: Start, Stop, Remove, and a Logs viewer.
• Added a session-mismatch hint: when no containers are visible but another wslc session
  with a different elevation exists, an info bar suggests running WSL Commander as
  administrator (or as a normal user) so the containers become visible.

Compatibility & polish

• Added graceful degradation: the container filter is hidden with an informational note
  when a compatible WSL version (2.9.3+) isn't installed.
• Added an explicit Windows AppUserModelID so the app shows its own icon in the taskbar
  when run from source.

Requirements

• Container management requires WSL 2.9.3 or higher (currently a pre-release). Enable it
  with wsl --update --pre-release and confirm with wsl --version. Without it, WSL
  Commander runs normally and simply hides the container filter.

WSL Commander v1.1.0

WSL Commander v1.1.0

Release date: 2026-06-04

This release builds on v1.0.1 with a strong focus on USB device management and a cleaner distro install experience.

---

Highlights

• Improved USB device management with color-coded states and sortable device lists
• Added USB auto-attach support, including support for unplugged devices
• Added automatic UAC elevation for USB bind and unbind operations
• Streamlined distro installation with an inline Install button in the catalogue

Changes

USB sharing improvements

• Added color-coded USB device states to make attached, shared, and unavailable devices easier to distinguish at a glance.
• Added sorting support to the USB device table.
• Added an Auto-Attach action so supported USB devices can reconnect to WSL automatically.
• Added optional support for auto-attach when a device is currently unplugged.
• Improved lifecycle handling so auto-attach workers are stopped during detach and page cleanup.
• Added automatic UAC elevation for usbipd bind and unbind commands when administrator rights are required.

Install experience

• Moved the distro install action onto the selected catalogue card with an inline Install button.
• Simplified the install flow by removing the separate install action row.

Maintenance

• Removed unused imports and performed minor internal cleanup.
• Updated USB page screenshot to reflect the new color-coded states and UI improvements.

v1.0.1

WSL Commander v1.0.1

✨ New Features

• Alma Linux logo — Added distribution logo for Alma Linux
• Unbind USB button — Added unbind button and UnbindUsbWorker for detaching USB devices

🐛 Bug Fixes

• No distros installed — App now correctly handles the case when no WSL distributions are installed
• Window centering — App now starts at the center of the screen
• Application icon — Switched to .ico format to fix missing icon on some screen resolutions
• USB device selection — Restored USB device selection state after bind/refresh
• USB detach refresh — Added delay after USB detach to allow device re-enumeration before refreshing the list
• Auto-refresh on terminal launch — Distro status now auto-refreshes after a terminal is launched
• Auto-refresh after install/import — Distributions page now automatically refreshes after a new distro is installed or imported

v1.0.0

🚀 WSL Commander v1.0.0 — Initial Release

WSL Commander is a modern graphical interface for managing Windows Subsystem for Linux (WSL) distributions, built with Python and PyQt6 + Fluent Design.

---

Distro Management

• View all installed WSL distributions at a glance
• Start, stop, and restart distributions
• Set a default distribution
• Import and export distributions (backup & restore)
• Unregister (remove) distributions safely

USB Sharing

• Share USB devices with WSL distributions using usbipd
• Attach and detach USB devices with a single click
• Requires usbipd-win installed on the host

Theming & UI

• Auto, Light, and Dark theme support via Fluent Design
• High-DPI display support
• Modern, clean interface