tvtime-configure(1)

💖 tvtime-configure(1) — the manual page, but make it fashion 💖

okay bestie, welcome to the tvtime-configure manual page, section 1 of the General Commands Manual ✨ yes we're in the big leagues now, one whole man page, and it's giving "I know exactly what I'm doing and also I'm adorable." let's get into it 🫶

🌸 NAME 🌸

tvtime-configure — change settings in the tvtime configuration file 💅

✨ SYNOPSIS ✨

tvtime-configure [ OPTION ] ...

that's it, that's the whole vibe. options, plural, go wild 🎀

🦋 DESCRIPTION 🦋

so here's the tea: tvtime-configure lets you set configuration settings for tvtime without actually starting the application. no window popping up, no nothing, just you, the command line, and your settings. periodt.

and why is that iconic? because it's useful for installation programs like debconf — they can configure tvtime without having to write a whole parser for the configuration file 😭 like imagine having to write a parser. couldn't be them.

the command line options are a subset of those for tvtime itself. so if you know tvtime, you already lowkey know this one. iykyk 💜

👑 OPTIONS 👑

• -a, --widescreen — starts tvtime in 16:9 aspect ratio mode. cinematic. main character energy 🎬
• -A, --nowidescreen — starts tvtime in 4:3 aspect ratio mode. retro, vintage, classic 💫
• -h, --help — show usage information. when in doubt, ask for help, bestie 🫶
• -m, --fullscreen — start tvtime in fullscreen mode. no distractions, just vibes 🌈
• -M, --window — start tvtime in windowed mode. multitasking queen 👑
• -p, --fspos=POS — set the fullscreen window position. use this if you have a projector, it helps tvtime fit properly onto your screen 📽️ valid values are:
  • top
  • bottom
  • centre (default)
• -F, --configfile=FILE — additional config file to load settings from. extra config? say less 📂
• -H, --height=HEIGHT — sets the height of the output window to start up at, in scanlines. the default output window size is 576 scanlines 📏
• -I, --inputwidth=SAMPLING — V4L input scanline sampling, defaults to 720. this sets how many pixels per scanline to request from the capture card. a higher setting gives better quality, while a lower setting means we do less work, and so tvtime will run faster ✨ if you have a slower CPU (like, less than 500Mhz or so), maybe values of 480 or 400 might suit you best. for best quality, choose a high value like 720 or 768. many capture cards cannot sample higher than 768 pixels per scanline ⚠️ (respect the limit, she has boundaries)
• -d, --device=NAME — video4linux device to use, defaults to /dev/video0 🎥
• -b, --vbidevice=DEVICE — VBI device to use, defaults to /dev/vbi0 📡
• -i, --input=INPUTNUM — video4linux input number, defaults to 0. cards commonly have a bunch of sources — for example, on my WinTV card, source 0 is my tuner and source 1 is the composite input 🎛️ so yeah, know your sources
• -c, --channel=CHANNEL — on startup, tvtime will tune to the given channel. otherwise, the channels from the config file will be used 📺
• -n, --norm=NORM — the mode to set the tuner to, defaults to NTSC. valid modes are:
  • NTSC
  • PAL
  • SECAM
  • PAL-NC
  • PAL-M
  • PAL-N
  • NTSC-JP
• -f, --frequencies=NAME — the channels you are receiving with the tuner, defaults to us-cable. valid values are:
  • us-cable
  • us-broadcast
  • japan-cable
  • japan-broadcast
  • europe
  • australia
  • australia-optus
  • newzealand
  • france
  • russia
• -R, --priority=PRI — sets the process priority (see nice(1)) that tvtime should be run at. be nice to her 🥺
• -t, --xmltv=FILE — reads XMLTV listings from the given file to display on the OSD. channels are looked up based on their name, and tvtime will display the show title, sub-title and show description on the OSD 📖 obsessed
• -l, --xmltvlanguage=LANG — use XMLTV data in given language, if available. languages are represented by their two-letter language code (for example, "de" for German). the default language used in the file will be used if this is unset or set to "none" 🌍
• -x, --mixer=DEVICE[:CH] — the mixer device and channel for the volume controls, defaults to /dev/mixer:line. valid channels are:
  • vol
  • bass
  • treble
  • synth
  • pcm
  • speaker
  • line
  • mic
  • cd
  • mix
  • pcm2
  • rec
  • igain
  • ogain
  • line1
  • line2
  • line3
  • dig1
  • dig2
  • dig3
  • phin
  • phout
  • video
  • radio
  • monitor

💜 AUTHORS 💜

Billy Biggs. 💅 (shoutout, icon behaviour, no cap)

🎀 SEE ALSO 🎀

tvtime(1), tvtime.xml(5),

okay that's the whole page, you ate that fr fr 🍓 go forth and configure, bestie. this was tvtime 1.0RC1 from way back in April 2005 — vintage queen behaviour, and honestly? still slaying. mwah 💋✨