# HG changeset patch # User Amine Sehili # Date 1449101421 -3600 # Node ID 755ff17eb2bf172b1944f06b43e3b51f86ee223b # Parent 816b6278c4f400ab0c419d16bafe28df1fb72459 update doc diff -r 816b6278c4f4 -r 755ff17eb2bf README.rst --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README.rst Thu Dec 03 01:10:21 2015 +0100 @@ -0,0 +1,48 @@ +auditok, an AUDIo TOKenization tool +=================================== + +.. image:: https://travis-ci.org/amsehili/auditok.svg?branch=master + :target: https://travis-ci.org/amsehili/auditok + +.. image:: https://readthedocs.org/projects/auditok/badge/?version=latest + :target: http://auditok.readthedocs.org/en/latest/?badge=latest + :alt: Documentation Status + +**auditok** is an **Audio Activity Detection** tool that can process online data (read from an audio device or from standard input) as well as audio files. It can be used as a command line program and offers an easy to use API. + +The latest version of this documentation can be found at `Readthedocs `_. + +Requirements +------------ + +`auditok` can be used with standard Python! + +However if you want more features, the following packages are needed: + +- `Pydub `_ : read audio files of popular audio formats (ogg, mp3, etc.) or extract audio from a video file + +- `PyAudio `_ : read audio data from the microphone and play back detections + +- `matplotlib `_ : plot audio signal and detections (see figures above) + +- `numpy `_ : required by matplotlib. Also used for math operations instead of standard python if available + +- Optionally, you can use **sox** or **parecord** for data acquisition and feed **auditok** using a pipe. + +Installation +------------ + +.. code:: bash + + git clone https://github.com/amsehili/auditok.git + cd auditok + sudo python setup.py install + + + +Getting started +--------------- + +- `Command-line Usage Guide `_ +- `API Tutorial `_ +- `API Reference `_ \ No newline at end of file diff -r 816b6278c4f4 -r 755ff17eb2bf doc/index.rst --- a/doc/index.rst Wed Dec 02 23:41:45 2015 +0100 +++ b/doc/index.rst Thu Dec 03 01:10:21 2015 +0100 @@ -17,7 +17,7 @@ `auditok` can be used with standard Python! -However if you want more features, the following packages are needed: +However, if you want more features, the following packages are needed: - `Pydub `_ : read audio files of popular audio formats (ogg, mp3, etc.) or extract audio from a video file