TV_GRAB_HURO(1)

πŸ“¦ version 1.4.0, in alpine 3.24

πŸ’… tv_grab_huro β€” the Hungary TV listings grabber, bestie edition πŸŽ€

okay so real talk: this is tv_grab_huro, a lil Perl script from the XMLTV family (that's the User Contributed Perl Documentation corner of the man-page universe, iykyk) and it grabs TV listings for Hungary. no cap. let's get into it πŸ¦‹


✨ NAME ✨

tv_grab_huro β€” grab TV listings for Hungary. literally that's the whole job πŸ’–


🌸 SYNOPSIS 🌸

here's every single way you can call her:

tv_grab_huro --help

tv_grab_huro [--config-file FILE] --configure [--gui GUITYPE]

tv_grab_huro [--config-file FILE] [--output FILE] [--days N] [--offset
N]                [--slow] [--get-full-description] [--max-desc-length
LENGTH]                [--icons | (--local-icons DIRECTORY
[--no-fetch-icons])]                [--gui GUITYPE] [--quiet]

tv_grab_huro --list-channels                [--icons | (--local-icons
DIRECTORY [--no-fetch-icons])]

tv_grab_huro --capabilities

tv_grab_huro --version

she's flexible, she's booked, she's busy πŸ’…


🫢 DESCRIPTION 🫢

so this grabber outputs TV listings for a bunch of channels you can get in Hungary. but heads up bestie β€” the grabber relies on parsing HTML, which means it might stop working at any time 😭 fr fr, HTML scraping is that one friend who changes their whole personality every six months.

first thing you gotta do: run tv_grab_huro --configure to pick which channels you actually want to download. then running tv_grab_huro with no arguments just outputs listings in XML format to standard output. slay. ✨

here's the whole menu of flags, no skips:

  • --configure β€” prompts you for which channels you want, and writes the configuration file. the starter pack, the entry point, the main character move πŸ‘‘
  • --config-file FILE β€” sets the name of the configuration file. the default is ~/.xmltv/tv_grab_huro.conf. this is the file that --configure writes and that gets read when grabbing. so like, it's the whole memory of your setup 🧠✨
  • --gui GUITYPE β€” use this one to enable a graphical interface. OPTION (that's the GUITYPE value) may be 'Tk', or you can leave it blank for the best available choice. other allowed values of OPTION are 'Term' for normal terminal output (that's the default) and 'TermNoProgressBar' to disable the use of Term::ProgressBar. pick your vibe πŸ’…
  • --output FILE β€” write to FILE rather than standard output. giving "I don't do stdout" energy.
  • --days N β€” grab N days. the default is eight. eight whole days of television, she's committed πŸ“
  • --offset N β€” start N days in the future. the default is to start from today. time travel but make it scheduling πŸ¦‹
  • --quiet β€” suppress the progress messages that normally get written to standard error. shhh. no yapping πŸ™ˆ
  • --slow β€” enables "long strategy run": port.hu publishes only some (vital) information on the actual listing pages, and the rest is shown in a separate popup window. if you'd like to parse the data from these popups as well, supply this flag. but consider that the grab process takes much longer when doing so, since many more web pages have to be retrieved. so like... she's thorough, but she's not fast πŸ’€
  • --get-full-description β€” quite like --slow, but it doesn't always download data from the popup window. instead it's only requested if the description in the overview is truncated. selective queen behavior ✨
  • --list-channels β€” writes output giving <channel> elements for every channel available (ignoring the config file), but no programmes. window shopping only πŸŽ€
  • --capabilities β€” shows which capabilities the grabber supports. for more information, see <http://wiki.xmltv.org/index.php/XmltvCapabilities>. receipts! πŸ“‹
  • --version β€” shows the version of the grabber. who are you? πŸ’–
  • --icons and --local-icons DIRECTORY β€” get the URL for channel-logos together with the channel-list. with --icons specified, the logos (images) will not be fetched β€” just their URL (http://...) gets written in the output XML. if called with --local-icons, the generated URL (file://...) will point to the local directory DIRECTORY and all channel logos will be grabbed and saved under this place. use the --no-fetch-icons option to disable the icon fetching. 🌈 iconic, genuinely.
  • --max-desc-length LENGTH β€” can be used to maximize the length of the grabbed program long description. this is useful if you have a viewer program (using this xmltv output) which can't display the description in a user-friendly way if it's more than LENGTH characters. we love a size limit bestie 🫢
  • --help β€” print a help message and exit. the classic. the icon. the moment. πŸ‘‘

πŸ’œ SEE ALSO πŸ’œ

xmltv(5) β€” go read it, she said so πŸ’…


🌟 AUTHOR 🌟

Attila Szekeres and Zsolt Varga. based on tv_grab_fi by Matti Airas. heavily patched and earlier maintained by Stefan siegl <stesie@brokenpipe.de>, reworked and now maintained by Balazs Molnar <mbdev@freemail.hu>. a whole lineage, a whole family tree of maintainers, we stan succession planning πŸ‘‘


πŸ’€ BUGS πŸ’€

  • the data source does not include full channels information, and the channels are identified by short names rather than the RFC2838 form recommended by the XMLTV DTD. so, not ideal, not the glow-up we wanted 😭
  • this grabber no longer supports Romanian listings as of 2024. see <https://github.com/XMLTV/xmltv/issues/227> for the lore.

⚠️ friendly reminder bestie: the HTML parsing thing means it might break at literally any moment. don't build your whole personality on it. (jk build your whole personality on it, but keep a backup plan 🫢)

and that's the whole page! this gem is perl v5.42.2, dated 2025-06-30 β€” so go forth, grab those Hungarian listings, and remember: TV guide, but make it fashion. πŸ’…βœ¨πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from