lavrec accepts the following options:
filename
The file to record to (*.avi, *.qt). Use a % to record to multiple files (using file%02d.avi will
record to file00.avi, file01.avi, etc). You can also give more than one filename, which will have
the same effect. This will avoid problems resulting from filetype or filesystem size limits. AVI,
for example, has a 2 GB limit, as does ext2fs in 2.2.x kernels.
--software-encoding
By default, lavrec will capture in a mode that is only suitable for recording from hardware MJPEG
devices. Using this option will make lavrec use software-JPEG-encoding (using libjpeg) which
enables MJPEG-video-capture from many generic video4linux devices (such as Bt848/Bt878-based
ones).
--software-encoding-yuvp
This option adds support for the EM28XX USB driver. As this driver is V4L2. As the original BTTV
software implementation assumes that the driver supports V4L it will not work with the EM28XX
driver, not even with the V4L1 emulation layer. This option enables two things:
It enables the V4L2 calls to make interaction with this driver possible
It select the cards YUV Packed format and converts this in software to YUV Planar The process
is after this the same as for the BTTV driver. ome things of note are the fact that the EM28XX
driver expects 48KHz audio recording. If you choose slower things will work, but a lot of
deleted/inserted frames will occur. The lower the sample rate, the worse this problem gets.
Recording at 48KHz is therefore recommended. This code was tested and found working with a
DVC100 Pinnacle Dazzle. This option should work with any EM28XX, but this hasnt been tested. It
might work for any other V4L2 device that outputs YUV packed format, this has however not been
tested. Feedback would be appreciated.
-f/--format [a|A|q|m]
The format in which the video should be saved to the harddisk.
a - MJPEG AVI
A - MJPEG AVI with fields exchanged
q - Quicktime
By default, lavrec will look at the extension of the first file (*.avi, *.qt) and choose a format
based on that.
-i/--input [p|P|n|N|s|S|t|T|f|a]
or
-i/--input input[:norm]
The recording source and the video source standard format.
p - PAL through Composite or 1st Bt8x8 input
P - PAL through SVHS- or 2nd Bt8x8 input
t - PAL through TV-tuner- or 3rd Bt8x8 input
n - NTSC through Composite or 1st Bt8x8 input
N - NTSC through SVHS- or 2nd Bt8x8 input
T - NTSC through TV-tuner- or 3rd Bt8x8 input
s - SECAM through Composite or 1st Bt8x8 input
S - SECAM through SVHS- or 2nd Bt8x8 input
f - SECAM through TV-tuner- or 3rd Bt8x8 input
a - (or every other letter) Autosense (default)
The input can be specified using either single letters or an input number with an optional norm,
where the number specifies the n'th input of the card, ranging from 1 to 10. Using a numerical
input is necessary when using input four or higher with a card that has more than three inputs,
for instance the AverMedia 6 Eyes. When using numeric input with the norm it must contain the
whole norm name; valid names are pal, ntsc and secam. You can use numeric input selection for
cards with only three inputs, too, which most Zoran based cards has. "-i 2:pal" used with a Buz
would be equivalent to "-i P", recording from the S-Video input in PAL format.
-d/--decimationnum
Recording decimation, either 1, 2 or 4. This will decimate the size of the recorded video
horizontally and vertically. To use different horizontal and vertical decimations, use two
numbers, the first one being the horizontal and the second one being the vertical (-d 12). Note:
this option can only be used during hardware recording.
-g/--geometryWxH(+X+Y)Forhardwarerecording: An X-style geometry string, giving the geometry of the undecimated
subframe to record. The default is the full frame, so 720x576/480+0+0 for Buz/LML33-users and
640x480+0+0 or 768x576+0+0 for DC10(+)-users. Forsoftwarerecording: The size of the video to
be captured. Currently, width and height need to be a multiple of 16. You always capture the
full frame since most video4linux devices don´t support subframe capture.
-q/--qualitynum
Quality of the JPEG-video to be recorded (in percent). This must be a number between 0 and 100.
Lower quality should generally mean lower filesize, higher quality will take more diskspace but
will give more detailed perfectness in the resulting recorded video. Default is 50%.
-C/--channelLIST:CHAN
Choose the channel to record from (xawtv-style). By default, lavrec will just use the current TV
channel.
-t/--timenum
Recording time in seconds. The default is unlimited. To stop capturing video while recording, use
Ctrl-C.
-S/--single-frame
Single-frame capture mode. This means that one can capture individual frames from the capture
device.
-T/--time-lapsenum
time-lapse factor, which means that only every <num>th frame is saved to the recording file.
-w/--wait
If this option is given, lavrec will wait for the user to press enter before starting to record.
-B/--batch
This option turns off all possible interactivity options and limits console output as much as
possible. Useful for cron/scheduled recordings.
-a/--audio-bitsizenum
Audio size in bits, either 0, 8 or 16 (default). 0 means no audio.
-r/--audio-bitratenum
Audio sampling rate in Hz. This must be a sampling rate which is supported by the soundcard.
Often-supported audio sampling rate values are 11025, 22050 or 44100 (default).
-s/--stereo
Capture in stereo. By default, lavrec captures in mono.
-l/--audio-volumenum
Recording level. This must be a value between 0 (no sound) and 100 (loud recording). -1 (default)
means to not touch the mixer settings at all.
-m/--mute
Mute sound output while recording. This can be useful when recording sound from the microphone to
disable echos. This option is disabled by default.
-R/--audio-source [l|m|c]
Recording source, either (l)ine-in, (m)icrophone or (c)d-rom. The default is to record from line-
in (l).
-U/--use-read
Use the read() system call rather than the mmap() system call for audio recording. This may fix
many audio recording problems.
-c/--synchronization [0|1|2]
Audio/video synchronization level efforts. (0) means no synchronization, (1) means that lavrec
will replicate frames for lost frames. (2) means that lavrec will replicate frames for lost
frames and do sync correction. Default is 2.
-n/--mjpeg-buffersnum
Number of MJPEG-buffers. Default is 32. Try changing this number if you have many lost frames.
-b/--mjpeg-buffer-sizenum
MJPEG buffersize in kilobytes. The default is 256 kB.
--max-file-sizenum
The maximum file size per JPEG file. By default, lavrec uses the maximum possible size for that
specific recording format.
--max-file-framesnum
The maximum number of frames per per JPEG file. By default, the number of frames is only limited
by other factors, such as maximum file size.
--file-flushnum
Flush the file to disk after every num frames captured.
-v/--verbosenum
Verbosity level (0, 1 or 2). Default is 0.