Skip to content
3D Reconstruction Software
Python QML Other
Branch: develop
Clone or download
Latest commit bc1eb83 Nov 1, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github [github] added template for questions Sep 10, 2019
bin [bin] meshroom_photogrammetry: fix argument name Oct 22, 2019
docker [docker] update to Qt 5.13 Aug 7, 2019
docs/logo update meshroom logo, icon and banner Apr 21, 2018
meshroom Merge branch 'develop' into dev/imagesImport Nov 1, 2019
tests [tests] multiviewPipeline: add de/serialization testing Feb 1, 2019
.gitignore add build/tests folders to .gitignore Jun 8, 2018
.travis.yml Travis CI: Add Python 3.7 to the testing May 14, 2019 Add release notes for 2019.2 Aug 12, 2019
CMakeLists.txt [cmake] another workaround Aug 8, 2019 Create Aug 8, 2019 [doc] Minor fix to CONTRIBUTING Aug 16, 2019 [copying] add the obvious AliceVision dependency Feb 22, 2019
Dockerfile [docker] go back to cuda-7.0 for compatibility Aug 23, 2019
Dockerfile_py2 [docker] minor fix for python-2 Sep 9, 2019 [doc] INSTALL: add QtAliceVision Aug 12, 2019 Add License file Apr 23, 2018 [doc] readme: add link to manual Oct 24, 2019
appveyor.yml [ci][appVeyor] remove Python27 matrix Aug 3, 2018
dev_requirements.txt [build] fix cxFreeze version for Python 2.7 compatibility Sep 13, 2019
requirements.txt Merge branch 'develop' of into dev/stats Sep 10, 2019 [cxFreeze] bundle more context files Aug 21, 2019 [setup] init LD_LIBRARY_PATH in cx_Freeze Aug 8, 2018

Meshroom - 3D Reconstruction Software

CII Best Practices

Meshroom is a free, open-source 3D Reconstruction Software based on the AliceVision Photogrammetric Computer Vision framework.

Learn more details about the pipeline on AliceVision website.

See results of the pipeline on sketchfab.

Continuous integration:

  • Windows: Build status
  • Linux: Build Status


Photogrammetry is the science of making measurements from photographs. It infers the geometry of a scene from a set of unordered photographs or videos. Photography is the projection of a 3D scene onto a 2D plane, losing depth information. The goal of photogrammetry is to reverse this process.

See the presentation of the pipeline steps.



Overall presentation of the Meshroom software.

Detailed tutorial with a focus on the features of the 2019.1 release.

Overall presentation of the protogrammetry practice with Meshroom.

Overall presentation of the protogrammetry practice with Meshroom and detailed presentation how to do the retolopogy in Blender.

Presentation of the Meshroom software with a focus on using it for Match Moving.


The project is released under MPLv2, see

Get the project

See to setup the project and pre-requisites.

Get the source code and install runtime requirements:

git clone --recursive git://
cd meshroom
pip install -r requirements.txt

Start Meshroom

You need to have AliceVision installation in your PATH (and LD_LIBRARY_PATH on Linux/macOS).

  • Launch the User Interface
# Windows
set PYTHONPATH=%CD% && python meshroom/ui
# Linux/macOS
PYTHONPATH=$PWD python meshroom/ui

On 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: LD_LIBRARY_PATH=/usr/lib/nvidia-340 PYTHONPATH=$PWD python meshroom/ui You may need to adjust the folder /usr/lib/nvidia-340 with the correct driver version.

  • Launch a 3D reconstruction in command line
# Windows: set PYTHONPATH=%CD% &&
python bin/meshroom_photogrammetry --input INPUT_IMAGES_FOLDER --output OUTPUT_FOLDER


See the Meshroom wiki for more information.


Use 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:

You can also contact the core team privately on:

You can’t perform that action at this time.