🔧 master: work in progress [might break]

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
 
 ```