TV_GRA...REEVIEW(1p)

💖 tv_grab_uk_freeview 💖

okay bestie, welcome to the tv_grab_uk_freeview page, from the User Contributed Perl Documentation corner of the manual-verse, section 1p. sit down, grab a strawberry, we're getting your UK Freeview listings and we're getting them correctly. 🍓✨

---

🌸 NAME 🌸

tv_grab_uk_freeview — grab TV listings for UK (Freeview). that's it, that's the job, and it ate. 👑

---

🦋 SYNOPSIS 🦋

look at these four whole moods:

tv_grab_uk_freeview --help

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

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

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

the first one is your "what is this thing" era, the second is your set-it-up era, the third is your actually-grabbing-listings era, and the fourth is your "just show me the channels" era. main character energy, all four. 💅

---

💜 DESCRIPTION 💜

so basically: this thing outputs TV listings for channels available on Freeview (UK). no cap.

the way that you start is you run tv_grab_uk_freeview --configure first, to choose which channels you want to download. then, once you've done that little ritual, running tv_grab_uk_freeview with no arguments will output listings in XML format to standard output. iconic behaviour, honestly.

now, channel ids — this is the part people get confused about so listen up 🫶 — they get output either as the Freeview channel number (e.g. 101 for BBC One HD) or as the internal channel id (e.g. 17536 for BBC One HD). two totally different numbers, same BBC One HD, choose your fighter. you can set this option during --configure.

---

✨ the options, bestie ✨

• --configure — prompts you for which channels you want, and writes the configuration file. your lil setup era. 🎀
• --gui OPTION — use this 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 (default) and 'TermNoProgressBar' to disable the use of Term::ProgressBar. yes queen, pick your vibe. 🌈
• --config-file FILE — sets the name of the configuration file. the default is ~/.xmltv/tv_grab_uk_freeview.conf. this is the file written by --configure and read when grabbing. it's giving home base. 🏠
• --days N — grab N days. the default is 7 days. a whole week of drama, as a treat. 📅
• --offset N — start N days in the future. the default is to start from today. time travel but legal. ⏳
• --fast — only fetch summary information for each programme. this is only title, start/stop times, episode number. speedrun mode, fr fr. ⚡
• --output FILE — write to FILE rather than standard output. 🗂️
• --quiet — suppress the progress messages normally written to standard error. shhhh, no talking, just listings. 🤫
• --debug — provide more information on progress to standard error to help in debugging. detective mode activated. 🔍
• --list-channels — output a list (in xmltv format) of all channels that can be fetched. window shopping. 🛍️
• --version — show the version of the grabber. 🏷️
• --help — print a help message and exit. the classic. 🫶

---

🔥 SEE ALSO 🔥

xmltv(5). go read it, iykyk. 💜

---

👑 AUTHOR 👑

Geoff Westcott, February 2024. absolute legend, we love to see it. 💖

---

🎀 BUGS 🎀

None known. literally flawless (as far as anyone's saying). ✨

---

and that's the whole page bestie!! go configure your channels and slay 💅

---

sign-off time: this was perl v5.40.1, dated 2025-04-19, and we are soooo done here. byeee 🦋💖✨