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 - 8.4 9.0 - 9.3 10.0 - 11.4 12.0 - 14.4
EmojiPort (iOS 5.1) Yes - - - - -
EmojiPort (iOS 6.0-8.2) - Yes - - - -
EmojiPort (iOS 8.3-8.4) - - Yes - - -
EmojiPort (iOS 9.0-9.3) - - - Yes - -
EmojiPort (iOS 10.0-11.4) - - - - Yes -
EmojiPort (iOS 12.0-14.4) - - - - - Yes
EmojiAttributes Required
EmojiLibrary Required
EmojiLocalization Required Required Required Required, < 9.1 - -
EmojiResources - Required, 7.0+ Required Required, < 9.1 - -
EmojiFontManager Unknown Yes Yes Yes Yes Yes
EmojiDarkStyle - 7.0+ Yes 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.

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. Add this repository: https://vxbakerxv.github.io/repo
  3. Install EmojiFontManager and Emoji iOS "XY.Z" font for EmojiFontManager (com.ps-vxbakerxv.emoji{xyz}fontefm)
  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" font (com.ps-vxbakerxv.emoji{xyz}fontefm) 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 14.5 emoji font for iOS 14+
  2. iOS 14.5 emoji font for iOS 10 - 13
  3. iOS 14.5 emoji font for iOS <=9.3

Back up the original fonts

  1. Backup the default AppleColorEmoji(@2x).ttc (or AppleColorEmoji(@2x).ttf) and AppleColorEmoji(@2x).ccf (if there is one) in /System/Library/Fonts/CoreAddition or /System/Library/Fonts/Core or /System/Library/Fonts/Cache of your device (Rename 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 - 14.0 users, place downloaded files at /System/Library/Fonts/Core on your device.
  3. For iOS 14.1+ 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.

To ensure that everything works correctly, you have to see what happened inside the directory /System/Library/Fonts/CoreAddition (iOS 14.1+), /System/Library/Fonts/Core (iOS 8.2 - iOS 14.0) 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, the exactly correct name of the emoji font is AppleColorEmoji@2x.ttf (retina devices) or AppleColorEmoji.ttf otherwise
  • For iOS 8.2, the exactly correct name of the emoji font is AppleColorEmoji_2x.ttf (retina devices) or AppleColorEmoji_1x.ttf otherwise
  • For iOS 8.3 - 9.3, similar to 5.1 - 8.1 ones but you will also have AppleColorEmoji@2x.ccf (or AppleColorEmoji.ccf), which is larger than the ttf
  • For iOS 10.0 - 13.x, similar to 8.3 - 9.3 but AppleColorEmoji@2x.ttc instead of AppleColorEmoji@2x.ttf
  • For iOS 14.0, it is AppleColorEmoji.ttc
  • For iOS 14.1+, it is 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-8.4)

  • -

EmojiPort (iOS 9.0-9.3)

  • Couple emojis picker isn't sized correctly

EmojiPort (iOS 10.0-11.4)

  • -

EmojiPort (iOS 12.0-14.4)

  • Inherited from EmojiPort (iOS 10.0-11.4)

EmojiLibrary

  • -

EmojiAttributes

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

EmojiFontManager

  • -
EmojiPort iOS 6.1 / 7.1