Skip to content

saw-jan/web-app-3dmodel-viewer

Repository files navigation

3D Model Viewer - ownCloud Web Extension

3d model viewer ui

This is an extension for ownCloud web for viewing 3D files.

Feature Highlights ✨

  • Supported formats: [.glb, .stl, .fbx, .obj]
  • Zoom/Rotate model
  • Fullscreen view
  • Navigate between model files

Installation

  1. Download the zip file from the releases page
  2. Extract the zip file to the apps directory of the oCIS server, which is set using the WEB_ASSET_APPS_PATH environment variable

App Installation With oCIS Deployment

  1. Copy deployments/3dviewer.yaml into the web_extensions subfolder of oCIS full deployment example.

  2. Add APP_3D_VIEWER=:web_extensions/3dviewer.yaml to the ## oCIS Web Extensions ## section of the .env file of your installation (file is located in deployments/examples/ocis_full) and append it to the COMPOSE_FILE variable.

    ## oCIS Web Extensions ##
    APP_3D_VIEWER=:web_extensions/3dviewer.yaml
    
    COMPOSE_FILE=docker-compose.yml${...}${APP_3D_VIEWER:-}
  3. Run docker compose up to run oCIS with the extensions

    oCIS URL: ocis.owncloud.test

    See the docs for more information.

Build and Run for development

For building and running the app from the code base, follow these steps:

  1. Install the dependencies

    pnpm i
  2. Build the extension

    pnpm build

    For development, build with watch.

    pnpm build:w
  3. Start the extension and the web services

    docker compose up

Now, you can access the app at https://localhost:9200

3D models

You can find models on the following platforms: