101

How do I assign a keyboard shortcut to an AppleScript? I found a script for automatically going back to the inbox in Office 2011.

1
  • 1
    As pointed out by this answer keyboard shorcuts assigned through services are not always consistent.
    – William
    Mar 20, 2017 at 0:14

8 Answers 8

126

It is also possible without paid 3rd party apps!
1. Open Automator.
2. Make a new Quick Action.
3. Make sure it receives 'no input' at all programs.
4. Select Run Apple Script and type in your code.
5. Save!

Now go to System Preferences > Keyboard > Shortcuts. Select Services from the sidebar and find your service. Add a shortcut by double clicking (none).

Finally go to System Preferences > Security > Privacy > Accessibility and add Automator and the preferred app to run the shortcut.

10
  • 3
    That last "Finally" is important – miss it, and you get a confusing "The action [...] encountered an error" dialog, just offering you to Show Workflow, likely not making you any wiser.
    – ecmanaut
    Mar 6, 2017 at 5:56
  • 7
    What do you mean by the preferred app?
    – William
    Mar 17, 2017 at 19:42
  • 3
    @William like if you wrote an AppleScript for in the Finder, just select both Automator and Finder in the Accessibility settings.
    – MegaCookie
    Sep 24, 2017 at 11:05
  • 1
    For MacOS 10.13 ("High Sierra") users: "Accessibility" is found under "Security and Privacy"
    – asherbret
    Feb 27, 2018 at 19:42
  • 3
    "It seems I sometimes have to run the script under services to get it to register before it will register the keyboard shorcut which is a shame." (services meaning go to your App, then go to menu App > Services > Your script, then give permission) - This comment by @William to the answer by monomeeth is important!
    – rfabbri
    Oct 24, 2020 at 20:42
45
+50

In summary you will need to use:

  • Automator to create a service that runs an Apple Script
  • System Preferences to assign a keyboard shortcut to the service

Below are the steps involved for each.

1. Create a service using Automator

  1. Launch Automator (usually found within your Applications folder)
  2. Go to File > New
  3. Select Service and click Choose
  4. In the top right hand of the window that appears, ensure that "No input" is selected from the Service receives drop-down list
  5. Ensure the In drop-down list is showing "Any application"
  6. In the second column containing the long list, find "Run AppleScript" and double-click on it
  7. This will add the Run AppleScript window on the right
  8. Now, replace the (* Your script goes here *) with the script you want
  9. Save the service using a meaningful name (e.g. GoToInbox).

Now to the next step.

2. Creating your shortcut

  1. Go to System Preferences > Keyboard > Shortcuts
  2. Select Services from the sidebar
  3. Find your service (it'll be in the list on the right-hand side)
  4. Add a shortcut by double clicking on the service name
  5. Now go to System Preferences > Security & Privacy > Privacy
  6. Select Accessibility in the sidebar
  7. Click on the + sign (you may need to unlock the padlock if it's locked)
  8. Add Automator.
  9. Add Finder (to find this you will need to navigate to /System/Library/CoreServices/Finder.app).
  10. Exit your System Preferences.

Now you should be able to do two things:

1. Run the service from any application by going to the Services list within any Application menu (e.g. Finder > Services, Safari > Services, TextEdit > Services, etc) and select the service you just created.

2. Use the keyboard shortcut to run the service.

NOTE: I am aware that for some users keyboard shortcuts do not seem to work even though they've been assigned to a service. This is a whole other topic, but if this happens in your case, at least you can run the service from within any application you're using.

Let me know how you go.

11
  • 3
    Why must I add finder manually and what apps does this not work on in general? It seems I sometimes have to run the script under services to get it to register before it will register the keyboard shorcut which is a shame.
    – William
    Mar 19, 2017 at 23:35
  • 2
    Yes, the issue I referred in my Note at the end can often (but not always) be rectified by first running a service (and sometimes just accessing the Services menu is enough) before the keyboard shortcut will be recognised. This is an extremely annoying bug that has been around for a long time and I certainly recommend you send a bug report to Apple. As for why you have to add Finder manually, simply because it's not added by default. Finally, I didn't understand what you meant by what apps does this not work on in general?
    – Monomeeth
    Mar 19, 2017 at 23:54
  • Ignoring my question about the app not working in some apps. It appears running the script once under the Service menu rectifies this issue and your explanation explains the issue I was having. Why must I add Automator Finder under the list Accessibility list it seems to not make a difference when running commands(That was my basic question)?
    – William
    Mar 20, 2017 at 0:12
  • Good question! If you find steps 5 to 9 above for creating a shortcut aren't necessary for you, then that's great. However, I've helped a lot of people create keyboard shortcuts to run custom scripts and have found that including those steps often avoids an error message (don't recall what it is now or under which circumstances it would appear). Perhaps I shouldn't include those steps by default, but that's what I've been doing now for quite a few years (although the exact steps will differ depending on your version of macOS - above I included the steps for El Capitan as per your bounty).
    – Monomeeth
    Mar 20, 2017 at 0:44
  • 2
    In Automator, Service has been renamed Quick Action Feb 5, 2021 at 19:24
14

You cannot assign keyboard shortcuts to AppleScripts out of the box. However, you can:

  1. use a launcher that supports setting global hot keys and executing AppleScripts (Alfred, Keyboard Maestro, FastScripts - whatever takes your fancy), or
  2. put the script into a Run AppleScript action inside an Automator service. Note it has to be a service, not an application or an ordinary workflow: services can be assigned hotkeys in the System Preferences keyboard settings.
6
  • Just follow the steps in @MegaCookie’s answer.
    – kopischke
    Jan 29, 2017 at 22:57
  • What OS version are you own my 10.6.5 mac doesn't seem to have the option "Select Run Apple Script and type in your code"?
    – William
    Jan 29, 2017 at 22:59
  • 1
    It’s not “Select Run AppleScript”, it’s – as noted in my answer – the Run AppleScript action you need to add to your Automator service; just drag it into the action area from the library, that will get you a text field with a function scaffold you can add your code to. Also, I doubt the accessibility settings in @MegaCookie’s answer are needed – these pertain to UI Automation.
    – kopischke
    Jan 29, 2017 at 23:05
  • 2
    After testing almost ~ALL~ solutions proposed in this stack, this is what I learned. Automator is very slow to execute scripts. It doesn't matter if it is a Python script or a Shell script. They both take 1-3 seconds to run on my Mac (script on simulates a click on the screen). I tested FastScripts and had the same issues, faster than Automator, but still slow (1-2 seconds). Couldn't test Alfred because it is a paid feature. However, I did test Keyboard Maestro, and it is blazing fast. No perceptible delay! The best solution hands down. Jun 16, 2020 at 0:20
  • @GuilhermeSalomé Yeah Automator is insanely slow, thanks for specifying that Keyboard Maestro is faster, going to test it now!
    – Bohao LI
    Feb 27, 2021 at 22:10
9

Note: In macOS Mojave it was renamed from "Service" to "Quick Action" in Automator.

  1. cmd + space and type "automator"
  2. Select: File > New
  3. Select "Quick Actions"
  4. Search in the top of the left section for "applescript" or "shellscript" or "javascript"
  5. Drag desired action to right side workflow
  6. File > Save with desired name

To add keystroke to your workflow:

  1. Open System Preferences
  2. Select Keyboard > Shortcuts
  3. Select Services on left
  4. Find newly created service and double-click on "none" to add keyboard shortcut
2
  • Note: if you don't make it a Quick Action (e.g. you make it a "Workflow") then the Shortcuts list won't detect it. Nov 13, 2019 at 21:47
  • 1
    I did it! It still does not detect the keyboard shortucts. I need to run the quick action manually inside automator!
    – chikitin
    Apr 14, 2020 at 20:44
4

To bypass all the hassle with Accessibility settings I recumbent do run the script with the build-in Shortcuts app.

  1. Open Shortcuts app
  2. In the left pane choose Quickly actions or Menu bar (if you want to access this action from menu bar as well) quic actions Click the + to add new action
  3. In the right menu and look for the Script Editor
  4. Double click on Run AppleScript AppleScript
  5. Replace the (* Your script goes here *) with your code
  6. In the right panes with to the options tab. Check "Use as Quick actions " (Service Menu will be checked automatically) and click "Add keyboard shortcut" Options
  7. Press the key combination of your choice Your keyboard shortcut will trigger the AppleScript form any application without any rework of Accessibility options.
2
  • Two things: Is there a way to run an AppleScript file instead of pasting some code? And is there a way for AppleScript's display notifications to show when running from Shortcuts?
    – hobbes3
    Jul 25, 2023 at 0:20
  • @hobbes3 just write AppleScript to run your file! Something like: run script alias ((path to scripts folder as text) & "MyBestScript.scpt")
    – RyanCu
    Feb 22 at 4:04
3

Just to reiterate a very important point first noted in the post by @MegaCookie:

When creating a script that emulates mouse or keyboard activity, you must add not only Automator, but also each and every app in which you wish to use your script to the System Preferences > Security > Privacy > Accessibility application list.

This is counterintuitive as you don't actually want those apps to control the computer, but this is what Apple requires. Otherwise, you will receive a popup like this (it will vary depending on what you're trying to do):

The action "Run AppleScript" encountered an error: "System Events got an error: com.automator.runner.xpc is not allowed to send keystrokes."

Clicking Show Workflow in the popup just opens up a Finder window to the location of the script. OK closes the popup.

This may not have always been necessary but I found it necessary in macOS 10.15 (Catalina).

As an example for when you'd need this, I created a script to emulate pasting the clipboard by simply "typing" the contents of the clipboard into an application that does not accept paste operations.

In my case, this is the remote console provided by VMware's vCenter when looking at VMs on ESXi hosts. I needed to add the browser being used to view vCenter, which in my case is Chrome. Definitely a security risk, IMHO.

1
  • Yea this sucks :(
    – nhooyr
    Aug 7, 2020 at 16:36
0

I used BetterTouchTool which also works fast. It's also paid but it is popular.

-2

You can go to System Preferences -> Keyboard -> Shortcuts -> add a new shortcut. You can then select your script.

https://support.apple.com/kb/PH18418?locale=en_US

3
  • 3
    That won’t work. The document you are linking to describes how to (re-)assign a hotkey to a menu command of an application.
    – kopischke
    Mar 3, 2015 at 20:59
  • Broken link, apple has long since disabled this one-click functionality, replacing it with a 90-click operation involving 3rd party apps. Mar 1, 2019 at 3:56
  • Do you mean to say that this entire method as outlined here by Arecibo won't work any more? I've gone down three rabbit holes on this, one with (unpaid) FastScripts (can't access preferences to set keyboard shortcut); one with Automator (Step 2.3 "Find your service in the list," and it's not in the list); and one here with the gnom1gnom method, in which in the end I can't add a keyboard shortcut for "⌘Q" because, well, it quits the Shortcuts app. The script is working fine, I just can't find how to map the shortcut to the script. Help?
    – Keith G
    Oct 24, 2023 at 22:08

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .