{"id":13481958,"url":"https://github.com/alicevision/meshroom","last_synced_at":"2025-05-14T22:06:51.843Z","repository":{"id":30847886,"uuid":"34405381","full_name":"alicevision/Meshroom","owner":"alicevision","description":"Node-based Visual Programming Toolbox","archived":false,"fork":false,"pushed_at":"2025-05-14T16:23:26.000Z","size":10813,"stargazers_count":11871,"open_issues_count":520,"forks_count":1143,"subscribers_count":276,"default_branch":"develop","last_synced_at":"2025-05-14T22:06:42.603Z","etag":null,"topics":["3d-reconstruction","alicevision","camera-tracking","computer-vision","hdr-imaging","image-stitching","meshroom","multi-view-stereo","nocode","nodal-interface","photogrammetry","structure-from-motion","texturing","workflow-automation"],"latest_commit_sha":null,"homepage":"http://alicevision.org","language":"QML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alicevision.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"COPYING.md","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":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["alicevision"],"custom":["https://alicevision.org/association/#donate"]}},"created_at":"2015-04-22T17:33:16.000Z","updated_at":"2025-05-14T21:07:59.000Z","dependencies_parsed_at":"2023-12-20T13:36:11.881Z","dependency_job_id":"54f7d8af-85e8-4de6-94c7-672d76e0d188","html_url":"https://github.com/alicevision/Meshroom","commit_stats":{"total_commits":3076,"total_committers":68,"mean_commits":45.23529411764706,"dds":0.7808842652795839,"last_synced_commit":"45fd86e51b05bc90e7c6fd03eb509ffffafb4187"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alicevision%2FMeshroom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alicevision%2FMeshroom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alicevision%2FMeshroom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alicevision%2FMeshroom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alicevision","download_url":"https://codeload.github.com/alicevision/Meshroom/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254235695,"owners_count":22036963,"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-reconstruction","alicevision","camera-tracking","computer-vision","hdr-imaging","image-stitching","meshroom","multi-view-stereo","nocode","nodal-interface","photogrammetry","structure-from-motion","texturing","workflow-automation"],"created_at":"2024-07-31T17:00:57.770Z","updated_at":"2025-05-14T22:06:46.808Z","avatar_url":"https://github.com/alicevision.png","language":"QML","funding_links":["https://github.com/sponsors/alicevision","https://alicevision.org/association/#donate"],"categories":["\u003ca id=\"tag-graphics\" href=\"#tag-graphics\"\u003eGraphics\u003c/a\u003e","Sensor Processing","Photogrammetry Tools, Libraries, and Frameworks","Python","其他_机器视觉","Open Source","Digital Content Creation Software (DCCs)","Uncategorized","3D Printing","Tools, Pipeline \u0026 Utilities"],"sub_categories":["Image Processing","VS Code Extensions for Developer Productivity","网络服务_其他","Viewpoints and Trajectory Optimization","Photogrammetry","Uncategorized","Helpful Software","Photogrammetry \u0026 3D Scanning"],"readme":"# ![Meshroom - 3D Reconstruction Software](/docs/logo/banner-meshroom.png)\n\n[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/2997/badge)](https://bestpractices.coreinfrastructure.org/projects/2997)\n\nMeshroom is a free, open-source 3D Reconstruction Software based on the [AliceVision](https://github.com/alicevision/AliceVision) Photogrammetric Computer Vision framework.\n\nLearn more details about the pipeline on [AliceVision website](http://alicevision.github.io).\n\nSee [results of the pipeline on sketchfab](http://sketchfab.com/AliceVision).\n\nContinuous integration: [![Build status](https://github.com/alicevision/Meshroom/actions/workflows/continuous-integration.yml/badge.svg?branch=develop)](https://github.com/alicevision/Meshroom/actions/workflows/continuous-integration.yml)\n\n\n## Photogrammetry\n\nPhotogrammetry is the science of making measurements from photographs.\nIt infers the geometry of a scene from a set of unordered photographs or videos.\nPhotography is the projection of a 3D scene onto a 2D plane, losing depth information.\nThe goal of photogrammetry is to reverse this process.\n\nSee the [presentation of the pipeline steps](http://alicevision.github.io/#photogrammetry).\n\n\n## Manual\n\nhttps://meshroom-manual.readthedocs.io\n\n\n## Tutorials\n\n* [Meshroom: Open Source 3D Reconstruction Software](https://www.youtube.com/watch?v=v_O6tYKQEBA) by [Mikros Image](http://www.mikrosimage.com)\n\n  Overall presentation of the Meshroom software.\n\n* [Meshroom: Initial Pipeline, CCTags, using a Turntable and Known Camera Positions](https://www.youtube.com/watch?v=XUKu1apUuVE) by [mpr-projects](https://github.com/mpr-projects)\n\n  Overview of the default Meshroom 2023.3 pipeline, including masking, cctags and known camera positions.\n\n* [Meshroom Tutorial on Sketchfab](https://sketchfab.com/blogs/community/tutorial-meshroom-for-beginners) by [Mikros Image](http://www.mikrosimage.com)\n\n  Detailed tutorial with a focus on the features of the 2019.1 release.\n\n* [Photogrammetry 2 – 3D scanning with just PHONE/CAMERA simpler, better than ever!](https://www.youtube.com/watch?v=1D0EhSi-vvc) by [Prusa 3D Printer](https://blog.prusaprinters.org)\n\n  Overall presentation of the photogrammetry practice with Meshroom.\n\n* [How to 3D Photoscan Easy and Free! by ](https://www.youtube.com/watch?v=k4NTf0hMjtY) by [CG Geek](https://www.youtube.com/channel/UCG8AxMVa6eutIGxrdnDxWpQ)\n\n  Overall presentation of the protogrammetry practice with Meshroom and detailed presentation how to do the retolopogy in Blender.\n\n* [Meshroom Survival Guide](https://www.youtube.com/watch?v=eiEaHLNJJ94) by [Moviola](https://moviola.com)\n\n  Presentation of the Meshroom software with a focus on using it for Match Moving.\n\n\n## Customization\n\n### Custom Pipelines\n\nYou can create custom pipelines in the user interface and save it as template: `File \u003e Advanced \u003e Save As Template`.\nYou can define the `MESHROOM_PIPELINE_TEMPLATES_PATH` environment variable to specific folders to make these pipelines available in Meshroom.\nIn a standard precompiled version of Meshroom, you can also directly add custom pipelines in `lib/meshroom/pipelines`.\n\n### Custom Nodes\n\nYou can create custom nodes in python and make them available in Meshroom using the `MESHROOM_NODES_PATH` environment variable.\n[Here is an example](meshroom/nodes/blender/ScenePreview.py) to launch a Blender rendering from Meshroom.\nIn a standard precompiled version of Meshroom, you can also directly add custom nodes in `lib/meshroom/nodes`.\nTo be recognized by Meshroom, a custom folder with nodes should be a Python module (an `__init__.py` file is needed).\n\n\n## License\n\nThe project is released under MPLv2, see [**COPYING.md**](COPYING.md).\n\n\n## Citation\n\nIf you use this project for a publication, please cite the [paper](https://hal.archives-ouvertes.fr/hal-03351139):\n  ```\n  @inproceedings{alicevision2021,\n    title={{A}liceVision {M}eshroom: An open-source {3D} reconstruction pipeline},\n    author={Carsten Griwodz and Simone Gasparini and Lilian Calvet and Pierre Gurdjos and Fabien Castan and Benoit Maujean and Gregoire De Lillo and Yann Lanthony},\n    booktitle={Proceedings of the 12th ACM Multimedia Systems Conference - {MMSys '21}},\n    doi = {10.1145/3458305.3478443},\n    publisher = {ACM Press},\n    year = {2021}\n  }\n  ```\n\n## Get the project\n\nYou can [download pre-compiled binaries for the latest release](https://github.com/alicevision/meshroom/releases).  \n\nIf you want to build it yourself, see [**INSTALL.md**](INSTALL.md) to setup the project and pre-requisites.\n\nGet the source code and install runtime requirements:\n```bash\ngit clone --recursive https://github.com/alicevision/Meshroom.git\ncd meshroom\npip install -r requirements.txt\n```\n\n\n## Start Meshroom\n\nYou need to have [AliceVision](https://github.com/alicevision/AliceVision) installation in your PATH (and LD_LIBRARY_PATH on Linux/macOS).\n\n - __Launch the User Interface__\n\n```bash\n# Windows\nset PYTHONPATH=%CD% \u0026\u0026 python meshroom/ui\n# Linux/macOS\nPYTHONPATH=$PWD python meshroom/ui\n```\n\nOn Ubuntu, you may have conflicts between native drivers and mesa drivers. In that case, you need to force usage of native drivers by adding them to the LD_LIBRARY_PATH:\n`LD_LIBRARY_PATH=/usr/lib/nvidia-340 PYTHONPATH=$PWD python meshroom/ui`\nYou may need to adjust the folder `/usr/lib/nvidia-340` with the correct driver version.\n\n - __Launch a 3D reconstruction in command line__\n\n```bash\n# Windows: set PYTHONPATH=%CD% \u0026\u0026\n# Linux/macOS: PYTHONPATH=$PWD\npython bin/meshroom_batch --input INPUT_IMAGES_FOLDER --output OUTPUT_FOLDER\n```\n\n## Start Meshroom without building AliceVision\n\nTo use Meshroom (ui) without building AliceVision\n*   Download a [release](https://github.com/alicevision/meshroom/releases)\n*   Checkout corresponding Meshroom (ui) version/tag to avoid versions incompatibilities\n*   `LD_LIBRARY_PATH=~/foo/Meshroom-2023.2.0/aliceVision/lib/ PATH=$PATH:~/foo/Meshroom-2023.2.0/aliceVision/bin/ PYTHONPATH=$PWD python3 meshroom/ui`\n\n## Start and Debug Meshroom in an IDE\n\nPyCharm Community is free IDE which can be used. To start and debug a project with that IDE,\nright-click on `Meshroom/ui/__main__.py` \u003e `Debug`, then `Edit Configuration`, in `Environment variables` : \n*   If you want to use aliceVision built by yourself add: `PATH=$PATH:/foo/build/Linux-x86_64/`\n*   If you want to use aliceVision release add: `LD_LIBRARY_PATH=/foo/Meshroom-2023.2.0/aliceVision/lib/;PATH=$PATH:/foo/Meshroom-2023.2.0/aliceVision/bin/` (Make sure that you are on the branch matching the right version)\n\n![image](https://user-images.githubusercontent.com/937836/127321375-3bf78e73-569d-414a-8649-de0307adf794.png)\n\n\n## FAQ\n\nSee the [Meshroom wiki](https://github.com/alicevision/meshroom/wiki) for more information.\n\n\n## Contact\n\nUse the public mailing-list to ask questions or request features. It is also a good place for informal discussions like sharing results, interesting related technologies or publications:\n\u003e [alicevision@googlegroups.com](mailto:alicevision@googlegroups.com)\n\u003e [http://groups.google.com/group/alicevision](http://groups.google.com/group/alicevision)\n\nYou can also contact the core team privately on: [alicevision-team@googlegroups.com](mailto:alicevision-team@googlegroups.com).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falicevision%2Fmeshroom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falicevision%2Fmeshroom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falicevision%2Fmeshroom/lists"}