TV_GRAB_NA_TVMEDIA(1)

💖 NAME 💖

okay so this is tv_grab_na_tvmedia(1), a User Contributed Perl Documentation page, and it's the grabber for North America TV listings. No cap.

tv_grab_na_tvmedia — Grab TV listings for North America.

---

✨ SYNOPSIS ✨

Here's the exact command shape, bestie:

tv_grab_na_tvmedia --help

tv_grab_na_tvmedia --configure [--config-file FILE]

tv_grab_na_tvmedia [--config-file FILE]
                 [--days N] [--offset N]
                 [--output FILE] [--quiet]

tv_grab_na_tvmedia --list-channels [--config-file FILE]
                 [--output FILE] [--quiet]

---

🎀 DESCRIPTION 🎀

It outputs TV listings in XMLTV format for stations available in North America. Data is provided by TVMedia Inc.

The grabber requires an active subscription to XMLTVListings.com, as well as at least one lineup selected from your account page. Then you can run tv_grab_na_tvmedia --configure to set your API key and which lineup you want to receive.

Then running tv_grab_na_tvmedia with no arguments will get listings for all the channels you have in your lineup, as you configured on XMLTVListings.com.

bestie, this one is serious: that subscription has to be active, and you need at least one lineup picked from your account page. The grabber is not out here doing magic for free 💅

---

💅 OPTIONS 💅

Every flag, bestie — collect them all:

• --configure — Prompt for which stations to download and write the configuration file.
• --config-file FILE — Set the name of the configuration file; the default is ~/.xmltv/tv_grab_na_tvmedia.conf. This is the file written by --configure and read when grabbing.
• --output FILE — When grabbing, write output to FILE rather than standard output.
• --days N — When grabbing, grab N days rather than 5.
• --offset N — Start grabbing at today + N days. Also supports negative offset for past listings.
• --quiet — Only print error-messages on STDERR.
• --debug — Provide more information on progress to stderr to help in debugging.
• --list-channels — Output a list of all channels that data is available for. The list is in xmltv-format.
• --capabilities — Show which capabilities the grabber supports. For more information, see <http://wiki.xmltv.org/index.php/XmltvCapabilities>
• --version — Show the version of the grabber.
• --help — Print a help message and exit.

---

😭 ERROR HANDLING 😭

If the grabber fails to download data, it will print an errormessage to STDERR and then exit with a status code of 1 to indicate that the data is missing.

not the 1 exit code 😭 that's the "data is missing" signal, fr fr.

---

🌈 CREDITS 🌈

Grabber written by Matthew April on behalf of TVMedia.ca. This documentation copied from tv_grab_cz; this code modified from tv_grab_cz, by Mattias Holmlund, mattias -at- holmlund -dot- se.

---

🦋 BUGS 🦋

None known. iconic.

---

okay bye bestie — TV_GRAB_NA_TVMEDIA(1) is from perl v5.42.2, dated 2025-06-30 💅✨