Custom Font

February 28, 2026 ยท View on GitHub

The custom font feature in OverKeys allows you to use your own font for the keyboard display. This is particularly useful for users who need:

  • Better readability
  • Specific fonts for language support
  • Custom font preferences

Overview

When enabled, OverKeys will use the font specified in your configuration file for displaying keyboard keys. The font must be installed on your system for this feature to work correctly.

Setup Instructions

Turning the setting on

  1. Open OverKeys
  2. Right-click the OverKeys icon in the system tray
  3. Select Preferences
  4. Go to the General tab
  5. Toggle the Enable advanced settings option
  6. Toggle the Use custom font option

Using Configuration File

  1. Right-click the OverKeys tray icon

  2. Select Preferences

  3. Go to the General tab

  4. Click Open Config

  5. In the JSON file, set the customFont field to your preferred font name:

    {
    "customFont": "Lexend"
}

  6. Save the file

  7. Right-click the tray icon and click Reload config to apply changes

Implementation Notes

  • Custom fonts must be installed on your system
  • Font names are case-sensitive
  • If the specified font is not found, OverKeys will fall back to the default app font, i.e., DM Mono
  • Custom fonts is applied to all layout types including alternative layouts and layers
  • Some fonts may not display certain special characters correctly

Troubleshooting

  • If your custom font isn't displaying correctly, verify the font name exactly matches the installed font name
  • Make sure the font is properly installed on your system