From d1a86e89f3d8ed8c6062d2197ca884a833422a1a Mon Sep 17 00:00:00 2001
From: Sean Fitzgibbon <seanf@fmrib.ox.ac.uk>
Date: Wed, 19 Jan 2022 09:43:53 +0000
Subject: [PATCH] added WSL instructions to readme

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index 34f6b68..9d313ea 100644
--- a/README.md
+++ b/README.md
@@ -37,6 +37,22 @@ A page should open in your web browser - to access the practicals, navigate
 into one of the `getting_started`, `advanced_programming`, or `applications`
 directories, and click on the `.ipynb` file you are interested in.
 
+> **Windows Subsystem for Linux (WSL)** users - if the browser does not open automatically try:
+>
+> Start `jupyter notebook` with the `--no-browser` option and then copy & paste the URL in the terminal to your browser:
+>   ```
+>   fslpython -m notebook --no-browser
+>   ``` 
+>
+> OR
+>
+> Find the path to your browser and point `notebook` to it:
+> ```
+> export BROWSER=/mnt/c/path/to/browser.exe
+> fslpython -m notebook --NotebookApp.use_redirect_file=False
+> ```
+>
+
 Some practical sub-directories will also contain a `README.md` file with
 additional information specific to the practical. Make sure you read this as
 well **before running the notebooks**.
-- 
GitLab