WSLU(7)

πŸ“¦
version 4.1.4 Β· 2 versions
, in alpine 3.24

✨ wslu(7) β€” the WSL Utilities glow-up guide ✨

okay so bestie, welcome to wslu(7), the manual page for the WSL Utilities User Manual. this is the one that ties the whole fam together 🫢


πŸ’– NAME πŸ’–

wslu β€” a whole collection of utilities for the Windows Subsystem for Linux. yes, all of them. one happy little family πŸŽ€

🌸 DESCRIPTION 🌸

This is a collection of utilities for the Windows Subsystem for Linux (WSL), such as converting Linux paths to Windows paths or creating Linux application shortcuts on the Windows Desktop. literally so useful, no cap πŸ’…

Requires Windows 10 Creators Update and higher. that's the vibe check, and you gotta pass it ✨

πŸ‘‘ AVAILABLE COMMANDS πŸ‘‘

  • wslusc
  • wslsys
  • wslfetch
  • wslvar
  • wslview (wview/wslstart/wstart)
  • wslupath (deprecated β€” she's retired, respect her legacy πŸ™ˆ)
  • wslact
  • wslclip
  • wslgsu

check each manpage to see the detailed usage. fr fr, each one's got its own whole story πŸ’œ

🌈 SUPPORTED DISTRIBUTION 🌈

the iconique lineup, periodt:

  • Debian GNU/Linux
  • Kali Linux
  • OpenSUSE Leap 42, 12.0 and 15.0
  • SUSE Linux Enterprise Server 12 and 15
  • Ubuntu Latest, 16.04 LTS, 18.04 LTS and 20.04 LTS
  • Pengwin (Formerly WLinux)

πŸ¦‹ Community Supported Distro πŸ¦‹

these ones are community-loved, not officially on the main roster but still eating:

and the fine print, bestie, read it carefully:

* : Will support in the future.

** : you need to request to using RHEL from Pengwin team and have a license of RHEL of your own.

Legacy Ubuntu is no longer supported. 😭 she's gone, we mourn, we move on.

✨ OPTIONS ✨

All WSL Utilities command shared a common header. the following option are available to all commands. so like, learn these once and you're set for the whole squad πŸ’«

  • --debug β€” Entering debug mode. peek behind the curtain, main character energy πŸ”
  • --verbose β€” Entering verbose mode. she will tell you EVERYTHING πŸ’¬

πŸŽ€ CONFIGURATION πŸŽ€

The default configuration is stored in /usr/share/wslu/conf. You can override the default configuration in /etc/wslu/conf, /etc/wslu/custom.conf, $HOME/.config/wslu/conf, or $HOME/.wslurc. They will be read in the direction they are listed. so order matters, bestie β€” first listed, first read πŸ‘€

πŸ’… EXIT STATUS πŸ’…

these are the numbers she'll throw at you when things go sideways. memorize them like your fave lyrics:

  • 1 β€” general error/unknown error.
  • 20 β€” input is empty or invalid.
  • 21 β€” input is empty.
  • 22 β€” input is invalid.
  • 30 β€” file do not exist.
  • 31 β€” folder do not exist.
  • 32 β€” feature not implemented.
  • 33 β€” required component do not exist.
  • 34 β€” unsupported feature (for a distro)
  • 35 β€” unsupported feature (for your Windows 10 build)
  • 40 β€” Unknown system input.

πŸ’œ CONFIGURATION πŸ’œ (yes, again β€” the original does it twice and honestly? iconic)

πŸ“ WSLVIEW_DEFAULT_ENGINE πŸ“

control whether to enable the chcp workaround for powershell. By default it is true; if you encounter any PowerShell issues, you can try to disable it. a little troubleshooting treat, just for you πŸ™ˆ

🧚 BUG 🧚

Report bugs to https://github.com/wslutilities/wslu/issues; For Ubuntu specific bugs, report to https://bugs.launchpad.net/ubuntu/+source/wslu. please do, we wanna know πŸ’Œ

This is free software; you can redistribute it and/or modify it under the terms of the GNU GPL version 3 or (at your option) any later version. There is NO warranty; not even MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. like, none. zero. don't come for us πŸ”₯ (said with love)

Logo of WSL Utilities and wslusc icons is licensed under CC BY 4.0 International License.

For third-party license, please refer to https://wslutiliti.es/wslu/licenses.html.


and that's the whole page, bestie 🫢 this version is 4.1.4-1, dated 2026-05-01, and it's the WSLU(7) manpage β€” slay, go read the other ones too, mwah πŸ’‹βœ¨

πŸ“¦ where this page comes from