{"id":20992248,"url":"https://github.com/setsun/react-model-viewer","last_synced_at":"2025-05-14T20:32:37.907Z","repository":{"id":41792282,"uuid":"187553055","full_name":"setsun/react-model-viewer","owner":"setsun","description":"3D model viewer / animation player in React \u0026 Three.js","archived":false,"fork":false,"pushed_at":"2024-03-26T10:40:23.000Z","size":1988,"stargazers_count":35,"open_issues_count":15,"forks_count":6,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-10-18T07:07:09.972Z","etag":null,"topics":["3d","animation","react","react-three-fiber","threejs","webgl"],"latest_commit_sha":null,"homepage":"https://setsun.github.io/react-model-viewer","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/setsun.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":"2019-05-20T02:14:27.000Z","updated_at":"2024-06-28T20:47:35.000Z","dependencies_parsed_at":"2024-06-21T05:47:55.221Z","dependency_job_id":"2a4d39dd-7068-4078-ae03-51d62b668326","html_url":"https://github.com/setsun/react-model-viewer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/setsun%2Freact-model-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/setsun%2Freact-model-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/setsun%2Freact-model-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/setsun%2Freact-model-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/setsun","download_url":"https://codeload.github.com/setsun/react-model-viewer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225310090,"owners_count":17454089,"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","animation","react","react-three-fiber","threejs","webgl"],"created_at":"2024-11-19T07:10:05.045Z","updated_at":"2024-11-19T07:10:06.915Z","avatar_url":"https://github.com/setsun.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# react-model-viewer\n\nA 3D model viewer \u0026 animation player for React.\n\nSupports:\n- GTLF, OBJ formats\n- Loading progress bar for asset files\n- Animation progress bar for 3D animations\n- Animation clip selection\n- Orbit camera controls\n- Play, pause, seek, \u0026 loop controls\n- Playback speed controls\n\n### Install\n```\n# main package\nnpm i react-model-viewer\n\n# peer dependencies\nnpm i react react-dom three\n```\n\nBundle size: https://bundlephobia.com/result?p=react-model-viewer\n\n### Example\nhttp://setsun.github.io/react-model-viewer/?path=/story/react-model-viewer--gtlf-sonic\n\n![example](https://user-images.githubusercontent.com/4651424/61834820-64e2b180-ae47-11e9-85d4-cd69d02b7dd6.gif)\n\n### API\n`react-model-viewer` is meant to interface seamlessly with `three.js` model loaders  for loading 3D assets (`GTLFLoader`, `OBJLoader`, etc).\n\nAdditionally it supports animations via `THREE.AnimationMixer` if the model includes them.\n\n```tsx\nimport ModelViewer from 'react-model-viewer';\n\nconst modelPath = 'https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Duck/glTF/Duck.gltf';\n\nconst App = () =\u003e (\n  \u003cModelViewer type=\"gtlf\" src={modelPath} /\u003e\n);\n```\n\n### Coming Soon\n\n- [ ] Animation timestamps / frames\n- [ ] Better support for `OBJ` and switching out `MTL` textures.\n- [ ] Support for other loaders (`FBX`, `COLLADA`, etc.)\n- [ ] Render props for headless component rendering (BYOS - bring your own styles)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsetsun%2Freact-model-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsetsun%2Freact-model-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsetsun%2Freact-model-viewer/lists"}