comparison doc/installation.rst @ 377:c6308873f239

Improve documentation, add more examples
author Amine Sehili <amine.sehili@gmail.com>
date Wed, 17 Feb 2021 21:18:05 +0100
parents 0106c4799906
children 81bc2375354f
comparison
equal deleted inserted replaced
376:d83cba0f8072 377:c6308873f239
1 Installation 1 Installation
2 ------------ 2 ------------
3
4 .. code:: bash
5
6 pip install auditok
7
8 3
9 A basic version of ``auditok`` will run with standard Python (>=3.4). However, 4 A basic version of ``auditok`` will run with standard Python (>=3.4). However,
10 without installing additional dependencies, ``auditok`` can only deal with audio 5 without installing additional dependencies, ``auditok`` can only deal with audio
11 files in *wav* or *raw* formats. if you want more features, the following 6 files in *wav* or *raw* formats. if you want more features, the following
12 packages are needed: 7 packages are needed:
13 8
14 - `pydub <https://github.com/jiaaro/pydub>`_ : read audio files in popular 9 - `pydub <https://github.com/jiaaro/pydub>`_ : read audio files in popular audio formats (ogg, mp3, etc.) or extract audio from a video file.
15 audio formats (ogg, mp3, etc.) or extract audio from a video file. 10 - `pyaudio <https://people.csail.mit.edu/hubert/pyaudio>`_ : read audio data from the microphone and play audio back.
16 - `pyaudio <http://people.csail.mit.edu/hubert/pyaudio/>`_ : read audio data 11 - `tqdm <https://github.com/tqdm/tqdm>`_ : show progress bar while playing audio clips.
17 from the microphone and play back detections. 12 - `matplotlib <https://matplotlib.org/stable/index.html>`_ : plot audio signal and detections.
18 - `tqdm <https://github.com/tqdm/tqdm>`_ : show progress bar while playing 13 - `numpy <https://numpy.org/>`_ : required by matplotlib. Also used for some math operations instead of standard python if available.
19 audio clips. 14
20 - `matplotlib <http://matplotlib.org/>`_ : plot audio signal and detections. 15
21 - `numpy <http://www.numpy.org>`_ : required by matplotlib. Also used for 16 Install the latest stable version with pip:
22 some math operations instead of standard python if available. 17
18 .. code:: bash
19
20 sudo pip install auditok
21
22 Install with the latest development version from github:
23
24 .. code:: bash
25
26 pip install git+https://github.com/amsehili/auditok
27
28 or
29
30 .. code:: bash
31
32 git clone https://github.com/amsehili/auditok.git
33 cd auditok
34 python setup.py install