You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@guacamole.apache.org by "Michael Jumper (JIRA)" <ji...@apache.org> on 2018/11/07 22:38:00 UTC

[jira] [Commented] (GUACAMOLE-655) keymap creation walkthrough

    [ https://issues.apache.org/jira/browse/GUACAMOLE-655?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16678897#comment-16678897 ] 

Michael Jumper commented on GUACAMOLE-655:
------------------------------------------

{quote}
... many key or key combinations do not work with the other keymaps or the provided failsafe keyboard. This renders Guacamole unusable.
{quote}

If there are key combinations which cannot be typed remotely, despite the keyboard of the remote desktop server having those keys and being properly set as the server layout in the connection configuration, then another key map will not help. The underlying issue preventing that key from being properly sent needs to be addressed.

As mentioned on GUACAMOLE-654, please keep in mind that the client side of Guacamole is independent of keyboard layout. It does not matter what keyboard layout the client side is using. Key events sent through Guacamole are sent using the identity of the key ("a", "B", etc.) and thus are unaffected by layout, not the location of the key as RDP would send ("first key in second row", "fifth key in third row", etc.) which is indeed dependent on layout.

The keymaps you refer to are used strictly on the server side. They tell Guacamole how to translate each key identity ("a") into the scancode used by RDP (the numeric equivalent of "first key in second row"). Since the RDP side of this *does* depend on keyboard layout, Guacamole needs to know ahead of time what keyboard layout the remote desktop server uses so it can translate.

> keymap creation walkthrough
> ---------------------------
>
>                 Key: GUACAMOLE-655
>                 URL: https://issues.apache.org/jira/browse/GUACAMOLE-655
>             Project: Guacamole
>          Issue Type: Improvement
>          Components: Documentation
>            Reporter: Stanislas Elie
>            Priority: Minor
>
> I notice several bug reports on the issue tracker related to missing keymap files. I realize it is not a priority for the Guacamole developer community, but it is a show stopper for the users affected. For example, I am unable to find a proper French Canadian keymap, as many key or key combinations do not work with the other keymaps or the provided failsafe keyboard. This renders Guacamole unusable.
>  
> I would like to have a detailed (very detailed) walkthrough of how one can create their own keymap file, put it in the right place in the source tree, a list of files that need to be modified to accommodate the new keymap and re-build instructions. Such a walkthrough would allow some of us script kiddies to contribute a little, and would remove a little of the burden from the Guacamole devs.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)