Created By: James Sumners, 462 Stars, Last Updated: 02/07/21 05:24:36

Love this? Please consider supporting its creator by starring or sponsoring this project on GitHub!

From the project's README:


Build Status

An Alfred workflow that makes it easy to search for emoji and copy them to the clipboard ๐Ÿค˜.


Installing the Workflow

Download the provided Alfred workflow.

Notice: This workflow relies on JXA (JavaScript for Automation) that is built into macOS.


emoji [query]

Press return (โ†ต): Copy the symbol of the selected emoji (e.g. ๐Ÿคฃ) to your clipboard.

Press alt+return (โŒฅโ†ต): Copy the code of the selected emoji) (e.g. (rofl)) to your clipboard.

Press shift+return (โ‡งโ†ต): Copy the default symbol of the selected emoji) (e.g. ๐Ÿคฃ) to your clipboard without skin tone modifier.

Press cmd+return (โŒ˜โ†ต): Paste the symbol of the selected emoji (e.g. ๐Ÿคฃ) directly to your frontmost application.

Set skin tone

To change the emoji skin tone for supported emoji set the skin_tone environment variable in Alfred:

screenshot skin tone settings


  • No value => ๐Ÿ‘
  • 0 => ๐Ÿ‘๐Ÿป
  • 1 => ๐Ÿ‘๐Ÿผ
  • 2 => ๐Ÿ‘๐Ÿฝ
  • 3 => ๐Ÿ‘๐Ÿพ
  • 4 => ๐Ÿ‘๐Ÿฟ
  • random => ๐Ÿ‘๐Ÿป | ๐Ÿ‘๐Ÿผ | ๐Ÿ‘๐Ÿฝ | ๐Ÿ‘๐Ÿพ | ๐Ÿ‘๐Ÿฟ

After setting skin tone you can still quickly copy the default emoji with the shift modifier.

Automatic Updates

This workflow will automatically check for updates at most once per day. If a new release is found, it automatically downloads and installs the latest version of the workflow. All downloads come directly from official GitHub releases.

Optional Hotkey and Snippet Triggers

Trigger the workflow with either a custom hotkey or a custom snippet.

Building the Workflow

  1. Clone this repository
  2. npm install
  3. npm run build

Loading the Workflow into Alfred

  1. npm run load


This is based on the original work by Carlos Galdino. His project seems to be unmaintained (some emoji don't copy and some newer are missing). Whereas his project is based on the Ruby language, this one is based on JavaScript.



MIT License