This is a list of the important freevo commands and their mapping to keys on a keyboard:

You can get this list by pressing h on your keyboard.

If you want to use a remote to controll freevo, you should map your remote keys to that commands. (see lirc)

The mapping of these commands to real functions is done in freevo/src/event.py. But you can overwrite those mappings in your local_conf.py.

For example if you rather like to use UP and DOWN for channel changing than CH+ and CH-, you can put the following there:

EVENTS['tv']['UP']=Event('TV_CHANNEL_UP')
EVENTS['tv']['DOWN']=Event('TV_CHANNEL_DOWN')

The first argument gives the type of menu in which your mapping should become effectiv (here 'tv'), the second argument gives the command key (UP/DOWN) you want to use and the last one gives the action (TV_CHANNEL_UP or TV_CHANNEL_DOWN)

If you fiddle with these settings, you always should check that the command key you want to use is not already used by something else.

If you have a USB remote like the ATIUSBRemote , you can adjust the keymap to work a bit better with it. In your local_conf.py you add:

KEYMAP[key.K_PAGEUP]   = 'UP'
KEYMAP[key.K_PAGEDOWN] = 'DOWN'
KEYMAP[key.K_UP] = 'RIGHT'
KEYMAP[key.K_DOWN] = 'LEFT'

The full list of keys is here http://www.pygame.org/docs/ref/key.html#pygame.key

tvtime

If you're having problems changing channel, volume when using the tv.tvtime plugin, then you may want to directly edit the keymap in freevo/src/tv/plugins/tvtime.py around line 594 to look something like:

        events = { 'Left' : em.MIXER_VOLDOWN,
                   'Right' : em.MIXER_VOLUP,
                   'Up' : em.TV_CHANNEL_UP,
                   'Down' : em.TV_CHANNEL_DOWN,
                   'Escape' : em.STOP,
                   'Enter' : em.TOGGLE_OSD,
                   '_' : em.Event(em.BUTTON, arg='PREV_CHAN'),
                   '0' : em.INPUT_0,
                   ...

Volume bodge

If you've tried the above and can change channels but still can't change the volume you can try the following:

Install this patch.

In src/tv/plugins/tvtime.py add in the same place as above:

                   ...
                   'Left' : em.Event(em.TV_SEND_TVTIME_CMD, arg='MIXER_DOWN'),
                   'Right' : em.Event(em.TV_SEND_TVTIME_CMD, arg='MIXER_UP'),
                   ...

Restart freevo and volume will now work! As long as /etc/tvtime/tvtime.xml and ~/.tvtime/tvtime.xml are using the right mixer.

mplayer

If you want to specify your own mplayer key commands in mplayer style try

local_conf.py

# Add custom controls when watching avi's and others

MPLAYER_ARGS = { 'dvd'    : '-cache 8192',
                  'vcd'    : '-cache 4096',
                  'cd'     : '-cache 1024 -cdda speed=2',
                  'tv'     : '-nocache',
                  'ivtv'   : '-cache 8192',
                  'avi'    : '-cache 1024 -fs -input conf=/etc/freevo/mplayer.conf',
                  'rm'     : '-cache 5000 -forceidx',
                  'rmvb'   : '-cache 5000 -forceidx',
                  'webcam' : 'tv:// -tv driver=v4l:width=352:height=288:outfmt=yuy2:device=/dev/video2',
                  'default': '-cache 1024 -fs -input conf=/etc/freevo/mplayer.conf'
                  }

/etc/freevo/mplayer.conf

##
## MPlayer input control file
##
## Make it similar to tvtime
## Seeking only works in avi's if their -idx (index) has been built

UP seek +10
DOWN seek -10
LEFT volume -3
RIGHT volume +3
q quit
f vo_fullscreen
ESC quit