HDHOMERUN_CONFIG(1)

📦 in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 hdhomerun_config(1) — bestie's guide to her Silicon Dust HDHomeRun 💖

okay so. this is hdhomerun_config, a utility used for maintaining and controlling a Silicon Dust HDHomeRun. yes it's a whole thing and yes you're gonna slay with it. 🫶

✨ SYNOPSIS ✨

hdhomerun_config <id> command [options]

that's it. that's the whole vibe check. <id> first, then the command, then whatever options that command wants. 💅

🌸 DESCRIPTION 🌸

okay so picture this: the HDHomeRun is a networked digital television receiver with two tuners. two!! it can tune QAM64, QAM128, QAM256, or 8VSB television streams. icon behavior honestly. 📺✨

it's most useful in the United States, where QAM is very commonly used for cable transmission and 8VSB (ATSC) is the whole thing for Over The Air television transmission. iykyk. 🇺🇸

this utility is your girl for controlling the HDHomeRun, updating it, and querying information about it. like, she does it all. no cap.

the one requirement? the HDHomeRun has to be hooked up on the same subnet as the computer performing the actions. that's the whole deal. and heads up: the HDHomeRun will receive an address via DHCP, so if static addressing is in use on the network instead, the device will not function. 💀 not "might not", not "maybe", it will not. so if it's giving nothing, check that first bestie.

🎀 FEATURES 🎀

  1. Multiple tuners. for those nights that several primetime shows are on at the same time, you won't need to worry. the stress? gone. evaporated. ✨
  2. QAM & OTA support. both tuners can be set as either QAM or OTA. this way if only a few channels are available by one variety, but you would still like those channels, each tuner can be used for the different connections. flexible queen. 👑
  3. Networked. the HDHomeRun can be accessed by any computer on the local network by using VLC, MythTV, or SageTV. group chat energy but for devices. 🌈
  4. Upgradable. Silicon Dust regularly releases firmware updates for the HDHomeRun. these can be used to add support for upcoming recording standards, changing frequencies, or stability. glow-up via firmware, we love to see it. 💖

💅 OPTIONS 💅

here's the menu, order up:

  • discover — locates all HDHomeRun(s) on your network and displays their ID. the "who's here" move. 🔍
  • <id> get help — displays supported configuration for current firmware revision. your cheat sheet fr fr.
  • <id> get <item> — obtains the current value for the given configuration <item>. peeking, respectfully. 🙈
  • <id> set <item> — sets the new current value for the given configuration <item>. now you're the main character. 💅
  • <id> scan <tuner> <file> — performs a QAM/8VSB scan using <tuner> and saves results to <file>. go find those channels bestie. 📡
  • <id> save <tuner> <file> — saves a copy of the stream that <tuner> is tuning to <file>. capture the moment, literally. 💾
  • <id> upgrade <file> — installs <file> as a firmware upgrade on the HDHomeRun. big girl move, do it carefully. 🧚
⚠️ WARNING: don't attempt to upgrade the HDHomeRun with something other than a Silicon Dust firmware update. like. do not. i'm begging. this is the "don't test me" of warnings. 💀🚫

⭐ the config items ⭐

using the May 12, 2007 firmware, here are the currently supported configuration items:

  • /tuner<n>/channel <modulation>:<freq|ch> — get/set modulation and frequency. the classic combo. 🍓
  • /tuner<n>/channelmap <channel map> — get/set channel to frequency map. the whole layout. 🗺️
  • /tuner<n>/filter 0x<nnnn>-0x<nnnn> [...] — get/set PID filter. note the [...], you can stack these. 🧵
  • /tuner<n>/program <program number> — get/set MPEG program filter. 🎬
  • /tuner<n>/target <ip>:<port> — get/set target IP for tuner. where's it going? here. 📍
  • /tuner<n>/status — display status of tuner. the vibe check. ✨
  • /tuner<n>/streaminfo — display stream info. the tea. ☕
  • /tuner<n>/debug — display debug info for tuner. for when it's being mysterious. 🔍
  • /ir/target <ip>:<port> — get/set target IP for IR. yes, the remote too. 📻
  • /lineup/location <countrycode>:<postcode> — get/Set location for lineup. (capital S in "Set" right there in the original, we respect the author's choices 💜)
  • /lineup/location disabled — disable lineup server connection. leave me alone mode. 🙅
  • /sys/version — display firmware version. what era are we in. 🕰️
  • /sys/copyright — display firmware copyright. the legal girlies. 📜
  • /sys/debug — display debug info. no arguments, no <n>, just vibes. 🌈

🦋 AUTHOR 🦋

the HDHomeRun configuration utility was written by Silicon Dust to support their product. periodt. 👑

this manual page was written by Mario Limonciello <superm1@ubuntu.com>, for the Ubuntu project (but may be used by others). shoutout Mario, absolute legend. 🫶

copyright 2005-2006 Silicon Dust Engineering Ltd. this is free software; see the source for copying conditions. there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. like, zero. none. read that again. 😭

and that's the whole page bestie 💖 this was HDHOMERUN_CONFIG(1) from May 26, 2007 — yes, 2007, she's vintage, she's iconic, she's still out here tuning streams. go forth and <id> get help. mwah. 💅✨🌸

📦 where this page comes from