GATOS(7)

📦 version 0.0.5, in debian trixie, ubuntu questing

💅 NAME 💅

Gatos — ATI-TV for GNU/Linux. That's it, that's the name, bestie. This is the GATOS manual page, section 7. ✨

🌈 DESCRIPTION 🌈

Okay so. GATOS stands for General ATI TV and Overlay Software, and it's a whole effort to build standard drivers for all the currently-unsupported features of ATI video cards — specifically the TV features. It's giving "we saw a gap and we filled it." 🦋

🎀 HOMEPAGE 🎀

The GATOS homepage lives at:

http://gatos.sourceforge.net/

Updates, news, additional documentation and the FAQ? All there. Go read it, it's lowkey essential. 💖

👑 MAINTAINER 👑

Insomnia (Stea Greene) <insomnia@core.binghamton.edu> — send bug reports and code patches to this address. That's the person. That's the one. 🫶

✨ REQUIREMENTS ✨

Here's the vibe check on what you actually need:

  • -GNU/Linux, FreeBSD and NetBSD — (only tested on x86). Just so you know. 🙈
  • -ATI — All-In-Wonder, All-In-Wonder Pro or Rage II/Pro with ATI-TV tuner card. Limited support for the All-In-Wonder 128 and Rage128 with ATI-TV tuner card.
  • -XFree86 — recommended, but not required.

🍓 PROGRAMS 🍓

There are many programs packaged with GATOS, and they're all iconic in their own way:

  • xatitv — GUI "TV in a window" application.
  • atitv — Simple text-mode program.
  • gatos-conf — GUI GATOS configuration application.
  • atitoppm,
  • atitogif,
  • atitojpg,
  • yuvsum,
  • atisplit — YUV conversion program.
  • scanpci — PCI bus utility.

😭 BUG REPORTS 😭

Found a bug? Not me crying. To submit a bug report, send an e-mail to:

Insomnia (Stea Greene) <insomnia@core.binghamton.edu>

with a subject line of:

GATOS BUG: <brief description...>

Then in the main body of the message:

  • Describe the bug in detail, including how to repeat the misbehavior,
  • Specify what version of GATOS and what version of IBTK you are using,
  • Then include a dump of "xatitv -v" (either as a MIME attachment or right in the message),
  • Include a patch of any changes you made to the code that may fix the problem. See PATCHES below,

When a bug is fixed or if the bug report is not understood, you will get a reply, so make sure your message is properly reply-able. 💌

🧚 PATCHES 🧚

Wanna make a patch? Slay. First, make sure you have a full tree of both the original and the modified trees (herin called "gatos-orig" and "gatos-new" respectively).

Make sure each tree is clean by using:

->     make distclean

in EACH directory. Then change to the directory immediately above these two directories and use the following command:

->     diff -ur gatos-orig gatos-new > gatos-new-patch

Look at gatos-new-patch (with a text editor or viewer) and make sure nothing is changed that you didn't intend to be. You can submit this patch to me either included in an e-mail, or as a MIME attachment, or you can compress it and send it as a MIME attachment, as follows:

Compress it with:

->     gzip -9 gatos-new-patch

Then send gatos-new-patch.gz to me as a MIME attachment. 📎

If there is a problem with the patch, or I have a question or the patch/description is not understood, you will get a reply, so make sure your message is properly reply-able. (Yes, this is the second time I've said it. It matters. 😤)

💀 LICENSE 💀

Files not covered by the main GATOS license (GNU Public License):

  • delay.S, delay.h and linkage.h are from the Linux 2.0.36 kernel sources (slightly modified) and are Copyright (C) 1993 by Linus Torvalds.
  • scanpci.c is from XFree86 3.3.3 and is Copyright (C) 1995 by Robin Cutshaw.
  • pci.c is modified from scanpci.c and is Copyright (C) 1995+1999 by Robin Cutshaw and Øyvind Aabling.
Real talk: those specific files are not under the main GATOS license, so respect the separate copyrights, bestie. 🙏

🌸 AUTHORS 🌸

Primary Authors:

Øyvind Aabling                <Oyvind.Aabling@uni-c.dk>
Daniel Caujolle-Bert          <lobadia@club-internet.fr>
Vladimir Dergachev            <vdergach@sas.upenn.edu>
Insomnia (Stea Greene)        <insomnia@core.binghamton.edu>
Christian Lupien              <lupien@physics.utoronto.ca>
Octavian PURDILA              <purdila@sundy.cs.pub.ro>

Other Contributors:

Bob Bell                      <bbell@macroped.com>
Bruce Forsberg                <forsberg@adnc.com>
Chris Hardy                   <chris@hardys.org>
Victor Bogado da Silva Lins   <bogado@openlink.com.br>
Ken Dresser                   <Ken@dresser.net>
Jan ONDREJ                    <ondrejj@salstar.shadow.sk>
techt                         <techt@pikeonline.net>
hook                          <hook@netrio.com.br>
Rodrigo Ventura               <yoda@isr.ist.utl.pt>

Based on:

  • -aiwtv-0.22
    • by Øyvind Aabling.
  • -aiwtv-0.20uX
    • by Øyvind Aabling, Christian Lupien, Vladimir Dergachev and Bruce Forsberg.
  • -atitv-0.21#X
    • by Øyvind Aabling, Insomnia (Stea Greene) and Bruce Forsberg.
  • -Limited documentation and some support
    • from ATI Technologies Inc.

And that's a wrap, bestie. 🎀 This one's from the GATOS Manual, dated 20 Dec 1999, filed under GATOS(7) — go forth and TV-in-a-window responsibly. 💜👑

📦 where this page comes from