From ba19ad88c14f43237a5e349c98e6e362a9d95748 Mon Sep 17 00:00:00 2001
From: wisemoth <wisemoth>
Date: Sat, 17 May 2025 10:28:32 +0100
Subject: [PATCH] Add documentation for Windows users to run Linux releases

---
 doc/WINDOWS_WSL.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 doc/WINDOWS_WSL.md

diff --git a/doc/WINDOWS_WSL.md b/doc/WINDOWS_WSL.md
new file mode 100644
index 0000000..a9c3a01
--- /dev/null
+++ b/doc/WINDOWS_WSL.md
@@ -0,0 +1,19 @@
+# YTuner in Windows Subsystem for Linux (WSL)
+
+Windows users can easily run the Linux releases in WSL 1, following the process below (version 1 of WSL simplifies access to the Windows LAN interface from the Linux environment)
+
+At least YTuner 1.2.6 is known to run in the following configuration:
+```
+> wsl -l -v
+  NAME            STATE           VERSION
+* Ubuntu-16.04    Running         1
+```
+
+1. [Install](https://learn.microsoft.com/en-us/windows/wsl/install) WSL, following guidance to use WSL v1
+2. Enter WSL with `bash`
+3. Fetch a pre-built YTuner for Linux that matches the required architecture; eg\
+`wget https://github.com/coffeegreg/YTuner/releases/download/1.2.6/ytuner-1.2.6-x86_64-linux.zip`
+4. Inflate to a chosen folder:\
+`unzip ytuner-1.2.6-x86_64-linux.zip  -d ytuner`
+5. Edit `IPAddress` in `ytuner.ini` to match the address of the Windows interface that is accessible from the AVR
+6. Follow other instructions for Linux in the [README](https://github.com/coffeegreg/YTuner/blob/master/README.md) to launch `YTuner`