TV_GRAB_CH_SEARCH(1p)

👑 TV_GRAB_CH_SEARCH — the tea ☕

okay bestie, welcome to TV_GRAB_CH_SEARCH(1p), aka the little Perl script that goes and gets you TV listings for Switzerland 🇨🇭 (and, like, partly central Europe, it's giving "we got the good stuff, you get the leftovers").

---

✨ NAME ✨

tv_grab_ch_search — grab TV listings for Switzerland (from the tv.search.ch webpage). no cap, that's literally the whole job.

---

🌸 SYNOPSIS 🌸

here's every way you can slide into this program's DMs:

tv_grab_ch_search --help

tv_grab_ch_search [--config-file FILE] --configure [--gui OPTION]

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

tv_grab_ch_search --list-channels

tv_grab_ch_search --capabilities

tv_grab_ch_search --version

---

💖 DESCRIPTION 💖

so basically: this grabber spits out TV listings for several channels you can get in Switzerland and (partly) central Europe. the data comes from tv.search.ch. ⚠️ the grabber relies on parsing HTML, so it might stop working at any time — yes girl, it's fragile, it's living on borrowed time, it's giving "house of cards" 🏚️💀.

first thing you do: run tv_grab_ch_search --configure to choose which channels you wanna download. then running tv_grab_ch_search with no arguments outputs listings in XML format to standard output. periodt.

---

🎀 the options (aka your menu of power) 🎀

• --configure — it asks you, channel by channel, whether you wanna download that one, then writes the config file. it's a whole vibe check for your channel list.
• --config-file FILE — sets the name of the configuration file. the default is ~/.xmltv/tv_grab_ch_search.conf. this is the file that --configure writes and that gets read when you're grabbing. one file, two jobs, main character energy.
• --gui OPTION — use this to enable a graphical interface. OPTION may be 'Tk', or left blank for the best available choice. other allowed values of OPTION are 'Term' for normal terminal output (that's the default) and 'TermNoProgressBar' to disable the use of Term::ProgressBar. pick your fighter 💅
• --output FILE — write to FILE instead of standard output. fancy.
• --days N — grab N days. the default is fourteen (14, two whole weeks, iconic).
• --offset N — start N days in the future. the default is to start from now on (= zero).
• --quiet — suppress the progress messages that normally get written to standard error. shhh 🤫 sometimes you just don't wanna hear it.
• --list-channels — writes output giving <channel> elements for every channel available (ignoring the config file, yes really, she doesn't care about your config rn), but no programmes. channels only, no filler.
• --capabilities — show which capabilities the grabber supports. for more info, see <http://wiki.xmltv.org/index.php/XmltvCapabilities>.
• --version — show the version of the grabber. slay, what era are we in.
• --help — print a help message and exit. your emergency contact 🫶

---

🦋 SEE ALSO 🦋

xmltv(5) — go read it, iykyk.

---

💜 AUTHORS 💜

• Daniel Bittel <betlit@gmx.net>. inspired by tv_grab_ch by Stefan Siegl.
• Patric Mueller <bhaak@gmx.net>.
• Markus Keller <markus.kell.r@gmail.com>.

three whole legends, we love to see it 👑

---

🍓 BUGS 🍓

if you happen to find a bug, you're requested to send a mail to one of the XMLTV mailing lists — see the webpages at <http://sourceforge.net/projects/xmltv/>. don't be shy, they wanna hear it fr fr 🙈

---

and that's the whole page, bestie! 💖 this one's from the perl v5.40.1 era, dated 2025-04-19, and it's the TV_GRAB_CH_SEARCH(1p) manual — go grab those listings, you've got this 🌈⭐