TV_GRAB_CH_SEARCH(1)

📦 version 1.4.0, in alpine 3.24

okay so this is the manual page for tv_grab_ch_search, from the User Contributed Perl Documentation corner of the universe, and honestly? she's a whole vibe. let's get into it 🎀

✨ NAME ✨

tv_grab_ch_search — grab TV listings for Switzerland (straight off the tv.search.ch webpage). Switzerland bestie, you're up 🇨🇭💖

🦋 SYNOPSIS 🦋

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

like, pick your lane, bestie. each line is a different mood 💅

🌸 DESCRIPTION 🌸

so this grabber outputs TV listings for a bunch of channels available in Switzerland and (partly) central Europe. the data comes from tv.search.ch. the catch? the grabber relies on parsing HTML, so it might literally stop working at any time 😭 no cap, that's just how it is.

first thing first: run tv_grab_ch_search --configure to pick which channels you wanna download. then running tv_grab_ch_search with no arguments will output listings in XML format to standard output. slay. periodt. ✨

  • --configure — it asks you, for each available channel, whether to download it, and then writes the configuration file. lowkey the most important step 🫶
  • --config-file FILE — sets the name of the configuration file. the default is ~/.xmltv/tv_grab_ch_search.conf. this is the file written by --configure and read when grabbing. iykyk 💖
  • --gui OPTION — use this option to enable a graphical interface. OPTION may be 'Tk', or left blank for the best available choice. additional allowed values of OPTION are 'Term' for normal terminal output (that's the default) and 'TermNoProgressBar' to disable the use of Term::ProgressBar. girl, choose your aesthetic 💅
  • --output FILE — write to FILE rather than standard output. main character behavior honestly 👑
  • --days N — grab N days. the default is fourteen. fourteen!! that's so many days of television 🍓
  • --offset N — start N days in the future. the default is to start from now on (= zero). time travel but make it listings ⭐
  • --quiet — suppress the progress messages normally written to standard error. she's quiet, she's mysterious, she's not telling you what she's doing 🙈
  • --list-channels — write output giving <channel> elements for every channel available (ignoring the config file), but no programmes. just the names, no drama 🌈
  • --capabilities — show which capabilities the grabber supports. for more information, see <http://wiki.xmltv.org/index.php/XmltvCapabilities>. flex time, bestie 🔥
  • --version — show the version of the grabber. who are you? 💀
  • --help — print a help message and exit. the classic "i don't know what i'm doing but i'm doing it with confidence" move 😭
real talk though: because this grabber parses HTML, it might stop working at any time. that's not me being dramatic, that's the manpage being dramatic. both of us are valid 💀

🧚 SEE ALSO 🧚

xmltv(5). that's the one. go read it, bestie. 💜

👑 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>.

four absolute icons. we stan. 🫶✨

💀 BUGS 💀

if you happen to find a bug, you're requested to send a mail to one of the XMLTV mailing lists, see webpages at <http://sourceforge.net/projects/xmltv/>.

don't suffer in silence, bestie. tell the list. they want to know. 🎀

okay that's the whole page — this was perl v5.42.2, dated 2025-06-30, and it's giving exactly what it needed to give. bye bestie, mwah 💖💅✨

📦 where this page comes from