简体中文

A simple, fast, and robust utility to open files, directories, and URLs from WSL in their default Windows applications.

• Fast & Lightweight: Starts instantly as a compiled native binary with no shell overhead.
• Safe & Robust: Correctly handles complex paths with spaces and special characters. Uses a sanitized command execution method to prevent shell injection vulnerabilities.
• Simple & Focused: Does one thing and does it well. The command-line interface is minimal and intuitive.
• Works Out-of-the-Box: Requires no extra libraries or runtimes to install. It works on any modern WSL2 environment by leveraging its built-in tools.

The recommended way is to download the latest binary from the Releases page.

# Replace vX.Y.Z with the latest version number, for example: v1.0.0
wget https://github.com/jbwfu/wsl-open/releases/download/vX.Y.Z/wsl-open_linux_amd64.tar.gz
tar -xvf wsl-open_linux_amd64.tar.gz
sudo mv wsl-open /usr/local/bin/

go install github.com/jbwfu/wsl-open@latest

git clone https://github.com/jbwfu/wsl-open.git
cd wsl-open
go build
sudo mv wsl-open /usr/local/bin/

Provide a path to a file, a directory, or a URL as an argument.

# Open a file in its default Windows application
wsl-open "My Documents/report.docx"

# Open the current directory in Windows File Explorer
wsl-open .

# Open a URL in the default Windows browser
wsl-open https://github.com

Use the -x flag to see what command would be executed without running it. For more details, run wsl-open --help.

For minimal WSL environments that may not include xdg-open, you can link wsl-open to act as a system-wide default. This allows tools that call xdg-open (like git browse) to work seamlessly.

First, check if xdg-open is already installed:

command -v xdg-open

If the command above returns no output, you can create a symbolic link:

# This finds where wsl-open is and links it to /usr/local/bin/xdg-open
sudo ln -s "$(command -v wsl-open)" /usr/local/bin/xdg-open

• Full xdg-open integration.
• Native path translation (remove wslpath dependency).

Contributions are welcome! Please feel free to open an issue or submit a pull request.

This project is licensed under the MIT License.