Mercurial > hg > auditok
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>) |