wsl_open_browser

Crates.iowsl_open_browser
lib.rswsl_open_browser
version2021.823.702
sourcesrc
created_at2021-08-22 08:49:53.963762
updated_at2021-08-23 07:04:15.5108
descriptionInside WSL2 opens a html file in the browser that is in Win10. The local file path is transformed between Linux and Win10 notation.
homepage
repositoryhttps://github.com/LucianoBestia/wsl_open_browser
max_upload_size
id440590
size16,941
bestia.dev (bestia-dev)

documentation

README

wsl_open_browser

Inside WSL2 opens a html file in the browser that is in Win10. The local file path is transformed between Linux and Win10 notation.
repository; version: 2021.823.702 date: 2021-08-23 authors: Luciano Bestia

Lines in Rust code Lines in Doc comments Lines in Comments Lines in examples Lines in tests

crates.io Documentation crev reviews Lib.rs Licence Rust

Try it

Install it from crates.io and add 2 symbolic links and one env variable:

cargo install wsl_open_browser
sudo ln -sf "/mnt/c/Program Files/Mozilla Firefox/firefox.exe" /usr/bin/browser_in_win
export BROWSER='/usr/bin/wsl_open_browser'
# I like to use the short command `www` to open a browser
ln -sf "/usr/bin/wsl_open_browser" www

# go to a directory that contains a subdirectory with index.html
cd ~/rustprojects/wsl_open_browser
www docs/index.html
# or
www docs
# or go inside the directory that contains index.html
cd docs
www .
# or simply
www
# if you want to open an URL
www rust-lang.org

Congratulations! You have just opened a windows browser from WSL2.

Motivation

Inside WSL2 I want to open a html file in the browser. But the browser is in Win10.
This is useful in Rust for the documentation:

cargo doc --open

or for simply open a file in a browser from bash:

www index.html

Open URL in Win10 Browser (first attempt)

I prepared a symbolic link to the firefox exe.

ln -s "/mnt/c/Program Files/Mozilla Firefox/firefox.exe" /usr/bin/browser_in_win
# now I can open a page like this
browser_in_win http://github.com
# I want to open it with xdg-open
# xdg-open is the "Open any file" for linux
export BROWSER='/usr/bin/browser_in_win'
# now I can use
xdg-open http://rust-lang.org

This works great for URL, but it does not work for local files, because Linux and Windows see the same file with different paths.
The command ln -sf is permanent and persistent. It makes a file that stays there forever.
But export BROWSER= is NOT persistent. You need to add this command to ~/.bashrc that runs it on every start of terminal.

Open local file in Win10 Browser

For example:
Linux: /home/luciano/index.html
Win10: \\wsl$\Debian\home\luciano\index.html
OR:
Linux: /mnt/c/Users/Luciano/Downloads\index.html
Win10: c:\Users\Luciano\Downloads\index.html

I need a way to transform the path prior to call the browser.
Let's make a Rust CLI for that.

Development

This is a simple binary. For good habit I separated the lib from the bin.
Use cargo auto to run automation tasks: build, release, doc, copy_to_usr_bin,....
After cargo auto copy_to_usr_bin we can now open the browser like this:

wsl_open_browser http://rust-lang.org
wsl_open_browser /home/luciano/index.html
wsl_open_browser /mnt/c/Users/Luciano/Downloads/index.html
wsl_open_browser docs/index.html

Open with xdg-open

But I want to use xdg-open.
xdg-open is the "Open any file" for linux.
For that I need to set the environment variable BROWSER.
To make it persistent, copy this line to ~/.bashrc.

export BROWSER='/usr/bin/wsl_open_browser'

Finally we can open the browser like this:

xdg-open http://rust-lang.org
xdg-open /home/luciano/index.html
xdg-open /mnt/c/Users/Luciano/Downloads/index.html

and the Rust documentation works fine:

cargo doc --open

simply: www docs or www .

I am still not satisfied.
I want to open the browser from Debian bash terminal with this simple syntax:

www docs
www .
www rust-lang.org

I will make another alias:

ln -sf "/usr/bin/wsl_open_browser" www

The command ln -sf is permanent and persistent. It makes a file that stays there forever.

Commit count: 30

cargo fmt