TV_AUGMENT(1)

💖 NAME 💖

okay so this is the manual page for tv_augment(1) from the User Contributed Perl Documentation, and it is literally the tool that augments XMLTV listings files with automatic and user-defined rules. bestie, it’s giving “make my TV guide make sense” energy. 💅

✨ SYNOPSIS ✨

two ways to call her, both iconic:

tv_augment [--rule <file>] [--config <file>]
           [--input <file>] [--output <file>]
           [--log <file>] [--nostats]
           [--debug <level>]

tv_augment [-r <file>] [-c <file>]
           [-i <file>] [-o <file>]
           [-l <file>] [-n]
           [-d <level>]

🎀 DESCRIPTION 🎀

so the whole point: you take an XMLTV xml file and you apply corrections — the page calls them "fixups" — to programmes that match defined criteria called "rules". no cap, that’s the vibe. 🦋

two types of rules get actioned: (i) automatic, and (ii) user-defined. periodt.

automatic rules use pre-programmed input and output to modify the input programmes. like, for example, removing a "title" where it’s repeated in a "sub-title" (e.g. "Horizon" / "Horizon: Star Wars"), or trying to identify and extract series/episode numbers from the programme title, sub-title or description. she’s doing detective work, fr fr. 🔍

user-defined rules use the content of a "rules" file, which lets programmes matching certain user-defined criteria get corrected/enhanced with the user data you supplied (e.g. adding/changing categories for all episodes of "Horizon", or fixing misspellings in titles, etc.). highkey useful. 🫶

for the extra lore: (see "perldoc XMLTV::Augment" for more details) ✨

🌸 the flags, bestie 🌸

• --input FILE (-i FILE) — read from FILE rather than standard input. 📥
• --output FILE (-o FILE) — write to FILE rather than standard output. 📤
• --rule FILE (-r FILE) — file containing the user-defined rules. 📜
• --config FILE (-c FILE) — configuration file containing a list of which rules you want to run. ⚙️
• --nostats (-n) — do not print the summary log of actions performed, or list of suggested fixups. 🙈
• --log FILE (-l FILE) — output the stats to this FILE. 📝
• --debug LEVEL (-d LEVEL) — print debug info to STDERR (debug level > 3 is not likely to be of much use (it generates a lot of output)) 💀

🌈 SEE ALSO 🌈

xmltv(5) — go read that too, bestie. 👑

👑 AUTHOR 👑

Geoff Westcott, honir.at.gmail.dot.com, Dec. 2014. an icon. 💜

---

mwah 💋 — this page is from perl v5.42.2, dated 2025-06-30. slay. 🌟