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