AbsoluteTelnet – Keyboard Mapping

Keyboard mapping allows the user to assign alternate text to be sent in response to any key or key combination. AbsoluteTelnet users can redefine a key to send a single keystroke, escape sequence, or run an entire script.

The keyboard mapping functionality can be accessed through the “Edit Keymap” button on the Options->Properties->VT Options menu option.

Pressing the button brings up the keymap manager. Keyboard maps are stored for each Connection File inside of the connection file itself. This allows you to store different keymaps for each of your hosts.

The keymap manager will display any existing mapped keys and allows you to add, modify, or delete key mappings. To add a new mapping, click the add button. You will be presented with the following dialog.

Now, press any key combination that you want to re-map. Any combination of keys using control, shift, and alt can be used.

Now you can define the new text for the key. This text can be either a single character or multiple characters. To configure the mapping to send characters that are not normally printable, use the following syntax for the unprintable character:

      \x??

where ?? is the HEX value for the character to be sent.

Additionally, you can use the following pre-defined text strings to map existing commands in AbsoluteTelnet

Command TextCommand Description
CMD-copymap a key to the ‘Edit->Copy’ menu command (normally ctrl-ins)
CMD-pastemap a key to the ‘Edit->Paste’ menu command (normally shift-ins)
CMD-newwindowmap a key to the ‘File->New->Window’ menu command (normally alt-n)
CMD-togglepassdesthese commands allow you to redefine the control keys that operate the scrollbar. Normally, holding ctrl in combination with the page-up, page-down, end, home, left, up, right, and down arrows will allow you to move around the scrollback buffer using the keyboard instead of the mouse. If you want to redefine this functionality, you can with keymapping.

For example, by mapping the ctrl-alt-f10 key to the text ‘CMD-scrolldownpage’, you now have a new keyboard shortcut to scroll down a page of the scrollback.

CMD-insert
CMD-delete
CMD-pageup
CMD-pagedown
CMD-end
CMD-home
CMD-arrowleft
CMD-arrowup
CMD-arrowright
CMD-arrowdown
Map a key to one of the terminal specific terminal commands. It is important to note that not all commands are defined for each terminal type. The commands send a terminal specific control sequence from the client to the host.
For example, CMD-insert sends ‘CSI 2 ~ ‘ in xterm mode, but ‘ESC @’ in ansi mode and remains undefined in VT52 mode.
CMD-scrolluppage
CMD-scrolldownpage
CMD-scrollend
CMD-scrollhome
CMD-scrollleft
CMD-scrollup
CMD-scrollright
CMD-scrolldown
These commands allow you to redefine the control keys that operate the scrollbar. Normally, holding ctrl in combination with the page-up, page-down, end, home, left, up, right, and down arrows will allow you to move around the scrollback buffer using the keyboard instead of the mouse. If you want to redefine this functionality, you can with keymapping.

For example, by mapping the ctrl-alt-f10 key to the text ‘CMD-scrolldownpage’, you now have a new keyboard shortcut to scroll down a page of the scrollback.

CMD-PF1
CMD-PF2
CMD-PF3
CMD-PF4
CMD-keypad0
CMD-keypad1
CMD-keypad2
CMD-keypad3
CMD-keypad4
CMD-keypad5
CMD-keypad6
CMD-keypad7
CMD-keypad8
CMD-keypad9
CMD-keypadenter
CMD-keypadplus
CMD-keypadcomma
CMD-keypaddecimal

These commands will cause the terminal to send the default escape sequences used by the VT keypad. The keypad has two modes, ‘numeric’, and ‘applicaton’, and the escape sequences will vary depending on the mode the keypad is in. Of course, users don’t normally specify the keypad mode directly. It is something that is specified by the host.

For example, CMD-keypad6 will send a 6 in numeric mode, but ‘ESC O v’ in application mode.

Leave a Comment

Your email address will not be published. Required fields are marked *