summaryrefslogtreecommitdiffstats
path: root/audio/listener/listener.rst
blob: 83ca3bd94a195ac19165dd14be9f9e306b8900ab (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
.. RST source for listener(1) man page. Convert with:
..   rst2man.py listener.rst > listener.1
.. rst2man.py comes from the SBo development/docutils package.

.. |version| replace:: 2.2
.. |date| date::

========
listener
========

------------------------------
listen for sound and record it
------------------------------

:Manual section: 1
:Manual group: SlackBuilds.org
:Date: |date|
:Version: |version|

SYNOPSIS
========

listener [*-options*]

DESCRIPTION
===========

Listener listens for sound. If it detects any, it starts recording
automatically and also automatically stops when things become silent
again.

OPTIONS
=======

Most options can be set in the config file.

-c<configfile>    Config file to use (default is **/etc/listener.conf**).

-l<detect_level>
                  Detect level.

-m<min_duration>
                  Minimum duration to record (samples).

-b<rec_silence>   How many seconds to keep recording after no sound is heard.

-x<max_duration>  Maximum duration to record (seconds).

-S<pars>          Sets the sample rate, number of channels, output file type, etc.
                  e.g.: **44100,1,wav**
                  or: **2,ima_adpcm,10khz**.
                  See below for a list of fileformats and subtypes.

-F                Use a fixed amplification factor.

-o                Exit after 1 recording.

-w<wav_path>      Where to write outfile files.

-p                Read from pipe (together with splitaudio).

-y<command>       Script to call as soon as the recording starts.

-e<command>       Script to call after recording.

-f                Fork into the background.

-a<pidfile>       File to write the pid in.

-s                Be silent.

-h                Print help text and exit.

Supported file formats: wav, aiff, au, raw, paf, svx, nist, voc, ircam, w64, mat4, mat5, pvf, xi, htk, sds, avr, wavex, sd2, flac, caf, wve, ogg, mpc2k, rf64

Supported sub-types: pcm_s8, pcms8, pcm8, pcm_16, pcm16, pcm_24, pcm24, pcm_32, pcm32, pcm_u8, pcmu8, float, double, ulaw, alaw, ima_adpcm, ms_adpcm, gsm610, vox_adpcm, g721_32, g723_24, g723_40, dwvw_12, dwvw_16, dwvw_24, dwvw_n, dpcm_8, dpcm_16, vorbis

FILES
=====

/etc/listener.conf   The default config file (when **-c** not used).

.. ENVIRONMENT
.. ===========

.. EXIT STATUS
.. ===========

.. BUGS
.. ====

.. EXAMPLES
.. ========

COPYRIGHT
=========

See the file /usr/doc/listener-|version|/license.txt for license information.

AUTHORS
=======

listener was written by folkert@vanheusden.com.

This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.

SEE ALSO
========

The listener homepage: https://www.vanheusden.com/listener/