From MythTV Official Wiki
Jump to: navigation, search


The real FAQ answer is at

If you have any comments or suggestions - please talk about them on the discussion page before editing this page.

Keyboard commands

The file keys.txt in your documentation directory (typically /usr/share/doc/mythtv/ or /usr/local/share/doc/mythtv/) describes what the various keyboard commands are. If you have loaded mythweb, you may change the default keys to your liking.


Keys Action
Arrow keys used to move the highlight point around
ALT-F4 exit out of the application
Space/Enter take action on the item under the highlight point
P play in both "Watch a Recording" and "Delete a Recording"
D delete in both "Watch a Recording" and "Delete a Recording"
I edit recording options from the EPG, "Program Finder", "Program Recording Priorities", or "Fix Scheduling Conflicts" screens. From the Playback and Delete screens, 'I' presents options for recorded shows such as Auto Expire or Stop Recording. Pressing 'I' while on the Recording Options screen will take you to the Advanced Recording Options screen.

Watching TV or a recording

Keys Action
Up or down keys change the channel
num pad Type a number to enter a channel number or jump amount (HHMM format)
P pause / play
C change inputs on TV Tuner card
ESC quits
I puts the On-screen Display up again. During playback, 'I' toggles between position and show description info. If a jump amount is entered, jump to that position (e.g., '75I' or '115I' will jump to one hour and 15 minutes after the start).
M brings up the menu. While in LiveTV the first item is the EPG, while watching a recording, the first item is Edit Recording.
S brings up Electronic Program Guide (EPG).
Page Up jump back the configured number of minutes (default is 10)
Page Down jump ahead the configured number of minutes (default is 10)
End or Z skip to next commercial break marker
Home or Q skip back to previous commercial break marker
T toggle close caption support
F rotate between the various Picture Adjustments (Colour, Hue, etc.) While Picture Adjustment is on-screen, use Left and Right arrows to adjust. These settings adjust the look of the video playback, and are independent of the G-key settings used at record-time. The Xv picture controls must be enabled in the Playback settings.
[ or F10 decrease volume
] or F11 increase volume
| or F9 toggle mute
/ jump to the next "favorite" channel
? mark/unmark the current channel as a "favorite"
U increase the play speed
J decrease the play speed
W cycle through 4:3 aspect ratio, 16:9, 4:3 Zoom (like Pan and Scan), 16:9 Zoom, and 16:9 Stretch (eliminates black sidebars in TV signal)
Left (if a jump amount is entered) to jump back that amount
Right (if a jump amount is entered) to jump ahead that amount

Without the stickykeys option selected

Keys Action
Left rewind the configured number of seconds (default is 5)
Right fast forward the configured number of seconds (default is 30)
< starts rewind mode as if stickykeys are selected
> starts fast forward mode as if stickykeys are selected

With Stickykeys option selected

Keys Action
Right starts fast forward mode
Left starts rewind mode

In fast forward or rewind mode

Keys Action
Left/Right increases the ff/rew speed
0 plays at normal speed, but leaves the time indicator on screen
1 or 2 plays back more slowly than normal ff/rew speed (1 is slowest)
3 plays back at normal ff/rew speed
4-9 plays back faster than normal ff/rew speed (9 is fastest)
Space exits fast forward or rewind mode

While video is paused

Keys Action
Left rewind 1 frame
< rewind 1 second
Right advance 1 frame
> advance 1 second

Watching TV only

Keys Action
G rotate between the various Picture Adjustments (Colour, Hue, etc.) for recording. These values affect the look of the resulting .nuv file, and are independent of the playback picture settings. While Picture Adjustment is on-screen, use Left and Right arrows to adjust.
H Channel history. Each repeat steps back through the previous channels.
O Turns on 'Browse' mode, allowing user to browse channels and program info while watching current show Full Screen.
Alt-F7 Bring up the signal meter
F8 toggle the sleep timer 30m->1hr->1hr30m->2hr->Off
Y switch between multiple capture cards. NOTE: you lose your LiveTV buffer on your current card. Useful for different-sourced cards (such as Dish Network on one, HDTV over-the-air on another card.)

Watching a recording only

Keys Action
Space/Enter set a bookmark at that point. Next time you start the recording, you will automatically jump forward to this point and clear the bookmark.
X queues the current recording for transcoding
O brings up menu to allow toggling settings such as Commercial Auto-Skip, Auto-Expire, etc.
E or M enters/exits edit mode.

In edit mode

Keys Action
Left/Right move forward and backward
Up/Down alter the amount of time you jump forward and backward. Increments are: nearest cutpoint, nearest video keyframe, 1 frame, 0.5 seconds, 1 second, 20 seconds, 1 minute, 5 minutes, and 10 minutes.
Page Up/Page Down move forward and backward to the nearest cut point
< or > move forward or backward by 10 times the normal jump amount
Space/Enter allows you to set or delete a cut point
Z loads the commercial skip list (if one exists) into the cutlist
C or Q clear all cut points in the cutlist

LiveTV Browse Mode

Keys Action
Left browse program prior to current listed program
Right browse program following current listed program
Up browse program on channel above current listed channel/program
Down browse program on channel below current listed channel/program
/ browse program on next favorite channel
0-9 enter a channel number to browse
Space/Enter change channel to channel of current listed program
R/r Toggle recording of current program (cycles through types)
ESC/O Exit Browse mode

Playback Recording Zoom Mode

Keys Action
Left Move video to Left
Right Move video to Right
Up Move video Up
Down Move video Down
Page Up Zoom In
Page Down Zoom Out
Space/Enter Exit Zoom mode leaving picture at current size and position
ESC Exit Zoom mode and return to original size

If you have two or more tuner cards

Keys Action
V toggle Picture-in-picture on or off
B toggles the window focus (lets you change channels on the PiP window)
N swaps the two channels by changing channels on both cards

Electronic Program Guide

Keys Action
Arrows are used to move the highlighted program point around
A, D, S, W perform the same as left, right, down and up
Page Up/Page Down move the channel list up or down a page
Home/End move the highlight left or right by one day
Ctrl+Left or < move the highlight left by one page
Ctrl+Right or > move the highlight right by one page
9, 3, 7, 1 (like a numeric keypad) perform the same as Page Up, Page Down, Home and End
I bring up more information about a show, and allow you to schedule a recording. If you select "Record this showing" while watching Live TV you can "Instant Record" a program.
Space/Enter allow you resolve conflicts or change overrides. If the program is not already scheduled to record, it will instead act like pressing 'I'.
M when on a channel will change to that channel
ESC or C exits without changing the channel
R change the current item from Recording/Not-Recording. Successive keypresses cycle through the scheduled recording type list.
X change the channel to the currently selected channel without leaving the EPG (Most useful in the alternate EPG)
? mark/unmark the current channel as a "favorite"
/ cycle the guide listing between all channels and channel groups

Setting Program or Channel Recording Priorities

Keys Action
Right increases priority value
Left decreases priority value
1 sorts by title
2 sorts by priority
Home/End toggle sort priority
I edit recording options
ESC commits changes and exits

Viewing Scheduled Recordings/Resolving Conflicts

Keys Action
1 show all recordings
2 show only important recordings
Home/End toggle show showing all/important
I edit recording options
Space/Enter resolve conflict or override

Viewing Search Listings

Keys Action
Home change to the previous view if applicable
End change to the next view if applicable
M select another view if applicable. In the title and description search popup, press M again to edit or delete the selected view.

Recording Profiles Setup Screen

Keys Action
D on a custom profile group displays a popup to delete the group
M on a custom profile group displays a menu popup to delete the group

Recording Groups

In the Watch Recordings screen, Recording Groups allow you to separate programs into user-defined categories, such as "Kids", "Alice", "Bob", etc. This can be used to reduce clutter, or to segregate content if you use the PIN function.

Keys Action
M change the view or to set a group password
I move a program from one Recording Group to another

Remote Controls

If you are using MythTV with just a remote control then it is suggested that you map the remote control keys as described below. Your remote control may not have the same set of keys as those named below, the names are only a suggestion that roughly correspond to the function.

If you are adding new key bindings to the program then consideration of this suggested list will help users with remote controls.

This list assumes a minimal remote control that only has 20 keys, nearly all features can be used with this configuration. If you have more keys then you can access all of the features. With only 16 keys most features are usable.

Remote Control LIRC Keystroke Function
0 - 9 0 - 9 channel selection, EPG navigation, ff/rew speed setting (with stickykeys)
Left Arrow Left scroll left, rewind
Right Arrow Right scroll right, fast forward
Up Arrow Up scroll up, channel change up
Down Arrow Down scroll down, channel change down
Page Up PgUp scroll up one page
Page Down PgDown scroll down one page
Select / OK / Play Space Select item, play (with stickykeys) set bookmark
Cancel Escape Cancel, quit playback
Menu m Show menu
Pause p Pause
Other key 1 i Information
Other key 2 c Change tuner card input

More information

You can control just about any program with your remote control from MythTV by using Lirc. With this you can bind any key or combination of keyboard keys to an remotecontrol button. - Lirc