TV_GRA...ODAFONE(1p)

💖 TV_GRA...ODAFONE(1p) 💖

okay so bestie, you found the manual page for tv_grab_pt_vodafone, and it lives in the User Contributed Perl Documentation corner of the manual-verse. Grab a snack, we're doing this together 🍓

---

✨ NAME ✨

tv_grab_pt_vodafone — grab TV listings for Vodafone in Portugal 🇵🇹📺

---

🎀 SYNOPSIS 🎀

tv_grab_pt_vodafone --help

tv_grab_pt_vodafone --configure [--config-file FILE]

tv_grab_pt_vodafone [--config-file FILE]
                    [--days N] [--offset N] [--channel
xmltvid,xmltvid,...]
                    [--output FILE] [--quiet | --debug]

tv_grab_pt_vodafone --list-channels [--config-file FILE]
                    [--output FILE] [--quiet | --debug]

the way that it just runs with no arguments and still delivers… we love a low-maintenance icon 💅

---

🌸 DESCRIPTION 🌸

So basically this program outputs TV listings in XMLTV format for many stations available in Portugal. It snacks on the EPG service from <https://vodafone.pt/> — that's the source of truth, no cap.

First things first tho: you must run tv_grab_pt_vodafone --configure to pick which stations you actually want to receive. Choose your faves, bestie 🎀

Then, once you've done that, running tv_grab_pt_vodafone with no arguments will get listings for the stations you chose, for the maximum 7 days, including today. That's it. That's the whole vibe. Slay ✨

---

💅 OPTIONS 💅

• --configure — prompts you for which stations to download and writes the configuration file. The get-to-know-you phase 🫶
• --config-file FILE — sets the name of the configuration file. The default is ~/.xmltv/tv_grab_pt_vodafone.conf. This is the file that --configure writes and that gets read when grabbing. it's giving "your saved preferences, bestie"
• --output FILE — when grabbing, write output to FILE instead of standard output. Take the receipts somewhere specific 💌
• --days N — when grabbing, grab N days rather than everything available. Pick your portion size 🍰
• --offset N — start grabbing at today + N days. Time travel, but make it calendar-accurate ⏩
• --quiet — only print error-messages on STDERR. Silent but observant, main character energy 🤫
• --debug — provide more information on progress to STDERR to help in debugging. not me turning on debug mode and reading every single line… 🔍
• --list-channels — output a list of all channels that data is available for. The list is in xmltv-format. The full menu, no filter 👑
• --capabilities — show which capabilities the grabber supports. For more information, see <http://wiki.xmltv.org/index.php/XmltvCapabilities>. It's the "what can u do" icebreaker 🦋
• --version — show the version of the grabber. iykyk
• --help — print a help message and exit. the classic "help me help you" 🎀

---

😭 ERROR HANDLING 😭

If the grabber fails to download data from Vodafone, it will print an error message to STDERR and then exit with a status code of 1 to indicate that the data is missing.

fr fr, exit code 1 means the data is missing. Don't ignore it bestie, that's your signal 💀

---

🌈 ENVIRONMENT VARIABLES 🌈

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

On Windows, it might be necessary to set HOME to a path without spaces in it. Spaces are NOT invited to this party 🙈

---

🧚 CREDITS 🧚

Kevin Groeneveld (kgroeneveld at gmail dot com) — icon behavior ✨

This grabber uses code from tv_grab_pt_meo by Karl Dietz, dekarl -at- users -dot- sourceforge -dot- net, and from tv_grab_zz_sdjson by Kevin Groeneveld, kgroeneveld -at- gmail -dot- com. collab era 🫶

The original idea of this grabber came from higuita's shell script, see <https://github.com/higuita/vodafone.pt-xmltv>. OG inspiration, we see you 🌸

Special thanks to Vodafone for building a clean, fast, and public access API; much more reliable than Meo's open API (but sadly not as open) and much better than the lack of any API from NOS. Vodafone really said "here's a clean fast public API" and we are obsessed 💖

---

👑 AUTHOR 👑

Nuno Sénica, nsenica -at- gmail -dot- com. author of the moment 💅

---

💀 BUGS 💀

None known. we love a bug-free queen 🦋

---

and that's the whole page, bestie. This was perl v5.40.1, dated 2025-04-19, and it's the User Contributed Perl Documentation version of TV_GRA...ODAFONE(1p). Go grab those listings — you got this 🌟💜