summaryrefslogtreecommitdiff
path: root/doc/installing.rst
blob: 6629e3855677b2d52b96234ec95596a99debf242 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
.. highlight:: bash

Installing aubio
================

A number of distributions already include aubio. Check your favorite package
management system, or have a look at the `download page
<http://aubio.org/download>`_.

aubio uses `waf <https://waf.io/>`_ to configure, compile, and test the source.
A copy of ``waf`` is included along aubio, so all you need is a ``terminal``
and a recent ``python`` installed.

Source code
-----------

Check out the `download page <http://aubio.org/download>`_ for more options:
http://aubio.org/download.

The latest stable release can be found at http://aubio.org/pub/::

        $ curl -O http://aubio.org/pub/aubio-0.4.1.tar.bz2
        $ tar xf aubio-0.4.1.tar.bz2
        $ cd aubio-0.4.1

The latest develop branch can be obtained with::

        $ git clone git://git.aubio.org/git/aubio/ aubio-devel
        $ cd aubio-devel
        $ git fetch origin develop:develop
        $ git checkout develop

Compiling
---------

To compile the C library, examples programs, and tests, run::

        $ ./waf configure

Check out the available options using ``./waf configure --help | less``. Once
you are done with configuration, you can start building::

        $ ./waf build

To install the freshly built C library and tools, simply run the following
command::

        $ sudo ./waf install

Cleaning
--------

If you wish to uninstall the files installed by the ``install`` command, use
``uninstall``::

        $ sudo ./waf uninstall

To clean the source directory, use the ``clean`` command::

        $ ./waf clean

To also forget the options previously passed to the last ``./waf configure``
invocation, use the ``distclean`` command::

        $ ./waf distclean