FreeBSD Manual Pages
ossrecord(1) User Commands ossrecord(1) NAME ossrecord - Open Sound System recording program. SYNOPSIS ossrecord? [-ORhlv?] [-F? cntname? | ? ] [ -c? channels? ] [ -d? devname? ] [ -f? fmtname?? | ? ] [ -g? gain?? ] [ -i? recsource?? | ? ] [ -m? nfiles?? ] [ -r? command? ] [ -s? rate?? ] [ -t? maxsecs?? ] filename?? | - ... DESCRIPTION The? ossrecord? program? records? audio? in? Microsoft? RIFF? (wav?) format?. It? will? record? from? any? input? that?'s? currently? set? as? the? recording? source? by? the? ossxmix?/ossmix? mixer? pro- grams?. With? the? -l? option?, you? also? get? a? level? meter? that? will? display? VU? levels? in? a? character? mode?. The? filename?? parameter? is? name? of? the? (.wav?) file? to? be? produced?. Output? can? be? sent? to? stdout? by? giving? - as? the? file? name?. OPTIONS -s?<rate??> Select? the? recording? rate?? for? raw? PCM? audio? (eg? -s48000?). -c?<channels?> Select? the? number? of? channels? 1?=mono? 2?=stereo?, 4?, 6?, 8?, etc?. -d?<devname?> Select? <devname?> as? the? device? (eg? -d?/dev?/dsp2?). -f?<fmt?> Select? the? input? sample? format? (eg? -fS32_LE? or? -fMU_LAW?) -f?? Prints? the? list? of? supported? format? names?. -F?<cnt?> Select? the? container? format? (eg? WAV? or? AU?). Default? is? WAV?. -F?? Prints? the? list? of? supported? container? formats?. -R? Open? audio? device? in? raw? mode? to? disable? virtual? mix- ing? and? sample? rate??/format? conversions?. Can? be? used? when? recording? from? a? digital? source? (S?/PDIF? input?). -v? Verbose? output?. -l? Display? level? meters? (character? based?). -i?<recsrc?|?> Select? the? recording? source? or? display? available? record- ing? sources? if? '?' is? supplied?. e.g?. ossrecord? -i?? may? display?: vol? line? (currently? selected?) mic? cd? aux1? phone? mono? video? -m?<nfiles??> Repeat? the? recording? operation? <nfiles??> times?. The? file- name?? argument? must? have? %d? (or? %02d?) somewhere? in? the? file? to? guarantee? unique? filenames?. If? no? %d? is? given? then? subsequent? recordings? will? overwrite? the? pre- vious? one??(s?). This? option? is? useful? only? with? loop- back? audio? devices? or? if? the? -t? option? is? used?. -r?<command?> This? option? launches? the? <command?> in? background? after? recording? the? file? has? completed?. The? name? of? the? recorded? file? will? be? given? as? the? (only?) command? line? argument?. When? the? -m? option? is? used? the? script? will? run? in? parallel? while? recording? the? next? file?. See? the? COMMAND? SCRIPT? section? (below?) for? more? info?. -g?<gain??> Amplify? recorded? samples? by? percentage? given? as? argu- ment?. 100? (default?) means? normal? signal? level?, 200? means? double? level?. Only? supported? in? 16? and? 32? bit? modes?. -t?<maxsecs??> Do? not? record? more? than? <maxsecs??> seconds? in? a? single? recording? operation?. -L?<level?> Set? the? recording? level? to? <level?>. -O? Do? not? allow? ossrecord? to? overwrite? the? output? file?. -h? Display? usage? instructions?. COMMAND SCRIPT The? -r? command? line? argument? makes? it? possible? to? execute? a? script? or? program? after? recording? of? the? wave? file? is? fin- ished?. Below? is? a? simple? scell? script? that? does? MP3? encod- ing? using? lame?. #!/bin?/sh? WAVENAME?=$1? MP3NAME?=$1.mp3? lame? -m? s? -h? --preset? studio? $WAVENAME? $MP3NAME? exit? 0? Another? example? script? for? ossrecord? is? a? simple? CGI? script? for? live? MP3? streaming? (from? /dev?/dsp?). #!/bin?/sh? echo? Content?-Type?: audio?/mp3? echo? ossrecord? -S? -b16? -s48? - | lame? -m? j? - - exit? 0? NOTES The? ossrecord? executable? is? the? same? as? the? ossplay? exe- cutable?. Behaviour? is? decided? by? the? name? used? to? invoke? the? program?. Some? file? formats? allocate? only? 32? bits? to? record? the? file? length?, which? may? prevent? some? programs? from? reading? a? too? large? file? properly?. If? a? recording? may? pass? the? 4GB? limit? (a? bit? more? then? 6? hours? and? 10? minutes? of? sound? assuming? [48Khz?/16bit?/stereo?] quality?), it?'s? best? to? have? ossrecord? use? the? AU? or? RAW? containers? (via? -F? switch?) which? do? not? have? this? restriction?. SEE ALSO ossplay?(1?), ossmix?(1?), ossxmix?(1?) FILES /usr?/local?/bin?/ossrecord? AUTHOR 4Front? Technologies? 11 June 2026 ossrecord(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | COMMAND SCRIPT | NOTES | SEE ALSO | FILES | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ossrecord&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>