https://github.com/dmlls/whatsapp-emoji-linux
WhatsApp Emoji for GNU/Linux 🐧
https://github.com/dmlls/whatsapp-emoji-linux
emoji fonts gnu linux whatsapp whatsapp-emoji
Last synced: about 2 months ago
JSON representation
WhatsApp Emoji for GNU/Linux 🐧
- Host: GitHub
- URL: https://github.com/dmlls/whatsapp-emoji-linux
- Owner: dmlls
- License: apache-2.0
- Created: 2022-01-23T11:56:03.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2026-01-25T21:50:33.000Z (4 months ago)
- Last Synced: 2026-01-26T13:25:46.986Z (4 months ago)
- Topics: emoji, fonts, gnu, linux, whatsapp, whatsapp-emoji
- Language: Go Template
- Homepage:
- Size: 95.1 MB
- Stars: 39
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
WhatsApp Emoji for GNU/Linux
The freshest 3,961 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](https://github.com/googlefonts/noto-emoji)
- [Symbola](https://dn-works.com/ufas/)
- [JoyPixel](https://www.joypixels.com/)
- [Twitter Color Emoji](https://github.com/eosrei/twemoji-color-font)
- [Apple Color Emoji](https://github.com/samuelngs/apple-emoji-linux)
**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.:
```shell
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.:
```shell
sudo cp WhatsAppEmoji.ttf /usr/share/fonts/TTF/
```
### After installing...
Don't forget to rebuild the system font cache with:
```shell
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](https://www.freedesktop.org/wiki/Software/pkg-config/)
- [pngquant](https://pngquant.org/)
- [zopflipng](https://github.com/google/zopfli)
- [ImageMagick](https://imagemagick.org/)
### Installing Python packages
Once the packages listed in pre-requisites are installed, you can install the Python dependencies listed under [`requirements.txt`](https://github.com/dmlls/whatsapp-emoji-linux/blob/main/requirements.txt). It is highly recommended that you install the dependencies in a virtual environment:
```shell
# 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:
```shell
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:
```shell
make install
```
Finally, rebuild the system font cache with:
```shell
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.