User Tools

Site Tools


Keyboard Maestro Control is the iOS adjunct to Keyboard Maestro. It allows you to log in to Keyboard Maestro and execute macros from your iPhone, iPod touch or iPad.

You need to ensure that the Keyboard Maestro Web Server is running and configured with a username and password.

After that, get Keyboard Maestro Control from the App Store (it's free).

Launch Keyboard Maestro Control on your iOS device.

If your Keyboard Maestro Mac is on your local network, it should immediately show up in the list. Touch it and then enter the username and password. Once connected, your connection is automatically saved as a favourite for future access.

Alternatively, you can manually add a connection. If your Mac has a static IP address and/or static domain name, you can use that, otherwise (as is far more common) you will only be able to access it on your local Mac network (unless you configure port forwarding on your ADSL modem - which is far beyond the scope of this wiki I'm afraid!). If you have problems, remember that you need to allow the connection via the http port when configuring port forward or allowing access via any firewalls. Keyboard Maestro Control currently uses only http (although the password is never sent in plain text, nor stored in plain text on your iOS device once you have made a successful connection), but you should probably also configure port forwarding and firewall access to the next adjacent port (4491 by default) at the same time in case we can use that in the future.

If you get a 403 connection failed error, then probably the username/password is incorrect. They must be configured in the Keyboard Maestro Web Server preferences. Make sure you tab out of the password field after entering as it seems sometimes if you don't it wont be set correctly. Then make sure the username and password is entered correctly in Keyboard Maestro Control.

Once connected and authenticated, you can execute any active macro you have configured in Keyboard Maestro.

It is highly recommended to use a different password as your Mac password. The password is not stored on the Mac, and once the connection is made the password is no longer stored on the iOS device, but even so, a different password to your system password would be highly advisable.

There are plans to eventually add custom icon palettes.

Keyboard_Maestro_Control.txt · Last modified: 2016/11/13 22:21 by peternlewis