README.md

Welcome to the Alfred Emoji Wine repository: An Alfred Workflow ✨

✅ Prerequisites

• MacOS.
• Alfred 5. Note that the Alfred Powerpack is required to use workflows.
• Requires python 3.8 or above.
• Requires pillow library.

🏎️ Data sources

This workflow combines multiple sources (see below) to build a local JSON API (~/Library/Caches/com.runningwithcrayons.Alfred/Workflow Data/com.benjamino.emoji_wine) along with an icons folder with png images.

List of sources :

• Full list of latest emojis - Used to grab the full list of emojis.
• CLDR Data files annotations - Used to translate emojis titles and tags.
• CLDR Data files annotations derived - Used to translate emojis titles and tags.

⬇️ Installation

1. Download the workflow
2. Double click the .alfredworkflow file to install

🧰 Setup the workflow

Install Python 3.8 or above. Check your version with :

python --version

Install pillow using Homebrew :

brew install pillow

🧙‍♂️ Invoke the workflow

There is 2 flows in this workflow :

1. The first one allows you to display emojis. It can be triggered by writing wine keyword.
2. The second allows you to build the local api according the selected language. You can invoke this flow with the harvest keyword.

You can edit these triggers (flagged with a 🕹️ symbol) in the user configuration panel.

🤖 Usage of the workflow

Setup variables

1. 🌐 Language : select the language you prefer. Here is the full list of supported languages :

Language	ISO639-1	EmojiPedia	EmojiTerra	EmojiAll
🇬🇧 English	en	🟢	🟢	🟢
🇫🇷 Français	fr	🟢	🟢	🟢
🇪🇸 Español	es	🟢	🟢	🟢
🇵🇹 Português	pt	🟢	🟢	🟢
🇮🇹 Italiano	it	🟢	🟢	🟢
🇩🇪 Deutsch	de	🟢	🟢	🟢
🇳🇱 Nederlands	nl	🟢	🔴	🟢
🇳🇴 Norsk	no	🟢	🔴	🔴
🇸🇪 Svenska	sv	🟢	🔴	🟢
🇩🇰 Dansk	da	🟢	🔴	🟢
🇮🇩 Melayu	ms	🟢	🔴	🟢
🇸🇦 ٱلْعَرَبِيَّة	ar	🔴	🔴	🟢
🇷🇺 Русский	ru	🔴	🔴	🟢
🇨🇳 中文	zh	🟢	🔴	🔴
🇨🇳 繁體中文	zh-hant	🔴	🔴	🟢
🇯🇵 日本語	ja	🟢	🔴	🟢
🇰🇷 한국어	ko	🟢	🔴	🟢
🇮🇳 हिंदी	hi	🔴	🔴	🟢
🇮🇳 मराठी	mr	🔴	🔴	🔴
🇮🇳 తెలుగు	te	🔴	🔴	🔴
🇧🇩 বাংলা	bn	🔴	🔴	🔴
🇱🇰 தமிழ்	ta	🔴	🔴	🔴

All emojis aren't translated in all languages. Some languages aren't supported by emoji dictionnaries.

If you wish to use another language, open a GitHub issue here.

2. ✂️ Padding : Add transparent margins to icons (in pixels).

3. 🪩 Style : Select between list or grid view.

4. 📖 Emoji Dictionary : Select your online emoji dictionary.

5. 🌈 Skin Tone : Select your preferred skin tone.

6. 🎷 Notification sound : Personalize the sound of the workflow notification.

Search an emoji

Trigger the workflow with wine keyword and search for an your emoji in the selected language.

Workflow actions

1. Press ⏎ on the selected emoji to copy it to the clipboard.
2. Press ⌘⏎ on the selected emoji to paste it to the frontmost application.
3. Press ⇧⏎ on the selected emoji to open its emojipedia page in the selected language.

Refresh the API and configure tags

Use the harvest keyword.

In the following menu you'll find :

1. A button to refresh the API for the selected language.
2. The Tags section for the selected language.
3. The last API information with date and time of the last update, number of emojis and the language selected when the API was created.

Tags can be created and linked to one or multiple emojis.

This allows to search emojis using custom words or phrases.

Tags are language specific meaning that when created they will impact only the selected language. They are also persistent overtime meaning that if you switch language or refresh the API, they will not be erased. Tags are stored under JSON files located in the afred_workflow_data folder (~/Library/Application Support/Alfred/Workflow Data/com.benjamino.emoji_wine).

⚖️ License

MIT License © Benjamin Oddou