key codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codekey codeskey codekey codekey codekey codekey codekey codekey codeescF1F2F3F4F5F6F7F8F9F10F11F12~`!1@2#3$4%5^6&7*8(9)0_-+=delete|\}]{[POIUYTREWQcaps locktabshiftfncontroloptioncommandcommandoption53enterreturnshiftASDFGHJKL:;"'?/>.<,MNBVCXZ107122113120160991311189697981001011091031115124272925282622232120191850481213141517163234313533304236763941374038453210575767891145464347446012612412312561554955585963

Complete list of AppleScript key codes

All of the key codes. All of them. Ever. Maybe. I tested this out on a MacBook Air and also a MacBook Pro. If I missed something, please let me know.

Key code 49 in this example triggers the space bar.

tell application "System Events"
  key code 49
end tell

You may also want to check out this short introduction to keyboard automation in macOS (with AppleScript).

The play/pause function keys don't trigger correctly using key codes, but there's a workaround for this, which I'll go over.

Keyboard brightness keys don't work with key codes. I don't know how to make them work. Yet... Yet.

Oh, and also caps lock. It doesn't look like key code 57 enables caps lock. I am looking into this.

Return and enter

enterreturnkey code3676key code

The enter key on most Macs is actually the return key (key code 36). The key code for enter is 76. The enter key is what you might see on a full size keyboard on the numpad side. On the more common, non-full-size Mac keyboards, enter can still be accomplished by hitting fn + enter. This is why the enter key says return and enter on it.

Most applications don’t really care about the difference between return and enter. In pretty much every text editor both enter and return will result in the same new line. One example of where these two keys do different things is with iTunes. Interestingly, in iTunes, enter (76) renames the currently selected song while return (36) plays the song from the beginning. This is still true as of iTunes 12 running on OS X 10.10 Yosemite.

Modifier keys

key code63key code59key code58key code55key code56key code60key code55key code61fncontroloptioncommandshiftshiftcommandoption

Most of the modifiers have two different key codes. One for the left and one for the right. So instead of just triggering, say, option, you can trigger (right) option specifically. This applies to option, shift, and control. It appears that command has only one key code. I think it is worth noting that the keyboard on the MacBook Air I’m using right now has only one control key on the physical keyboard.

While this is all fine and dandy, I'm guessing you probably want to use these keys to modify other keys. They are modifier keys, right? Actually, key codes aren't even needed to accomplish this. For example, you could do command + A like this:

tell application "System Events" to keystroke a using command down

Use multiple modifier keys with {..., ...}. In this example, let's do a “Paste and Match Style” with option + shift + command + V like this:

tell application "System Events" to key code 9 using {option down, shift down, command down}

Key code 9, in the example above, is the V key. But it would be just as easy to use keystroke, like this:

tell application "System Events" to keystroke "V" using {option down, shift down, command down}

For numbers, letters, and symbols, using keystroke is probably better. However, there's still key codes if you want 'em.

Remember, when using keystroke, place the characters in quotes. Also, don't forget, keystroke (one word), key code (two words). I accidentally type keycode sometimes.

keystroke "Hello world"

Like that

Arrow keys, page up, page down, home and end

123126124125115116119121key codekey codekey codekey codekey codekey codekey codekey codePageUpEndHomePageDown

Arrow keys are pretty great. And also the page up, page down, home, and end keys. Those are pretty great also. Scripting them is awesome. And this is where key codes are really necessary. You can't write keystroke up arrow. That won't work. You don't need to try that. I've saved you the trouble.

Some nifty arrow key examples. Try these in a text editor to move the cursor around:

Skip ahead one word: tell application "System Events" to key code 124 using option down

Go back one word: tell application "System Events" to key code 123 using option down

Skip to the end of the paragraph: tell application "System Events" to key code 125 using option down

Go back to the beginning of the paragraph: tell application "System Events" to key code 126 using option down

Skip to the end of the line: tell application "System Events" to key code 124 using command down

Go back to the beginning of the line: tell application "System Events" to key code 123 using command down

Esc, space bar, tab, delete, caps lock

esccaps locktabdeletekey code53key code57key code49key code48key code51

All of these work as expected, except for caps lock. It doesn't look like key code 57 does anything. Too bad. That'd be neat.

Keystroke works just fine for triggering the return, space, and tab keys.

This is the exception to the rule about keystroke and quotes. Putting "return" in quotation marks would write out return. No quotes and the return key is triggered.

F keys and some of the function keys

F1F2F3F4F5F6F12F11F10F9F8F7key code107key code122key code113key code120key code160key code99key code131key code118key code96key code97key code111key code103key code109key code101key code100key code98

Not all of the function keys can be reliably scripted using key codes. See further down for work arounds.

In the diagram above, some of the keys list two key codes. The top number corresponds to the function and the bottom number corresponds to the F key. For example, this would increase screen brightness by one increment, the same as pressing the screen brightness key.

tell application "System Events" to key code 113

What about F13-F20? Those are scriptable too!

Play, pause, fast forward, rewind and volume function keys

I dunno if there's a good way to do this using key codes. You can leapfrog this hurdle by just not using key codes.

If you’re using something other than iTunes, you can still try the above. Just substitute “iTunes” with the name of the app. Depending on how scriptable the app is, this may or may not work.

Mute, unmute, set and increment system volume like so:

Make your system volume slowly fade out with this nifty little script. Adjust the “delay 0.2” bit in the middle of the loop to speed up or slow down the fade.

set a to output volume of (get volume settings)
 
repeat while a is not 0
  set a to (a - 1)
  delay 0.2
  set volume output volume a
end repeat

Controlling keyboard brightness

I don't know how to control keyboard brightness with Applescript. Yet.

Letters, numbers and symbols

Instead of using key codes, why not just use keystrokes? This works great with all of the letter keys (upper and lower case). Also, the number keys (above the letter keys, not numpad) and all of the symbols you can make with them using shift. Also these keys: ~ ` { [ } ] | \ : ; " ' _ - + = < , > . and ? /. And also other keys.

Keystroke works like this:

tell application "System Events" to keystroke "Abcde"

Keystrokes might be super cool, and awesome, and generally pretty great and what have you. But guess what! There's also key codes for these!...:

Numpad key codes

And the numpad. There's even key codes for the numpad. Key codes for everyone!

<-- Back to Front Page