xatitv(1)

✨ xatitv(1) — GATOS Manual ✨

okay bestie, pull up a chair 🫶 you're about to meet xatitv, the GUI "TV in a Window" application from the GATOS package. yes it's a whole vibe. let's get into it 💅

---

🌸 NAME 🌸

xatitv — the GUI "TV in a Window" application from the GATOS package. that's it, that's the name, iconic behavior honestly 👑

---

🎀 SYNOPSIS 🎀

xatitv [options]

---

💖 DESCRIPTION 💖

xatitv is the main program shipped with GATOS. it gives you GUI access to basically all of GATOS functionality, save tv-out. the GUI is pretty self-explanatory, but here are the basics, because I love you and I want you to thrive:

• when you first run it, hit setup and configure format and options, then do a channel scan. do not skip this. I'm serious. 🙈
• use the three buttons labeled TV, CV and SV to select video input from TV tuner, Composite Video and SVHS respectively.
• the Adv., Capture and Edit Channel buttons toggle other sections of the GUI. little toggles, little slay ✨
• Volume, Brightness, Contrast, Hue and Saturation can be modified by clicking the mouse at any location along their respective sliders. just click wherever on the slider, it's giving instant gratification 💅
• the Edit Channel GUI can be used to set channel-specific video and audio settings (if a channel is too bright/dark, too loud/quiet, etc) and to remove bogus channels. it can also be used to name a channel so you can later select that channel by name. so yes, you can name your channels. main character naming rights fr fr 👑
• there are many other feature, look around and tinker with them. (that's the original's grammar and I'm keeping it, no cap 🫶)
• most features have keyboard shortcuts, and these are the moment:
  • -Esc — Quit.
  • -Tab/Right-Click — Hide/Show GUI.
  • -F1-F8 — Favorite channels (CTRL+Key to set).
  • -F9-F12 — Output debug info.
  • -Numbers — Change channel by number.
  • -Letters/space — Change channel by name.
  • -Enter/Return — Finish entering item (channel name/number).
  • -Up/Down — Scroll through settings.
  • -Left/Right — Change current setting.
  • -Keypad +/- — Change channel.
  • -Backspace — Switches to the previous channel that you spent more than 5 seconds at. (the 5 seconds thing is the whole point, it's a vibe check on your attention span 😭)
  • -Keypad / — Toggle mute.
  • -Keypad * or Double-Click — Toggle fullscreen Mode.
  • - or ~` — Toggle closed captioning (CC).
  • -> and < — Increase/Decrease size of window by a factor of 2.
  • -Pause — Freeze capture on current frame.
  • -PrintScreen — Capture single frame (Snapshot).

---

🦋 FILE FORMATS 🦋

note bestie, motion capture in xatitv use a special .yuv file format unique to gatos. it's its own thing, it's exclusive, it's mysterious 🌈

Snapshots on the other hand save to .ppm files, which are viewable (and convertible) by most graphics programs. those are the friendly ones, they play nice with everyone 💜

there is no automatic intelligence in xatitv to select this file's extension, so to make sure other programs don't get confused, always take snapshots to a .ppm file, and capture video to .yuv files. This should be fixed in the next version. (yes, that's a promise from 1999, we're all still waiting, and we love that for it 🙈)

Snapshots to files containing a number (eg: gatos000.ppm) will automatically increment the number in this filename for the next snapshot. so after taking a ppm snapshot to gatos000.ppm, xatitv will capture the next to gatos001.ppm, then gatos002.ppm, etc.... it's counting, it's slaying, it's doing its little number thing ⭐

---

💅 OPTIONS 💅

• -pci <pciaddr> — Override PCI address in gatos.conf.
• -q — Quiet mode (disable messages output). shhh. 🤫
• -v — Verbose mode (display many debug infos). the opposite of shhh.
• -qv|-vq — Display GATOS and IBTK versions used.
• -d<value> — Set verbosity level (no space between d and value). no space, bestie, I mean it.
• -nosa — Only for testing.

---

🍓 FILES 🍓

• /etc/gatos.conf — Configuration file of GATOS.

---

🌈 SEE ALSO 🌈

gatos, gatos-conf, gatos.conf, atitv, atisplit, atitogif, atitojpg, yuvsum, scanpci.

---

🧚 AUTHORS 🧚

Xatitv was written and copyrighted by Steaphan Greene, Øyvind Aabling, Octavian Purdila, Vladimir Dergachev, Christian Lupien, and Daniel Caujolle-Bert. absolute legends, all of them, the founding mothers and fathers of the TV-in-a-window cinematic universe 💖

---

and that's the whole page, bestie ✨ this was the GATOS Manual, dated 20 Dec 1999 — yes, 1999, the vintage is part of the charm, and xatitv(1) is forever that girl 💅🫶