Search the VMware Knowledge Base (KB)
View by Article ID

Specifying the keyboard layout when connecting with VNC client (1004815)

  • 8 Ratings


  • A VNC client acts as if the keyboard is currently using an English layout, when it is not.
  • Incorrect letters appear when you type.
  • Letters typed on a non-English keyboard do not print the correct letters on the screen.


This issue can be resolved by specifying the remote keyboard layout to be used by the virtual machine.
To specify the remote keyboard layout:
  1. Open the virtual machine configuration file ( .vmx) for editing. For more information, see:

  2. Add this line to the end of the file:

    RemoteDisplay.vnc.keymap = "<lang_code>"

    where <lang_code> is a value chosen from the vnckeymap folder.

    Note: The location of the vnckeymap folder varies based on your host operating system or your product version:

    • Windows XP / Server 2003: %ALLUSERSPROFILE%\Application Data\VMware Workstation.
    • Windows Vista / 7 / 8 / 10: %ALLUSERSPROFILE%\VMware.
    • Linux: /usr/lib/vmware
    • Fusion 4.x and above: /Applications/VMware Fusion/Library.
    • Fusion 3.x and earlier: /Library/Application Support/VMware Fusion.

Additional Information

Instead of using a value from the vnckeymap folder, you can create a custom file.

To create a custom layout file, create a new text file and specify the key value pairs consisting of the VNC or X KeySym and the corresponding keyboard scan code. Use an existing vnckeymap file as an example. When completed, set the keymap file variable in the .vmx to specify the custom file you created.

Example: RemoteDisplay.vnc.keymapFile = "my_keyfile"


cannot-use-keyboard  keyboard-mapping

See Also

Update History

08/25/2014 - Updated for Fusion 7.x

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.


  • 8 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.

What can we do to improve this information? (4000 or fewer characters)

Please enter the Captcha code before clicking Submit.
  • 8 Ratings