TV_GRAB_IT_DVB(1p)

👑 TV_GRAB_IT_DVB 👑

okay bestie, sit down, grab a strawberry 🍓, because we're reading TV_GRAB_IT_DVB(1p) together and it's from the User Contributed Perl Documentation section, which means a real human person wrote it and we're gonna respect every single word, fr fr.

---

✨ NAME ✨

tv_grab_it_dvb — grab TV listings for Italy from the DVB-S stream 💅

---

🦋 SYNOPSIS 🦋

tv_grab_it_dvb --help

tv_grab_it_dvb [--adapter N] [--config-file FILE] --configure

tv_grab_it_dvb [--config-file FILE] [--output FILE] [--days N]
               [--offset N] [--quiet] [--verbose] [--adapter N]
               [--no-cache-summaries]

---

🌈 DESCRIPTION 🌈

so like, the whole point: this thing outputs TV listings for several channels, as provided by the DVB-S stream from Skyitalia. iconic. 🛰️

The grabber is based on the work of Lukkinosat for everything concerning the decoding of data — shoutout, no cap. The tuning part is mostly a port to perl of the relevant parts in szap. And, bestie, listen: this is an early release and should be considered beta quality. 💀 she's new, she's learning, be nice.

First run tv_grab_it_dvb --configure to choose which channels you want to download. Then running tv_grab_it with no arguments will output listings in XML format to standard output. periodt. ✨

• --configure — prompts you for which channels you want, and writes the configuration file. the whole setup arc 💖
• --adapter — use this adapter for tuning and grabbing. Default is 0.
• --config-file FILE — set the name of the configuration file, the default is ~/.xmltv/tv_grab_it_dvb.conf. This is the file written by --configure and read when grabbing.
• --gui OPTION — use this option to enable a graphical interface to be used. OPTION may be 'Tk', or left blank for the best available choice. Additional allowed values of OPTION are 'Term' for normal terminal output (default) and 'TermNoProgressBar' to disable the use of XMLTV::ProgressBar.
• --output FILE — write to FILE rather than standard output.
• --days N — grab N days. Since we cannot decide how much data we get we simply throw away everything above this number of days. rude but necessary 🙈
• --offset N — start N days in the future. The default is to start from today.
• --quiet — suppress the progress messages normally written to standard error. (cron-girlies, this one's for you 🫶)
• --no-cache-summaries — disables caching of summaries in the file summaries.cache. It is advised to leave this option on as the summaries part of the data stream can be very different between grabs, and you might get blank descriptions.
• --verbose — prints out verbose information useful for debugging. Repeat (up to 4x) for more verbosiness. the more you say it the more it tells you 💅
• --min-noname — this is a hack. As I have a situation where there are a few channels whose name I cannot find (usually 3 or 4) you can set the number of channels that can be left nameless. Try using this if the grabber keeps on running forever. literally the "please stop" button 😭
• --version — show the version of the grabber.
• --help — print a help message and exit.

---

💀 CAVEATS 💀

This grabber relies on the linux dvb api, and therefore does not run under other operating systems. she is a linux girlie only, sorry to everyone else 🐧

For Debian users: this means the package does not depend on the Linux::DVB perl package, as this would make it uninstallable on the Debian kFreeBSD and HURD ports. Please install the liblinux-dvb-perl package to use this grabber. (yes bestie, you have to install it yourself, it's giving DIY 🔥)

---

🎀 EXAMPLES 🎀

tv_grab_it_dvb --adapter 2 --configure

configures tv_grab_it_dvb using adapter number 2 🧚

tv_grab_it_dvb --adapter 2 --quiet

grabs the full data without displaying anything (useful in cron scripts) ⭐

---

🔥 SEE ALSO 🔥

xmltv(5).

---

💜 AUTHOR 💜

Davide Chiarini, davide.chiarini@gmail.com

you can find some more help at http://www.htpcpoint.it/forum/

---

and that's the whole page bestie, we ate and left no crumbs 💅✨ — this gorgeous little document ships with perl v5.40.1 and is dated 2025-04-19. mwah, go grab some listings 🫶🎀