====== Windows Subsystem for Linux (WSL) ======

I'll grudgingly admit that Windows Subsytem for Linux isn't bad like I thought it would be. That said, there are several things you might want to do to make it more livable.

===== Enabling WSL =====

First, to enable WSL at all ([[https://docs.microsoft.com/en-us/windows/wsl/install-win10|from here]]), in adminstrator powershell:
<code>

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

</code>

Then, it still being Windows, you have to restart.

===== Installing distro =====

Windows Store is a garbage zone. Here's the spell for skipping that part ([[https://docs.microsoft.com/en-us/windows/wsl/install-manual|from here]]). Just download this URL and double click what you get:

[[https://aka.ms/wsl-ubuntu-1804|https://aka.ms/wsl-ubuntu-1804]]

[[https://aka.ms/wslubuntu2004|https://aka.ms/wslubuntu2004]]

[[https://aka.ms/wslubuntu2204|https://aka.ms/wslubuntu2204]]

Other URLs exist for other distros; you're on your own for that.

===== Making it Launchy-launchable =====

The distro will be installed as an "app", which is Windows 10 speak for "dumbed down program that's treated in special ways that break normal workflows". If you have classic Start and Launchy, to make it work with Launchy:

  * Make a shortcut of the "app", then put the shortcut into the classic start menu programs list.

===== Update plus basic packages =====

The default package set is actually not bad. But this will update and install what's missing:
<code>

sudo apt update
sudo apt dist-upgrade
sudo apt install lynx links binutils zip unzip gdb build-essential dos2unix

</code>

Bigger list:

<code>
sudo apt install at bc bzip2 default-jdk dos2unix fdisk ffmpeg build-essential gdb hashdeep valgrind lynx links wget curl ltrace strace manpages-dev mdadm nasm net-tools netcat nmap pv spim zip unzip whois x11-apps

</code>

===== Symlinks =====

To get to places easily:

<code>
ln -s /mnt/c/Users/$USER ~

</code>

===== "Open Linux Shell Here" context menu =====

It turns out there already is one by default, but it only shows if you //shift//  right click. To make it always visible ([[https://winaero.com/blog/make-open-linux-shell-always-visible/|per here]]):

  * Download and run "[[https://winaero.com/blog/execti-run-programs-trustedinstaller/|ExecTI]]" to allow you to run regedit as TrustedInstaller (more privileges than admin)
  * Run regedit using the tool
  * In ''HKEY_CLASSES_ROOT\Directory\shell\WSL'', delete the key ''Extended''

===== Run explorer from this directory in bash =====

I'm used to saying ''start .''  to open an explorer in this directory. Using [[https://stackoverflow.com/questions/44245721/launching-explorer-from-wsl|this recipe]], you can add the following to ~/.bashrc to restore this functionality:
<code>

alias start="powershell.exe /c start"

</code>

===== Keyboard scrolling =====

By default, there's no keyboard shortcut to scroll the Windows terminal. Per [[https://superuser.com/questions/1408859/windows-subsystem-linux-terminal-scrolling-using-keyboard|here]], a quick duct tape solution is to use the following script in [[https://www.autohotkey.com/|AutoHotKey]]:
<code>

#IfWinActive ahk_class ConsoleWindowClass

+PgUp::
Send {WheelUp}
Return

+PgDn::
Send {WheelDown}
Return

#IfWinActive

</code>

===== Ensure Windows drives are writable =====

I just upgraded to Ubuntu 22.04 WSL, and found that some IO requests to /mnt/c were getting permission denied. Upon investigating, I found that the old WSL (which worked) had this output for mount:

<code>
C:\ on /mnt/c type drvfs (rw,noatime,uid=1000,gid=1000,case=off)

</code>

And the new one had:

<code>
C:\ on /mnt/c type drvfs (rw,noatime,uid=0,gid=0,case=off)

</code>

The fix is to set UID for the WSL mounts. This can be done by editing /etc/wsl.conf and adding:

<code>
[automount]
options = "uid=1000,gid=1000"

</code>

===== Script to mount *all* drives =====

By default, WSL just mounts physical drives around at boot. This script mounts all drives Windows knows about to directories under /mnt:

<code>
for DRV in `wmic.exe logicaldisk get name | grep : | awk '{print tolower($1)}'` ; do
    MNT=/mnt/${DRV::1}
    if mount | grep -q $MNT ; then
        echo $MNT already mounted
    else
        sudo mkdir -p $MNT
        sudo mount -t drvfs $DRV $MNT
    fi
done

</code>