Skip to content

gingerbeardman/Emojipedia

Repository files navigation

Emojipedia

MacOS X Dictionary containing Emoji and their meanings

Installing the dictionary

Pick one method of installation: using Dictionaries.app, Terminal, or Finder.

Using Dictionaries.app

  1. Download Dictionaries.app and run it
  2. Click "Add Dictionary"
  3. Select Emojipedia
  4. Click "Add"

Using Terminal

  1. Install using homebrew caskroom brew install --cask emojipedia
  2. Launch Dictionary.app
  3. In Dictionary > Preferences, scroll to the bottom of the list and check the Emojipedia dictionary to enable it
  4. Optional: drag the Emojipedia dictionary entry to change the order of dictionaries

Using Finder

  1. Download Emojipedia.dictionary.zip and unzip it
  2. Copy Emojipedia.dictionary to ~/Library/Dictionaries
  3. Launch Dictionary.app
  4. In Dictionary > Preferences, scroll to the bottom of the list and check the Emojipedia dictionary to enable it
  5. Optional: drag the Emojipedia dictionary entry to change the order of dictionaries

Using the dictionary

Try looking up the meaning of these emoji as a test: 😍 🔰 💮 💩

  • Right-click on the emoji and choose the Look Up menu item (on a track pad you can also use a Three Finger Tap or Force Click)
  • Press Cmd+Ctrl+D whilst pointing the mouse cursor at the emoji to display a popup
  • Launch Dictionary and type the emoji into the search field

Screenshots

Contextual menu Look Up Dictionary lookup

Dicationary Popup Dictionary popup

Dictionary.app Dictionary.app


Status

Number of Emoji included: 1719
Emoji Data: v12

Features:

  • Emoji display
  • Descriptive name
  • Hyperlinked keywords
  • Link to read more at Emojipedia

Todo

  • Add long descriptions and other data provided by Emojipedia
  • Add translations
  • Add language toggle
  • Transition to use Emoji Data instead of copy/pasted HTML table

Editing the dictionary

The following steps are only required if you wish to modify the dictonary.

Feel free to send Pull Requests for items on the todo list!

Requirements

Preparing

  1. Copy contents of Additional_Tools_for_Xcode_x.x.dmg to /Applications/Additional Tools/
  2. Download this project and unzip

Editing

Edit the generator/emoji.txt file as you wish.

Building

  1. Open Terminal and cd to project directory
  2. Run build.sh (this will build and install the dictionary)
  3. In Dictionary > Preferences, scroll to the bottom of the list and activate the Emojipedia dictionary (only required once)

References

  1. Dictionary Services Programming Guide, Apple
  2. Create Custom Dictionaries For Mac OSX, Indiver Nagpal
  3. Emoji Data, Unicode, Inc.
  4. Emojipedia, Emojipedia Pty Ltd
  5. How to type emoji on Mac OS X, Emoji Blog