This shows you the differences between two versions of the page.
Next revision | Previous revision Next revision Both sides next revision | ||
wiki:components:nxagent_keyboard_shortcuts [2012/12/06 14:05] arw created |
wiki:components:nxagent_keyboard_shortcuts [2012/12/14 19:28] tan Added description on most of the actions |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | Configurable keybindings in nxagent | + | ==== General remarks ==== |
+ | |||
+ | === necessary X2go version === | ||
+ | |||
+ | The feature described below has only recently (as of 2012-12-06) been added to X2go and is currently **experimental**, | ||
+ | |||
+ | === 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 | Keybindings in the redistributed x2go version of nxagent can now be configured | ||
by the user. This is done via a configuration file. | by the user. This is done via a configuration file. | ||
- | File location | + | ==== File location |
- | ------------- | + | |
nxagent searches for the configuration file in the following order: | nxagent searches for the configuration file in the following order: | ||
- | - in the location given by the ' | + | * 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 | If none of those files is accessible, the default configuration is used which | ||
is the same as the old, traditional nxagent keybindings. | is the same as the old, traditional nxagent keybindings. | ||
- | File format | + | ==== File format |
- | ----------- | + | |
The configuration file is XML with the following format: | The configuration file is XML with the following format: | ||
+ | <code xml> | ||
< | < | ||
< | < | ||
Line 32: | Line 48: | ||
< | < | ||
</ | </ | ||
+ | </ | ||
- | Each ' | + | Each '' |
list of possible actions is given below. Some of those actions are only | list of possible actions is given below. Some of those actions are only | ||
available with debug builds of nxagent. | available with debug builds of nxagent. | ||
- | Keys are given as a combination of ' | + | Keys are given as a combination of ''key'' and (optionally) a number of |
modifiers. The key attribute is evaluated into a X11 key via the usual | modifiers. The key attribute is evaluated into a X11 key via the usual | ||
XStringToKeysym function. A list of possible keys can be found in | XStringToKeysym function. A list of possible keys can be found in | ||
/ | / | ||
- | ' | + | ''XK_''. Evaluation is case-sensitive, |
- | ' | + | ''Space'' and '' |
Modifiers are given as boolean attributes, possible modifiers are Mod1, Mod2, | Modifiers are given as boolean attributes, possible modifiers are Mod1, Mod2, | ||
Mod3, Mod4, Control, Shift, Lock. Sensible combinations strongly depend on your | Mod3, Mod4, Control, Shift, Lock. Sensible combinations strongly depend on your | ||
keyboard configuration, | keyboard configuration, | ||
- | this context means ' | + | this context means ''0'', |
else is considered true. | else is considered true. | ||
Line 57: | Line 74: | ||
file deactivates all keybindings. | file deactivates all keybindings. | ||
- | List of possible ' | + | ==== List of possible |
- | ------------------------------------- | + | |
- | close_session | + | * close_session |
- | switch_all_screens | + | * This terminates the session |
- | minimize | + | * switch_all_screens |
- | left | + | |
- | up | + | * This will minimize the client window (even for fullscreen sessions) |
- | right | + | * left |
- | down | + | |
- | resize | + | |
- | defer | + | |
- | ignore | + | |
- | fullscreen | + | * This action switches between the auto-resize and viewport mode (static size). The default is auto-resize. In viewport mode one can use the ' |
- | viewport_move_left | + | * defer |
- | viewport_move_up | + | * Works like 'ignore' to make some keys be ignored / defunc inside the session |
- | viewport_move_right | + | * ignore |
- | viewport_move_down | + | * Makes it possible to add ' |
+ | * fullscreen | ||
+ | * Turns the client window into, or out of, fullscreen | ||
+ | | ||
+ | * moves the desktop to the left | ||
+ | * viewport_move_up | ||
+ | * moves the desktop up | ||
+ | * viewport_move_right | ||
+ | * moves the desktop to the right | ||
+ | * viewport_move_down | ||
+ | * moves the desktop down | ||
Only in builds with certain debugging options enabled, ignored otherwise: | Only in builds with certain debugging options enabled, ignored otherwise: | ||
- | force_synchronization | + | * force_synchronization |
- | debug_tree | + | * forces the drawing of elements to be synchronized which can fix some visual bugs. |
- | regions_on_screen | + | * debug_tree |
- | test_input | + | |
- | deactivate_input_devices_grab | + | |
+ | | ||