tvtime-command(1)

✨ NAME ✨

tvtime-command — control a running tvtime process.

(okay bestie, this is the tvtime-command(1) page from the General Commands Manual — we folded that header in like a cute little bow 🎀)

🦋 SYNOPSIS 🦋

tvtime-command [COMMAND] ...

🌸 DESCRIPTION 🌸

okay so tvtime-command lets you control a running tvtime process by sending it commands. It communicates with tvtime through a FIFO, otherwise known as a named pipe. Commands are case-insensitive, and they're executed in order. periodt. 💅

🎮 COMMANDS 🎮

• AUTO_ADJUST_PICT — restores the picture settings (brightness, contrast, hue, colour) to their default values. factory reset but make it fashion ✨
• AUTO_ADJUST_WINDOW — automatically resizes the window to match the content inside it. this is for when you resize tvtime into, say, a long rectangle, and want it to jump back to being a perfect 4:3 box around the content. main character window energy 👑
• BRIGHTNESS_DOWN — lowers the brightness setting on the input. dim it a lil 🔅
• BRIGHTNESS_UP — increases the brightness setting on the input. glow up ✨
• CHANNEL_[0-9] — simulates a keypad number press. keypad number energy 🔢
• CHANNEL_ACTIVATE_ALL — re-activates all channels in the list. use this to re-initialize the channel list before running the scanner if you believe some channels are missing, or if new channels have become available. bring 'em back 🫶
• CHANNEL_DEC / CHANNEL_DOWN — move one channel down in the channel list. down bad but for channels 📉
• CHANNEL_INC / CHANNEL_UP — move one channel up in the channel list. upward slay 📈
• CHANNEL_JUMP / CHANNEL_PREV — changes to the last channel you were at. useful for jumping back and forth between two programs on distant channels. remote-control ping-pong 🏓
• CHANNEL_RENUMBER — renumbers the current channel. this will swap the current channel with the number you type in. use this to configure your station list to suit preference or locality. customize the lineup, bestie 💅
• CHANNEL_SAVE_TUNING — saves the current fine tuning settings as a custom channel in the station list. save that tuning, it's iconic 💾
• CHANNEL_SCAN — walks from the current position through the channel list, disabling any channels for which no signal is detected. this command is only available if signal checking is enabled. no signal, no entry 🚫
• CHANNEL_SKIP — toggles the current channel as being active or disabled in the station list. you can use this to manually scan your channels and enable those with signal or disable duplicate stations. skip or unskip, your call 💅
• COLOUR_DOWN / COLOR_DOWN — decreases the input colour picture setting. this will make the image less colourful until it is black-and-white. fading to grayscale, mood 🌫️
• COLOUR_UP / COLOR_UP — increases the input colour picture setting. this will give the image more colour. saturation slay 🌈
• CONTRAST_DOWN — decreases the contrast setting of the input. soft focus vibes 🫧
• CONTRAST_UP — increases the contrast setting of the input. punch it up 🔥
• DISPLAY_INFO — this will re-display the OSD for the current channel, showing the channel information, current deinterlacer and framerate, the time, and input settings. info dump but make it cute 📋
• DISPLAY_MESSAGE — this will display a message along the bottom of the OSD. useful for cron jobs or other scripts to send notifications to a user running tvtime. scripted shoutout 💌
• DOWN — this command provides the dual functionality of channel down or menu arrow down, depending on whether the menu is currently active. this command is to be used together with the LEFT, RIGHT and UP commands. choose your fighter ⬇️
• ENTER — sends a virtual enter command. use this when changing the channel:

tvtime-command channel_1 channel_5 enter

will change to channel 15.

• FINETUNE_DOWN — decreases the fine tuning setting for the current channel. tiny tweak down 🔧
• FINETUNE_UP — increases the fine tuning for the current channel. tiny tweak up 🛠️
• HUE_DOWN — decreases the hue setting of the input. hue down, mood shift 🎨
• HUE_UP — increases the hue setting of the input. hue up, colour rotate 🌈
• KEY_EVENT — sends a fake keystroke event to tvtime. this is useful for doing complex operations via a remote control, as you can indirect events to tvtime's internal key binding system. ghost-typing for your remote 👻
• LEFT — this command provides the dual functionality of mixer volume down or menu back command, depending on whether the menu is currently active. this command is to be used together with the RIGHT, UP and DOWN commands. left swipe but for menus ⬅️
• MENU_DOWN — in menu mode, this command moves the cursor down one entry in the menu. menu navigation, but downward ⬇️
• MENU_ENTER — in menu mode, this command selects the current entry or moves forward one level in the menu. press it, bestie ✅
• MENU_EXIT — in menu mode, this command shuts off the menu. bye-bye menu 👋
• MENU_BACK — in menu mode, this command moves back one level in the menu. back it up ↩️
• MENU_ENTER — in menu mode, this command selects the current entry or moves forward one level in the menu. (yes, it's listed again — the original said it twice, so we keep it twice 💖)
• MENU_UP — in menu mode, this command moves the cursor up one entry in the menu. upward menu energy ⬆️
• MIXER_DOWN — decreases the volume setting for the Line In device from /dev/mixer. an optional parameter specifies the percentage to decrease by. lower the mixer, optional percent and all 🎚️
• MIXER_TOGGLE_MUTE — toggles the mute status with the mixer, and not with the capture card like TOGGLE_MUTE does. mixer mute specifically, bestie 🔇
• MIXER_UP — increases the volume setting for the Line In device from /dev/mixer. an optional parameter specifies the percentage to increase by. turn it up, optional percent included 🔊
• NOOP — the command to do nothing. useful for when you want to blank out one of the default key bindings in tvtime. silent treatment, on purpose 💀
• OVERSCAN_DOWN — decreases the overscan compensation amount. this will show more of the captured input. zoom out, more picture 🖼️
• OVERSCAN_UP — increases the overscan compensation amount. this will show less of the captured input. zoom in, crop it 💅
• PICTURE — selects which picture setting (brightness/contrast/colour/hue) to change using the PICTURE_UP and PICTURE_DOWN commands. pick your picture parameter 🎛️
• PICTURE_UP — increases the current picture setting value (brightness/contrast/colour/hue). up, up, and away 📈
• PICTURE_DOWN — decreases the current picture setting value (brightness/contrast/colour/hue). down, down, down 📉
• RESTART — asks tvtime to restart itself. this is used in the menu when we have changed a value that we can't yet change at runtime. reboot era 🔄
• RIGHT — this command provides the dual functionality of mixer volume up or menu enter command, depending on whether the menu is currently active. this command is to be used together with the LEFT, UP and DOWN commands. right swipe but for menus ➡️
• RUN_COMMAND — instructs tvtime to spawn a command. this can be used to start a program using a key in tvtime or lirc, such as to spawn mythepg or alevt. using tvtime-command run_command "xterm" will have tvtime call system( "xterm &" ). spawn it, bestie 🚀
• SAVE_PICTURE_GLOBAL — saves the current picture settings as the global defaults. save the whole vibe 💾
• SAVE_PICTURE_CHANNEL — saves the current picture settings as the defaults for the current channel on the tuner. per-channel picture memory 📺
• SCREENSHOT — asks tvtime to take a screenshot. screenshots are saved to the directory listed as the screenshot directory in the tvtime.xml configuration file. the default is the running user's home directory. say cheese 📸
• SET_AUDIO_MODE — this command takes a parameter and sets the current audio mode. valid options are "mono", "stereo", "sap", "lang1" or "lang2". pick your audio flavor 🎧
• SET_DEINTERLACER — this command takes a parameter and sets the current deinterlacer. valid options are the short name of any of the deinterlacers available in tvtime. deinterlace, but make it named 💫
• SET_FRAMERATE — this command takes a parameter and sets the current framerate. valid options are "full", "top" and "bottom". framerate choose-your-own-adventure 🎞️
• SET_FREQUENCY_TABLE — this command takes a parameter and sets the current frequency table. frequency table glow-up 📡
• SET_FULLSCREEN_POSITION — this command sets where widescreen output will be aligned when in fullscreen mode, either top for the top of the screen, center, or bottom. fullscreen alignment, choose your spot 🖥️
• SET_INPUT — this command takes a parameter and sets the the capture card input (0-n). among the Inputs are: the tuner, composite, or S-Video connectors on the capture card. input roulette 🎰
• SET_INPUT_WIDTH — this command takes a parameter and sets the current input width in pixels. it will be used in tvtime after a restart. width now, restart later 📐
• SET_MATTE — this command sets the matte to apply to the output. this changes the size of the output window, and is useful for watching a 2.35:1 movie in a long, thin window, or for watching it at the top of the screen using the fullscreen position option. valid options here are 16:9, 1.85:1, 2.35:1 or 4:3. matte girl aesthetic 🖤
• SET_NORM — this command takes a parameter and sets the current television standard. it will be used in tvtime after a restart. standard now, restart later 📺
• SET_STATION — this command takes a station name or number as a parameter and changes the channel to the station given. station jump, no remote needed 📻
• SET_XMLTV_LANGUAGE — set the preferred language code for XMLTV data. the argument can be either the two-letter language code according to ISO 639 or a number to select one of the known languages. XMLTV language, polyglot era 🌍
• SHOW_DEINTERLACER_INFO — shows a help screen on the OSD describing the current deinterlacer setting. deinterlacer lore drop 📖
• SHOW_MENU — this command is used to bring up the tvtime setup menu. menu time 🎀
• SHOW_STATS — shows a debug screen showing statistics about the running instance of tvtime. stats for the nerds, and by nerds I mean us 💅
• SLEEP — this command sets the sleep timer to tell tvtime to shut itself off after a certain amount of time. sending this command will first activate the feature, and sending it again will increase the timer up until a maximum value at which point it is shut off. sleep timer escalation 😴
• TOGGLE_ALWAYSONTOP — if supported by your window manager, this command will ask to have the window be put into an "always on top" state, where no other window can be stacked above it. top-tier window behavior 👑
• TOGGLE_ASPECT — toggles the display between 4:3 and 16:9 mode. use 16:9 mode if you have configured an external DVD player or satellite receiver to output anamorphic 16:9 content. aspect ratio flip 🔄
• TOGGLE_AUDIO_MODE — toggles between the available audio modes on this channel. it can take some time before the driver discovers that modes are available. audio mode roulette, with a loading screen 🎧

TOGGLE_BARS

okay so this one asks tvtime to show colourbars. These colourbars are generated by tvtime itself and are not related to your capture card at all — they're just here to help you configure your video card and display device. Once your settings are correct with these colourbars, try colourbars from an input source like an external DVD player and make sure they match up. ✨

TOGGLE_CC

Enables closed caption information to be displayed in the tvtime window. But listen: closed captioning is only available if you have enabled VBI reading in your tvtime.xml configuration file. 📺

TOGGLE_CHANNEL_PAL_DK

For PAL users, this toggles the audio mode of the current channel between the PAL-BG and PAL-DK audio norms. 🎚️

TOGGLE_CHROMA_KILL

Enables or disables the chroma killer filter, which makes the input black and white. Useful when watching a black-and-white movie to avoid chrominance artifacts. 🖤🤍

TOGGLE_COLOR_INVERT / TOGGLE_COLOUR_INVERT

Turns on or off the colour invert filter. This is (apparently) useful for users of the Australian cable company Optus who want to avoid using the decryption boxes and tune using their capture card directly. 🌈💀

TOGGLE_DEINTERLACER

This toggles between the available deinterlacing methods. 🔄

TOGGLE_FULLSCREEN

This toggles between fullscreen and windowed mode. 🖥️

TOGGLE_FRAMERATE

Toggles the framerate at which tvtime will output. Options are:

• full frame rate (every field deinterlaced to a frame)
• half frame rate TFF (every top field deinterlaced to a frame)
• half frame rate BFF (every bottom field deinterlaced to a frame)

That's a whole lot of frames, bestie. 🎞️

TOGGLE_INPUT

Switches the capture card input used. Among the Inputs are: the tuner, composite, or S-Video connectors on the capture card. 🔌

TOGGLE_MATTE

Switches between the available mattes. This cuts off the top and bottom of the input picture to help fit the window to the image content. 🖼️

TOGGLE_MIRROR

Turns on or off the mirror filter, which flips the input. This is useful for using tvtime with mirroring projectors, although the manpage literally says: "I don't think it will actually work as intended yet since we don't mirror the OSD output. :) Comments appreciated." So yeah, iconic honesty. 🪞💖

TOGGLE_MUTE

Toggles the mute state in the capture card (and not in your soundcard). 🔇

TOGGLE_NTSC_CABLE_MODE

Toggles the NTSC cable mode settings: Standard, IRC, and HRC are available. 📡

TOGGLE_PAL_DK_AUDIO

For PAL users, toggles the default audio mode of all channels between the PAL-BG and PAL-DK audio norms. 🎶

TOGGLE_PAL_SECAM

Toggles between PAL and SECAM on the current channel. This feature is useful for regions which receive both PAL and SECAM channels, such that tvtime can be configured on a per-channel basis for the correct norm. 🌍

TOGGLE_PAUSE

Enters pause mode. Pause mode is a debugging feature used to test deinterlacer filters by allowing you to see the output of a single set of frames with various deinterlacers. ⏸️

TOGGLE_PULLDOWN_DETECTION

Enables or disables the 2–3 pulldown detection feature for NTSC input. 🎬

TOGGLE_QUIET_SCREENSHOTS

When this option is turned on, screenshots will not announce themselves on the OSD. This is useful if you intend to take a lot of screenshots, and don't want the text to interrupt your TV watching or appear in other screenshots. 🤫📸

TOGGLE_SIGNAL_DETECTION

Toggles on and off tvtime's signal detection code. Signal detection enables features like channel scanning and increases responsiveness on channels with poor reception, but may make it impossible to watch stations where the reception is too bad for the card to detect it reliably. 📶😭

TOGGLE_XDS

Toggles on and off tvtime's XDS decoding code. XDS is used to send information about the channel including the network name and call letters, and sometimes information about the current show. This information is then shown on the OSD and saved to the stationlist.xml file. 📝

TOGGLE_XMLTV_LANGUAGE

Toggles which language to show by default from the XMLTV file from the ones available in the file. 🗣️

UP

This command provides the dual functionality of channel up or menu arrow up, depending on whether the menu is currently active. This command is to be used together with the LEFT, RIGHT and DOWN commands. ⬆️

QUIT

Asks the running tvtime process to exit. 👋

---

AUTHORS

Billy Biggs, Stewart Allen. 👑

---

SEE ALSO

• tvtime(1)
• tvtime.xml(5)
• stationlist.xml(5)

---

And that's the whole vibe, bestie! This page was literally tvtime 1.0RC1, dated October 2004, and it's the tvtime-command(1) manual. 💖✨🦋