{"id":27940530,"url":"https://github.com/khronosgroup/gltf-blender-io","last_synced_at":"2025-05-14T16:03:22.863Z","repository":{"id":37458057,"uuid":"140887618","full_name":"KhronosGroup/glTF-Blender-IO","owner":"KhronosGroup","description":"Blender glTF 2.0 importer and exporter","archived":false,"fork":false,"pushed_at":"2025-05-05T09:54:53.000Z","size":46064,"stargazers_count":1547,"open_issues_count":217,"forks_count":330,"subscribers_count":79,"default_branch":"main","last_synced_at":"2025-05-07T10:17:24.560Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://docs.blender.org/manual/en/latest/addons/import_export/scene_gltf2.html","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KhronosGroup.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.txt","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-07-13T19:53:39.000Z","updated_at":"2025-05-03T18:15:52.000Z","dependencies_parsed_at":"2024-06-29T08:27:11.325Z","dependency_job_id":"e7035f7c-3a3b-4a08-9111-40c3f749b353","html_url":"https://github.com/KhronosGroup/glTF-Blender-IO","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhronosGroup%2FglTF-Blender-IO","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhronosGroup%2FglTF-Blender-IO/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhronosGroup%2FglTF-Blender-IO/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhronosGroup%2FglTF-Blender-IO/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KhronosGroup","download_url":"https://codeload.github.com/KhronosGroup/glTF-Blender-IO/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252856567,"owners_count":21814858,"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":[],"created_at":"2025-05-07T10:17:59.831Z","updated_at":"2025-05-07T10:18:00.367Z","avatar_url":"https://github.com/KhronosGroup.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Blender](misc/Blender_logo.png)](http://www.blender.org/) [![glTF](misc/glTF_logo.png)](https://www.khronos.org/gltf/)\n\nBlender glTF 2.0 Importer and Exporter\n======================================\n\nDocumentation\n-------------\n\n| Blender Version | Documentation |\n|---------|---------------------|\n| 4.2 LTS | https://docs.blender.org/manual/en/4.2/addons/import_export/scene_gltf2.html |\n| 4.4     | https://docs.blender.org/manual/en/4.4/addons/import_export/scene_gltf2.html  |\n| dev     | https://docs.blender.org/manual/en/dev/addons/import_export/scene_gltf2.html  |\n\nNotes:\n* 4.4 is the current stable release. Check the `blender-v4.4-release` branch (and `4.4.1` tag)\n* 4.5 is the next stable release. Check the `main` branch\n* 2.80 - 4.3 are previous stable releases.\n* 4.2.x is the current Blender LTS release. Check the `blender-v4.2-release` branch (and `4.2.x` tag)\n* main branch of this addon is mirrored in [Blender main](https://projects.blender.org/blender/blender/src/branch/main/scripts/addons_core/io_scene_gltf2), that will become Blender 4.5.\n\n### Legacy 2.79 Support\n\nThe final version of this addon with legacy support for Blender 2.79 is available on the [2.79 Release Page](https://github.com/KhronosGroup/glTF-Blender-IO/releases/tag/2.79).\n\nBlender 2.80 and higher bundle this addon in the main Blender install package, so no 3rd-party install is required.\n\nCredits\n-------\n\nDeveloped by [UX3D](https://www.ux3d.io/), Scurest and [Julien Duroure](http://julienduroure.com/), with support from the [Khronos Group](https://www.khronos.org/), [Mozilla](https://www.mozilla.org/), and [Airbus Defense \u0026 Space](https://www.airbus.com/space.html).\n\nIntroduction\n------------\n\nOfficial Khronos Group Blender [glTF](https://www.khronos.org/gltf/) 2.0 importer and exporter.\n\nThis project contains all features from the [previous exporter](https://github.com/KhronosGroup/glTF-Blender-Exporter), and all future development will happen on this repository. In addition, this repository contains a Blender importer, with common Python code shared between exporter and importer for round-trip workflows. New features are included or under development, but usage and menu functionality remain the same.\n\nThe shared codebase is organized into common (Blender-independent) and Blender-specific packages:\n\n![Packages](docs/packages.png)\nPackage organisation\n\nThis structure allows common code to be reused by third-party Python packages working with the glTF 2.0 format.\n\n![Process](docs/io_process.png)\nImport \u0026 export process\n\nThe main importer and exporter interface is the Python glTF scene representation.\nBlender scene data is first extracted and converted into this scene description. This glTF scene description is exported to the final JSON glTF file. Any compression of mesh, animation, or texture data happens here.\nFor import, glTF data is parsed and written into the Python glTF scene description. Any decompression is executed in this step. Using the imported glTF scene tree, the Blender internal scene representation is generated from this information.\n\nInstallation\n------------\n\nThe Khronos glTF 2.0 importer and exporter is enabled by default in [Blender 2.8](https://www.blender.org/2-8/) and higher. To reinstall it — for example, when testing recent or upcoming changes — copy the `addons/io_scene_gltf2` folder into the `scripts/addons_core/` directory of the Blender installation, then enable it under the *Add-ons* tab. For additional development documentation, see [Debugging](DEBUGGING.md).\n\nDebugging\n---------\n\n- [Debug with PyCharm](https://code.blender.org/2015/10/debugging-python-code-with-pycharm) **NOTE:** If you are using Blender 2.80+, you need the [updated debugger script](https://github.com/ux3d/random-blender-addons/blob/master/remote_debugger.py)\n- [Debug with VSCode](DEBUGGING.md)\n\nContinuous Integration Tests\n----------------------------\n\nSeveral companies, individuals, and glTF community members contribute to Blender glTF I/O. Functionality is added and bugs are fixed regularly. Because hobbyists and professionals using Blender glTF I/O rely on its stability for their daily work, continuous integration tests are enabled. After each commit or pull request, the following tests are run:\n\n-\tExport Blender scene and validate using the [glTF validator](https://github.com/KhronosGroup/glTF-Validator/)\n-\tRound trip import-export and comparison of glTF validator results\n\nThese quality-assurance checks improve the reliability of Blender glTF I/O.\n\n[![CI](https://github.com/KhronosGroup/glTF-Blender-IO/workflows/CI/badge.svg?branch=main\u0026event=push)](https://github.com/KhronosGroup/glTF-Blender-IO/actions?query=workflow%3ACI)\n\nRunning the Tests Locally\n-------------------------\n\nTo run the tests locally, your system should have a `blender` executable in the path that launches the desired version of Blender.\n\nThe latest version of [Yarn](https://yarnpkg.com/en/) should also be installed.\n\nThen, in the `tests` folder of this repository, run `yarn install`, followed by `yarn run test`.\n\nMain branch\n-----------\n\nThe main branch was renamed on 2023 January, 12th.\nIf you need to update your local repository, you can use the [following documentation](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch#updating-a-local-clone-after-a-branch-name-changes)\n\n\nSome Technical documentation\n----------------------------\n\nWant to fix some bugs or add some enhancement? You will find some technical overview of this addon [here](Technical.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhronosgroup%2Fgltf-blender-io","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkhronosgroup%2Fgltf-blender-io","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhronosgroup%2Fgltf-blender-io/lists"}