{"id":21659882,"url":"https://github.com/slub/dlf-3d-viewers","last_synced_at":"2025-07-06T12:34:52.053Z","repository":{"id":242698949,"uuid":"810193300","full_name":"slub/dlf-3d-viewers","owner":"slub","description":"3D viewer integrations for Kitodo.Presentation or DFG-Viewer","archived":false,"fork":false,"pushed_at":"2025-02-25T08:46:34.000Z","size":276215,"stargazers_count":1,"open_issues_count":60,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-18T23:59:49.638Z","etag":null,"topics":["3d-viewer","dfg-viewer","kitodo-presentation"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/slub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-04T08:21:03.000Z","updated_at":"2025-02-25T08:46:38.000Z","dependencies_parsed_at":"2024-06-04T14:40:44.165Z","dependency_job_id":"5780b3dc-703c-4d96-a13d-4271902bfa1a","html_url":"https://github.com/slub/dlf-3d-viewers","commit_stats":null,"previous_names":["markusweigelt/dlf-3d-viewers"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slub%2Fdlf-3d-viewers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slub%2Fdlf-3d-viewers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slub%2Fdlf-3d-viewers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slub%2Fdlf-3d-viewers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slub","download_url":"https://codeload.github.com/slub/dlf-3d-viewers/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244555922,"owners_count":20471528,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-viewer","dfg-viewer","kitodo-presentation"],"created_at":"2024-11-25T09:31:50.136Z","updated_at":"2025-07-06T12:34:52.039Z","avatar_url":"https://github.com/slub.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 3D viewer integrations for Kitodo.Presentation or DFG-Viewer\n\n * [Installation](#installation)\n * [Integrations](#integrations)\n   * [dlf-3dhop](#dlf-3dhop)\n   * [dlf-ai-mainz-3dviewer](#dlf-ai-mainz-3dviewer)\n   * [dlf-aton](#dlf-aton)\n   * [dlf-jena-3dviewer-holopyramid](#dlf-jena-3dviewer-holopyramid)\n   * [dlf-jena-3dviewer-vrglasses](#dlf-jena-3dviewer-vrglasses)\n   * [dlf-kompakkt](#dlf-kompakkt)\n   * [dlf-model-viewer](#dlf-model-viewer)\n   * [dlf-threejs](#dlf-threejs)\n * [DFG 3D-Viewer test system](#dfg-3d-viewer-test-system)\n * [Further information](#further-information)\n * [Maintainer](#maintainer)\n\nThis repository contains integrations of existing 3D viewers or reference implementations of 3D viewers for embedding in Kitodo.Presentation or DFG-Viewer.\n\n## Installation\n\n- Clone repository or download source code.\n- Run the `install.sh` bash script to download libraries and frameworks under `modules` folder of each viewer implementation\n\nAfter these steps, you will have a folder with the respective viewer integration, its dependencies and resources as well as the `dlf-3d-viewer.yml` configuration file required for the integration.\n\nFor more informations regarding embedding this folder into Kitodo.Presentation and DFG-Viewer, read the [Embedded 3D Viewer](https://kitodo.github.io/kitodo-presentation/Developers/Embedded3DViewer.html) documentation.\n\n## Integrations\n\nThese are integrations of 3D viewers or custom 3D viewer implementations base on a JavaScript 3D library (e.g. three.js) which have been prepared for Kitodo.Presentation and thus for the DFG-Viewer.\n\n*DLF prefix stands for “Digital Library Framework” and is the key of the TYPO3 extension “Kitodo.Presentation”. The name of the viewer integration can be chosen freely for your [custom viewer](https://kitodo.github.io/kitodo-presentation/Developers/Embedded3DViewer.html#Custom%20Viewer).*\n\n### dlf-3dhop\n\nIntegration of [3DHOP](https://3dhop.net/) framework.\n\nSupported model formats: .ply, .obj\n\n![image](https://github.com/user-attachments/assets/153f06ab-855b-4989-b06a-73cef84cc0f0)\n\n#### Test\n\nhttps://3dtest.dfg-viewer.de/viewer?tx_dlf[model]=https://3dtest.dfg-viewer.de/fileadmin/models/gargo.ply\u0026tx_dlf[viewer]=dlf-3dhop\n\n##### GitHub Runner Testsystem\n\nhttps://bear-genuine-hookworm.ngrok-free.app/viewer?tx_dlf[model]=https://bear-genuine-hookworm.ngrok-free.app/fileadmin/models/gargo.ply\u0026tx_dlf[viewer]=dlf-3dhop\n\n### dlf-aton\n\nIntegration of [ATON](https://osiris.itabc.cnr.it/aton/) framework.\n\nSupported model formats: .glb, .gltf\n\n![image](https://github.com/user-attachments/assets/3e46f16d-e201-4656-930e-93aa547f3342)\n\n#### Test\n\nhttps://3dtest.dfg-viewer.de/viewer?tx_dlf[id]=https://3drepo.eu/modelupload/b5df7cd550f64e818943ad96fff7e902metsmods.xml\u0026tx_dlf[viewer]=dlf-aton\n\n##### GitHub Runner Testsystem\n\nhttps://bear-genuine-hookworm.ngrok-free.app/viewer?tx_dlf[id]=https://3drepo.eu/modelupload/b5df7cd550f64e818943ad96fff7e902metsmods.xml\u0026tx_dlf[viewer]=dlf-aton\n\n### dlf-jena-3dviewer-holopyramid\n\nIntegration of 3DView for Holopyramid from https://3drepo.eu/.\n\nSupported model formats: .glb, .gltf\n\n![image](https://github.com/user-attachments/assets/90aaa744-cf2a-4fcf-bd4e-eab9b01477cf)\n\n#### Test\n\nhttps://3dtest.dfg-viewer.de/viewer?tx_dlf[id]=https://3drepo.eu/modelupload/b5df7cd550f64e818943ad96fff7e902metsmods.xml\u0026tx_dlf[viewer]=dlf-jena-3dviewer-holopyramid\n\n##### GitHub Runner Testsystem\n\nhttps://bear-genuine-hookworm.ngrok-free.app/viewer?tx_dlf[id]=https://3drepo.eu/modelupload/b5df7cd550f64e818943ad96fff7e902metsmods.xml\u0026tx_dlf[viewer]=dlf-jena-3dviewer-holopyramid\n\n### dlf-jena-3dviewer-vrglasses\n\nIntegration of 3DView for VR Glasses from https://3drepo.eu/.\n\nSupported model formats: .glb, .gltf\n\n![image](https://github.com/user-attachments/assets/5994b03a-802c-4bfc-ad25-c07c7e28603e)\n\n#### Test\n\nhttps://3dtest.dfg-viewer.de/viewer?tx_dlf[id]=https://3drepo.eu/modelupload/b5df7cd550f64e818943ad96fff7e902metsmods.xml\u0026tx_dlf[viewer]=dlf-jena-3dviewer-vrglasses\n\n##### GitHub Runner Testsystem\n\nhttps://bear-genuine-hookworm.ngrok-free.app/viewer?tx_dlf[id]=https://3drepo.eu/modelupload/b5df7cd550f64e818943ad96fff7e902metsmods.xml\u0026tx_dlf[viewer]=dlf-jena-3dviewer-vrglasses\n\n### dlf-kompakkt\n\nIntegration of [Kompakkt](https://kompakkt.de/) using the [Kompakkt Standalone Viewer](https://github.com/Kompakkt/StandaloneViewer).\n\nSupported model formats: .glb, .babylon, .gltf, .obj, .stl\n\n![image](https://github.com/user-attachments/assets/1fc458e8-fa48-4d69-b8dc-a1d3cbe46138)\n\n#### Test\n\nhttps://3dtest.dfg-viewer.de/viewer?tx_dlf[id]=https://3drepo.eu/modelupload/b5df7cd550f64e818943ad96fff7e902metsmods.xml\u0026tx_dlf[viewer]=dlf-kompakkt\n\n##### GitHub Runner Testsystem\n\nhttps://bear-genuine-hookworm.ngrok-free.app/viewer?tx_dlf[id]=https://3drepo.eu/modelupload/b5df7cd550f64e818943ad96fff7e902metsmods.xml\u0026tx_dlf[viewer]=dlf-kompakkt\n\n### dlf-model-viewer\n\nIntegration of the [model-viewer](https://modelviewer.dev/). \n\n*Kitodo.Presentation an thus DFG-Viewer includes this as a default viewer now*\n\nSupported model formats: .glb, .gltf\n\n![image](https://github.com/user-attachments/assets/14345cce-a32d-4c6e-89f8-d63909e3f35e)\n\n#### Test\n\nDefault of viewer Kitodo.Presentation and with that DFG-Viewer\nhttps://3dtest.dfg-viewer.de/viewer?tx_dlf[id]=https://3drepo.eu/modelupload/b5df7cd550f64e818943ad96fff7e902metsmods.xml\n\nUse the model viewer from the Integration repository\nhttps://3dtest.dfg-viewer.de/viewer?tx_dlf[id]=https://3drepo.eu/modelupload/b5df7cd550f64e818943ad96fff7e902metsmods.xml\u0026tx_dlf[viewer]=dlf-model-viewer\n\n##### GitHub Runner Testsystem\n\nDefault of viewer Kitodo.Presentation and with that DFG-Viewer\nhttps://bear-genuine-hookworm.ngrok-free.app/viewer?tx_dlf[id]=https://3drepo.eu/modelupload/b5df7cd550f64e818943ad96fff7e902metsmods.xml\n\nUse the model viewer from the Integration repository\nhttps://bear-genuine-hookworm.ngrok-free.app/viewer?tx_dlf[id]=https://3drepo.eu/modelupload/b5df7cd550f64e818943ad96fff7e902metsmods.xml\u0026tx_dlf[viewer]=dlf-model-viewer\n\n### dlf-ai-mainz-3dviewer\n\nIntegration of 3D Viewer implementation [thedworak/dfg_3dviewer](https://github.com/thedworak/dfg_3dviewer) of Daniel Dworak Hochschule Mainz.\n\nSupported model formats: .obj, .dae, .fbx, .ply, .ifc, .stl, .xyz, .json, .3ds, .gltf, .glb\n\n![image](https://github.com/user-attachments/assets/25092f15-a9c7-4564-96f8-342b341f2793)\n\n#### Test\n\nhttps://3dtest.dfg-viewer.de/viewer?tx_dlf[id]=https://3drepo.eu/modelupload/b5df7cd550f64e818943ad96fff7e902metsmods.xml\u0026tx_dlf[viewer]=dlf-ai-mainz-3dviewer\n\n##### GitHub Runner Testsystem\n\nhttps://bear-genuine-hookworm.ngrok-free.app/viewer?tx_dlf[id]=https://3drepo.eu/modelupload/b5df7cd550f64e818943ad96fff7e902metsmods.xml\u0026tx_dlf[viewer]=dlf-ai-mainz-3dviewer\n\n### dlf-threejs\n\nIntegration of a minimal implementation of [three.js](https://threejs.org/) with ply model loader.\n\nSupported model formats: .ply\n\n![image](https://github.com/user-attachments/assets/ed8a6993-1c31-45dd-8b02-88652979ce53)\n\n#### Test\n\nhttps://3dtest.dfg-viewer.de/viewer?tx_dlf[model]=https://3dtest.dfg-viewer.de/fileadmin/models/gargo.ply\u0026tx_dlf[viewer]=dlf-threejs\n\n##### GitHub Runner Testsystem\n\nhttps://bear-genuine-hookworm.ngrok-free.app/viewer?tx_dlf[model]=https://bear-genuine-hookworm.ngrok-free.app/fileadmin/models/gargo.ply\u0026tx_dlf[viewer]=dlf-threejs\n\n## DFG 3D-Viewer test system\n\nIf you have write permissions for this repository, you can start a DFG Viewer test system that includes the latest versions of the available integrations. **Please check beforehand if the test system https://bear-genuine-hookworm.ngrok-free.app/ is already running.**\n\nUnder `Actions` tab above, you will find the workflow named `Run DFG-Viewer test system over ngrok`. By clicking on it, a `Run workflow` button will appear in the upper-right area above the list of recent workflow executions. When clicking on this button, a popup opens. Click the green button with the label `Run workflow` in the popup.\n\n![image](https://github.com/user-attachments/assets/c07eb48b-1186-4655-a966-10c35094c385)\n\nIt takes a moment for the starting workflow to be displayed. Reloading the page can make it appear faster.\n\n![image](https://github.com/user-attachments/assets/c336c461-f9d8-4979-b998-725b8d8fbd02)\n\nAfter a short time (1-2 minutes), the test system was generated and is accessible at the URL https://bear-genuine-hookworm.ngrok-free.app/ for one hour. After that, the test system will be automatically stopped.\n\n## Further information\n\n- [DFG 3D-Viewer](https://dfg-viewer.de/dfg-3d-viewer-2)\n- [Infrastructure for Digital 3D Reconstructions](https://architekturinstitut.hs-mainz.de/projects/dfg-3d-viewer-2nd-phase)\n\n## Maintainer\n- [Hochschule Mainz](https://architekturinstitut.hs-mainz.de/)\n- [Friedrich-Schiller-Universität Jena](https://www.uni-jena.de/)\n- [Sächsische Landesbibliothek – Staats- und Universitätsbibliothek Dresden](https://www.slub-dresden.de/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslub%2Fdlf-3d-viewers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslub%2Fdlf-3d-viewers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslub%2Fdlf-3d-viewers/lists"}