You can provide customized gamepad configuration file in the disk images folder. The file name is bindings.cfg (iOS) or keypad.json (Android). They have different syntax.

bindings.cfg: Key Bindings on iOS

There can be up to 6 buttons on iPad, only first 4 buttons are used for iPhone. We use a lisp-like syntax:

(update-button-bindings (list key-lalt) (list key-lctrl) (list key-esc) (list key-enter)
                        (list key-f10) (list key-f1))
(update-button-titles   "Fire"         "Jump"            "ESC"          "ENTER"          
                        "F10"           "HELP")

As you see, it's possible to provide multiple keys for a single button, for example:

(list key-lalt key-lctrl)

keypad.json: Key Bindings on Android

There are only four buttons:

[
  {
    "title": "pgup",
    "key"  : "key-kp-page-up"
  },
  {
    "title": "pgdn",
    "key"  : "key-kp-page-down"
  },
  {
    "title": "home",
    "key"  : "key-kp-home"
  },
  {
    "title": "end",
    "key"  : "key-kp-end"
  }
]

Key Names

Here is a list of key names to be used in the configuration file.

key-esc
key-f1
key-f2
key-f3
key-f4
key-f5
key-f6
key-f7
key-f8
key-f9
key-f10
key-f11
key-f12
---------------------------------------- 
key-grave
key-1
key-2
key-3
key-4
key-5
key-6
key-7
key-8
key-9
key-0
key-minus
key-equals
key-backspace
---------------------------------------- 
key-tab
key-q
key-w
key-e
key-r
key-t
key-y
key-u
key-i
key-o
key-p
key-left-bracket
key-right-bracket
---------------------------------------- 
key-caps-lock
key-a
key-s
key-d
key-f
key-g
key-h
key-j
key-k
key-l
key-semicolon
key-quote
key-backslash
key-enter
---------------------------------------- 
key-lshift
key-left-backslash
key-z
key-x
key-c
key-v
key-b
key-n
key-m
key-comma
key-period
key-slash
key-rshift
---------------------------------------- 
key-lctrl
key-lalt
key-space
key-ralt
key-rctrl
---------------------------------------- 
key-insert
key-delete
key-left
key-home
key-end
key-up
key-down
key-page-up
key-page-down
key-right
---------------------------------------- 
key-num-lock
key-kp-home
key-kp-left
key-kp-end
key-kp-divide
key-kp-up
key-kp-5
key-kp-down
key-kp-insert
key-kp-multiply
key-kp-page-up
key-kp-right
key-kp-page-down
key-kp-delete
key-kp-subtract
key-kp-add
key-kp-enter