Universal Emoji Rendering Consistency Fixer

WHAT IT DOES

Universal Emoji Rendering Consistency Fixer scans webpages for emoji characters and replaces them with a consistent rendering style, ensuring they display uniformly across different browsers and operating systems. The script detects emoji in text nodes and applies a unified font-family (including "Apple Color Emoji", "Segoe UI Emoji", "Noto Color Emoji", and "Twemoji Mozilla") to prevent emoji from appearing as black-and-white or as different styles on different devices. It also provides options to use Twitter-style (twemoji) or Apple-style emoji rendering via CDN images or font styling. Additionally, the script fixes emoji sizing and alignment issues, ensuring emojis are properly sized and vertically aligned with surrounding text.

WHERE IT RUNS

This script operates as a userscript within the BotGentz extension on any webpage containing emoji characters, including social media platforms, messaging apps, blogs, forums, and documentation sites. It functions on any modern browser that supports the BotGentz extension, including Chrome, Firefox, Edge, Safari, and Opera. The script runs entirely client-side, processing emoji rendering locally without sending any data to external servers (with the exception of loading twemoji images from a CDN when that style is selected).

HOW TO USE

After installation, the script automatically scans the page for emoji characters and applies the default native rendering style. A floating control panel appears showing the current style and the number of emojis fixed. Use the Native, Twitter, or Apple buttons in the floating panel to switch between rendering styles instantly. Open the main panel to customize which elements to process, toggle sizing and alignment fixes, exclude specific sections using CSS selectors, or enable auto-detection. The script handles both single emoji characters and multi-character emoji sequences (including skin tone modifiers and ZWJ sequences).

THE MECHANISM THAT MAKES IT WORK

The script uses a comprehensive emoji detection system that identifies emoji characters by scanning Unicode code points across multiple emoji ranges (including emoticons, symbols, flags, and skin tone modifiers). It traverses all text nodes in the DOM using a TreeWalker, preserving the original text structure while wrapping detected emoji characters in styled span elements. For native rendering, the script applies a robust font-family stack that includes all major emoji fonts, ensuring the best available rendering on any platform. For twemoji style, it loads images from Twitter's CDN using the emoji's Unicode code point as the filename. For Apple style, it uses the same font-family stack with Apple Color Emoji prioritized. The script also detects and preserves ZWJ sequences (e.g., 👨‍👩‍👦) by not splitting these multi-character emojis during processing. The floating controls allow real-time switching between styles without reloading the page.

THE PANEL

The script panel is built using BotGentz's BGPanel framework and provides comprehensive control over the emoji fixer's behavior. The panel opens as a floating overlay that can be dragged anywhere on your screen, with a clean dark theme matching the tool's aesthetic. It includes dropdown menus for emoji style selection (Native, Twitter, Apple), a text input for CSS selectors to exclude specific elements, and toggle switches for enabling the fixer, applying to all text, fixing sizing, fixing alignment, and auto-detecting emojis. Action buttons allow you to fix emojis immediately, save settings, or reset all settings to defaults. The panel collapses to a small icon when not in use and expands when clicked, remaining accessible but unobtrusive. Press the Escape key at any time to close the panel.

PLEASE NOTE

This script requires the free BotGentz extension to be installed and activated in your browser. The extension is available from the official BotGentz website. The twemoji style loads images from a CDN (jsdelivr) and requires an internet connection to display images. The native and Apple styles use system fonts and do not require external resources. The script modifies the page's DOM by wrapping emoji characters in span elements; disabling the script will restore the original text. Some complex emoji sequences (skin tone modifiers, ZWJ sequences) may not render perfectly in all styles. The exclude selectors field allows you to prevent the script from affecting specific sections of the page. No user data is collected, stored, or transmitted by this script.