amine@2: AUDIo TOKenizer
amine@2: ===============
amine@2: 
amine@4: `auditok` is an **Audio Activity Detection** library that can be used with online data (i.e. microphone) or with audio files.
amine@2: 
amine@2: Requirements
amine@2: ------------
amine@2: `auditok` uses [PyAudio](http://people.csail.mit.edu/hubert/pyaudio/) for audio acquisition and playback.
amine@2: If installed, numpy  will be privileged for math operations on vectors.
amine@2: 
amine@2: Installation
amine@2: ------------
amine@4:     python setup.py install
amine@2: 
amine@2: Demos
amine@2: -----
amine@2: This code reads data from the microphone and plays back whatever it detects.
amine@3: 
amine@2:     python demos/echo.py
amine@2: 
amine@2: `echo.py` accepts two arguments: energy threshold (default=45) and duration in seconds (default=10):
amine@2: 
amine@2:     python demos/echo.py 50 15
amine@2: 
amine@4:    If only one argument is given it will be used for energy.
amine@4:    
amine@4: Try out this demo with an audio file (no argument is required):
amine@4: 
amine@4:     python demos/audio_tokenize_demo.py
amine@4: 
amsehili@6: Finally, in this demo `auditok` is used to remove tailing and leading silence from an audio file:
amine@4: 
amine@4:     python demos/audio_trim_demo.py
amine@2: 
amine@2: Documentation
amine@2: -------------
amine@2: 
amsehili@6: Check out this [quick start](https://github.com/amsehili/auditok/blob/master/quickstart.rst) or the  [API documentation](http://amsehili.github.io/auditok/pdoc/).
amsehili@6: 
amine@2: 
amine@2: Contribution
amine@2: ------------
amine@2: Contributions are very appreciated !
amine@2: 
amine@2: License
amine@2: -------
amine@2: `auditok` is published under the GNU General Public License Version 3.
amine@2: 
amine@2: Author
amine@2: ------
amine@2: Amine Sehili (<amine.sehili@gmail.com>)