https://github.com/saw-jan/web-app-3dmodel-viewer
3D model viewer extension for ownCloud Web
https://github.com/saw-jan/web-app-3dmodel-viewer
3d owncloud owncloud-web threejs typescript vuejs
Last synced: over 1 year ago
JSON representation
3D model viewer extension for ownCloud Web
- Host: GitHub
- URL: https://github.com/saw-jan/web-app-3dmodel-viewer
- Owner: saw-jan
- License: agpl-3.0
- Created: 2024-02-08T16:53:25.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-12-12T12:37:22.000Z (over 1 year ago)
- Last Synced: 2025-03-17T11:50:36.567Z (over 1 year ago)
- Topics: 3d, owncloud, owncloud-web, threejs, typescript, vuejs
- Language: Vue
- Homepage:
- Size: 4.07 MB
- Stars: 6
- Watchers: 1
- Forks: 5
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 3D Model Viewer - ownCloud Web Extension
This is an extension for [ownCloud web](https://github.com/owncloud/web) for viewing 3D files.
## Feature Highlights ✨
- Supported formats: [`.glb`, `.stl`, `.fbx`, `.obj`]
- Zoom/Rotate model
- Fullscreen view
- Navigate between model files
## [Demonstration](https://ocis.in-nepal.de/s/dSlOHjJcQSYuPxV)
## Installation
1. Download the zip file from the [releases page](https://github.com/saw-jan/web-app-3dmodel-viewer/releases)
2. Extract the zip file to the apps directory of the oCIS server, [which is set using the `WEB_ASSET_APPS_PATH` environment variable](https://doc.owncloud.com/ocis/next/deployment/webui/webui-customisation.html#extend-web-ui-with-apps)
### App Installation With [oCIS Deployment](https://github.com/owncloud/ocis/tree/master/deployments/examples/ocis_full)
1. Copy [`deployments/3dviewer.yaml`](./deployments/3dviewer.yaml) into the [web_extensions](https://github.com/owncloud/ocis/tree/master/deployments/examples/ocis_full/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](https://github.com/owncloud/ocis/tree/master/deployments/examples/ocis_full)) and append it to the `COMPOSE_FILE` variable.
```env
## 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](https://ocis.owncloud.test)
See the [docs](https://github.com/owncloud/ocis/tree/master/deployments/examples/ocis_full) 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
```bash
pnpm i
```
2. Build the extension
```bash
pnpm build
```
For development, build with watch.
```bash
pnpm build:w
```
3. Start the extension and the web services
```bash
docker compose up
```
Now, you can access the app at https://localhost:9200
## 3D models
You can find models on the following platforms:
- [sketchfab](https://sketchfab.com/)
- [3Dexport](https://3dexport.com/free-3d-models)
- [archive3D](https://archive3d.net/)
- [clara.io](https://clara.io/library)
- [downloadfree3D](https://downloadfree3d.com/file-format/glb/)
- [free3D](https://free3d.com/)
- [sketchup](https://3dwarehouse.sketchup.com/)
- [turbosquid](https://www.turbosquid.com/Search/3D-Models/free)