• Status Assigned
  • Percent Complete
  • Task Type Patches
  • Category User Interface → Simulator
  • Assigned To
  • Operating System All players
  • Severity Low
  • Priority Very Low
  • Reported Version Daily build (which?)
  • Due in Version Future release
  • Due Date Undecided
  • Votes
  • Private
Attached to Project: Rockbox
Opened by tomers - 2008-08-08
Last edited by tomers - 2009-12-15

FS#9252 - Common keyboard actions for Simulator

Note: This is work in progress.
Status: Code implemented

      Manual not updated
      Wiki not updated (only after commit)

The idea of this patch is to have the same keyboard keys assign to the same actions in all platforms.

For example, have +/- keys (both on keyboard and on Numpad) are assigned to Volume Up and Volume Down keys of the original platform.
For platforms which do not have these keys, pressing the +/- keys in the simulator will do nothing.

This change will help developers to do manual regression testing on lots of platforms easily, as they do not have to memorize each platform’s key assignment.

Future development: Display key assignment on screen, and/or on console

You can already display the key assignment in the simulator if you use the –background option.

Also, the simulators should be consistent with the corresponding device only, not with each other (if that makes sense).

I think the simulator in particular should be consistent over all targets. As long as it has all buttons the device has, it is consistent enough with the targets, imho.

Synced and modify patch

Now displays keyboard assignment on console on load, and when pressing the ‘?’ key.

Moved target specific key assignments from button.c to uisdl.h.

Tested on various targets.

Seems like a good idea to me, but I’m not sure what this has to do:


      printf("A, End\n", UI_KEY_SPECIAL_STR);


      printf("A, End; Keypad 1 (END)\n", UI_KEY_SPECIAL_STR);


Shouldn’t there be a %s somewhere in that printf()?

Thanks for this info. I’ve attached a fixed patch.

Note that we should also update the background images of various players, as the former key used are shown on each image.
I have no clue as to where the original images without these labels are, if there are such images at all.

Hopefully, when this patch is committed, we should also update the Twiki page, and remove the shortcut keys shown there (

About the images: I’m afraid the originals aren’t stored anywhere easily accessible; so you’ll have to either manually edit them or find new ones..


Available keyboard shortcuts


Task Details

Task Editing