yowsl

Yet another Windows Subsystem for Linux tweaker


Keywords
cli, windows, wsl
License
Apache-2.0

Documentation

YoWSL

YoWSL is yet another Windows Subsystem for Linux tweaker.

The Windows 10 Fall Creators Update has a great feature called the Windows Subsystem for Linux (WSL). YoWSL enables you to register a WSL distro in an arbitrary folder using your .tar.gz archive.

This project is in a very early stage of development.

Features

  • Register a WSL distro from your .tar.gz archive
  • Unregister a WSL distro
  • Get a configuration of a registered WSL distro
  • Set a configuration of a registered WSL distro
  • Launch a registered WSL distro

Prerequisites

  • The Windows 10 Fall Creators Update
  • The Windows Subsystem for Linux optional feature. You can install it in PowerShell as Administrator:
> Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
  • A .tar.gz archive that contains all files using a WSL distro. If you installed some WSL distro from the Microsoft Store, you may find some install.tar.gz in C:\Program Files\WindowsApps

Installation

Pre-built binaries

You can download pre-built binaries from the downloads page. You will need to extract a .zip archive and put yowsl.exe in your paths.

Building

If you have the Rust toolchain, you can build YoWSL with Cargo:

> cargo install yowsl

References

License

YoWSL is distributed under the terms of the Apache License, Version 2.0. See LICENSE-APACHE-2-0 for details.