Skip to content

sceneview-tools/3d-viewer-extension

Repository files navigation

3D Viewer by SceneView

A Chrome Extension that adds 3D model preview capabilities to any webpage. Right-click any .glb, .gltf, or .usdz link to instantly preview it in an interactive 3D viewer.

Features

  • Right-click preview -- Right-click any 3D model link on any webpage and select "Preview in 3D"
  • Auto-detection -- Automatically detects 3D model links on pages and adds a preview icon next to them
  • Interactive viewer -- Orbit controls, zoom, pan, auto-rotate with shadow and lighting
  • AR support -- View models in augmented reality on supported devices (WebXR, Scene Viewer, Quick Look)
  • Fullscreen mode -- Immersive viewing with keyboard shortcut (F)
  • Download -- Save the 3D model to your computer (D)
  • Dark/Light theme -- Toggle between themes, persisted across sessions (T)
  • SceneView Playground -- Open any model in the SceneView online playground
  • Responsive -- Works on desktop and mobile Chrome

Supported Formats

Format Extension Description
glTF Binary .glb Most common web 3D format
glTF .gltf JSON-based 3D format
USDZ .usdz Apple AR format (iOS Quick Look)

Installation (Development)

  1. Clone or download this repository
  2. Open Chrome and navigate to chrome://extensions/
  3. Enable "Developer mode" (top right toggle)
  4. Click "Load unpacked" and select the extension directory
  5. The extension icon appears in your toolbar

Usage

Right-click method

  1. Find a link to a .glb, .gltf, or .usdz file on any webpage
  2. Right-click the link
  3. Select "Preview in 3D" from the context menu
  4. The model opens in a new tab with the interactive viewer

Auto-detected links

When visiting a page with 3D model links, the extension automatically adds an eye icon next to each link. Click the icon to preview.

Keyboard shortcuts

Key Action
F Toggle fullscreen
D Download model
T Toggle dark/light theme

Chrome Web Store Submission Guide

Prerequisites

  • Chrome Web Store developer account ($5 one-time fee)
  • Privacy policy URL (use https://sceneview.github.io/privacy)
  • At least one screenshot (1280x800 or 640x400)
  • Promotional images (optional): 440x280 small tile, 920x680 large tile

Submission steps

  1. Package the extension

    cd 3d-viewer-extension
    zip -r 3d-viewer-extension.zip . -x ".*" -x "__MACOSX" -x "*.md" -x "icons/icon.svg"
  2. Go to Chrome Web Store Developer Dashboard

  3. Create new item and upload the .zip

  4. Fill in store listing

    • Name: 3D Viewer by SceneView
    • Summary: Preview 3D models (.glb, .gltf, .usdz) directly in your browser. Right-click any 3D file link to instantly preview it with orbit controls, AR, and fullscreen.
    • Description: (see below)
    • Category: Developer Tools or Productivity
    • Language: English
  5. Store description (copy-paste):

    3D Viewer by SceneView brings interactive 3D model previewing to your browser.
    
    Simply right-click any .glb, .gltf, or .usdz link on any webpage and select "Preview in 3D" to open an interactive viewer with:
    
    - Orbit controls (click and drag to rotate)
    - Zoom and pan
    - Auto-rotation with realistic shadows
    - AR mode on supported devices
    - Fullscreen viewing
    - Dark and light themes
    - One-click download
    - Open in SceneView Playground
    
    The extension also automatically detects 3D model links on web pages and adds a convenient preview button next to each one.
    
    Perfect for 3D artists, game developers, web developers, and anyone who works with 3D content on the web.
    
    Keyboard shortcuts:
    F - Fullscreen
    D - Download
    T - Toggle theme
    
    Powered by SceneView (https://sceneview.github.io) and Google's model-viewer.
    
    Privacy: This extension does not collect, store, or transmit any personal data. Models are loaded directly from their source URLs.
    
  6. Privacy practices

    • Single purpose: "Preview 3D model files in the browser"
    • Does not collect personal data
    • Privacy policy: https://sceneview.github.io/privacy
  7. Upload screenshots (capture from viewer.html with a loaded model)

  8. Submit for review (typically 1-3 business days)

Screenshots to capture

  1. Context menu showing "Preview in 3D" on a .glb link
  2. The viewer showing a 3D model in dark mode
  3. The viewer in light mode with AR button visible
  4. A webpage with auto-detected 3D links showing preview icons

Privacy Policy

This extension:

  • Does NOT collect any personal data
  • Does NOT track browsing activity
  • Does NOT transmit data to any server
  • Only accesses URLs that the user explicitly chooses to preview
  • Theme preference is stored locally using Chrome's storage API

Tech Stack

  • Manifest V3 -- Latest Chrome Extension standard
  • model-viewer -- Google's web component for 3D rendering (loaded from CDN)
  • Vanilla JS -- No frameworks, minimal footprint
  • Chrome Storage API -- For persisting theme preference

Credits

  • SceneView -- 3D/AR SDK for Android and Apple platforms
  • model-viewer -- Google's 3D web component
  • three.js -- 3D rendering engine (used by model-viewer)

License

MIT License. Copyright (c) 2026 SceneView.

About

3D Viewer by SceneView — Chrome Extension for 3D model preview

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors