xawtv(1)

✨ NAME ✨

okay bestie, meet xawtv — it's an X11 program for watching TV 💖 like, actual television, on your unix box. the manual name is xawtv and it lives in section 1 of the general commands manual, so you already know it's giving main character energy 💅

---

🌸 SYNOPSIS 🌸

xawtv [ options ] [ station name ]

---

🦋 DESCRIPTION 🦋

xawtv is a X11 application for watching TV with your unix box 📺✨ and it uses the Athena widgets, which is a whole vibe. yes really. it's iconic like that.

---

🎀 OPTIONS 🎀

okay so the thing about every single command line option here: they all also have a Resource, which means you can yeet them into your .Xdefaults file too 🫶 iykyk.

• -h, -help — prints a short description of all the command line options. basically the cheat sheet, no cap 📝
• -hwscan — prints a list of available devices. it's giving inventory check 🔍
• -f, -fullscreen — startup in fullscreen mode. Resource: xawtv.fullscreen (bool).
• -n, -noconf — don't read the config file ($HOME/.xawtv). like, pretend it doesn't exist 🙈 Resource: xawtv.readconfig (bool).
• -o, -outfile base — set basestring for the snapshot output files. the filename will be "base-timestamp-nr.ext". Resource: xawtv.basename (string).
• -c, -device device — set video4linux device (default is /dev/video0). this option also disables Xvideo support. Resource: xawtv.device (string).
• -D, -driver name — set video4linux driver (default is "libv4l"). this option also disables Xvideo support. Resource: xawtv.driver (string).
• -C, -dspdev device — set audio device (default is /dev/dsp). Resource: xawtv.dspdev (string).
• -vbidev device — set vbi device (default is /dev/vbi0). Resource: xawtv.vbidev (string).
• -c, -xvport number — set Xvideo port (defaults to the first usable if Xvideo is available). this option also enables Xvideo support. Resource: xawtv.xvport (int).
• -joydev device — joystick device to use for controlling xawtv. yes, joystick. gaming era 🕹️ Resource: xawtv.joydev (string).
• -v, -debug level — be verbose, level may be 0 (default), 1 or 2. it exists just for debugging and trouble-shooting. Resource: xawtv.debug (int).
• -remote — X11 display is remote. this basically disables overlay mode, you might need this if xawtv fails to autodetect a remote X11 display. Resource: xawtv.remote (bool).
• -b, -bpp n — force xawtv into n bpp color depth. works for switching between 15/16 and 24/32 bpp. this gets just passed through to v4l-conf(8). Resource: xawtv.bpp (int).
• -shift n — shift the video display by n bytes. try this if your video display isn't within the xawtv window, some older matrox cards show this problem 😭 this gets passed through to v4l-conf(8) too. Resource: xawtv.shift (int).
• -fb — use the framebuffer device to determine the video framebuffer address (instead of the DGA extension). yet another pass through argument. Resource: xawtv.fbdev (bool).
• -xv/-noxv — enable/disable the usage of the Xvideo extension altogether, i.e. -noxv has the same effect as both -noxv-video and -noxv-image switches (see below). Resource: xawtv.xv (bool).
• -xv-video/-noxv-video — enable/disable the usage of the Xvideo extension for video overlay (i.e. XvPutVideo). overlay mode uses this. default is on. Resource: xawtv.xvVideo (bool).
• -xv-image/-noxv-image — enable/disable the usage of the Xvideo extension for image scaling (i.e. XvPutImage). grabdisplay mode uses this. default is on. Resource: xawtv.xvImage (bool).
• -vm/-novm — enable/disable the usage of the VidMode extension, default is off. if there is a fullscreen video mode configured in the config file, the vidmode extension will be enabled automatically. Resource: xawtv.vidmode (bool).
• -dga/-nodga — enable/disable the usage of the DGA extension, default is on. Resource: xawtv.dga (bool).
• -parallel n — use n compression threads (default: one). Resource: xawtv.parallel (int).

and also — the usual toolkit options like -geometry are supported too 💅 don't forget those bestie.

---

💜 SUPPORTED HARDWARE / INTERFACES 💜

• v4l2 — video4linux two — modern standard linux video capture API ⭐ the moment.
• libv4l — work through the libv4l library, which provides an additional thin layer on top of video4linux2 devices for support of more wide range of devices' pixel formats (often required for webcams etc.) it is default for Xawtv on Linux systems. so like, she's the default queen 👑
• bktr — FreeBSD / OpenBSD driver for bt848/878 grabber cards.
• Xvideo — X11 Extension for video devices. note that the Xvideo extension does support overlay only, you can't capture images/movies if the Xvideo extension is used 🚨 on the other hand this is the only way to scaled video overlay (i.e. fullscreen without black borders @ 1024x748) if both hardware and xfree86 driver support it. see README.xfree4 for more details and hints on how to setup Xvideo.

---

🌈 GETTING STARTED 🌈

just start xawtv. simple as that, periodt. then verify the settings in the options menu (right mouse button) and adjust the settings (TV norm, Video source, frequency table). with the cursor keys you can control the tuner and look for TV Stations 📡 other useful hotkeys are listed below.

the hotkey E will show the channel editor where you can create/edit entries your TV stations. don't forget to click on "save" to write a config file. you can also create/edit a config file with any text editor, see xawtvrc(5) for a description of the config file syntax. there are a number of config options which can only be set by editing the config file 👀

you can also check out scantv. that's a command line tool which will perform a channel scan and write out a xawtv config file with all channels it has found. honestly? she works hard, we love her 🫶

🐭 Mouse functions

• the left mouse button will popup a menu with all TV stations found in the config file.
• the middle button switches to the next station.
• the right button brings up a window with a lot of options and control functions.

⌨️ Keyboard Shortcuts

V            Video (Capture) on/off
A            Audio on/off
F            Fullscreen on/off
G            Grab picture (full size, ppm)
J            Grab picture (full size, jpeg)
Ctrl+G       Grab picture (window size, ppm)
Ctrl+J       Grab picture (window size, jpeg)
O            Popup Options Window
C            Popup Channels Window
E            Popup Channel Editor
R            Popup AVI Recording Window
Z            Channel Hopper (zapping, tune in every
             station a few seconds)
Ctrl+Z       Fast Channel Hopping (grab the images for the
             Channel Buttons)

up/down      tune up/down one channel
left/right   fine tuning
pgup/pgdown  station up/down (the ones you have in the config file)
space        next station (same as pgup)
backspace    previously tuned station
Ctrl+up      scan for next station
F5-F12       adjust bright/hue/contrast/color

ESC,Q        Quit

+/-          Volume up/down (keypad)
Enter        mute (keypad)

---

💀 BUGS 💀

bug reports with images attached go to /dev/null unseen 🙈 yeah. that's the energy. read it and weep.

xawtv depends on a correct driver configuration. if you can't tune TV stations even if the settings in the options window are correct it is very likely a driver issue. not her fault bestie 😭

the mono/stereo display is not reliable due to v4l API restrictions. the API can not report back the current audio mode, but a list of the currently available modes. xawtv just does a guess based on that, assuming the driver uses the best available mode. depending on your hardware this might not be true. if in doubt whenever stereo really works, please tune in MTV and listen, don't trust what xawtv says 🎧 like, use your ears, not the screen.

---

🔥 SEE ALSO 🔥

xawtvrc(5), fbtv(1), v4l-conf(8), scantv(1)

http://bytesex.org/xawtv/ (homepage) 🌐

---

👑 AUTHOR 👑

Gerd Knorr <kraxel@bytesex.org>

---

🫶 COPYRIGHT 🫶

Copyright (C) 1997-2001 Gerd Knorr <kraxel@bytesex.org>

this program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

this program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. see the GNU General Public License for more details.

you should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

---

🍓 MISC 🍓

you are the 4711th visitor of this page ✨ congrats bestie, you're literally part of history now 🎀

and that's the whole page, fr fr 💖 this was xawtv(1) from the General Commands Manual, (c) 1997-2001 Gerd Knorr — ty for reading, mwah 💅🌸