45 ordinarily waits until it can obtain access to the device.
46 When the -i option is present, audioplay prints an error
47 message and exits immediately if the device is busy.
48
49
50 -v vol
51 Volume: The output volume is set to the specified value
52 before playing begins, and is reset to its previous level
53 when audioplay exits. The vol argument is an integer value
54 between 0 and 100, inclusive. If this argument is not
55 specified, the output volume remains at the level most
56 recently set by any process.
57
58
59 -V
60 Verbose: Prints messages on the standard error when waiting
61 for access to the audio device or when sample rate
62 deviations are detected.
63
64
65 -\?
66 Help: Prints a command line usage message.
67
68
69 OPERANDS
70 file
71 File Specification: Audio files named on the command line are
72 played sequentially. If no filenames are present, the standard
73 input stream (if it is not a tty) is played (it, too, must
74 contain an audio file header). The special filename - can be
75 used to read the standard input stream instead of a file. If a
76 relative path name is supplied, the AUDIOPATH environment
77 variable is consulted (see below).
78
79
80 USAGE
81 See largefile(5) for the description of the behavior of audioplay when
82 encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
83
84 ENVIRONMENT VARIABLES
85 AUDIODEV
86 The full path name of the audio device to write to, if no
87 -d argument is supplied. If the AUDIODEV variable is not
88 set, /dev/audio is used.
89
90
91 AUDIOPATH
92 A colon-separated list of directories in which to search
93 for audio files whose names are given by relative
94 pathnames. The current directory (.) can be specified
95 explicitly in the search path. If the AUDIOPATH variable
96 is not set, only the current directory is searched.
97
98
99 ATTRIBUTES
100 See attributes(5) for descriptions of the following attributes:
101
102
103
104
105 +--------------------+-----------------+
106 | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
107 +--------------------+-----------------+
108 |Architecture | SPARC, x86 |
109 +--------------------+-----------------+
110 |Interface Stability | Committed |
111 +--------------------+-----------------+
112
113 SEE ALSO
114 audioconvert(1), audiorecord(1), attributes(5), largefile(5), audio(7I)
115
116 BUGS
117 audioplay currently supports a limited set of audio format conversions.
118 If the audio file is not in a format supported by the audio device, it
119 must first be converted. For example, to convert to voice format on the
120 fly, use the command:
121
122 example% audioconvert -f voice myfile | audioplay
123
124
125
126
127 The format conversion is not always be able to keep up with the audio
128 output. If this is the case, you should convert to a temporary file
129 before playing the data.
130
131
132
133 May 13, 2017 AUDIOPLAY(1)
|
45 ordinarily waits until it can obtain access to the device.
46 When the -i option is present, audioplay prints an error
47 message and exits immediately if the device is busy.
48
49
50 -v vol
51 Volume: The output volume is set to the specified value
52 before playing begins, and is reset to its previous level
53 when audioplay exits. The vol argument is an integer value
54 between 0 and 100, inclusive. If this argument is not
55 specified, the output volume remains at the level most
56 recently set by any process.
57
58
59 -V
60 Verbose: Prints messages on the standard error when waiting
61 for access to the audio device or when sample rate
62 deviations are detected.
63
64
65 -?
66 Help: Prints a command line usage message.
67
68
69 OPERANDS
70 file
71 File Specification: Audio files named on the command line are
72 played sequentially. If no filenames are present, the standard
73 input stream (if it is not a tty) is played (it, too, must
74 contain an audio file header). The special filename - can be
75 used to read the standard input stream instead of a file. If a
76 relative path name is supplied, the AUDIOPATH environment
77 variable is consulted (see below).
78
79
80 USAGE
81 See largefile(5) for the description of the behavior of audioplay when
82 encountering files greater than or equal to 2 Gbyte (2^31 bytes).
83
84 ENVIRONMENT VARIABLES
85 AUDIODEV
86 The full path name of the audio device to write to, if no
87 -d argument is supplied. If the AUDIODEV variable is not
88 set, /dev/audio is used.
89
90
91 AUDIOPATH
92 A colon-separated list of directories in which to search
93 for audio files whose names are given by relative
94 pathnames. The current directory (.) can be specified
95 explicitly in the search path. If the AUDIOPATH variable
96 is not set, only the current directory is searched.
97
98
99 SEE ALSO
100 audioconvert(1), audiorecord(1), largefile(5), audio(7I)
101
102 BUGS
103 audioplay currently supports a limited set of audio format conversions.
104 If the audio file is not in a format supported by the audio device, it
105 must first be converted. For example, to convert to voice format on the
106 fly, use the command:
107
108 example% audioconvert -f voice myfile | audioplay
109
110
111
112
113 The format conversion is not always be able to keep up with the audio
114 output. If this is the case, you should convert to a temporary file
115 before playing the data.
116
117
118
119 February 8, 2020 AUDIOPLAY(1)
|