Skip to content

jsumners/alfred-emoji

Repository files navigation

alfred-emoji

Build Status

An Alfred workflow that makes it easy to search for emoji and copy them to the clipboard 🤘.

screenshot

Note About Available Emoji

The workflow is built against the latest available macOS within the GitHub continuous integration infrastructure. This means some emoji may be missing until the GitHub infrastructure is updated. It also means that some emoji may be present in the workflow that do not exist on your system if your system is running an earlier version of macOS.

If this is not desired, follow the instructions below for generating the workflow on your own system.

Installing the Workflow

Download the provided Alfred workflow.

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

Usage

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 ctrl+return (⌃↵): Copy the codepoint of the selected emoji) (e.g. U+1F923) 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

Options:

  • 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

Inspiration

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.

Other

License

MIT License