NAME

       wmtv - dockable video4linux TV player for WindowMaker.

SYNOPSIS

       wmtv [--exe program]

DESCRIPTION

       wmtv  is  a  dockable  video4linux TV player. It supports channel presets, PAL/Secam/NTSC,
       fine tuning, full screen display, ...

OPTIONS

       -c, --device
              Specifies the video4linux device to use.

       -d, --display
              Specifies the X server to contact.

       -e, --exe
              Launch an external TV player when the screen is double clicked. It is  possible  to
              pass some parameters to this external application with % codes.

USAGE

       This  sections  describes  how  to  use  the  application  in  docked state. See below for
       fullscreen mode usage.

       Button map:
           [ < ] [ > ] [ 0 ]
            <1>   <2>   <3>

       There are 3 modes of operation on this applications. You can cycle through the 3 modes  by
       clicking on the right most button <3>.

       The 3 modes are described below:

            On mode
            Clicking  on  the  rightmost  button <3> for the first time (after the start of WMTV)
            will turn the TV on. While in this mode, the left <1> and right <2> buttons change to
            preset  channels  which  has been defined in your config file. Use the left button to
            move down one channel and the right button to move up one channel.

            Tune mode
            Clicking again on button <3> after On mode will change WMTV  into  tune  mode.  Left-
            clicking  on the left <1> or right <2> button performs a channel scan. Scanning stops
            when there is a strong signal strength. Right-clicking on the left <1> or  right  <2>
            button fine tunes the current channel. After tuning, clicking on button <3> saves the
            fine tuning to your config file and brings you back into "On mode".

            Off mode
            Holding down button <3> for about 3 seconds from any of the two modes described above
            turns the TV off.

       Right-clicking the TV screen mutes/unmutes the audio.

       Double left-clicking the TV screen launches the application specified with --exe. If --exe
       was not specified, then the built-in full-screen mode  is  used  instead.  Double  middle-
       clicking will always invoke the built-in full screen mode.

FULL SCREEN MODE

       To exit full screen mode, click.

       Keyboard functions
         Up     - Change to next preset channel.
         Down   - Change to previous preset channel.
         Right  - Increase volume. (If supported by the v4l device.)
         Left   - Decrease volume. (If supported.)
         Escape - Leave full screen mode.
         m      - mute/unmute.

EXTERNAL APPLICATION

       It is possible to pass some parameters to the external application through % codes:
         %% is replaced by a single %.
         %n is replaced by the name of the current channel.
         %# is replaced by the number of the current channel.
         %f is replaced by the current frequency in MHz.
       The behavior of other % codes is undefined and subject to change.

       Example: wmtv -e 'xawtv "%n"'

CONFIGURATION FILE

       This section describes the format of WMTV's configuration file. It is located in your home
       directory under ".wmtvrc".

       Excerpt from a sample config file:
            /*-----------------------

            source = Television
            freqnorm = pal-australia
            maxpreset = 7
            mode = pal
            fullscreen = 640x480

            [channel]
            2       NAME
            7       FOO
            9       BAR
            10      FOOBAR
            32 (50)
            SE11
            S21     LAST CHANNEL
            -------------------------*/

       Settings
       source = { Television | CompositeX | S-Video } (X is an integer)

       freqnorm = { ntsc-bcast | ntsc-cable | ntsc-cable-hrc | ntsc-bcast-jp  |  ntsc-cable-jp  |
       pal-europe  | pal-europe-east | pal-italy | pal-newzealand | pal-australia | pal-ireland |
       secam-france }

       maxpreset = integer (maximum channel presets)

       mode = { pal | ntsc | secam }

       fullscreen = widthxheight

       [channel]
       Choose a total of <maxpreset> from the below channels.
       Separate the channels with a new line as in the sample config file above.
       {
         E2 | E3 | E4 |
         S01 | S02 | S03 |
         R1 | R2 | R3 | R4 | R5 |
         SE1 | SE2 | SE3 | SE4 | SE5 | SE6 | SE7 | SE8 | SE9 | SE10 |
         E5 | E6 | E7 | E8 | E9 | E10 | E11 | E12 |
         R6 | R7 | R8 | R9 | R10 | R11 | R12 |
         SE11 | SE12 | SE13 | SE14 | SE15 | SE16 | SE17 | SE18 | SE19 | SE20 |
         S21 | S22 | S23 | S24 | S25 | S26 | S27 | S28 | S29 | S30 | S31 | S32 | S33 | S34 |  S35
         | S36 | S37 | S38 | S39 | S40 | S41 |
         T7 | T8 | T9 | T10 | T11 | T12 | T13 | T14 |
         K01 | K02 | K03 | K04 | K05 | K06 | K07 | K08 | K09 | K10 |
         KB | KC | KD | KE | KF | KG | KH | KI | KJ | KK | KL | KM | KN | KO | KP | KQ |
         H01  | H02 | H03 | H04 | H05 | H06 | H07 | H08 | H09 | H10 | H11 | H12 | H13 | H14 | H15
         | H16 | H17 | H18 | H19 |
         1 - 125
       }
       Finetune parameters could be added in brackets, spaced after the channel.
       A name for the channel can also be specified, tabbed after the finetune.

       for example:
         32 (50)                 # channel 32 plus 50
         or
         SE11    LAST CHANNEL    # channel SE11 called "LAST CHANNEL"

FILES

       /etc/wmtvrc
              System wide config file.

       ~/.wmtvrc
              Users config file.

AUTHOR

       This manual page was first written by Remi Lefebvre <remi@debian.org>, and  then  modified
       by Nicolas Boullis <nboullis@debian.org>, for the Debian GNU/Linux system (but may be used
       by others).

       This manual page was written for the Debian GNU/Linux distribution  because  the  original
       program  does  not  have a manual page. It is widely based on the README provided with the
       program.

                                           August 2005                                    WMTV(1)