1 AUDIORECORD(1) User Commands AUDIORECORD(1)
2
3
4
5 NAME
6 audiorecord - record an audio file
7
8 SYNOPSIS
9 audiorecord [-af] [-v vol] [-c channels] [-s rate]
10 [-e encoding] [-t time] [-i info] [-d dev]
11 [-T au | aif[f] | wav] [file[.au|.aif[f]]|.wav]
12
13
14 DESCRIPTION
15 The audiorecord utility copies audio data from the audio device to a
16 named audio file, or to the standard output if no filename is present.
17 If no output file is specified and standard output is a tty, the
18 program exits with an error message.
19
20
21 By default, monaural audio data is recorded at 8 kHz and encoded in
22 -law format. If the audio device supports additional configurations,
23 the -c, -s, and -e options may be used to specify the data format. The
24 output file is prefixed by an audio file header that identifies the
25 format of the data encoded in the file.
26
27
28 Recording begins immediately and continues until a SIGINT signal (for
29 example, Control-c) is received. If the -t option is specified,
30 audiorecord stops when the specified quantity of data has been
31 recorded.
32
33
34 If the audio device is unavailable, that is, if another process
35 currently has read access, audiorecord prints an error message and
36 exits immediately.
37
38 OPTIONS
39 The following options are supported:
40
41 -\?
42 Help: Prints a command line usage message.
43
44
45 -a
46 Append: Appends the data on the end of the
47 named audio file. The audio device must support
48 the audio data format of the existing file.
49
50
51 -c channels
52 Channels: Specifies the number of audio
53 channels (1 or 2). The value may be specified
54 as an integer or as the string mono or stereo.
55 The default value is mono.
56
57
58 -d dev
59 Device: The dev argument specifies an alternate
60 audio device from which input should be taken.
61 If the -d option is not specified, the AUDIODEV
107 -T au | aif[f] | wav
108 Specifies the audio file type to create. If the
109 -a option is used, the file type must match the
110 file to which it is being appended. Regardless
111 of the file suffix, the type is set as
112 specified in this option. If this option is not
113 specified, the file suffix determines the type.
114
115
116 -v vol
117 Volume: The recording gain is set to the
118 specified value before recording begins, and is
119 reset to its previous level when audiorecord
120 exits. The vol argument is an integer value
121 between 0 and 100, inclusive. If this argument
122 is not specified, the input volume remains at
123 the level most recently set by any process.
124
125
126 OPERANDS
127 file[.au|.aif[f]]|.wav
128
129 File Specification: The named audio file is rewritten, or appended.
130 If no filename is present, and standard output is not a tty, or if
131 the special filename "-" is specified, output is directed to the
132 standard output.
133
134 If the -T option is not specified, the file suffix determines the
135 type of file. If the suffix is not recognized, the default is .au.
136 If the -T option is specified, that file type is used regardless of
137 the file suffix.
138
139
140 USAGE
141 See largefile(5) for the description of the behavior of audiorecord
142 when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
143
144 ENVIRONMENT VARIABLES
145 AUDIODEV
146 The full path name of the audio device to record from, if
147 no -d argument is supplied. If the AUDIODEV variable is not
148 set, /dev/audio is used.
149
150
151 ATTRIBUTES
152 See attributes(5) for descriptions of the following attributes:
153
154
155
156
157 +--------------------+-----------------+
158 | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
159 +--------------------+-----------------+
160 |Architecture | SPARC, x86 |
161 +--------------------+-----------------+
162 |Interface Stability | Committed |
163 +--------------------+-----------------+
164
165 SEE ALSO
166 audioconvert(1), audioplay(1), attributes(5), largefile(5), audio(7I)
167
168
169
170 May 13, 2017 AUDIORECORD(1)
|
1 AUDIORECORD(1) User Commands AUDIORECORD(1)
2
3
4
5 NAME
6 audiorecord - record an audio file
7
8 SYNOPSIS
9 audiorecord [-af] [-v vol] [-c channels] [-s rate]
10 [-e encoding] [-t time] [-i info] [-d dev]
11 [-T au|aif[f]|wav] [file[.au|.aif[f]|.wav]]
12
13
14 DESCRIPTION
15 The audiorecord utility copies audio data from the audio device to a
16 named audio file, or to the standard output if no filename is present.
17 If no output file is specified and standard output is a tty, the
18 program exits with an error message.
19
20
21 By default, monaural audio data is recorded at 8 kHz and encoded in u-
22 law format. If the audio device supports additional configurations, the
23 -c, -s, and -e options may be used to specify the data format. The
24 output file is prefixed by an audio file header that identifies the
25 format of the data encoded in the file.
26
27
28 Recording begins immediately and continues until a SIGINT signal (for
29 example, Control-c) is received. If the -t option is specified,
30 audiorecord stops when the specified quantity of data has been
31 recorded.
32
33
34 If the audio device is unavailable, that is, if another process
35 currently has read access, audiorecord prints an error message and
36 exits immediately.
37
38 OPTIONS
39 The following options are supported:
40
41 -?
42 Help: Prints a command line usage message.
43
44
45 -a
46 Append: Appends the data on the end of the
47 named audio file. The audio device must support
48 the audio data format of the existing file.
49
50
51 -c channels
52 Channels: Specifies the number of audio
53 channels (1 or 2). The value may be specified
54 as an integer or as the string mono or stereo.
55 The default value is mono.
56
57
58 -d dev
59 Device: The dev argument specifies an alternate
60 audio device from which input should be taken.
61 If the -d option is not specified, the AUDIODEV
107 -T au | aif[f] | wav
108 Specifies the audio file type to create. If the
109 -a option is used, the file type must match the
110 file to which it is being appended. Regardless
111 of the file suffix, the type is set as
112 specified in this option. If this option is not
113 specified, the file suffix determines the type.
114
115
116 -v vol
117 Volume: The recording gain is set to the
118 specified value before recording begins, and is
119 reset to its previous level when audiorecord
120 exits. The vol argument is an integer value
121 between 0 and 100, inclusive. If this argument
122 is not specified, the input volume remains at
123 the level most recently set by any process.
124
125
126 OPERANDS
127 file[.au|.aif[f]|.wav]
128
129 File Specification: The named audio file is rewritten, or appended.
130 If no filename is present, and standard output is not a tty, or if
131 the special filename "-" is specified, output is directed to the
132 standard output.
133
134 If the -T option is not specified, the file suffix determines the
135 type of file. If the suffix is not recognized, the default is .au.
136 If the -T option is specified, that file type is used regardless of
137 the file suffix.
138
139
140 USAGE
141 See largefile(5) for the description of the behavior of audiorecord
142 when encountering files greater than or equal to 2 Gbyte (2^31 bytes).
143
144 ENVIRONMENT VARIABLES
145 AUDIODEV
146 The full path name of the audio device to record from, if
147 no -d argument is supplied. If the AUDIODEV variable is not
148 set, /dev/audio is used.
149
150
151 SEE ALSO
152 audioconvert(1), audioplay(1), largefile(5), audio(7I)
153
154
155
156 February 8, 2020 AUDIORECORD(1)
|