How to install Macmoji

It's as easy as 🔢

1. Download emoji substitutions.plist (make sure it has the extension .plist)
2. Open System Preferences and navigate to Keyboard > Text
3. Drag the emoji substitutions.plist to the list of substitutions to add them
4. Type something like :boom: or :blackbox: and hit space after! 💥⬛️

Gif instructions:

Keyboard Maestro Version

If you'd prefer to use Keyboard Maestro to handle the substiutions, import the emojis-km6.kmmacros file in the Keyboard Maestro Editor. Emoji can be added in the editor or by editing the emojis-km6.kmmacros file before importing. The macro can then be exported to back up your changes.

This macro was created and tested using version 6. It has not been tested with other versions.

FAQ

🤔 Can I change/remove substitutions?

Yep! Macmoji substituions are ordinary text substituions. Double click an entry to change it; highlight and hit delete to remove it. To highlight multiple substituions select one and then while holding shift select another. You can always add your own too of course!

Some fun recommendations:

replace	with
ehh	¯\_(ツ)_/¯
tflip	(╯°□°）╯︵ ┻━┻
eml	[email protected]

💩 Why the colons?

Well it's what Slack does and it prevents mac os's autocomplete from being too aggressive when you're just trying to type normal sentences like, "ghost bananas are cool." 👻🍌🆒

🖐🏽 What about skin tones?

Type your skin-tonable emoji, then type :skin-tone-3: (any number 1-5) to add the skintone. They should combine!

😱 I have suggetions and mistakes to point out!

Let me know in the issues orrr file a pull request!

😯 Can I back-up or share my substitutions?

Yep! Highlight and drag out the ones you want to back-up or share and you'll get a neat little .plist. Drag them back in and only the unique ones will be added.

Known Problems

😫 Macmoji isn't working in Chrome

Yeah it's bummer. Chrome uses their own text engine and bypasses the system's autocomplete and a few other things, but fun work around is to open Spotlight (cmd + space) type your emojis there, copy, paste, and you're good to go! 👍

😠 Sometimes it just stops working in some applications

No clue. Beats me. Have a hunch why? I'd love to know too.

Change Log

The best way to update is to remove all previously added substitutions and then drag in the plist again (hold shift to select all the colon clad substitutions). Tip: You can always back-up substitutions by selecting and dragging them out of the list!

Date	Commit	Changes
July 12, 2016	2872b66	📞☎️ Add shortcut for call, and telephone
July 11, 2016	781926c	Added Keyboard Maestro macro version
July 8, 2016	e7225c2	🐴🍷🙎🖖 Add shortcut for mustang, wine, pouting, and spock
July 8, 2016	2f84c61	⚽⚾️⛄⛅ Fix mismatched shortcuts for soccer, baseball, snowman, and partially_sunny