annotate README.md @ 2:edee860b9f61

First release on Github
author Amine Sehili <amine.sehili@gmail.com>
date Thu, 17 Sep 2015 22:01:30 +0200
parents
children 364eeb8e8bd2
rev   line source
amine@2 1 AUDIo TOKenizer
amine@2 2 ===============
amine@2 3
amine@2 4 `auditok` is an Audio Activity Detection library that wan be used with online data (i.e. microphone) or with audio files.
amine@2 5
amine@2 6 Requirements
amine@2 7 ------------
amine@2 8 `auditok` uses [PyAudio](http://people.csail.mit.edu/hubert/pyaudio/) for audio acquisition and playback.
amine@2 9 If installed, numpy will be privileged for math operations on vectors.
amine@2 10
amine@2 11 Installation
amine@2 12 ------------
amine@2 13 pip install auditok
amine@2 14
amine@2 15 Demos
amine@2 16 -----
amine@2 17 This code reads data from the microphone and plays back whatever it detects.
amine@2 18 python demos/echo.py
amine@2 19
amine@2 20 `echo.py` accepts two arguments: energy threshold (default=45) and duration in seconds (default=10):
amine@2 21
amine@2 22 python demos/echo.py 50 15
amine@2 23
amine@2 24 If only one argument is given it will be used for energy. Other demos are in /demos.
amine@2 25
amine@2 26 Documentation
amine@2 27 -------------
amine@2 28
amine@2 29 Check out a quick start and the API documentation [here](http://amsehili.github.io/auditok/pdoc/)
amine@2 30
amine@2 31 Contribution
amine@2 32 ------------
amine@2 33 Contributions are very appreciated !
amine@2 34
amine@2 35 License
amine@2 36 -------
amine@2 37 `auditok` is published under the GNU General Public License Version 3.
amine@2 38
amine@2 39 Author
amine@2 40 ------
amine@2 41 Amine Sehili (<amine.sehili@gmail.com>)
amine@2 42