WSL UI Octasoft Ltd

developer-tools linux virtualization windows-subsystem-for-linux wsl wsl2

Use this command to install WSL UI:

winget install --id=OctasoftLtd.WSLUI -e

WSL UI is a lightweight desktop application for managing Windows Subsystem for Linux (WSL) distributions. It provides a graphical interface for common WSL operations including installing, removing, importing, exporting, and configuring distributions.

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.

Language	Native Name
English	English
Arabic	العربية
Chinese (Simplified)	简体中文
Chinese (Traditional)	繁體中文
French	Français
German	Deutsch
Hindi	हिन्दी
Japanese	日本語
Korean	한국어
Polish	Polski
Portuguese (Brazil)	Português (Brasil)
Russian	Русский
Spanish	Español
Turkish	Türkçe

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

Layer	Technology	Purpose
Desktop	Tauri 2.x	Native window, system access
Frontend	React 19 + Vite	UI components
Styling	Tailwind CSS	Utility-first CSS
Backend	Rust	WSL command execution
State	Zustand	State management

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.