Python and shell scripts to backport and theme Apple Color Emoji font.
brew install bash)pip3 install fonttools[repacker]>=4.48.0)pip3 install afdko)pip3 install libpylzfse)pip3 install Pillow)brew install pngquant)brew install oxipng)brew install freetype imagemagick)brew install librsvg)brew install svgo)Apple Color Emoji.ttc from /System/Library/Fonts of your macOS instance to the root of this repository and rename it to AppleColorEmoji_macOS.ttc.AppleColorEmoji_iOS.ttc. Read here for the exact file path../prepare.sh to create emoji TTF files and tables. Run this once.Build format: ./apple-prepare.sh <OS> && ./apple.sh [HD]
Replace <OS> with macOS (if you have both macOS and iOS fonts) or iOS (if you only have iOS font).
Replace [HD] with HD if you want to build HD version (160x160 image set included), or leave it blank for normal version.
Executing ./apple-prepare.sh <OS> && ./apple.sh will get AppleColorEmoji@2x.ttc (for iOS 10 and above) and AppleColorEmoji@2x.ttf (for iOS 9 and below) for you under apple directory.
EmojiFonts deals with certain font tables; mainly GDEF and sbix.
shift-multi.py resizes and shifts the multi-skinned emojis that pair up as one, including couples and handshake, to have them displayed on iOS 13 and below correctly where there is no render logic to automatically place the pair close together.
GDEF table which maps each of paired emojis to a certain class, is modified by the scripts. This is for the easiest backward-compatible solution for the emoji font. In this table, emojis with class 1 and 3 represent left and right, respectively. With those present, the text render engine on iOS 14+ will try to place the pair close together again even when we applied shift-multi.py to the font. Another script remove-class3.py ensures that there are no class 1 and 3 emojis that will otherwise be visible to the users.
extractor.py extracts PNG emoji images from the font. This opens up the possibility to theme the emoji font.
Also in extractor.py, it detects glyphs of type flip, reads the actual image glyph ID that they reference to, programmatically flips them and then extracts them. flip glyphs are present in iOS 17.4 version of Apple Color Emoji font and not supported by any lower OS versions. They are for directional emojis - Apple has a single image for each direction, and the font uses flip glyphs to render the correct image.
pngquant and oxipng are used to optimize the images with little to none changes to the quality. The Apple emoji font sizes are reduced by 50% using this method. The simpler the emoji images, the more size reduction is achieved.
Theming scripts for all emojis vendors produce the font in TTC format. The font may be used by EmojiFontManager iOS tweak, and is guaranteed to work on iOS 6 and higher. Ensure that you executed ./apple-prepare.sh <OS> && ./apple.sh HD before following instructions below.
It is recommended to limit the depth of clone to 1 (git clone --depth 1 git@github.com:PoomSmart/EmojiFonts.git) because of a long history of commits.
cd blobmoji && ./blobmoji.sh to create themed font, output at blobmoji/blobmoji.ttc.cd facebook && ./facebook.sh to create them themed font, output at facebook/facebook.ttc.cd fluentui && ./fluentui.sh STYLE (where STYLE is one of this list: Color, Flat, High Contrast) to create themed font, output at fluentui/fluentui-STYLE.ttc.cd noto-emoji && ./noto-emoji.sh to create the themed font, output at noto-emoji/noto-emoji.ttc.cd joypixels && ./joypixels.sh to create themed font, output at joypixels/joypixels.ttc.cd openmoji && ./openmoji.sh to create themed font, output at openmoji/openmoji.ttc.SamsungColorEmoji.ttf with Samsung One UI emojis somehow and place that in oneui folder.cd oneui && ./oneui.sh to create themed font, output at oneui/oneui.ttc.TossFaceFontMac.ttf from tossface GitHub Releases and place that in tossface folder.cd tossface && ./tossface.sh to create themed font, output at tossface/tossface.ttc.cd twemoji && ./twemoji.sh to create the themed font, output at twemoji/twemoji.ttc.cd whatsapp && ./whatsapp.sh to create themed font, output at whatsapp/whatsapp.ttc.