From 1ff95ca456557253db846524bffb920146db68a9 Mon Sep 17 00:00:00 2001
From: Leon van Kammen <leonvankammen@gmail.com>
Date: Thu, 20 Aug 2026 10:20:23 +0200
Subject: [PATCH] =?UTF-8?q?=F0=9F=94=A7=20master:=20work=20in=20progress?=
 =?UTF-8?q?=20[might=20break]?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

diff --git a/README.md b/README.md
index f903896..78c3476 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,8 @@ An open, seamless XR web built from simple URLs and directories, without gatekee
     <img src="screenshot.jpg"/>
 </a>
 
+## <a href="https://xrforge.isvery.ninja">Try here</a>
+
 * turn everyday directories into 3D portals.
 * seamlessly "surf" interconnected spatial webs on XR headsets
 * transforms local/remote filesystems into interconnected 3D spaces. 
@@ -45,6 +47,8 @@ An open, seamless XR web built from simple URLs and directories, without gatekee
 
 ## Usage / Radical Opensource
 
+Download [xrforge.com](releases) and open your windows/mac/linux terminal:
+
 ```bash 
 $ ./xrforge.com 
 Usage: ./xrforge.com <cmd> [opts]
@@ -57,6 +61,13 @@ Usage: ./xrforge.com <cmd> [opts]
   ./xrforge.com test         run testsuite (selftest)
 ```
 
+> NOTE: mac/linux-users need to do an additional `chmod +x xrforge.com`
+
+Profit! now run `xrforge.com admin` and XRForge will be launched in a webbrowser
+
+## Example content
+
+You can override the default content (embedded in the executable).
 Extract and run example 3D content in your browser:
 
 ```bash
@@ -65,6 +76,8 @@ $ ./xrforge.com server              # run as server
 opening your browser at https://localhost:8080
 ```
 
+> just look around in `myverse` and get a hunch of how directories + sidecarfiles are used to manage content.
+
 ## Radical opensource
 
 ```