TV_GRAB_COMBINER(1)

📦 version 1.4.0, in alpine 3.24

💖 NAME 💖

Bestie, this is the TV_GRAB_COMBINER(1) manual page for tv_grab_combiner — User Contributed Perl Documentation energy 💖 — and it grabs listings by combining data from several grabbers. Periodt.

🦋 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 ✨

Okay so tv_grab_combiner outputs TV and listings in XMLTV format by combining data from several other grabbers. Iconic behavior, honestly.

First you must run tv_grab_combiner --configure to choose which grabbers you want to grab data with and how these grabbers should be configured. That's the setup era, bestie.

Then you can run tv_grab_combiner with the --days and --offset options to grab data. Omitting these options will use the default values for these parameters for each grabber. Since these defaults differ between grabbers, you might end up with data for different periods of time for different channels. So like, lowkey check your vibes per grabber. 🫶

🎀 OPTIONS 🎀

  • --configure — prompts you for which grabbers to use, how these grabbers shall be configured, and writes the configuration file. Main character setup moment ✨
  • --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. The config file is literally the blueprint 💅
  • --output FILE — when grabbing, write output to FILE rather than standard output. Redirect your slay 🎀
  • --days N — when grabbing, grab N days rather than 5. You want more days? Say less. 😌
  • --offset N — start grabbing at today + N days. N may be negative. Time travel but make it scheduling 🦋
  • --quiet — suppress the progress-bar normally shown on standard error. For when you want peace and quiet, no cap. 🤫
  • --version — show the version of the grabber. Gotta know which era you're in 💖
  • --help — print a help message and exit. The classic "bestie explain" option 🫶

🚨 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. So yeah, 1 means "we have incomplete tea" 😭

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. Not well-formed xml? Ignored. Status code 1? Still showing up. 💀

🌈 ENVIRONMENT VARIABLES 🌈

The environment variable HOME can be set to change where configuration files are stored. All configuration is stored in $HOME/.xmltv/. That's the config home base, bestie 🏠✨

👑 AUTHOR 👑

Mattias Holmlund, mattias -at- holmlund -dot- se. The legend behind the manual page 👑

💀 BUGS 💀

The original page has this heading but no bug text under it, so that's the whole vibe here: an empty section, bestie. Iconic, honestly. 🫶

That's the whole TV_GRAB_COMBINER(1) page, bestie! Source/version: perl v5.42.2, dated 2025-06-30. Stay slay and may your XMLTV always be well-formed. 💅✨

📦 where this page comes from