A lightweight desktop application to manage Windows Subsystem for Linux (WSL) distributions.
Built with Tauri (Rust) and React (TypeScript).
Developed by Octasoft Ltd | Website
- 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
.wslconfigandwsl.conffrom 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.
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.
Download the latest installer from the Releases page.
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- 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
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
| 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 |
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)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
"WSL UI" and "Octasoft" are trademarks of Octasoft Ltd. See the TRADEMARK file for usage requirements for forks and derivative works.