How to Add and Use Custom Maps in Keyboardy

Keyboardy allows you to enhance your typing experience by enabling the use of custom keyboard maps tailored to your specific needs. This guide walks you through the process of adding and using custom maps in Keyboardy.


Step 1: Download and Place the Custom Map

For Windows:

  1. Download the custom map:
    • The Keyboardy team may share a custom map file with you via email, such as my_custom_map.kbdy.
    • Download the attached .kbdy file to your computer.
  2. Locate or create the necessary folders:
    • Navigate to Users/USER/Documents/.
    • Check if there is a folder named Keyboardy. If not, create one (note: the folder name is case-sensitive).
    • Inside the Keyboardy folder, check if there is a Maps folder. If it doesn’t exist, create it (note: this folder name is also case-sensitive).
  3. Move the file: Place the downloaded .kbdy file into the Maps folder.

For Linux:

  1. Download the custom map:
    • The Keyboardy team may share a custom map file with you via email, such as my_custom_map.kbdy.
    • Download the attached .kbdy file to your computer.
  2. Choose a storage location:
    • You can save the file in any location of your choice.
    • Example path: /home/USER/Keyboardy/Maps/.
  3. Move the file: Place the downloaded .kbdy file into your chosen folder.

For macOS:

  1. Download the custom map:
    • The Keyboardy team may share a custom map file with you via email, such as my_custom_map.kbdy.
    • Download the attached .kbdy file to your computer.
  2. Locate or create the necessary folders:
    • Navigate to /Users/USER/Library/Containers/net.keyboardy.keyboardy/Data/Documents.
    • Check if there is a folder named Keyboardy. If not, create one (note: the folder name is case-sensitive).
    • Inside the Keyboardy folder, check if there is a Maps folder. If it doesn’t exist, create it (note: this folder name is case-sensitive).
  3. Move the file: Place the downloaded .kbdy file into the Maps folder.

Step 2: Add the Custom Map to Keyboardy

  1. Launch the Keyboardy application.
  2. Navigate to the Settings tab.
  3. In the Maps dropdown, you should see the newly added map (e.g., my_custom_map) listed.
  4. Select the custom map from the dropdown menu.

Step 3: Test Your Custom Map

  1. Navigate to the Playground page in the Keyboardy application.
  2. You should see the name of the map, the reflector, and the shift names displayed.
  3. Use the Try it out section to type and see if the map is functioning as expected. Test various keys to confirm that the custom mapping aligns with your intended layout.

Tips and Best Practices

  • Backup your custom maps: Keep a copy of your .kbdy files in a safe location.
  • Check for updates: Ensure that you are using the latest version of Keyboardy for compatibility with custom maps.

By following these steps, you can customize your typing experience with Keyboardy to meet your unique requirements. If you encounter any issues, refer to the troubleshooting guide or contact Keyboardy support.