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	15.0 - 17.3
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-17.3)	-	-	-	-	Yes	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	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.

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?

---

TL;DR:
1. Add these repositories to your package manager: apt.bingner.com (iOS 10 or lower), repo.chariz.com, apt.thebigboss.org/repofiles/cydia and poomsmart.github.io/repo
2. Install "EFM Font Setter" and "EmojiPort (YOUR IOS VERSION)" tweak
3. Respring

---

First of all, add these repositories if not already: apt.bingner.com (if you are on iOS 10 or lower), apt.thebigboss.org/repofiles/cydia, repo.chariz.com and poomsmart.github.io/repo

Note that [VERSION] indicates the iOS version that have new emojis, for example: 17.4.
Also, [UVERSION] indicates the Unicode version of those emojis, usually falls behind the iOS version, for example: 15.1.

1. Get the latest emoji font

Option #1: EmojiFontManager (iOS 6+)

Installation

1. Disable any emoji font applied by Anemone, as this tweak simply overrides it.
2. (iOS 10 or lower) Upgrade all packages from apt.bingner.com, if not already.
3. Install EmojiFontManager and AppleColorEmoji Unicode [UVERSION] (EFM) font (com.ps.emojifontefm)
4. Go to Settings > EmojiFontManger, select AppleColorEmoji to enable the font and tap Respring button to apply changes.

Uninstallation

1. Uninstall AppleColorEmoji Unicode [UVERSION] (EFM) font (com.ps.emojifontefm) and EmojiFontManager
2. Respring your device.

Option #2: WDBFontOverwrite

If you are on iOS 15 - 16.1.2, you can use this method. iOS 14 also works, but is not recommended.

Installation

1. Follow ios.cfw.guide tutorial to install TrollStore on your device, if you haven't already.
2. Download and install WDBFontOverwrite (@ginsudev's fork) using TrollStore on your device, if you haven't already.
3. Download AppleColorEmoji.ttc or AppleColorEmoji-HD.ttc from EmojiFonts release page on your device.
4. Open WDBFontOverwrite app and install the downloaded emoji font.
5. Respring your device.

Uninstallation

1. Reboot your device.

Option #3: Manual (Rootful)

If your root filesystem is not writable (i.e., you are on a rootless jailbreak), you cannot use this method.

1. Download a compatible font (choose one)

1. AppleColorEmoji font (HD)
2. AppleColorEmoji font (iOS 10+)
3. AppleColorEmoji font (iOS <=9.3)

2. 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.

3. 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.

Where is my emoji font?

iOS version Your iOS version 5.0 - 8.1 8.2 8.3 - 9.3 10.0 - 13.7 14.0+

Device model Your device model iPhone SE (1st gen) or iPhone 6s or iPhone 6s Plus Any other non-retina devices Any other retina devices

Emoji font path

Important Notes

1. (iOS 9.3 or lower, non-Retina devices) If you choose iOS [VERSION] 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 [VERSION] 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 forEmojiPort.
2. Select and install "EmojiPort (YOUR IOS VERSION)".
3. Respring your device.

Troubleshooting

---

Common mistake

Some 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 - 13.7) 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, download the firmware or OTA update corresponding to your iOS version, extract files (decrypt if needed) and copy the original ones to the correct 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 "_ ".

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-17.3)

• -

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

• Jailbreak issue: Font theming won't work on WebContent processes (Websites on Safari) on rootless jailbreaks like Dopamine and palera1n.