WhatsApp Emoji for GNU/Linux

The freshest 3457 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 and FAQs

Non-color emojis are being displayed in some apps.

Please, refer to the troubleshooting guide.

Can I install the emoji on Android?

To install WhatsApp emoji on Android, you will need to replace your system font file currently in use, requiring root access.

In most cases the system font would be NotoColorEmoji.ttf, you can find it in /system/fonts/ using your choice of root File Manager, such as MiXplorer, take note of its assigned permissions.

Rename WhatsAppEmoji.ttf to NotoColorEmoji.ttf and copy it to /system/fonts/ overwriting the existing file. Change the permissions to that of the original's (644), reboot your phone, and you should now have WhatsApp emoji's as your system default.

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.