Skip to content

Add GeometryViewer as oEmbed provider#859

Merged
iamcal merged 1 commit intoiamcal:masterfrom
PrintShaper:add-geometryviewer
Mar 12, 2026
Merged

Add GeometryViewer as oEmbed provider#859
iamcal merged 1 commit intoiamcal:masterfrom
PrintShaper:add-geometryviewer

Conversation

@PrintShaper
Copy link
Copy Markdown
Contributor

New Provider: GeometryViewer

URL: https://geometryviewer.com
Type: Rich (interactive 3D model viewer via iframe)

What is GeometryViewer?

GeometryViewer is a free, zero-install browser-based 3D model viewer supporting STL, OBJ, GLTF, GLB, and 3MF formats. Users upload a model and get a shareable link — the recipient can rotate, zoom, and view the model in AR on iPhone (Quick Look) or Android (WebXR).

oEmbed implementation

  • Endpoint: https://geometryviewer.com/oembed
  • Scheme: https://geometryviewer.com/v/* (share URLs)
  • Type: rich — returns an <iframe> embed
  • Discovery tags: included in all /v/TOKEN.ext page <head>

Example

GET https://geometryviewer.com/oembed?url=https%3A%2F%2Fgeometryviewer.com%2Fv%2Fdemo.stl&format=json

Returns:

{
  "type": "rich",
  "version": "1.0",
  "title": "demo.stl — GeometryViewer",
  "provider_name": "GeometryViewer",
  "provider_url": "https://geometryviewer.com",
  "width": 560,
  "height": 560,
  "html": "<iframe src=\"https://geometryviewer.com/embed?url=...\" width=\"560\" height=\"560\" frameborder=\"0\" allow=\"xr-spatial-tracking\" allowfullscreen loading=\"lazy\"></iframe>"
}

GeometryViewer (https://geometryviewer.com) is a free online 3D model
viewer supporting STL, OBJ, GLTF, GLB, and 3MF formats with WebXR AR.
Shareable model links at /v/TOKEN.ext expose oEmbed discovery tags and
return rich iframe embeds via the /oembed endpoint.
@iamcal iamcal merged commit c32cd33 into iamcal:master Mar 12, 2026
1 check passed
@iamcal
Copy link
Copy Markdown
Owner

iamcal commented Mar 12, 2026

Your PR has been merged and site has been updated, thanks.

Using the central registry via HTTP is highly discouraged - you should instead use the discovery mechanism to allows services to consume OEmbed resources: https://oembed.com/#section4

If you need to consume the registry data, please use the NPM package as detailed in the README.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants