a tiny specification for (viewing) 3D models (metadata) as linkable AR/VR websites. Address and Control anything inside a 3D model with W3C Media Fragments and URI Templates. Simply SURF a 3D file-verse and design for a Spatial Open Internet with the highest degree of interoperability. https://xrfragment.org

Go to file

Leon van Kammen 33f80e5b75 pages: work in progress [might break]		2024-07-10 15:48:09 +02:00
.github/workflows	main: minor bugfix	2024-05-17 18:02:18 +02:00
dist	main: work in progress [might break]	2024-07-10 10:24:03 +00:00
doc	updated docs	2024-06-19 14:13:15 +02:00
example	pages: work in progress [might break]	2024-07-10 15:45:56 +02:00
src	main: work in progress [might break]	2024-07-10 10:24:03 +00:00
test	release v0.5.2	2024-04-16 13:19:08 +00:00
.domains	pages: work in progress [might break]	2024-07-10 15:00:28 +02:00
.gitignore	feat/godot wip	2024-05-10 13:41:20 +02:00
.gitmodules	moved godot repo to its own codeberg repo to submit as godot extension	2024-05-20 10:03:45 +02:00
.vimrc	updated vimrc	2023-11-16 14:58:51 +01:00
LICENSE	update documentation	2023-08-08 13:22:19 +02:00
README.md	main: update documentation	2024-05-20 10:21:46 +02:00
build.hxml	main: minor bugfix	2024-05-20 11:50:28 +02:00
index.glb	pages: work in progress [might break]	2024-07-10 15:44:09 +02:00
index.html	pages: work in progress [might break]	2024-07-10 15:34:17 +02:00
make	bugfix: enter-vr (black screen) + fixed objects-leak when resetting scene	2024-06-04 17:00:48 +00:00
other.glb	pages: work in progress [might break]	2024-07-10 15:48:09 +02:00
shell.nix	work in progress [might break]	2024-04-29 14:28:50 +00:00

README.md

A tiny specification for viewing 3D models as linkable AR/VR websites.
Address and Control anything inside a 3D model with W3C Media Fragments and URI Templates.

Simply SURF a 3D file-verse and design for a Spatial Open Internet with the highest degree of interoperability ❤

Documentation / Website

https://xrfragment.org

Getting started

https://xrfragmenorg

available parser-implementations

javascript (+example)
javascript module
python (+example)
lua (+example)
haXe (allows exporting to various programming languages)
Godot exports to all platforms

See documentation for more info

development

Pre-build libraries can be found in /dist folder
If you really want to build from source:

$ nix-shell           # nix-users: drops you into a dev-ready shell 
$ ./make install      # debian-users: install deps via apt-get
$ ./make build && ./make tests

NOTE #1: to rebundle the THREE/AFRAME javascripts during dev run ./make build js NOTE #2: to regenerate the parser in various languages (via haxe), run ./make build parser

Godot (>=v4.3.1)

$ ./make install godot       # this installs the godot-xr-tools addon

NOTE: the godot project is in src/xrfragment/godot (open the folder in godot)