https://github.com/gingerbeardman/emojipedia

MacOS X Dictionary containing Emoji and their meanings
https://github.com/gingerbeardman/emojipedia

dictionaries dictionary emoji emoji-data emojipedia

Last synced: about 1 month ago
JSON representation

MacOS X Dictionary containing Emoji and their meanings

• Host: GitHub
• URL: https://github.com/gingerbeardman/emojipedia
• Owner: gingerbeardman
• License: mit
• Created: 2016-07-17T20:56:14.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2021-03-22T20:28:39.000Z (about 4 years ago)
• Last Synced: 2025-05-12T11:55:52.619Z (about 1 month ago)
• Topics: dictionaries, dictionary, emoji, emoji-data, emojipedia
• Language: PHP
• Homepage:
• Size: 1.02 MB
• Stars: 255
• Watchers: 13
• Forks: 13
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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](https://dictionaries.io) 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](https://github.com/gingerbeardman/Emojipedia/releases/download/20190306/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](https://github.com/gingerbeardman/Emojipedia/blob/master/screenshot_emoji-dictionary_lookup.png)

Dicationary Popup

![Dictionary popup](https://github.com/gingerbeardman/Emojipedia/blob/master/screenshot_emoji-dictionary_popup.png)

Dictionary.app

![Dictionary.app](https://github.com/gingerbeardman/Emojipedia/blob/master/screenshot_emoji-dictionary_app.png)

---

## Status

Number of Emoji included: 1719  

Emoji Data: v12  

Features:

* Emoji display

* Descriptive name

* Hyperlinked keywords

* Link to read more at [Emojipedia](http://emojipedia.org)

## Todo

* Add long descriptions and other data provided by [Emojipedia](http://emojipedia.org)

* Add translations

* Add language toggle

* Transition to use [Emoji Data](http://www.unicode.org/Public/emoji/12.0/) instead of copy/pasted [HTML table](http://unicode.org/emoji/charts/emoji-list.html)

---

## 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

* php

* [Additional Tools for Xcode](https://developer.apple.com/download/more/)(download the one fit your Xcode's version) (contains the Dictionary Development Kit)

### 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](https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/DictionaryServicesProgGuide/Introduction/Introduction.html#//apple_ref/doc/uid/TP40006152-CH1-SW1), Apple

2. [Create Custom Dictionaries For Mac OSX](http://blog.nagpals.com/mac-dictionaries/), Indiver Nagpal

3. [Emoji Data](http://unicode.org/emoji/charts/emoji-list.html), Unicode, Inc.

4. [Emojipedia](http://emojipedia.org), Emojipedia Pty Ltd

5. [How to type emoji on Mac OS X](http://blog.getemoji.com/emoji-keyboard-mac), Emoji Blog