X-keys Mac App

X-keys For Mac

MacApp

Our X-keys Mac App makes it easy to program your X-keys device in Hardware Mode directly from your Mac. It supports all current X-keys models and is recommended for users who want a fast, straightforward setup without needing additional software running in the background.

App Store

apps.apple.com

Free Download

System Requirements:

MacOS 10.14.6 (Mojave) or newer

Compatible with Intel-based Macs and most M1 Macs

Note: Compatibility with M2 and newer Macs is not guaranteed.

Quick Start for Mac

1.) Download and launch the app

Download the X-keys Mac App from the Mac App Store. Once installed, open the app.

2.) Plug in your X-keys

Connect your X-keys device via USB. The layout will automatically appear in the app.

3.) Select a key to program

Press a key on the device or click its position in the on-screen layout to begin programming.

4.) Program your keys

You can assign keystrokes, macros, mouse actions, game controller inputs, backlighting, and more. Repeat for each key you want to set up.

Tip: You can also add long strings of text to your X-keys. Follow this guide here to learn how.
5.) Save to your X-keys

When you're done, click Save to Device. Your programming is now stored in the device’s memory.

6.) (Optional) Adjust USB Endpoint

If needed for compatibility with multimedia keys, go to Tools > Change Endpoint and select the correct setting.

Need help getting started? If you can't find what you’re looking for, email us at tech@piengineering.com.

Common Issues

Some users may encounter issues programming keys like Space, Tab, or Enter, since macOS may treat these as navigation keys during programming. To resolve this:

  1. Go to System Settings > Accessibility > Keyboard
  2. Uncheck Full Keyboard Access
  3. Restart the X-keys Mac App
  4. You should now be able to record all keys normally

You can re-enable Full Keyboard Access once you’ve finished programming.

Programming options:

Whats the difference?

Hardware mode

Hardware Mode saves your programming directly to the X-keys device. After setup, no software is needed—just plug it in and it works like a USB keyboard or mouse. It’s great for using X-keys on any system, including Windows, Mac, Linux, or even Raspberry Pi.

Can be programmed using any Software Options.

Software Mode

Software Mode lets you create advanced functions like opening programs, running scripts, or setting up keys that work differently in different applications. Your programming is stored on the computer and needs MacroWorks installed and running.

Can only be used with MacroWorks Software.