Need help with wsldl?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

yuk7
792 Stars 71 Forks MIT License 354 Commits 4 Opened issues

Description

Advanced WSL launcher / installer. (Win10 FCU x64/arm64 or later.)

Services available

!
?

Need anything else?

Contributors list

# 26,349
windows...
Arch Li...
uwp-app...
Electro...
278 commits
# 27,309
.NET
F#
Less
scss
7 commits
# 139,874
bash-on...
monitor...
vulkan
D
7 commits
# 193,780
Groovy
Atom
windows...
Arch Li...
3 commits
# 253,003
windows...
windows...
C
Linux
3 commits
# 157,529
windows...
windows...
C
Linux
2 commits
# 429,886
HTML
reddit
Android
C
2 commits
# 478,698
C++
Shell
C
windows...
1 commit
# 476,984
scoop
scoop-b...
Haxe
C
1 commit
# 367,934
Scala
Apache ...
jvm
C
1 commit
# 299,063
GitHub
usersty...
kuberne...
k8s
1 commit
# 537,004
C
windows...
Linux
windows...
1 commit
# 138,454
vk-api
vkontak...
steam
Django
1 commit
# 304,044
mtproto
Telegra...
mtproxy
C
1 commit
# 9,593
Groovy
oracle
oracle-...
Docker
1 commit

wsldl

Advanced WSL Distribution Launcher / Installer

screenshot

GitHub Workflow Status AppVeyor Github All Releases PRs Welcome License

Detailed documentation is here

💻Requirements

  • Windows 10 1709 Fall Creators Update 64bit or later.
  • Windows Subsystem for Linux feature is enabled.

📦Install with Prebuilt Packages

You can see List on docs

Note: Exe filename is using to the instance name to register. If you rename it, you can register with a different name.

🔧Install with any rootfs

1. Download Launcher.exe

2. Rename it for distribution name to register.

(Ex:Rename to Arch.exe if you want to use "Arch" for the Instance name)

3. Put your rootfs.tar(.gz) in same directory as exe (Installation directory)

4. Run exe to install. This process may take a few minutes.

🔗Use as a Launcher for already installed distribution

1. Download Launcher.exe

2. Rename it for registerd instance name.

Please check the registered instance name of the distribution with

wslconfig /l
command. (Ex: If the instance name is "Ubuntu-20.04", rename
Launcher.exe
to
Ubuntu-20.04.exe
)

4. Run exe to Launch instance or configuration.

For details, please see the help. (

{InstanceName}.exe --help
)

Note: You can distribute your distribution including wsldl exe.

📝How-to-Use(for Installed Instance)

exe Usage

Usage :
    
      - Open a new shell with your default settings.

run <command line>
  - Run the given command line in that distro. Inherit current directory.

runp <command line windows path>
  - Run the path translated command line in that distro.

config [setting [value]]
  - `--default-user <user>`: Set the default user for this distro to <user>
  - `--default-uid <uid>`: Set the default user uid for this distro to <uid>
  - `--append-path <on>`: Switch of Append Windows PATH to $PATH
  - `--mount-drive <on>`: Switch of Mount drives
  - `--default-term <default>`: Set default terminal window

get [setting]
  - `--default-uid`: Get the default user uid in this distro
  - `--append-path`: Get on/off status of Append Windows PATH to $PATH
  - `--mount-drive`: Get on/off status of Mount drives
  - `--wsl-version`: Get WSL Version 1/2 for this distro
  - `--default-term`: Get Default Terminal for this distro launcher
  - `--lxguid`: Get WSL GUID key for this distro

backup [contents]
  - `--tgz`: Output backup.tar.gz to the current directory using tar command
  - `--reg`: Output settings registry file to the current directory

clean
  - Uninstall the distro.

help
  - Print this usage message.

Just Run exe

>{InstanceName}.exe
[[email protected] user]#

Run with command line

>{InstanceName}.exe run uname -r
4.4.0-43-Microsoft

Run with command line with path translation

>{InstanceName}.exe runp echo C:\Windows\System32\cmd.exe
/mnt/c/Windows/System32/cmd.exe

Change Default User(id command required)

>{InstanceName}.exe config --default-user user

>{InstanceName}.exe [[email protected] dir]$

Set "Windows Terminal" as default terminal

>{InstanceName}.exe config --default-term wt

How to uninstall instance

>{InstanceName}.exe clean

🛠How-to-Build

Please see DEVELOPERS.md

📄License

MIT

Copyright (c) 2017-2020 yuk7

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.