Skip to content

feat(emoji): add setting to render high-resolution system emojis in chats - #2256

Open
igotlinux wants to merge 3 commits into
session-foundation:devfrom
igotlinux:feature/system-emoji-support
Open

igotlinux wants to merge 3 commits into
session-foundation:devfrom
igotlinux:feature/system-emoji-support

Conversation

@igotlinux

@igotlinux igotlinux commented Nov 11, 2026 •

Copy link
Copy Markdown

First time contributor checklist

  • I have tested my contribution on these devices:
  • Android Emulator (Pixel, Android 14 / API 34), playDebug
  • Android Physical Device, playDebug
  • My contribution is fully baked and ready to be merged as is
  • I ensure that all the open issues my contribution fixes are mentioned in the commit message of my first commit using the Fixes #1234 syntax (Fixes Low-res emojis #53)

Description

Fixes #53

Note on #1053: I noticed #1053 previously attempted a larger emoji pipeline rewrite but has experienced merge conflicts on dev. This PR proposes a lightweight, non-breaking user preference toggle ("Use System Emojis") that immediately delivers crisp emojis on modern devices without requiring assets removal or breaking backward compatibility.

Session currently uses a legacy 66x66px bitmap spritesheet pipeline (EmojiProvider / EmojiTextView) inherited from older Signal code. On modern high-DPI screens, these small bitmap tiles appear blurry and pixelated when scaled up.

This PR adds a "Use System Emojis" toggle in Settings → Chats (disabled by default to avoid missing glyphs on older devices) that allows messages to render sharp, high-resolution vector emojis using the device's native emoji font rather than the low-resolution spritesheets.

Changes:

  • Added USE_SYSTEM_EMOJI key and getter/setter preferences in TextSecurePreferences.kt (defaults to false).
  • Updated EmojiTextView.java to check isUseSystemEmojiEnabled() before parsing/replacing emoji spans; when enabled, it skips the bitmap spritesheet replacement and renders the native Unicode characters.
  • Added preference toggle in ChatsPreferenceScreen.kt with dedicated QA tags in content-descriptions, and state handling in ChatsPreferenceViewModel.kt.

Testing:

  • Verified in Android Studio with compilePlayDebugKotlin, compilePlayDebugJavaWithJavac, and testPlayDebugUnitTest (all tests pass).
  • Toggled on/off in Settings → Chats and verified emoji sharpness in conversation views.

@igotlinux
igotlinux force-pushed the feature/system-emoji-support branch from 08c3b58 to e97e27c Compare November 11, 2026 15:19

@mpretty-cyro mpretty-cyro left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for your contribution here, there are a few changes which need to be made before this could be merged


@JvmStatic
fun isUseSystemEmojiEnabled(context: Context): Boolean {
return getBooleanPreference(context, USE_SYSTEM_EMOJI, true)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

On older phones without Google Play fonts new emoji can show as empty boxes so we'd probably want the default to be off for this setting

}

override fun isUseSystemEmojiEnabled(): Boolean {
return getBooleanPreference(USE_SYSTEM_EMOJI, true)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same default value comment

prefs.observeBooleanKey(TextSecurePreferences.SEND_WITH_ENTER, default = false),
prefs.observeBooleanKey(TextSecurePreferences.AUTOPLAY_AUDIO_MESSAGES, default = false),
) { trim, enter, autoplay ->
prefs.observeBooleanKey(TextSecurePreferences.USE_SYSTEM_EMOJI, default = true),

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same default value comment

val sendWithEnter: Boolean = false,
val autoplayAudioMessage: Boolean = false
val autoplayAudioMessage: Boolean = false,
val useSystemEmoji: Boolean = true

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same default value comment

subtitle = annotatedStringResource("Render crisp, high-resolution emojis using your device's native font instead of compressed spritesheets"),
subtitleStyle = LocalType.current.large,
checked = uiState.useSystemEmoji,
qaTag = R.string.qa_preferences_send_with_enter,

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should have it's own QA tag rather than reusing the "send with enter" one

@igotlinux

Copy link
Copy Markdown
Author

Thanks for the review @mpretty-cyro! Addressed all feedback:

  • Changed the default of USE_SYSTEM_EMOJI / useSystemEmoji to false in TextSecurePreferences.kt and ChatsPreferenceViewModel.kt.
  • Added dedicated qa_preferences_use_system_emojis / qa_preferences_use_system_emojis_toggle strings in content-descriptions and updated ChatsPreferenceScreen.kt to use them.

Verified with compilePlayDebugKotlin, compilePlayDebugJavaWithJavac, and testPlayDebugUnitTest.

@igotlinux

Copy link
Copy Markdown
Author

also updated EmojiProvider so reaction emojis, reaction pills, the emoji picker and input search bar use the system font too when the setting is on instead of still pulling the 66x66 spritesheets

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Low-res emojis

2 participants