WSL UI

A lightweight desktop application to manage Windows Subsystem for Linux (WSL) distributions.

Built with Tauri (Rust) and React (TypeScript).

Developed by Octasoft Ltd | Website

Features

• Dashboard - View all distributions with real-time status, CPU, memory, and disk usage
• Quick Actions - Terminal, file explorer, IDE, restart, export, clone
• Install from Anywhere - Microsoft Store, Docker/Podman images, LXC catalog, custom URLs
• Backup & Restore - Export, import, and clone distributions
• Custom Actions - Define reusable commands with variable substitution
• WSL Settings - Edit .wslconfig and wsl.conf from a visual interface
• 17 Themes - Dark, light, and custom themes with live preview
• System Tray - Minimize to tray for quick access
• Disk Mounting - Mount VHD files and physical disks into WSL

See the User Guide for detailed features and screenshots.

Language Support

WSL UI is available in multiple languages. The app automatically detects your system language, or you can switch manually from the settings.

Don't see your language? Open an issue to request it.

Installation

From Microsoft Store

From Releases

Download the latest installer from the Releases page.

From Source

Prerequisites: Node.js v18+, Rust, Windows (not WSL)

git clone https://github.com/octasoft-ltd/wsl-ui.git
cd wsl-ui
npm install
npm run tauri dev

Documentation

• User Guide - Features, screenshots, and how-to guides
• Troubleshooting - Solutions to common issues
• Privacy Policy - How we handle your data (we don't collect any)
• Contributing - How to contribute to the project

Development

Project Structure

wsl-ui/
├── src/                    # React frontend
│   ├── components/         # UI components
│   ├── services/           # Tauri API wrappers
│   ├── store/              # Zustand state management
│   └── test/e2e/           # WebDriverIO E2E tests
├── src-tauri/              # Rust backend
│   └── src/                # Tauri commands and WSL logic
└── crates/wsl-core/        # Shared WSL parsing library

Tech Stack

Scripts

npm run tauri dev       # Development mode
npm run tauri build     # Production build
npm run test:run        # Unit tests
npm run test:e2e:dev    # E2E tests (mock mode)

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0) - see the LICENSE file for details.

• Free and open source software
• Copyleft — derivative works must also be open source under GPL-3.0
• Source code must be provided with any distribution

Trademark Notice

"WSL UI" and "Octasoft" are trademarks of Octasoft Ltd. See the TRADEMARK file for usage requirements for forks and derivative works.

Links

• Website
• Report Issues
• Security Policy
• Changelog
• Credits