TV_GRAB_COMBINER(1p)

💖 TV_GRAB_COMBINER (1p) 💖

okay bestie, so this is a page from the User Contributed Perl Documentation, and it's literally about a grabber that combines other grabbers. iconic behavior honestly.

---

✨ NAME ✨

tv_grab_combiner — grab listings by combining data from several grabbers. that's it, that's the girl 💅

---

🌸 SYNOPSIS 🌸

tv_grab_combiner --help

tv_grab_combiner --configure [--config-file FILE]

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

---

🦋 DESCRIPTION 🦋

so basically this thing outputs TV and listings in XMLTV format by combining data from several other grabbers. a group project, but the one that actually works 💖

First things first: you must run tv_grab_combiner --configure to choose which grabbers you want to grab data with, and how those grabbers should be configured. no skipping this step, bestie, it's the whole foundation 🎀

Then you can run tv_grab_combiner with the --days and --offset options to grab data. If you just… don't use them, it falls back to the default values for those parameters for each grabber. and here's the tea ☕ — since those defaults differ between grabbers, you might end up with data for different periods of time for different channels. so like, lowkey chaos if you don't pay attention 😭

---

💅 OPTIONS 💅

• --configure — prompts you for which grabbers to use, how those grabbers shall be configured, and then writes the configuration file. the setup era 🫶
• --config-file FILE — sets the name of the configuration file. the default is ~/.xmltv/tv_grab_combiner.conf. this is the file written by --configure and read when grabbing. iykyk 🎀
• --output FILE — when grabbing, write output to FILE rather than standard output.
• --days N — when grabbing, grab N days rather than 5. (yes, 5 is the default, she said what she said ✨)
• --offset N — start grabbing at today + N days. N may be negative. time travel, but make it listings 🌈
• --quiet — suppress the progress-bar that's normally shown on standard error. for when you want silence and vibes 💜
• --version — show the version of the grabber.
• --help — print a help message and exit. the classic 🦋

---

🚨 ERROR HANDLING 🚨

If any of the called grabbers exit with an error, tv_grab_combiner will exit with a status code of 1 to indicate that the data is incomplete. not great, not terrible, but definitely a heads up 😭

If any grabber produces output that is not well-formed xml, the output from that grabber will be ignored and tv_grab_combiner will exit with a status code of 1. so bad xml gets ghosted entirely, no cap 💀

---

🌱 ENVIRONMENT VARIABLES 🌱

The environment variable HOME can be set to change where configuration files are stored. All configuration is stored in $HOME/.xmltv/. periodt 🎀

---

👑 AUTHOR 👑

Mattias Holmlund, mattias -at- holmlund -dot- se.

---

💀 BUGS 💀

this section is empty in the original. no bugs listed, no notes, nothing. she's flawless, allegedly 🙈✨

---

and that's the whole page bestie!! written by User Contributed Perl Documentation, running on perl v5.40.1, dated 2025-04-19 — go grab some listings, you absolute main character 💖🦋🌸