XdTV Execution options:
  •   -b depth force XdTV into depth bits color depth. Might be needed for 24/32 bits. However the best performances in grabdisplay mode are achieved with a 16 bits color depth.
  • -f startup in fullscreen mode (oldswitch method).
  • -m startup with mouse pointer turned off.
  • -n don't read the config file ($HOME/.xdtv/xdtvrc).
  • -o filename set output filename for ppm grabbing (default is snap000.ppm)
  • -j filename set output filename for jpeg grabbing (default is snap000.jpeg)
  • -v level Be verbose, level may be 0 (default), 1 or 2. It exists just for debugging. If no level is provided, a level of 1 is assumed.
  • -x disable the usage of X11 extensions (DGA, VidMode).
  • -d disable the usage of X11 DGA extension.
  • -D adr set framebuffer address to adr. Needed for overlay mode if DGA is not available (needs root privileges, use with caution !).
  • -c video_device video4linux video device. For devfs enabled systems, default is /dev/v4l/video or /dev/v4l/video0, in that order. For non devfs systems, default is /dev/video or /dev/video/video0 or /dev/video0, in that order. Note that on /proc enabled systems, video device detection is automagic.
  • -C vbi_device video4linux vbi device. For devfs enabled systems, default is /dev/v4l/vbi or /dev/v4l/vbi0, in that order. For non devfs systems, default is /dev/vbi or /dev/video/vbi or /dev/vbi0, in that order. Note that on /proc enabled systems, vbi device detection is automagic.
  • -noxv | -no-xv disables the Xvideo support if it was compiled in.
  • -xvport number set Xvideo Image port (defaults to the first usable if Xvideo is available). A usuable one is one which does support YUY2 format.
  • -noplugin disable any plugin installed.
  • -plugin pathfile enable a specific plugin.
  • -plugindir pathdir set plugin directory (default=/usr/local/lib/xdtv-plugins)
  • -probe_memcpy force benchmarking of different possibilities for a fast memcpy function.
  • -rec_fps fps set recording framerate (default=25.0)
  • -rec_display on|off set display mode during recording (default=1)
  • -rec_width width set width of the recording video (default=384), if width is 0 then set to 4/3*height
  • -rec_height height set height of the recording video (default=288), if height is 0 then set to 3/4*width
  • -rec_videobr br set recording video bitrate to br kbit/s (default=800)
  • -rec_stereo on|off activate stero mode (default=off)
  • -rec_audiobuf size set the size of the audio buffer (default=1764)
  • -rec_fragments number set the number of audio fragments (default=48)
  • -rec_fragmentsize size set the size of the audio fragment (default=2048)
  • -rec_mp3 on|off activates MP3 compression (default=on)
  • -rec_mp3cbr br activate MP3 CBR and set bitrate to br kbit/s (default=activated, 128kbit/s)
  • -rec_mp3vbr quality activate MP3 VBR and set compressing quality (0=best, 9=worst) (default=deactivated, quality=8)
  • -rec_vcodec xvid|ffmpeg_mpeg4|ffmpeg_mpeg1|ffmpeg_huffyuv|divx4linux|uncompressed set recording video codec
  • -rec_maxgap gap set recording max gap between audio and video in seconds (default = 0.08 second)
  • -rec_delay value set recording delay between audio and video in seconds (default = 0.00 second). value can negative or positive. The delay will always be between value-gap and value+gap. Use this option if you notice that there is always the same A/V delay in your movies, but normally 0.00 is always fine.
  • -rec_sub on|off indicates if subtitles are recorded (the subtitles are recorded in MPlayer's MPsub format).
  • -rec_chg on|off allows channel changes during recording.
  • -rec_filename filename set the avi filename (default=divx_path/movie-channel-date.avi)
  • -rec_stream on|off enables http export of the recording (XdTV will act as a http stream server)
-rec_http_port set the port of the http stream (default=63427)
  • -e "cmd_1; cmd_2; cmd_3;...cmd_n" execute the commands at the beginning of execution see xdtv_cmd(1) for the list of commands
  • -nowd option to disable window decoration at startup
  • -stayontop Startup with stay on top activated.
  • -h prints a brief usage message and exits.
  • -v4l2 forces the v4l2 driver. By default if your driver is not v4l2 then v4l1 mode is automaticly selected, with this option if you have not v4l2, XdTV will die.
  • -v4l1 forces the old v4l1 driver. It is not recommended because drivers which provide v4l2 are more unstable in v4l1 mode.
  • -xvtv communicates with the TV-card through the X-server (needs Xvideo, and your TV-card must be recognized by X. Don't work with grabdisplay).
  • -xvtv_overlay on|off uses XVideo for overlay if available, all the other operations use the normal driver. It actually works only with v4l2 drivers because the device must allow multiple opens. (default=on with v4l2 and if the XvVideo port is named video4linux)
  • -xvtvport set Xvideo Video port (defaults to the first usable).
  • -novbi does not open the teletext device.
  • -capture overlay|grabdisplay|off to use a specific capture mode for all channels at startup.
  • -nbufs nbufs sets the number of kernel-buffered frames (default=3).
  • -capt_width width set maximum width of the grabbed frames (default=maximum=768)
  • -capt_height height similar to -capt_width option. (default=maximum=576)
  • -force_capt_width width forces width of the grabbed frames default=0 which means not forcing, -1 means the maximum width (768 for pal, 640 for ntsc).
  • -force_capt_height height similar to -capt_width option. (default=0=not forcing) -1 means the maximum height (576 for pal, 480 for ntsc).
  • -avi filename.avi reads frames from filename.avi. (only used for testing)
  • -avibench (requires the -avi option) Does not delay between two frames, stops when the end of the avi is reached and diplays some statistics on CPU usage.
  • -avi_audiofragments number set the number of audio fragments for avi reading (default=2, 16 for sunaudio)
  • -avi_audiofragmentsize size set the size of audio fragments for avi reading (default=2048)
  • -avinoaudioout does not output audio during avi reading.
  • -sub on|off activates/deactivates subtitles (default=off)
  • -xosd use xosd library to display osd. (still in developpement)
  • -noalsa | -nooss | -nosunaudio does not use the corresponding driver to manage sound
  • -mixer_dev selects the mixer device. (default=default for alsa, /dev/mixer for oss and sunaudio)
  • -mixer_tvchan selects the mixer channel corresponding to the TV (default=Line for alsa, line for oss, inputs.line for sunaudio)
  • -mixer_pcmchan selects the mixer channel corresponding to the digital audio (default=PCM for alsa, pcm for oss, inputs.dac for sunaudio)
  • -audio_dev selects the audio device. (default=default for alsa, /dev/dsp for oss, /dev/sound for sunaudio)
  • -restoresnd on|off indicates if XdTV restores the initial sound settings on exit. (default=off, works only with alsa)
  • -bktr_mode nr chooses a capture format by its number (see supported formats in XdTV output) (for BSD) you must specify which mode it supposes to be with the -grabfmt option
  • -bktr_read uses read instead of mmap (slow, use it only if your driver is buggy) (only for BSD)
  • -doublekey on/off enables double keys (default=on if there are more than 10 stations)
  • -doublekey_firstisone on/off indicates if the first station has number 1, and not 0, needed for doublekey (default=off except if lirc-key-1 is mapped to keypad 0 or the hotkey of the first channel is 1, KP_1 or KP_End)
  • -noxawpopup To disable xaw popup
  • -oldswitch Old X11 resolution switching method used in fullscreen mode
  • -ybar nr set height of the black borders for a total height of 1000: nr=125 for 16:9, nr=200 for 20:9 (default=0)
  • -grabfmt -grabfmt yuyv|yuv420|rgb32... forces the format of the frames captured by the card
  • -xvfmt yuyv|yuv420|rgb32... forces the format used by the XVideo adapter
  • -x11fmt gray1|gray4|rgb4|gray8|hi240|rgb8|rgb16|rgb24|rgb32... forces the format used by the x11 window
  • -vop op1:op2:op3... applies operations on the video.
  • -aop op1:op2:op3... applies operations on the audio.
  • -vop_autograb on|off automatically enter in grabdisplay mode when a vop is activated (default=on)
  • -alevt_arg You must write the AleVT arguments between two quotation marks
--help or -h
--version or -v
--debug or -debug
-copyright or -©
-editor or -ed
-display or -d <dpy>                                                            $DISPLAY
-geometry or -g <geo>                                                        41x25
-finetune or -f <-4..4|auto>                                                  0
-child or -c ppp[.ss]
[-parent] or -p ppp[.ss]                                                         900
-[no]erc or -[n]e                                                                    enabled
-[no]bell or -[n]b                                                                   enabled
-charset or -latin latin-1/2/koi8-r/koi/iso8859-7/el           latin-1

   
Copyright (c) 2002 Keuleu - Pingus - BlindMan
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1
or any later version published by the Free Software Foundation;
with the Invariant Sections being LIST THEIR TITLES, with the
Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
A copy of the license is included in the section entitled "GNU
Free Documentation License"