Hello,
I was able to fix this issue using below changes. Can anyone help with
review :
*diff --git a/guacamole-server/src/terminal/terminal.c
b/guacamole-server/src/terminal/terminal.c*
*index 14d07e0..040aa79 100644*
*--- a/guacamole-server/src/terminal/terminal.c*
*+++ b/guacamole-server/src/terminal/terminal.c*
@@ -1479,7 +1479,12 @@ static int __guac_terminal_send_key(guac_terminal*
term, int keysym, int pressed
guac_terminal_scroll_display_down(term, term->scroll_offset);
/* If alt being held, also send escape character */
- if (term->mod_alt)
+ /*
+ * If alt is being held, but the keysym is a printable character,
do
+ * not send an escape character. This allows AltGr to work
correctly.
+ * Otherwise, send ESC for Alt-based shortcuts.
+ */
+ if (term->mod_alt && keysym > 0xFF && (keysym & 0xFFFF0000) !=
0x01000000)
guac_terminal_send_string(term, "\x1B");
/* Translate Ctrl+letter to control code */
-Dilip
On Wed, Dec 3, 2025 at 2:34 PM Dilip Modi <[email protected]> wrote:
> Hello Guacamole Community,
>
> We've encountered an issue where the pipe character | cannot be typed into
> a Guacamole SSH session when using a French (AZERTY) keyboard layout on a
> macOS client.
>
>
> Here are the details of the environment and the issue:
>
> - *Client Operating System:* macOS
> - *Client Keyboard Layout:* French (AZERTY)
> - *Key Combination for |:* Option + Shift + L
> - *Connection Type:* SSH
> - *Server-side Keyboard Layout:* The server-side keyboard layout in
> Guacamole was set to French (fr-fr-azerty).
>
> *Observed Behavior:* When a user on a Mac with a French keyboard layout
> presses Option + Shift + L inside the Guacamole SSH terminal, no character
> appears. Other characters and key combinations seem to work correctly.
>
>
> *Troubleshooting Steps Taken:*
>
> 1. We confirmed that the key combination works correctly in local
> applications on the macOS client.
> 2. We tried explicitly setting the keyboard layout to "French" in the
> connection settings within our portal, but this did not resolve the issue.
> 3. Interestingly, the user *is* able to type the | character in the
> notepad with same short-cut key but on SSH connection it doesn’t work.
>
>
> Based on our investigation, it seems like the key event for Option + Shift
> + L from a macOS client with an AZERTY layout might not be mapping
> correctly to the | character on the server side for SSH connections.
>
> Has anyone in the community experienced a similar issue with this or other
> special characters on macOS? Any guidance on where to look in the Guacamole
> stack (client, guacd, or server) to debug this keyboard mapping would be
> greatly appreciated.
>
> Thank you for your time and help.
>
> Best regards,
>
> Dilip
>
--
This communication (including any attachments) is intended for the sole
use of the intended recipient and may contain confidential, non-public,
and/or privileged material. Use, distribution, or reproduction of this
communication by unintended recipients is not authorized. If you received
this communication in error, please immediately notify the sender and then
delete all copies of this communication from your system.
