source: README @ d17f63e

feature/autosinkfeature/constantqfeature/pitchshiftfeature/pydocstringsfeature/timestretchpitchshiftsamplertimestretchyinfft+
Last change on this file since d17f63e was 96fb8ad, checked in by Paul Brossier <piem@altern.org>, 16 years ago

import 0.1.7.1

  • Property mode set to 100644
File size: 3.5 KB
Line 
1AUBIO LIBRARY
2
3Aubio is a library for real time audio labelling. It can segment a sound at
4each of its attacks, perform pitch detection and produce midi streams from live
5audio.
6
7Aubio is still in an alpha state. More to come soon, suggestions and feedback
8welcome.
9
10A few examples of applications are provided in examples/ and python/:
11 - aubioonset output the onset detected,
12 - aubionotes emits midi-like notes,
13 - aubiocuts is a python script that takes an input sound and creates one new
14   sample at each new onsettimes
15
16The first two can work either offline or online, outputing the results on the
17console or playing a woodblock sound at each detected onset.
18
19The name Aubio comes from 'audio' with a typo. It is likely to have many
20transcription errors in the results too!
21
22DEPENDANCIES
23
24This package depends on the following libraries and utils:
25  - automake1.7
26  - libsndfile1
27  - fftw3
28  - libsamplerate
29  - libjack (optional)
30  - libasound2 (optional)
31  - python, python-numarray (optional)
32  - swig (optional, for the python interface)
33
34BUILDING AUBIO
35
36The usual invocation `$ ./configure && make' should do the job. Read on the
37generic INSTALL file for more information.
38
39DEBIAN
40
41You could try the debian package (see http://piem.homeip.net/~piem/debian/)
42
43On Debian you need the following packages to compile aubio: automake
44libsndfile1-dev libjack-dev fftw3-dev libsamplerate0-dev python python-dev
45python-numarray swig
46
47OTHER PLATFORMS
48
49Support has never been tested for Windows or MacOsX. It _could_ work with
50$ ./configure --enable-alsa=no --enable-jack=no
51Again, untested. Feedback and patches welcome.
52
53STATUS
54
55The shared library libaubio provides the following tools:
56  - various maths tools
57  - phase vocoder
58  - up/downsampling
59  - filtering (n pole/zero pairs)
60  - onset detection functions
61  - onset peak picking
62  - multicomb-filtering pitchdetection
63  - transient/steady-state separation
64  - alsa midi and jack input outputs
65
66A swig wrapper is provided in swig/. For now, I have only been playing with the
67python interface. But there is much overlap with projects such as pyjack and
68numeric. To be continued...
69
70`Make it run, make it right, make it fast.' [1] Aubio is in the "Make it right"
71process: almost no optimisation has been done to the code, and its speed could
72be much improved. The pitch detection is especially slow.
73
74[1] see http://c2.com/cgi/wiki?MakeItWorkMakeItRightMakeItFast
75
76EXTEND
77
78The C API is designed in the following old school way:
79
80    void del_aubio_thing(aubio_thing_t * t);
81    aubio_thing_t * new_aubio_thing(void * args);
82    audio_thing_methods(aubio_thing_t * t, void * args);
83
84Memory allocation or freeing should never take place in these _methods, and
85should all be bound to the new_ and del_ methods. Also most gcc warning flags
86are turned on, so functions must be prototyped and variables used.
87
88CONTACT
89
90This project is a demo program for my research project. It can be found online
91at http://piem.homeip.net/~piem/aubio/. I have been writting about the results
92obtained with aubio in the following papers (that are about to be published!):
93 
94  P. M. Brossier and J. P. Bello and M. D. Plumbley, Real-time temporal
95  segmentation of note objects in music signals, Proceedings of the
96  International Computer Music Conference, 2004, Miami, Florida, ICMA
97
98  P. M. Brossier and J. P. Bello and M. D. Plumbley, Fast labelling of note
99  objects in music signals, Proceedings of the International Symposium on Music
100  Information Retrieval, 2004, Barcelona, Spain
101
102Feel free to drop me a comment at piem@altern.org.
Note: See TracBrowser for help on using the repository browser.