Skip to content
Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.

Workman keyboard layout for MacOS

Workman and Workman-P Mac OSX keyboard layout packaged as a keylayout bundle includes alternate icons, similar in style to the system icons for other layouts like Dvorak or Colemak.

Workman-IO is the same as Workman, but with the I and O letters swapped. It was proposed by vjustin and has not been endorsed by OJ.


  1. Copy the layout(s) to a Keyboard Layouts directory. Choose one of the following options:

    • Option 1 (recommended). Copy Workman.bundle to /Library/Keyboard Layouts/. It requires administrator rights but this enables the layout system-wide, including the OS X login screen.

      To enable input options on the login window, check the option in System Preferences > Users & Groups > Login Options > Show Input menu in login window.

    • Option 2. Copy Workman.bundle to ~/Library/Keyboard Layouts/. It doesn't require admin rights. The layout is only available to the currently logged-in user.

  2. Log out of OS X and log back in.

  3. Open System Preferences > Language & Region > Keyboard Preferences > Input Sources and enable the Workman layout of your choice.

  4. Make sure that the Show Input menu in menu bar box is checked.

To switch quickly between layouts you can press Command+Space or Command+Option+Space. This hotkey combination conflicts with the default settings for showing Spotlight. Open System Preferences > Keyboard > Shortcuts and ensure the Spotlight shorcut is different from the Keyboard and Input Sources shortcuts.


There are variations to the Workman layout:


Special symbols (!, @, #, ...) are main characters of the top row so you need to hold the SHIFT key to input the numbers.

  • Workman Programmer Workman Programmer

  • Workman Programmer - SHIFT ⇧ Workman Programmer shift


Location of I and O keys are swapped (This is not officially approved.)

  • Workman IO Workman IO

Workman Extended

Adds accented letters and more internationalization.

  • Workman Extended - OPTION ⌥ Workman Extended

  • Workman Extended - SHIFT+OPTION (⇧+⌥) Workman Extended

Workman Dead (for programmers)

The idea of using 'dead' keys is based on assumption that pressing 2 easy keys is better than pressing 1 hard key. So to make it easier to type (programming) characters/symbols, we're going to press an easily reachable key (which will NOT output any character), release it and then press another easily reachable key to produce, say, @ character.

In this layout the COMMA key is a dead key, pressing it will cause keyboard enter a state in which a single stroke of other keys will output a different character than normal state. After that single stroke, the keyboard returns to its normal state.

For example, you'd press COMMA to enter the special state. Now if you strike the A key the output will be a forward slash "/". To see how to create other characters, refer to following images for more info.

To produce the COMMA character itself, just hit SPACE after entering 'dead' state.

This layout also changes the Numeric Keypad to be more programmer friendly when dealing with hexadecimal values.

  • Main Workman layout

Main layout

  • Dead State layout

This might also help you memorize it faster, the 0 and 1 are on the home keys:

dead state layout

The above layout is based on Arensito layout and Programmer Dvorak.

Dead State layout

In dead state, if you press ⌥ Option ( Alt ), you'll get these handy characters:

Dead State + Option

And if your keyboard has a numeric pad, holding Option will change it to:

Numeric Pad

Also note that a virtual numeric pad appears under your right hand.

You can’t perform that action at this time.