The Meson Build System
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Dylan Baker dff40ca259 environment: Pass defines to clang based ObjC[++] compilers 5 days ago
.github Add a test run in an environment which only has a cross compiler 2 weeks ago
ci Add a test run of MSVC ARM64 cross on Windows x64 2 weeks ago
cross Rename [properties] to [built-in options] 1 week ago
data test: Add 'dir' support for installed files in test.json 1 month ago
docs docs: Clarify what literal strings mean [skip ci] 6 days ago
graphics New logo and license text. Closes #4921. [skip ci] 1 year ago
man Bump version number for RC1. 2 months ago
manual tests Interpreter: Fix c_stdlib usage 1 month ago
mesonbuild environment: Pass defines to clang based ObjC[++] compilers 2 days ago
msi mdata: remove setuptools and use mesondata instead 2 months ago
test cases project tests: Verify that UWP cross binaries use the right arch 1 week ago
tools typing: fix code review 2 weeks ago
.coveragerc Enable code coverage on Travis. 3 years ago
.editorconfig Add a json schema for the test.json used in tests 5 months ago
.flake8 add missing commas 1 year ago
.gitattributes Fix crlf line endings 1 year ago
.gitignore Make virtualenv inside the project work 2 months ago
.mailmap mailmap: add couple of aliases 3 years ago
.mypy.ini typing: use follow_imports = silent 2 weeks ago
.pylintrc pylint: turn on a few more errors 4 days ago
.travis.yml ci: run some builders with response file threshold set to zero 3 months ago
CODEOWNERS CODEOWNERS: add dcbaker for compilers and linkers [skip ci] 1 week ago
COPYING Start of project. 7 years ago update 5 months ago fix ninja version inconsistent 5 months ago Fix for zipapp to work 2 years ago
azure-pipelines.yml CI: don't update MSYS2 [skip ci] 1 week ago Readme fixes. [skip ci] 1 year ago Add ability to specify project branch to install 8 months ago
lgtm.yml ci: lgtm: configure for Python 3 10 months ago sys.path requires str, not pathlib.Path 2 years ago
pyproject.toml Ensure setuptools via PEP508/518 pyproject.toml 10 months ago Add build machine compilers to project tests compiler report 2 weeks ago Fix setuptools 49 test. (fixes #7452) 2 months ago compilers/objcpp: add type annotations 2 days ago project tests: Also check whether introspect works 1 week ago compilers/mixins/clike: fix mypy issues 2 days ago compilers/mixins/clike: fix mypy issues 2 days ago
setup.cfg setup.cfg: Mark setuptools as required 5 months ago mdata: remove setuptools and use mesondata instead 2 months ago
sider.yml add pylint config file. update Sider CI name 1 year ago Add an azure-pipelines.yml 1 year ago

Meson® is a project to create the best possible next-generation build system.


Build Status
Code Quality: Python
Total Alerts


  • Python (version 3.5 or newer)
  • Ninja (version 1.7 or newer)

Installing from source

Meson is available on PyPi, so
it can be installed with pip3 install meson. The exact command to
type to install with pip can vary between systems, be sure to use
the Python 3 version of pip.

If you wish you can install it locally with the standard Python command:

python3 -m pip install meson

For builds using Ninja, Ninja can be downloaded directly from Ninja
GitHub release page
or via PyPi

python3 -m pip install ninja

More on Installing Meson build can be found at the
getting meson page.


Meson requires that you have a source directory and a build directory
and that these two are different. In your source root must exist a
file called To generate the build system run this

meson setup <source directory> <build directory>

Depending on how you obtained Meson the command might also be called instead of plain meson. In the rest of this document we
are going to use the latter form.

You can omit either of the two directories, and Meson will substitute
the current directory and autodetect what you mean. This allows you to
do things like this:

cd <source root>
meson setup builddir

To compile, cd into your build directory and type ninja. To run unit
tests, type ninja test.

More on running Meson build system commands can be found at the
running meson page
or by typing meson --help.


We love code contributions. See the contribution
on the website for


The irc channel for Meson is #mesonbuild over at Freenode.

You can use FreeNode’s official webchat
to connect to this channel.

Further info

More information about the Meson build system can be found at the
project’s home page.

Meson is a registered trademark of Jussi Pakkanen.