Getting started

Feb 3, 2025

MacOS

Apple has a security feature called Gatekeeper that prevents the installation of apps from unidentified developers. If you try to open an app that is not signed by an identified developer you will get an error message.

So follow these steps to install the app:

  1. Go to Mechy Keyboard website.
  2. Click on the download button.
  3. Once the download is complete, go to the downloads folder.
  4. Right-click on the app and select open. You will get a warning message, click on open again. Maybe you won't see the 'open' button the first time, just close the dialog and try again.
  5. Drag the app to the Applications folder.
  6. Open the Applications folder.
  7. Right-click on the app and select open. You will get a warning message, click on open again. Maybe you won't see the 'open' button the first time, just close the dialog and try again.
  8. Open the app then click here to go to Settings or go to System Preferences > Security & Privacy then find Input Monitoring.
  9. If Mechy Keyboard is on the list, delete it and add it again. If it's not on the list, add it.
  10. Restart the app.
  11. Enjoy!

Ubuntu (only on X11)

The app is not compatible with Wayland because there is no way to capture the keyboard input. If you are using Wayland you need to switch to X11.

  1. Check if you are using X11
echo $XDG_SESSION_TYPE
  • If the output is x11 you are using X11. So you can continue with the installation.
  • Otherwise, you need to switch to X11. It's very simple, you can follow this video: How to switch to X11 or this article
  1. Install prerequisites
sudo apt install libfuse2
  1. Go to Mechy Keyboard website.
  2. Click on the download button.
  3. Once the download is complete, go to the downloads folder.
  4. Install the app
# Replace the file name with the one you downloaded
sudo apt install mechy-keyboard_<version>_amd64.deb
  1. App is installed, enjoy!
Mechy Keyboard