janusweb 1.7.0 → 1.7.1

package/.github/workflows/deploy.yml

@@ -0,0 +1,71 @@
+name: Build and Deploy to Pages
+
+on:
+  push:
+    # Monitor all branches so we can catch '#deploy' in commit messages
+    branches: ["**"]
+    tags:
+      - "v*.*.*"
+
+permissions: write-all
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  build-and-deploy:
+    # Run only on the master branch OR if the commit message contains '#deploy'
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20' # Change to your preferred version
+          cache: 'npm'       # Only works if you have a package-lock.json
+
+      - name: Install dependencies
+        # Only runs if package.json exists; avoids errors if it doesn't
+        run: |
+          if [ -f package.json ]; then
+            npm install
+          fi
+
+      - name: Run build script
+        run: |
+          chmod +x ./utils/build.sh
+          ./utils/build.sh
+          ./utils/release.binary.sh
+
+      - name: Create Release and Upload Assets
+        uses: softprops/action-gh-release@v3
+        with:
+          files: |
+            build/janusweb-*.tar.gz 
+            build/*/janusxr.com
+        #env: # only needed when creating a release in other repo
+        #  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Organize build artifacts
+        # Creates a clean 'www' folder and copies your build/sub/folders into it
+        run: |
+          mkdir -p www
+          cp -r build/*/* www/ 2>/dev/null || cp -r build/* www/
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: 'www'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+

package/Dockerfile

@@ -0,0 +1,14 @@
+FROM busybox:latest
+
+ARG JANUSXR_VERSION="1.5.56"
+
+WORKDIR /www
+COPY build/$JANUSXR_VERSION/janusxr.com .
+
+# assimilate the crossplatform binary into host architecture
+# otherwise docker will complain with 'Exec format error'
+RUN wget https://cosmo.zip/pub/cosmos/bin/assimilate && \
+    chmod +x assimilate && \
+    ./assimilate ./janusxr.com 
+
+CMD ["/www/janusxr.com"]

package/README.md

@@ -70,10 +70,188 @@ You can even put your mark-up onto sites like PasteBin or PiratePad.  Then just
 in our viewer by entering the URL into the navigation bar, and you can link directly to it, share 
 on social media, or embed our viewer directly into other webpages, blog posts, or articles.
 
-See also **Using a specific version of JanusWeb** below.
+### Single-binary server+client 
+
+Use our all-in-one **janusxr.com** multi-platform binary file:
+Run a **local-first** viewer locally on your desktop, raspberry pi (ARM64) or server.<br>
+
+| executable    | platforms |
+|-|-|
+| [janusxr.com](https://jbaicoianu.github.io/janusweb/janusxr.com) | <img src="https://i.imgur.com/v7cYVq1.png"/> |
+
+Run `janusxr.com` from anywhere, or put it into a folder with your 3D models or JanusXR rooms:
+
+```
+$ chmod +x janusxr.com          # only for non-windows users
+
+$ ./janusxr.com 
+I2026-01-19T15:41:10 (srvr) listen http://127.0.0.1:8080
+I2026-01-19T15:41:10 (srvr) listen http://192.168.1.168:8080
+Launching browser..
+```
+
+A browser will popup, and connect to `https://janusxr.org` via Janusweb.<br>
+Webbrowsers on the same network can access your node `https://192.168.1.168:8080`
+
+> Optionally, you can expose this janusweb-node to the internet. Check [here](https://redbean.dev) for more commandline options.
+</details>
+
+<details>
+<summary><b>Usecase:</b> 3D file viewer</summary>
+<br>
+Make sure `janusxr.com` is in a folder with your 3D models
+
+```
+$ ls 
+janusxr.com
+world1.glb
+world2.glb
+```
+
+Then make sure you rename `janusxr.com` to whatever you want to set as homepage:
+
+```
+$ mv janusxr.com world1.com
+$ ./world1.com 
+I2026-01-19T15:41:10 (srvr) listen http://127.0.0.1:8080
+I2026-01-19T15:41:10 (srvr) listen http://192.168.1.168:8080
+✅ detected /world1.glb (setting as spatial home)
+Launching browser..
+```
+</details>
+
+<details>
+<summary><b>Usecase:</b> all-in-one JanusXR runtime</summary>
+<br>
+You can bundle all your XR experiences with the server/client binary.<br>
+Just Make sure `janusxr.com` is in a folder with your JanusXR rooms or 3D models
+
+```
+$ ls 
+janusxr.com
+world1.html
+world2.html
+foo.glb
+```
+
+Then make sure you rename `janusxr.com` to whatever you want to set as homepage:
+
+```
+$ zip -r janusxr.com *              # add janus files to janusxr.com
+$ mv janusxr.com world1.com         # hint homepage room (world1.html) sidecarfile
+$ ./world1.com                       
+✅ detected /world1.html (setting as spatial home)
+I2026-01-19T15:41:10 (srvr) listen http://127.0.0.1:8080
+I2026-01-19T15:41:10 (srvr) listen http://192.168.1.168:8080
+Launching browser..
+```
+
+Profit! You can now send `world1.com` to a friend, and his browser will launch straight into world1.html 
+
+> NOTE: you can also point directly to a 3D model (`foo.com` would load `foo.glb`) or PDF-file etc!
+</details>
+
+
+<details>
+<summary><b>Usecase:</b> run as a docker</summary>
+<br>
+You can run our docker-image as following:
+
+```
+$ docker run -p 8080:8080 codeberg.org/coderofsalvation/janusxr:1.5.56
+```
+
+Profit! You can now point your browser to `http://localhost:8080` or configure your reverseproxy for SSL certs/domain etc.<br>
+Or optionally, serve your own XR experiences with it:
+
+```
+$ ls
+myworld1.xml myworld2.html myworld3.glb
+$ 
+$ docker run -p 8081:8080 -v $(pwd):/data codeberg.org/coderofsalvation/janusxr:1.5.56 /www/janusxr.com -D /data
+```
+
+Profit! You can now use URLs like `http://localhost:8080/#janus.url=https://localhost:8080/myworld1.xml` e.g.<br>
+Btw. you can build the docker image yourself too:
+
+```
+$ utils/release.binary.sh # build the janusxr.com binary 
+$ docker build -t janusxr.com .
+$ docker run -p 8080:8080 janusxr
+```
+
+</summary>
+</details>
+
+<details>
+<summary><b>Usecase:</b> serve all-in-one-binary in different docker/OCI container</summary>
+<br>
+
+Make sure to run you're in a folder with your JanusXR rooms or 3D models, and `janusxr.com`
+
+```
+$ ls 
+janusxr.com
+
+$ unzip janusxr.com          # extract the viewer files
+
+$ ls 
+janusxr.com
+world1.html
+world2.html
+foo.glb
+
+$ docker run -d -v ./:/www -p 8080:8080 --name janusweb busybox:latest /bin/httpd -f -h /www -p 8080
+e7928798379e872983b7ec9b89237ebc
+
+$ docker ps
+CONTAINER ID  IMAGE                             COMMAND               CREATED         STATUS         PORTS                   NAMES
+6711ed9739f3  docker.io/library/busybox:latest  /bin/httpd -f -h ...  16 seconds ago  Up 16 seconds  0.0.0.0:8080->8080/tcp  janusweb
+```
+
+Profit! You can now point your browser to `http://127.0.0.1:8080` or configure your reverseproxy for SSL certs/domain etc.
+
+</details>
+
+<details>
+<summary><b>Usecase:</b> deploy janusweb as github/gitlab/codeforge webpage</summary>
+
+<br>
+*TODO* provide action-files
+</details>
+
+<details>
+<summary><b>Usecase:</b> get the latest build files</summary>
+
+<br>
+Sometimes, developers just want the latest janusweb **files**.<br>
+Good news, the executable is also a zip-file.<br>
+
+```
+$ ls 
+janusxr.com
+$ unzip janusxr.com
+$ ls
+index.html
+janusweb.js
+(...)
+
+$ janusxr.com 
+I2026-01-19T15:41:10 (srvr) listen http://127.0.0.1:8080
+I2026-01-19T15:41:10 (srvr) listen http://192.168.1.168:8080
+Launching browser..
+
+( the webserver will prioritize the unzipped files )
+
+$ zip janusxr.com index.html   # you can even update the binary 
+```
+
+> Profit!
+
+</details>
 
 ### Pull our scripts into your page
-Using the above method, all of your links would go through our servers.  If you'd prefer to 
+Using the above method, all of your links would go through community CORS-proxies. If you'd prefer to 
 link to your own servers, you can pull our JS into your page and use JanusWeb as a scriptable
 client via its API.  This looks something like this:
 
@@ -97,13 +275,38 @@ client via its API.  This looks something like this:
 ```
 
 The `elation.janusweb.init()` function can take a number of arguments, and returns a promise which
-receives an instance of the client.  This client reference can be controlled via its API.  See the 
-sections on **Arguments** and **Scripting** below.
+receives an instance of the client.  This client reference can be controlled via its API:
+
+```html
+<html>
+  <head>
+    <title>My JanusVR Room</title>
+  </head>
+  <body>
+    <script src="https://web.janusvr.com/janusweb.js"></script>
+    <script>
+        elation.janusweb.init({url: document.location.href })
+        .then( (client)=> console.log("rendering this page's virtual twin") )
+    </script>
+
+    <!-- 
+    <fireboxroom>
+      <room use_local_asset="room1">
+        <object id="cube" pos="0 1 5" />
+        <text col="1 0 0" pos="0 2 4">my first room</text>
+      </room>
+    </fireboxroom>
+    -->
+
+  </body>
+</html>
+```
+
+> **NOTE**: you can also update the `janusxr.com` binary to your likings: (`unzip janusxr.com index.html && vi index.html && zip janusxr.com index.html` see 'get the latest build files' above)
 
-See also **Using a specific version of JanusWeb** below.
+See the sections on **Arguments** and **Scripting** below.
 
-### Install from ZIPs
-(TODO - we will start shipping zip builds of JanusWeb once we release v1.0)
+> See also **Using a specific version of JanusWeb** below.
 
 ### Install from NPM
 (TODO - we will start shipping official NPM packages of JanusWeb once we release v1.0)

package/janusxr.com/.args

@@ -0,0 +1,2 @@
+-D
+.

package/janusxr.com/.init.lua

@@ -0,0 +1,30 @@
+HidePath("/usr/share/zoneinfo/")
+HidePath("/usr/share/ssl/")
+homepage = false
+homepath = false
+home = arg[-1]:gsub(".*/","")
+              :gsub(".com","")
+ext = { "txt", "xml", "html", "pdf", "mp3", "yaml", "json", "xlsx", "png", "jpg", "glb", "gltf", "dae", "obj"}
+for k,v in pairs(ext) do
+  file = string.format("%s.%s", home, v)
+  if( path.exists( file ) ) then homepath = "/" .. file; end
+end
+
+if( homepath ) then 
+  print("✅ detected " .. homepath .. " (setting as spatial home)")
+  homepage = Slurp("/zip/index.html"):gsub("<janus%-viewer .-</janus%-viewer>","<janus-viewer src=\"" .. homepath .. "\"></janus-viewer>")
+
+  function OnHttpRequest()
+    path = GetPath()
+    if( homepage and path == "/" ) then
+      SetStatus(200)
+      SetHeader("Content-Type", "text/html; charset=utf-8")
+      SetHeader("Access-Control-Allow-Origin", "*")
+      Write(homepage)
+    else
+      Route()
+    end
+  end
+end
+LaunchBrowser()
+

package/media/assets/webui/apps/comms/voip.js

@@ -681,35 +681,37 @@ console.log('[voip-remoteuser] got a remote voip user', data);
       this.audio = audio;
       this.appendChild(audio);
 
-      audio.play()
-        .then(() => {
-          console.log('[voip-remoteuser] remote user audio playing', audio, this);
-          this.hasaudio = true;
-        });
+      room.getAudioNodes().then(() => {
+        audio.play()
+          .then(() => {
+            console.log('[voip-remoteuser] remote user audio playing', audio, this);
+            this.hasaudio = true;
+          });
 
-      let listener = player.engine.systems.sound.getRealListener();
-      let context = listener.context;
-      let analyser = context.createAnalyser();
-      let source = context.createMediaStreamSource(audio.srcObject);
-      source.connect(analyser);
+        let listener = player.engine.systems.sound.getRealListener();
+        let context = listener.context;
+        let analyser = context.createAnalyser();
+        let source = context.createMediaStreamSource(audio.srcObject);
+        source.connect(analyser);
 
-      analyser.fftSize = 32;
-      this.analyser = analyser;
-      this.audiobuffer = new Uint8Array(analyser.frequencyBinCount);
+        analyser.fftSize = 32;
+        this.analyser = analyser;
+        this.audiobuffer = new Uint8Array(analyser.frequencyBinCount);
 
-      if (this.updateVolumeInterval) {
-        clearInterval(this.updateVolumeInterval);
-        this.updateVolumeInterval = false;
-      }
-      this.updateVolumeInterval = setInterval(() => {
-        analyser.getByteFrequencyData(this.audiobuffer);
-        let sum = 0;
-        for (let i = 0; i < this.audiobuffer.length; i++) {
-          sum += this.audiobuffer[i];
+        if (this.updateVolumeInterval) {
+          clearInterval(this.updateVolumeInterval);
+          this.updateVolumeInterval = false;
         }
-        let avg = sum / this.audiobuffer.length;
-        this.updateVolume(avg / 100);
-      }, 20);
+        this.updateVolumeInterval = setInterval(() => {
+          analyser.getByteFrequencyData(this.audiobuffer);
+          let sum = 0;
+          for (let i = 0; i < this.audiobuffer.length; i++) {
+            sum += this.audiobuffer[i];
+          }
+          let avg = sum / this.audiobuffer.length;
+          this.updateVolume(avg / 100);
+        }, 20);
+      });
     }
 
     let remoteuser = janus.network.remoteplayers[this.id];

package/media/assets/webui/apps/editor/editor.js

@@ -325,7 +325,10 @@ console.log('set translation snap', ev.data, ev);
     room._target.objects['3d'].traverse(n => {
       userDatas.set(n, n.userData);
       n.userData = {};
+      elation.events.fire({element: this, type: 'webui_editor_export_node', data:{n,userData: userDatas.get(n)} })
     });
+    elation.events.fire({element: this, type: 'webui_editor_export', data:{ scene: room._target.objects['3d']} })
+
     exporter.parse(room._target.objects['3d'], (data) => {
       // Restore userData objects
       room._target.objects['3d'].traverse(n => {

package/media/assets/webui/apps/navigation/navigation.js

@@ -391,7 +391,7 @@ elation.elements.define('janus.ui.urlbar', class extends elation.elements.ui.pan
   handleAccept(ev) {
     var url = this.input.value;
     if (url.length > 0) {
-      if (url.indexOf(':') == -1) {
+      if (url.indexOf(':') == -1 && !url.match(/^\.\//) ) {
         url = 'http://' + url;
       }
       if (ev.altKey) {