Swakshan / emoji-builder

Emoji Builder

WhatsApp Emoji for GNU/Linux

The freshest 3442 WhatsApp emoji to color up our favorite OS.

Installing

Download font  •  Available on AUR

Before installing...

WhatsAppEmoji will conflict with the following fonts:

• Noto Emoji
• Symbola
• JoyPixel
• Twitter Color Emoji
• Apple Color Emoji

Make sure these fonts are not installed, and if so, uninstall them first.

Option 1: Install for current user

To install the font only for you, copy the .ttf file to ~/.local/share/fonts/, e.g.:

cp WhatsAppEmoji.ttf ~/.local/share/fonts/

Option 2: System-wide installation

To install the font for all the users, copy the .ttf file to cd /usr/share/fonts/TTF/, e.g.:

sudo cp WhatsAppEmoji.ttf /usr/share/fonts/TTF/

After installing...

Don't forget to rebuild the system font cache with:

fc-cache -f -v

Finally, you will have restart any open program in order for the installation to take effect.

Troubleshooting

• Non-color emojis being displayed in some apps.

Building

Pre-requisites

Building WhatsAppEmoji requires:

• Python 3
• pkg-config
• pngquant
• zopflipng
• ImageMagick

Installing Python packages

Once the packages listed in pre-requisites are installed, you can install the Python dependencies listed under requirements.txt. It is highly recommended that you install the dependencies in a virtual environment:

# Make sure the pre-requisites are installed

# Create & activate a virtual environment
python3 -m venv venv
source venv/bin/activate

# Install Python requirements
pip install -r requirements.txt

Build

Once all the dependencies are installed, you can build the font:

time make -j

This will create a directory build with the processed emojis and the compiled font WhatsAppEmoji.ttf.

Bear in mind that building the font will take several miutes.

Install

To automatically install the font in your system, run:

make install

Finally, rebuild the system font cache with:

fc-cache -f -v

You will need to restart any open program for the installed font to be displayed.

Credits

• Noto Emoji: https://github.com/googlei18n/noto-emoji
• Noto Tools: https://github.com/googlei18n/nototools
• Apple Emoji Linux: https://github.com/samuelngs/apple-emoji-linux

Disclaimer

The emoji images included in this repository belong to WhatsApp. WhatsApp is a Trademark of WhatsApp LLC, registered in the U.S. and/or other countries. These images are provided for non-commercial, educational purposes only. Its use is solely transformative, i.e., intended with a further purpose or different character, and do not substitute under any circumstance for the original use of the work.