WMTV(1)

👑 WMTV(1) — the dockable video4linux TV player situation

okay bestie, sit down, because this is a General Commands Manual page and we're about to make it make sense. no cap. 💖

---

✨ NAME ✨

wmtv — a dockable video4linux TV player for WindowMaker. yes that's the whole vibe. a lil TV buddy that lives in your dock. 🦋

---

🎀 SYNOPSIS 🎀

wmtv [--exe program]

---

🌸 DESCRIPTION 🌸

wmtv is a dockable video4linux TV player. it's giving "watch TV in a tiny app icon" and honestly? iconic.

here's what it's got going on: channel presets, PAL/Secam/NTSC, fine tuning, full screen display, and then the original page just trails off with a ... because the list goes on and on, iykyk. 😌

---

💅 OPTIONS 💅

• -c, --device — tells it which video4linux device to use. point it at the right one bestie.
• -d, --display — tells it which X server to contact. yes, that X server.
• -e, --exe — launches an external TV player when the screen gets double clicked. and plot twist: you can pass parameters to that external application with % codes (more on those below 👀).

---

🌈 USAGE 🌈

this section is all about using the app while it's in its docked state. for fullscreen mode usage, scroll down, it's right there.

Button map:

   [ < ] [ > ] [ 0 ]
    <1>   <2>   <3>

there are 3 modes of operation on this application. you cycle through all 3 by clicking on the right most button <3>. so much power in one lil button fr fr.

the 3 modes, bestie, are:

On mode

clicking on the rightmost button <3> for the first time (after the start of WMTV) will turn the TV on. while you're 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". chef's kiss. 😭

Off mode

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

---

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. no exceptions, no debate. ✨

---

🧚 FULL SCREEN MODE 🧚

to exit full screen mode: click. that's it. that's the instruction. 💀

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.

⚠️ okay so listen — the behavior of other % codes is undefined and subject to change. do not go inventing your own, bestie, it's giving chaos. 🙈

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. cute right?

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). shoutout to them, fr fr. 🌸

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. so this page literally exists because someone had to do it. iconic behavior honestly. 👑

---

and that's the whole page bestie!! this one's from August 2005, and it's page WMTV(1). vintage manual energy, still serving. slay, take care of your lil dock TV, mwah 💖✨