doc/index.rst

   1 Welcome
   2 =======
   3
   4 aubio is a collection of algorithms and tools to label and transform music and
   5 sounds. It scans or `listens` to audio signals and attempts to detect musical
   6 events. For instance, when a drum is hit, at which frequency is a note, or at
   7 what tempo is a rhythmic melody.
   8
   9 aubio features include segmenting a sound file before each of its attacks,
  10 performing pitch detection, tapping the beat and producing midi streams from
  11 live audio.
  12
  13 Quick links
  14 ===========
  15
  16 * :ref:`python`
  17 * :ref:`manpages`
  18 * :ref:`develop`
  19 * :ref:`building`
  20
  21 .. only:: devel
  22
  23     .. include:: statuslinks.rst
  24
  25 Project pages
  26 =============
  27
  28 * `Project homepage`_: https://aubio.org
  29 * `aubio on github`_: https://github.com/aubio/aubio
  30 * `aubio on pypi`_: https://pypi.python.org/pypi/aubio
  31 * `Doxygen documentation`_: https://aubio.org/doc/latest/
  32 * `Mailing lists`_: https://lists.aubio.org
  33
  34 .. _Project homepage: https://aubio.org
  35 .. _aubio on github: https://github.com/aubio/aubio
  36 .. _aubio on pypi: https://pypi.python.org/pypi/aubio
  37 .. _Doxygen documentation: https://aubio.org/doc/latest/
  38 .. _Mailing lists: https://lists.aubio.org/
  39
  40 * `Travis Continuous integration page <https://travis-ci.org/aubio/aubio>`_
  41 * `Appveyor Continuous integration page <https://ci.appveyor.com/project/piem/aubio>`_
  42 * `Landscape python code validation <https://landscape.io/github/aubio/aubio/master>`_
  43 * `ReadTheDocs documentation <https://aubio.readthedocs.io/en/latest/>`_
  44
  45 Features
  46 ========
  47
  48 aubio provides several algorithms and routines, including:
  49
  50 - several onset detection methods
  51 - different pitch detection methods
  52 - tempo tracking and beat detection
  53 - MFCC (mel-frequency cepstrum coefficients)
  54 - FFT and phase vocoder
  55 - up/down-sampling
  56 - digital filters (low pass, high pass, and more)
  57 - spectral filtering
  58 - transient/steady-state separation
  59 - sound file read and write access
  60 - various mathematics utilities for music applications
  61
  62 The name aubio comes from *audio* with a typo: some errors are likely to be
  63 found in the results.
  64
  65 Copyright
  66 =========
  67
  68 Copyright © 2003-2016 Paul Brossier <piem@aubio.org>
  69
  70 License
  71 =======
  72
  73 aubio is a `free <http://www.debian.org/intro/free>`_ and `open source
  74 <http://www.opensource.org/docs/definition.php>`_ software; **you** can
  75 redistribute it and/or modify it under the terms of the `GNU
  76 <https://www.gnu.org/>`_ `General Public License
  77 <https://www.gnu.org/licenses/gpl.html>`_ as published by the `Free Software
  78 Foundation <https://fsf.org>`_, either version 3 of the License, or (at your
  79 option) any later version.
  80
  81 .. note::
  82
  83    aubio is not MIT or BSD licensed. Contact the author if you need it in your
  84    commercial product.
  85
  86 Content
  87 =======
  88
  89 .. toctree::
  90    :maxdepth: 2
  91
  92    installing
  93    python_module
  94    cli
  95    develop