gingerbeardman / emojipedia Goto Github PK

View Code? Open in Web Editor NEW

252.0 14.0 13.0 1.04 MB

MacOS X Dictionary containing Emoji and their meanings

License: MIT License

CSS 23.71% Makefile 21.33% Shell 1.89% PHP 53.07%

emoji emoji-data dictionaries emojipedia dictionary

emojipedia's Introduction

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

Download Dictionaries.app and run it
Click "Add Dictionary"
Select Emojipedia
Click "Add"

Using Terminal

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

Using Finder

Download Emojipedia.dictionary.zip and unzip it
Copy Emojipedia.dictionary to ~/Library/Dictionaries
Launch Dictionary.app
In Dictionary > Preferences, scroll to the bottom of the list and check the Emojipedia dictionary to enable it
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

Dicationary Popup

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

php
Additional Tools for Xcode(download the one fit your Xcode's version) (contains the Dictionary Development Kit)

Preparing

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

Editing

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

Building

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

References

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

emojipedia's People

Contributors

Stargazers

Watchers

Forkers

jerybeary ertos12 kevinrodbe poweruser82 dongyuwei antonioribeiro binderclip slother123 maskmale batermj kawarimidoll hermanbarrantes lodera

emojipedia's Issues

Update to use Emoji CLDR data

Generator should use https://unicode.org/Public/emoji/12.0/
https://unicode.org/Public/emoji/12.0/emoji-test.txt rather than copy/pasted HTML table.

Previously the HTML table approach worked, but with Emoji V12.0 (and possibly before) the HTML table no longer includes variations (such as skin tone).

question about copyright of descriptions provided by Emojipedia

Hello, I found the todo Add long descriptions and other data provided by Emojipedia in this project's README doc.

I want to translate the descriptions to Chinese and may also create emoji input tools using these data like Flags Keyboard for iPhone.

Wanna to know could the usage of these descriptions be authorized? If yes, then how.

Would be very grateful if you could provide some information. 🙏

version number wrong

i've downloaded version 20190306 but the displayed version number is 20170424

No content in popup when using look up on word "cool"

Try it yourself: cool

after clicking Emojipedia

screens from trying on this page: http://www.polygon.com/tv/2016/12/8/13881068/shigeru-miyamoto-the-roots-play-the-super-mario-bros-theme

Update.

There is new version, v14.

Could be useful as data source, or more keywords https://github.com/alirawashdeh/emoji-list-fetcher + https://github.com/alirawashdeh/emoji-data-enricher

https://unicode.org/Public/emoji/14.0/emoji-test.txt
https://unicode.org/emoji/charts-14.0/full-emoji-list.html
https://unicode.org/emoji/charts/emoji-list.html

Where is the file gernerator/emoji.txt coming from? I'd love to update it to a more recent version of unicode / emoji but can't find the source or way of generation of that. The structure looks like this but there is a complex html table. According to that page, production code should only rely on the official data files. It would be great if the build process could be integrated with upstream unicode data.

Can't display some emoji definition

In OS X 10.10.5 neither Dictionary.app nor the pop up can display the definition of some emoji.
I.e.:

😅 Smiling Face With Open Mouth & Cold Sweat.
😆 Smiling Face With Open Mouth & Closed Eyes

I suppose this may be due to unescaped & in the Emoji.xml file.

Is your feature request related to a problem? Please describe.
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

Describe the solution you'd like
A clear and concise description of what you want to happen.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Additional context
Add any other context or screenshots about the feature request here.

Installation is failed using latest Homebrew

Describe the bug

The command brew cask install in README.md doesn't work now because of update of Homebrew.
This is not a bug of this app, but the document needs to be fixed.

To Reproduce

Run brew cask install emojipedia.

Expected behavior

Installation is succeeded.

Screenshots

Desktop (please complete the following information):

OS: macOS 11.2.3
Browser: not relevant

Additional context

homebrew discussions: Error: Calling brew cask install is disabled! · Discussion #340 · Homebrew/discussions

brew cask <command> was deprecated in favor of brew <command> --cask in Homebrew 2.6.0. Now that 2.7.0 has been released, they have been disabled.

homebrew blog: 2.6.0 — Homebrew

All brew cask commands have been deprecated in favour of brew commands (with --cask) when necessary

Keywords are no longer clickable hyperlinks

😩

Dance emojis keywords

👯, 💃 and 🕺 have respectively the keywords dancer, dancing and dance. It would be easier to find them if they shared the same keyword.