TV_AUGMENT(1p)

✨ TV_AUGMENT 💅

okay bestie, so this is TV_AUGMENT(1p) — a perl situation, and it's literally here to make your XMLTV listings files glow up 💖

---

NAME

tv_augment — augment XMLTV listings files with automatic and user-defined rules. no cap, that's the whole vibe.

---

SYNOPSIS

two ways to summon it, pick your fighter:

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 what it actually does: it augments an XMLTV xml file by applying corrections (aka "fixups") to programmes that match defined criteria (aka "rules"). it's giving glow-up but for TV metadata 🦋

two types of rules get actioned, and yes there are exactly two:

1. automatic
2. user-defined

Automatic rules use pre-programmed input and output to modify the input programmes. e.g. removing a "title" where it is 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. it's out here doing detective work 🔍

User-defined rules use the content of a "rules" file which allows programmes matching certain user-defined criteria to be corrected/enhanced with the user data supplied (e.g. adding/changing categories for all episodes of "Horizon", or fixing misspellings in titles, etc.) — basically you tell it what's wrong and it fixes it, iconic behaviour 💅

(see perldoc XMLTV::Augment for more details) — iykyk, go read it

---

OPTIONS ✨

• --input FILE — read from FILE rather than standard input. your source, your choice 🫶
• --output FILE — write to FILE rather than standard output. where the slay goes.
• --rule FILE — FILE containing the user-defined rules. the lore file 📜
• --config FILE — configuration file containing a list of which rules you want to run. it's the playlist of rules, if you will 🎀
• --nostats — do not print the summary log of actions performed, or list of suggested fixups. quiet mode, mysterious mode 💀
• --log FILE — output the stats to this FILE.
• --debug LEVEL — print debug info to STDERR. heads up: debug level > 3 is not likely to be of much use (it generates a lot of output). like, a lot a lot. you've been warned 😭

---

SEE ALSO

• xmltv(5) — go read the sibling, bestie 💜

---

AUTHOR

Geoff Westcott, honir.at.gmail.dot.com, Dec. 2014. shoutout to the author, absolute main character energy 👑

---

and that's the whole page fr fr 🌸 this was written against perl v5.40.1, dated 2025-04-19, and it lives under TV_AUGMENT(1p) — so go forth and augment, bestie 💖✨