# YoWSL

[YoWSL](https://yowsl.akaumiga.me/) 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)](https://msdn.microsoft.com/en-us/commandline/wsl/about).
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](https://bitbucket.org/ykomatsu/yowsl/downloads).
You will need to extract a `.zip` archive and put `yowsl.exe` in your paths.

### Building

If you have [the Rust toolchain](https://www.rustup.rs/), you can build YoWSL
with [Cargo](https://crates.io/):

```
> cargo install yowsl
```

## References

* [Windows Subsystem for Linux (Windows)](https://msdn.microsoft.com/en-us/library/windows/desktop/mt811415(v=vs.85).aspx)

## License

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