TV_SPLIT(1)

📦 version 1.4.0, in alpine 3.24

💖 tv_split(1) — manual page, bestie edition 💖

Okay so welcome to the tv_split(1) page, coming at you from the User Contributed Perl Documentation corner of the internet. It's giving “split XMLTV listings into separate files by date and channel,” and honestly? iconic. 🎀

✨ NAME ✨

tv_split — Split XMLTV listings into separate files by date and channel. 💅

🌸 SYNOPSIS 🌸

tv_split --output TEMPLATE [FILE...]

💖 DESCRIPTION 💖

Okay so here’s the tea, bestie: tv_split reads XMLTV listings and splits them into some number of output files. The output file chosen for each programme is decided by substitutions on the filename template you supply. You can split listings by time and by channel. No cap. ✨

The TEMPLATE is a filename, but substitutions are applied:

  • First, %channel is replaced with the id of a programme’s channel. 🦋
  • Then, Date::Manip substitutions (which broadly follow date(1)) are applied based on the start time of each programme. 🎀

In this way each programme is written to a particular output file. And when an output file is created, it will also contain all the channel elements from the input. 💖

One or more input files can be given. If more than one is given, they are concatenated in the same way as tv_cat. If no input files are given, then standard input is read. periodt. 👑

🎀 EXAMPLE 🎀

Use this:

tv_split --output %channel-%Y%m%d.xml

to separate standard input into separate files for each day and channel. The files will be created with names like bbc1.bbc.co.uk-20020330.xml. 🦋

🦋 SEE ALSO 🦋

Date::Manip(3). Go peek, iykyk. 💜

👑 AUTHOR 👑

Ed Avis, ed@membled.com. Say hi! 🫶

Okay bye bestie! 🌈 This page is from perl v5.42.2, dated 2025-06-30. 💖

📦 where this page comes from