WSL Graphics
WSL Graphics enables running Linux GUI applications and full desktop environments from Windows Subsystem for Linux (WSL) distributions — displayed directly inside OxideTerm via VNC.
Opening WSL Graphics
Section titled “Opening WSL Graphics”Open New Connection → WSL Graphics.
Selecting a Distribution
Section titled “Selecting a Distribution”OxideTerm auto-detects installed WSL distributions and lists them with their status:
- Running — distribution is running
- Stopped — distribution is not running
Select a distribution from the dropdown to proceed.
Prerequisites
Section titled “Prerequisites”Before first use, install the required packages inside your WSL distribution:
# VNC server + D-Bussudo apt install tigervnc-standalone-server dbus-x11 -y
# Desktop environment — choose one:sudo apt install xfce4 -y # XFCE (lightweight)sudo apt install ubuntu-desktop -y # GNOME (full Ubuntu)sudo apt install kde-plasma-desktop -y # KDE PlasmaFor single-app mode, also install Openbox (minimal window manager):
sudo apt install openbox -yDesktop Mode
Section titled “Desktop Mode”Desktop Mode starts a full desktop environment inside OxideTerm:
- Select your distribution
- Click Desktop Mode
- OxideTerm starts TigerVNC and your desktop environment
- The desktop renders in the tab, with keyboard and pointer input sent to the session
Use Fullscreen to expand the VNC view to fill the OxideTerm window.
App Mode
Section titled “App Mode”App Mode launches a single GUI application without a full desktop:
- Select your distribution
- Choose App Mode
- Enter the command (e.g.,
gedit /home/user/notes.txt,gimp,firefox) - Click Start App
Common app examples are listed as quick shortcuts.
VNC Session Management
Section titled “VNC Session Management”| Action | Button |
|---|---|
| Reconnect | Click Reconnect if the VNC connection drops |
| Stop | Terminate the VNC server and session |
| Fullscreen | Toggle fullscreen VNC view |
If the VNC server is not found, OxideTerm shows the install command. If D-Bus is missing, it shows the dbus-x11 install instruction.
WSLg Compatibility
Section titled “WSLg Compatibility”If your Windows 11 system has WSLg (WSL built-in GUI support), OxideTerm detects it and shows “Available”. WSLg provides native Wayland/X11 forwarding without requiring TigerVNC, but OxideTerm’s VNC mode offers a self-contained embedded view that works without WSLg.
Use Cases
Section titled “Use Cases”- Run Linux-native GUI tools (GIMP, Inkscape, LibreOffice) on Windows
- Develop with a full Linux desktop environment without a separate VM
- Test Linux GUI applications in different distributions side-by-side
- Run GUI-only apps (database GUIs, IDE plugins, X11 tools) from WSL