WSLUSC(1)

📦
version 4.1.4 · 2 versions
, in alpine 3.24

💅 WSLUSC(1) — like, the shortcut-maker era ✨

okay so welcome to wslusc, bestie — a whole component of the WSL Utilities User Manual family 🫶 (yes that's the manual she lives in, and yes she's iconic for it).

✨ NAME ✨

wslusc — a Component of WSL Utilities. that's the whole name, no notes 💅

🌸 SYNOPSIS 🌸

wslusc [-IsgN] [-d SHORTCUT_FILE] [-e PATH] [-n NAME] [-i FILE] COMMAND

wslusc [-hv]

🦋 DESCRIPTION 🦋

so basically this is a WSL shortcut creator — its whole job is making a shortcut on your Windows Desktop. that's it, that's the gig 👑 and honestly? she ate.

💖 OPTIONS 💖

  • -h, --help — prints a simple help. tiny little assist, we love her 🌈
  • -v, --version — prints the current version. vibe check on which build you're running ⭐
  • -d, --shortcut-debug SHORTCUT_FILE — debugs the generated shortcut file. for when your shortcut is acting up and you need to snoop 🔍
  • -g, --gui — makes a shortcut that links to a GUI application. windows and windows and windows, but make it graphical 🎀
  • -N, --native — makes a shortcut that uses the system builtin wslg.exe to launch the GUI application. native mode, no middleman, main character energy 💀
  • -i, --icon — adds an icon to the Windows Shortcut. supports .ico/.png/.svg. give your shortcut a little face 🧚
  • -s, --smart-icon — turns on smart icon detection. this feature requires wslpy to be installed, so no wslpy = no magic, periodt 🙈
  • -n, --name — adds a different name other than the command name. rename your baby 🍓
  • -e, --env — adds a custom environment to your command. like, if you want HiDPI support for a GTK app, add export GDK_SCALE=2; in your command, like this: wslusc ... -e "export GDK_SCALE=2;" ... ✨
  • -I, --interactive — interactive mode. she asks questions, you answer, it's a whole conversation 💬

🌟 CONFIGURATION 🌟

  • WSLUSC_GUITYPE — the default GUI type. the default type is 'legacy'. use 'native' for Native GUI generation (wslg.exe) by default. highkey the easiest way to switch vibes 🔥
  • WSLUSC_SMART_ICON_DETECTION — Smart Icon Detection. requires wslpy (requires Python 3.5). default is false. off by default, bestie, you gotta opt in 🎀
  • WSLUSC_BASE_CONVERTER_ENGINE — the converter engine. you can choose either 'ffmpeg' or 'imagemagick'. by default it is 'imagemagick'. pick your fighter, both slay 💅

💜 AUTHOR 💜

Created by Patrick Wu <me@patrickwu.space>. founder behavior, honestly 👑

🫶 REPORTING BUGS 🫶

Report bugs to <https://github.com/wslutilities/wslu/issues>; for Ubuntu specific/related bugs, report to <https://bugs.launchpad.net/ubuntu/+source/wslu>. we will read them, fr fr 😭

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 her 💀

🌈 SEE ALSO 🌈

  • wslu(7) — go read the big sibling, iykyk 💖

and that's the page!! this was version 4.1.4-1, dated 2026-05-01, in the WSL Utilities User Manual — mwah, go make some shortcuts bestie 🦋💅✨

📦 where this page comes from