EmojiPort

A set of open-source tweaks that enable latest emojis on your device, developed by PoomSmart.

EmojiPort: iOS 8.1 / 8.4 / 9.0 / 9.3 / 10.1 / 10.3

Compatibility and Dependencies


Tweak iOS Versions
5.1 6.0 - 8.2 8.3 - 9.3 10.0 - 11.4 12.0 - 14.8
EmojiPort (iOS 5.1) Yes - - - -
EmojiPort (iOS 6.0-8.2) - Yes - - -
EmojiPort (iOS 8.3-9.3) - - Yes - -
EmojiPort (iOS 10.0-11.4) - - - Yes -
EmojiPort (iOS 12.0-14.8) - - - - Yes
EmojiAttributes Required
EmojiLibrary Required
EmojiLocalization Required Required Required, < 9.1 - -
EmojiResources - Required, 7.0+ Required, < 9.1 - -
EmojiPort-10-Resources - - - Required
EmojiFontManager Unknown Yes Yes Yes Yes
EmojiDarkStyle - 7.0+ Yes < 10.2 -

Which does what?


EmojiPort adds latest emojis on your emoji keyboard. It may need the following other tweaks depending on the iOS version you are on to make everything work as intended.

EmojiAttributes

This tweak helps display emoji characters properly. Otherwise, you may see "?", "U", square or just blank space instead of actual emojis.

EmojiLocalization

(iOS 5.1 - 9.0) This tweak updates localization on the emoji keyboard to match the latest. For example: "People", "Nature", "Objects" and "Flags".

EmojiResources

(iOS 7.0 - 9.0) This tweak updates category icons on the emoji keyboard to match the latest. That is, the icons you see at the bottom-middle of the emoji keyboard.

EmojiPort-10-Resources

(iOS 10+) This package updates localization and metadata of emojis for functions like emoji suggestion and search to work up-to-date.

EmojiFontManager

This tweak allows users to install the correct emoji font without filesystem modifications..

EmojiLibrary

Required for all EmojiPort tweaks, it contains a set of latest emojis and handles any kinds of emojis correctly.

EmojiDarkStyle

This tweak is optional. It enables dark variants of emoji category icons seen in iOS 10.2+.

Read first about EmojiPort


Emojis are available on iOS through a keyboard. All emojis you see on the keyboard are predefined on iOS. Newer iOS versions usually include more emojis, thus the users at the lower versions won't be able to use or see unless they update their iOS to the latest.

Emojis are images, packed as a font, named AppleColorEmoji (and called internally .AppleColorEmojiUI on iOS 10+). The font gets updated to include new emojis.

EmojiPort works with an up-to-date emoji font that contains all emoji images needed. Without the new font installed, users are going to see "blank" emojis - in other words, new emojis won't show up.

How to install EmojiPort?


First of all, add this repository: https://poomsmart.github.io/repo

Note that "XY.Z" means the iOS version that have new emojis. For example, 14.5

1. Get the latest emoji font

Option #1: BytaFont (iOS 6 - 9)

Installation

  1. Make sure you have enough space on the system partition (over 50 MB is recommended)
  2. If BytaFont app cannot be run as root (for example: on iOS 9.3.5 with stashing tweak), you cannot proceed and have to choose another method
  3. Install BytaFont app (BytaFont 3 for iOS 9, BytaFont 2 for iOS 7 - 8, BytaFont for iOS 5 - 6)
  4. Add this repository: https://vxbakerxv.github.io/repo
  5. Install Emoji iOS "XY.Z" font for BytaFont (com.ps-vxbakerxv.emoji{xyz}font)
  6. Open BytaFont app, go to Swap Mode > Emoji and tap Emoji_"XY.Z" to enable the font, and respring.

Uninstallation

  1. Open BytaFont app, go to Swap mode > Emoji then tap on Restore BytaFont Backup to restore the default emoji font, and respring.
  2. Uninstall Emoji iOS "XY.Z" font (com.ps-vxbakerxv.emoji{xyz}font)
  3. Respring your device.

Option #2: EmojiFontManager (iOS 6+)

Note: It supports Anemone emoji fonts.

Installation

  1. Disable any emoji font applied by Anemone, as this tweak simply overrides it.
  2. Install EmojiFontManager and Emoji iOS "XY.Z" (EFM) font (com.ps.emojifontefm)
  3. Note: If you are on iOS 14+, you may instead install Emoji iOS "XY.Z" (EFM) Native font (com.ps.emojifontefm-native). Read package description for more information.
  4. Go to Settings > EmojiFontManger, select Emoji_"XY.Z" to enable the font and tap Respring button to apply changes.

Uninstallation

  1. Uninstall Emoji iOS "XY.Z" (EFM) font (com.ps.emojifontefm) and EmojiFontManager
  2. Respring your device.

Option #3: SnowBoard

Installation

  1. Install SnowBoard Fonts Extension if you haven't already.
  2. Add this repository: https://vxbakerxv.github.io/repo
  3. Install Emoji iOS "XY.Z" font for Anemone (com.ps-vxbakerxv.emoji{xyz}fonta)
  4. Go to Settings > SnowBoard > Select Theme..., enable Fonts (Emoji) then hit Apply Change.
  5. Resring your device.

Uninstallation

  1. Go to Settings > SnowBoard > Select Theme..., disable Fonts (Emoji) then hit Apply Change.
  2. Uninstall Emoji iOS "XY.Z" font (com.ps-vxbakerxv.emoji{xyz}fonta).
  3. Respring your device.

Option #4: Manual

Download a compatible font (choose one)

  1. iOS 15.4 emoji font for iOS 14+ (Native)
  2. iOS 15.4 emoji font for iOS 10+
  3. iOS 15.4 emoji font for iOS <=9.3

Back up the original fonts

  1. Back up the default fonts with the following names (if any): AppleColorEmoji-160px.ttc, AppleColorEmoji(@2x).ttc, AppleColorEmoji(@2x).ttf, AppleColorEmoji(@2x).ccf in /System/Library/Fonts/CoreAddition or /System/Library/Fonts/Core or /System/Library/Fonts/Cache of your device by adding .bak or simply move them to somewhere else MAKE SURE you don't let the default and the new font files in the same directory - or your keyboard will break.
  2. If you device is non-retina, all font names won't include @2x, instead will be _1x (in iOS 8.2) or nothing otherwise.

Copy the font to the correct location

  1. For iOS 5.1 - 8.1 users, place downloaded files at /System/Library/Fonts/Cache on your device.
  2. For iOS 8.2+, iPhone SE 1st gen, iPhone 6s and iPhone 6s Plus users, place downloaded files at /System/Library/Fonts/Core on your device.
  3. For everything else (iOS 14.0+ users), place downloaded files at /System/Library/Fonts/CoreAddition on your device.

Important Notes

  1. (iOS 9.3 or lower, non-Retina devices) If you choose iOS "XY.Z" font for iOS <=9.3, rename the font name from AppleColorEmoji@2x.ttf to AppleColorEmoji.ttf (iOS != 8.2), or from AppleColorEmoji@2x.ttf to AppleColorEmoji_1x.ttf otherwise.
  2. (iOS 8.3 - 9.3) If you choose iOS "XY.Z" font for iOS <=9.3, make sure you don't have the original CCF file in the same directory. You can either move this CCF to somewhere else or rename it to something else.

2. Install EmojiPort of your iOS version

  1. In your package manager, search for EmojiPort
  2. Select and install the one with the corresponding iOS version in the parentheses.
  3. Respring your device.

Troubleshooting


Common mistake

Many people don't use the correct emoji font after they install the tweaks. They expect EmojiPort alone to work out-of-the-box. The original emoji font won't contain any new emojis. This is why they experience emojis not displaying correctly.

Issues with fonts

Some people don't know what they did. The emoji font, if installed manually, must be in the correct location and with the correct file name and extension. Doing anything wrong will cause the emoji keyboard to be either full of blanks, full of "U" symbols or full of "?" symbols.

Location Prefix /System/Library/Fonts iOS Versions and Device Types
5.1 - 8.1 8.2 8.3 - 9.3 10.0 - 13.7 14.0+
Non-HD HD Non-HD HD Non-HD HD Non-HD HD iPhone SE (2016) & iPhone 6s(+) Others
/Cache/AppleColorEmoji .ttf @2x.ttf -
/Core/AppleColorEmoji - _1x.ttf _2x.ttf .ttf and .ccf @2x.ttf and @2x.ccf .ttc and .ccf @2x.ttc and @2x.ccf .ttc -
/CoreAddition/AppleColorEmoji - -160px.ttc

To ensure that everything works correctly, you have to see what happened inside the directory /System/Library/Fonts/CoreAddition (iOS 14.0+), /System/Library/Fonts/Core (iOS 8.2+) or /System/Library/Fonts/Cache otherwise. The original font should still be there, but maybe with a wrong file extension.

  • For iOS 5.1 - 8.1, you must see AppleColorEmoji@2x.ttf (retina devices) or AppleColorEmoji.ttf (non-retina devices)
  • For iOS 8.2, you must see AppleColorEmoji_2x.ttf (retina devices) or AppleColorEmoji_1x.ttf (non-retina devices)
  • For iOS 8.3 - 9.3, you must see AppleColorEmoji@2x.ttf (retina devices) or AppleColorEmoji.ttf (non-retina devices), and AppleColorEmoji@2x.ccf (retina devices) or AppleColorEmoji.ccf (non-retina devices)
  • For iOS 10.0 - 13.7, you must see AppleColorEmoji@2x.ttc (retina devices) or AppleColorEmoji.ttc (non-retina devices), and AppleColorEmoji@2x.ccf (retina devices) or AppleColorEmoji.ccf (non-retina devices)
  • For iOS 14.0+ on iPhone SE 1st gen, iPhone 6s and iPhone 6s Plus, you must see AppleColorEmoji.ttc
  • For iOS 14.0+ on other devices, you must see AppleColorEmoji-160px.ttc

If you see something different, you likely have issues with the font. To restore the default fonts, there are multiple ways:

  • [BytaFont] Get BytaFont Backup fonts that should be in your package manager for you to recover lost fonts.
  • [BytaFont] /User/Library/Preferences/BytaFontBackup should keep all the default fonts, you can get the old emoji font from there.
  • Download firmware or OTA update corresponding to your iOS version, extract files (decrypt if needed) and copy the original ones to the font directory.

By installing the correct font, this should fix 90% of problems installing EmojiPort that new users usually encounter.

[iOS 8.2] Apple named emoji font to be AppleColorEmoji (underscore)(2 or 1)x.ttf. BytaFont might not be able to handle this special case and you might need to rename the file manually, by changing from "@ " to "_ ".

Font on non-retina devices

Some font management tool like Anemone may not handle the new emoji font correctly. Most of the emoji font packages have only AppleColorEmoji@2x.ttf. In other words, only the font is recognized by retina devices. The simplest recommendation is, you install the font manually so that you can make sure the font name contains no @2x nor _2x.

Known issues


EmojiPort (iOS 5.1)

  • Unforeseen issue about keyboard
  • Emoji HUD may accidentally show as swiping across emoji pages

EmojiPort (iOS 6.0-8.2)

  • Keyboard appearance issue in rare cases
  • Emoji HUD may accidentally show as swiping across emoji pages

EmojiPort (iOS 8.3-9.3)

  • (iOS 9) Couple emojis picker isn't sized correctly

EmojiPort (iOS 10.0-11.4)

  • -

EmojiPort (iOS 12.0-14.8)

  • Inherited from EmojiPort (iOS 10.0-11.4)

EmojiLibrary

  • -

EmojiAttributes

  • (iOS < 13.2) Interracial emojis don't seem to be combined programmatically
  • (iOS < 11.2) Display issue of the three flag emojis
  • (iOS < 10) Emoji split and wrong glyph size issues on websites
  • (iOS 5.1) Emoji won't combine (WebCore version too old)

EmojiFontManager

  • -
EmojiPort iOS 6.1 / 7.1