Universal Emoji Meaning Popup

WHAT IT DOES This userscript helps you understand emoji by displaying a popup with detailed information whenever you hover over or click on an emoji on any webpage. The popup shows the emoji's official Unicode name (e.g., "Grinning Face"), its category ("Smileys & Emotion"), a list of common meanings, and example usage phrases. It also displays the emoji's Unicode codepoint, notes if the emoji is commonly ambiguous or culturally specific, and provides context to avoid misinterpretation. For example, the skull emoji 💀 is often used to mean "I'm dying of laughter" rather than literal death, and the fire emoji 🔥 typically means "cool" or "impressive". The script also highlights emoji that are frequently misused across different cultures and platforms. WHERE IT RUNS The script works on every website you visit—social media, messaging apps, forums, blogs, news sites, or any page with emoji text. It runs entirely within your browser, reading only the visible text content of the current page. It does not track your browsing history, access other tabs, or send any data externally. All emoji data is stored locally within the script. HOW TO USE After installation, open the panel by clicking the tool's icon in the BotGentz sidebar. Choose whether you want emoji to trigger on hover or click. Set the popup size (Small, Medium, Large) and toggle whether to show Unicode codepoints and highlight ambiguous emoji. The script automatically scans the page on load (you can toggle this off). Hover or click on any emoji to see its popup. Click anywhere else or press Escape to dismiss the popup. Use "Scan page for emoji" to manually re-scan after dynamic content loads, or "Clear emoji wrappers" to remove all triggers and return the page to its original state. THE TECHNICAL MECHANISM This script uses Unicode regex matching to detect emoji characters in text nodes, targeting the full emoji range (U+1F600–U+1FAFF and related symbols). It traverses the DOM using TreeWalker to find text nodes containing emoji, then replaces each emoji with a styled element that preserves the original character while adding interactive event listeners. When triggered, the script looks up the emoji in a built-in database of over 35 common emoji with official Unicode names, categories, meanings, and examples. For ambiguous emoji, it includes contextual notes to prevent miscommunication. The popup is absolutely positioned using getBoundingClientRect and automatically adjusts to stay within the viewport—if it would appear off-screen, it flips above or below the emoji and shifts horizontally to remain fully visible. The script also calculates and displays the Unicode codepoint for each emoji, which can be useful for developers or for referencing specific characters across platforms. THE PANEL The panel is draggable anywhere on the screen and remembers its position between sessions. It can be collapsed to a small floating bubble to minimize distraction, and expanded again with a single click. The panel's width can be adjusted, and pressing the Escape key closes it instantly. All settings—trigger method, popup size, show codepoint, highlight ambiguous, and auto-scan—are persisted locally using GM_setValue, so your preferences remain intact across page reloads and browser restarts. PLEASE NOTE This userscript requires the free BotGentz extension to function. The emoji database covers many common emoji but is not exhaustive—some less common or newer emoji may not have entries in the current database. The script relies on emoji detection using Unicode ranges; if a platform uses custom emoji or non-standard representations, detection may vary. Ambiguity notes are based on common usage patterns and may not cover all cultural interpretations. No data from your browsing is stored or transmitted anywhere—all processing occurs entirely in your browser.