TV_GRAB_TR(1p)

📦 version 1.1.1, in ubuntu jammy

💖 tv_grab_tr — the Turkey TV listings grabber, bestie edition 💖

Okay so real talk: this is tv_grab_tr, a 1p man page from the User Contributed Perl Documentation corner of the universe. She grabs TV listings for Turkey. She is that girl. Let's go. ✨

🌸 NAME 🌸

tv_grab_tr — grab TV listings for Turkey. 🇹🇷 no cap.

🎀 SYNOPSIS 🎀

tv_grab_tr --help

tv_grab_tr --configure [--config-file FILE]

tv_grab_tr [--config-file FILE]
           [--days N] [--offset N]
           [--output FILE] [--quiet] [--debug]

tv_grab_tr --list-channels [--config-file FILE]
           [--output FILE] [--quiet] [--debug]

tv_grab_tr --version

tv_grab_tr --capabilities

tv_grab_tr --description

🦋 DESCRIPTION 🦋

So basically? She outputs TV listings in XMLTV format for a whole bunch of stations available in Turkey. The data gets downloaded from Digiturk. 💅

But first — and this is the part nobody reads, and then everyone messages the group chat like "why is it empty" — you must run:

tv_grab_tr --configure

...to pick which stations you actually want to receive. Choose your faves, bestie. 👑

Then once that's done, running tv_grab_tr with no arguments at all will get you listings for your chosen stations, including today. Just like that. Iconic behaviour, honestly. ✨

✨ OPTIONS ✨

  • --help — prints a help message and dips. That's it. That's the whole job. 🫶
  • --configure — prompts you for which stations to download, then writes the configuration file. This is your moment to curate. 🎀
  • --list-channels — spits out a list of all the channels that data is available for. And the list is in xmltv-format, because of course it is. 💖
  • --config-file FILE — sets the name of the configuration file. The default is ~/.xmltv/tv_grab_tr.conf. This is the exact file that --configure writes and the one that gets read when grabbing. She's the blueprint, fr fr. 📁
  • --output FILE — when grabbing, write the output to FILE instead of just yeeting it to standard output. 💌
  • --days N — when grabbing, grab N days. Simple as. 🗓️
  • --offset N — start grabbing at today + N days. Time travel, but make it listings. ⏩
  • --quiet — only print error messages on STDERR. She's shy. She's lowkey. 🤫
  • --debug — provides more information on progress to STDERR to help with debugging. Main character energy for your terminal. 🔍
  • --capabilities — shows which capabilities the grabber supports. For more info, peep http://wiki.xmltv.org/index.php/XmltvCapabilities. 👀
  • --version — shows the version of the grabber. Know your queen. 👑
  • --description — shows a brief description of the grabber. The little blurb. The vibe check. 💜

😭 ERROR HANDLING 😭

If the grabber fails to download listings data for a channel, she will print an error message to STDERR and then keep going with the next configured channel. No dramatic collapse. She's resilient. She's healing. She moves on. 💪

🌈 ENVIRONMENT VARIABLES 🌈

The environment variable HOME can be set to change where configuration files are stored. All configuration lives in $HOME/.xmltv/. 🏠

On Windows, it might be necessary to set HOME to a path without spaces in it. Yes, really. Do not fight this. Just do it. 💀

💜 CREDITS 💜

Grabber written by Dig Lam, dig -dot- lam -at- gmail -dot- com. 🫶

This documentation was copied from tv_grab_uk by Ed Avis, ed -at- membled -dot- com. Credit where credit is due, always. ✨

🙈 BUGS 🙈

None known. (Which is the most suspicious sentence in all of software, but okay bestie, we believe you. 🍓)

And that's the whole page, gorgeous. This one's running on perl v5.34.0, dated 2022-02-19, and it's filed under TV_GRAB_TR(1p). Go configure your channels and slay. 💅✨🌸

📦 where this page comes from