Mercurial > hg > auditok
changeset 39:755ff17eb2bf
update doc
author | Amine Sehili <amine.sehili@gmail.com> |
---|---|
date | Thu, 03 Dec 2015 01:10:21 +0100 |
parents | 816b6278c4f4 |
children | 23dbe3bacdf7 |
files | README.rst doc/index.rst |
diffstat | 2 files changed, 49 insertions(+), 1 deletions(-) [+] |
line wrap: on
line diff
--- /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 <http://auditok.readthedocs.org/en/latest/>`_. + +Requirements +------------ + +`auditok` can be used with standard Python! + +However if you want more features, the following packages are needed: + +- `Pydub <https://github.com/jiaaro/pydub>`_ : read audio files of popular audio formats (ogg, mp3, etc.) or extract audio from a video file + +- `PyAudio <http://people.csail.mit.edu/hubert/pyaudio/>`_ : read audio data from the microphone and play back detections + +- `matplotlib <http://matplotlib.org/>`_ : plot audio signal and detections (see figures above) + +- `numpy <http://www.numpy.org>`_ : 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 <http://auditok.readthedocs.org/en/latest/cmdline.html>`_ +- `API Tutorial <http://auditok.readthedocs.org/en/latest/apitutorial.html>`_ +- `API Reference <http://auditok.readthedocs.org/en/latest/index.html>`_ \ No newline at end of file
--- 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 <https://github.com/jiaaro/pydub>`_ : read audio files of popular audio formats (ogg, mp3, etc.) or extract audio from a video file