annotate README.md @ 4:31c97510b16b

README.md, demos/audio_trim_demo.py updated
author Amine Sehili <amine.sehili@gmail.com>
date Tue, 22 Sep 2015 11:12:11 +0200
parents 364eeb8e8bd2
children 78fae88dd98f
rev   line source
amine@2 1 AUDIo TOKenizer
amine@2 2 ===============
amine@2 3
amine@4 4 `auditok` is an **Audio Activity Detection** library that can 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@4 13 python setup.py install
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@3 18
amine@2 19 python demos/echo.py
amine@2 20
amine@2 21 `echo.py` accepts two arguments: energy threshold (default=45) and duration in seconds (default=10):
amine@2 22
amine@2 23 python demos/echo.py 50 15
amine@2 24
amine@4 25 If only one argument is given it will be used for energy.
amine@4 26
amine@4 27 Try out this demo with an audio file (no argument is required):
amine@4 28
amine@4 29 python demos/audio_tokenize_demo.py
amine@4 30
amine@4 31 Finally, this in this demo `auditok` is used to remove tailing and leading silence from an audio file:
amine@4 32
amine@4 33 python demos/audio_trim_demo.py
amine@2 34
amine@2 35 Documentation
amine@2 36 -------------
amine@2 37
amine@2 38 Check out a quick start and the API documentation [here](http://amsehili.github.io/auditok/pdoc/)
amine@2 39
amine@2 40 Contribution
amine@2 41 ------------
amine@2 42 Contributions are very appreciated !
amine@2 43
amine@2 44 License
amine@2 45 -------
amine@2 46 `auditok` is published under the GNU General Public License Version 3.
amine@2 47
amine@2 48 Author
amine@2 49 ------
amine@2 50 Amine Sehili (<amine.sehili@gmail.com>)