This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
wiki:components:nxagent_keyboard_shortcuts [2012/12/06 14:19] arw [Configurable keybindings in nxagent] |
— (current) | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ==== General remarks ==== | ||
- | |||
- | === about this Wiki page === | ||
- | |||
- | This Wiki page is largely a copy of the '' | ||
- | [[http:// | ||
- | sync. | ||
- | |||
- | === about nxagent === | ||
- | |||
- | nxagent is the process that an X2go _server_ executes. Therefore the configuration described below | ||
- | is evaluated on an X2go Server and you have to place your configuration file on the _server_. | ||
- | |||
- | ==== Configurable keybindings in nxagent ==== | ||
- | |||
- | Keybindings in the redistributed x2go version of nxagent can now be configured | ||
- | by the user. This is done via a configuration file. | ||
- | |||
- | ==== File location ==== | ||
- | |||
- | nxagent searches for the configuration file in the following order: | ||
- | * in the location given by the '' | ||
- | * in the location given by the NXAGENT_KEYSTROKEFILE environment variable | ||
- | * in ~/ | ||
- | * in / | ||
- | |||
- | If none of those files is accessible, the default configuration is used which | ||
- | is the same as the old, traditional nxagent keybindings. | ||
- | |||
- | ==== File format ==== | ||
- | |||
- | The configuration file is XML with the following format: | ||
- | |||
- | <code xml> | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | </ | ||
- | </ | ||
- | |||
- | Each '' | ||
- | list of possible actions is given below. Some of those actions are only | ||
- | available with debug builds of nxagent. | ||
- | |||
- | Keys are given as a combination of '' | ||
- | modifiers. The key attribute is evaluated into a X11 key via the usual | ||
- | XStringToKeysym function. A list of possible keys can be found in | ||
- | / | ||
- | '' | ||
- | '' | ||
- | |||
- | Modifiers are given as boolean attributes, possible modifiers are Mod1, Mod2, | ||
- | Mod3, Mod4, Control, Shift, Lock. Sensible combinations strongly depend on your | ||
- | keyboard configuration, | ||
- | this context means '' | ||
- | else is considered true. | ||
- | |||
- | Everything in this file is case-sensitive. Unknown lines are ignored. | ||
- | Keybindings are evaluated from top to bottom, so if a keybinding matches, other | ||
- | keybindings further down will be ignored. The contents of the file replaces the | ||
- | default keybindings, | ||
- | configuration files is done. This also means that an empty or invalid configuration | ||
- | file deactivates all keybindings. | ||
- | |||
- | ==== List of possible '' | ||
- | |||
- | * close_session | ||
- | * switch_all_screens | ||
- | * minimize | ||
- | * left | ||
- | * up | ||
- | * right | ||
- | * down | ||
- | * resize | ||
- | * defer | ||
- | * ignore | ||
- | * fullscreen | ||
- | * viewport_move_left | ||
- | * viewport_move_up | ||
- | * viewport_move_right | ||
- | * viewport_move_down | ||
- | |||
- | Only in builds with certain debugging options enabled, ignored otherwise: | ||
- | * force_synchronization | ||
- | * debug_tree | ||
- | * regions_on_screen | ||
- | * test_input | ||
- | * deactivate_input_devices_grab | ||