TV_GRAB...TVMEDIA(1p)

💖 NAME 💖

okay so bestie, this is tv_grab_na_tvmedia — a grabber that pulls TV listings for North America. no cap. 🦋

---

✨ SYNOPSIS ✨

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 🌸

so basically it outputs TV listings in XMLTV format for stations available in North America, and the data is provided by TVMedia Inc. iconic of them tbh 💅

lowkey important: this grabber needs an active subscription to XMLTVListings.com, plus at least one lineup selected from your account page. you cannot skip this part, bestie, it's giving mandatory. 😭

once you've got that sorted, run tv_grab_na_tvmedia --configure to set your API key and pick which lineup you want to receive. 🎀

then just running tv_grab_na_tvmedia with no arguments gets you listings for all the channels in your lineup, exactly how you configured it on XMLTVListings.com. slay. 👑

---

💅 OPTIONS 💅

• --configure — prompts you for which stations to download, and writes the configuration file. it's giving setup wizard energy ✨
• --config-file FILE — sets the name of the configuration file. the default is ~/.xmltv/tv_grab_na_tvmedia.conf. this is the file that --configure writes, and the file that gets read when grabbing. 🗂️
• --output FILE — when grabbing, write output to FILE instead of to standard output.
• --days N — when grabbing, grab N days instead of 5. yes, 5 is the default, remember it. 🗓️
• --offset N — start grabbing at today + N days. it also supports a negative offset for past listings, so you can go back in time, main character time-travel moment ⏪
• --quiet — only print error-messages on STDERR. shhh 🤫
• --debug — provides more information on progress to stderr to help in debugging. detective mode 🕵️
• --list-channels — outputs a list of all channels that data is available for. the list is in xmltv-format. 📺
• --capabilities — shows which capabilities the grabber supports. for more information, see <http://wiki.xmltv.org/index.php/XmltvCapabilities> 🌈
• --version — shows the version of the grabber. ⭐
• --help — prints a help message and exits. the classic 🫶

---

😭 ERROR HANDLING 😭

if the grabber fails to download data, it prints an errormessage to STDERR and then exits with a status code of 1, which is the signal that the data is missing. so if you see that 1, it's not you, it's the data. 💀

---

🎀 CREDITS 🎀

grabber written by Matthew April on behalf of TVMedia.ca. this documentation was copied from tv_grab_cz, and this code was modified from tv_grab_cz, by Mattias Holmlund, mattias -at- holmlund -dot- se. giving credit where credit is due, periodt. 💖

---

🐛 BUGS 🐛

None known. we're clean, bestie, no bugs in sight ✨🧚

---

this was perl v5.40.1, dated 2025-04-19, from the User Contributed Perl Documentation. mwah, enjoy your listings 💋🌸