ref: d1b78dc51e3abe868d109fb6ca9ed6532b711982
dir: /doc/installing.rst/
Installing aubio
================
aubio runs on Linux, Windows, macOS, iOS, Android, and probably a few others
operating systems.
Aubio is available as a C library and as a python module.
Cheat sheet
-----------
- :ref:`get aubio latest source code <building>`::
    # official repo
    git clone https://git.aubio.org/aubio/aubio
    # mirror
    git clone https://github.com/aubio/aubio
    # latest release
    wget https://aubio.org/pub/aubio-<version>.tar.gz
- :ref:`build aubio from source <building>`::
    # 1. simple
    cd aubio
    make
    # 2. step by step
    ./scripts/get_waf.sh
    ./waf configure
    ./waf build
    sudo ./waf install
- :ref:`install python-aubio from source <python>`::
    # from git
    pip install git+https://git.aubio.org/aubio/aubio/
    # mirror
    pip install git+https://github.com/aubio/aubio/
    # from latest release
    pip install https://aubio.org/pub/aubio-latest.tar.bz2
    # from pypi
    pip install aubio
    # from source directory
    cd aubio
    pip install -v .
- :ref:`install python-aubio from a pre-compiled binary <python>`::
      # conda [osx, linux, win]
      conda install -c conda-forge aubio
      # .deb (debian, ubuntu) [linux]
      sudo apt-get install python3-aubio python-aubio aubio-tools
      # brew [osx]
      brew install aubio --with-python
- :ref:`get a pre-compiled version of libaubio <download>`::
    # .deb (linux) WARNING: old version
    sudo apt-get install aubio-tools
    # python module
    ./setup.py install
    # using pip
    pip install .
- :ref:`check the list of optional dependencies <requirements>`::
    # debian / ubuntu
    dpkg -l libavcodec-dev libavutil-dev libavformat-dev \
            libswresample-dev libavresample-dev \
            libsamplerate-dev libsndfile-dev \
            txt2man doxygen
.. include:: download.rst
.. include:: building.rst
.. include:: requirements.rst