v4lctl1x
Part of xawtv-remote(1x).
Usage
xawtv-remote [options]
command
v4lctl [options]
command
Overview
xawtv-remote and v4lctl can be used to control a video4linux driven TV card. xawtv-remote passes the command to a already running xawtv instance using X11 properties. v4lctl sets the parameters directly.
Options
xawtv-remote knows the following options:
-
-h -
print a short help text
-
-d dpy -
Set the X11 display
-
-i id -
Set the Window ID.
v4lctl understands these options:
-
-h -
print a short help text
-
-c device -
Set video4linux device.
-
-v n -
Set debug level to
n, where n = [0..2]
Commands
Both tools basically use the same set of commands. Some of them are useful for xawtv-remote only (fullscreen for example).
- setstation [ <name> | <nr> | next | prev | back ]
-
Set the TV station. This selects on of the TV stations which are configured in the .xawtv config file. The argument can be the station name or a number (the first one listed in the config file is 0, ...). next/prev jumps to the next/previous station in the list, back to the previously selected one.
- setchannel [ <name> | next | prev ]
-
Tune in some channel.
- setfreqtab <table>
-
Set the frequency table. See the menu in xawtv for a list of valid choices.
- setnorm <norm>
-
Set the TV norm (NTSC/PAL/SECAM).
- setinput [ <input> | next ]
-
Set the video input (Television/Composite1/...)
- capture [ on | off | overlay | grabdisplay ]
-
Set capture mode.
- volume <n>
- color <n>
- hue <n>
- bright <n>
- contrast <n>
-
Set the parameter to the specified value. Range for all values is 0 <= n <= 65535. <n> can be either absolute (like "32768") or relative (marked by a sign, like "+1000" or "-512"). "inc" and "dec" are accepted too and increase/decrease the parameter by one percent. "volume" additionally accepts "mute".
- snap [ jpeg | ppm ] [ full | win | widthxheight ] <filename>
-
Capture one image.
fullscreen-
Toggle fullscreen mode.
- msg text
-
Display text on the on-screen display.
quit-
quit xawtv
- keypad n
-
enter digit 'n'. That's the two-digit channel selection, entering two digits within 5 seconds switches to the selected station. Useful for lirc.