Fix chat emoji on IMVU Classic’s old Gecko engine, with a searchable picker, text shortcuts, and Twemoji rendering — plus optional DPI scaling patches for high-DPI displays.
Docs: Architecture · Antibot · DPI patches · Compatibility · FAQ
python -m imvu_toolkit emoji install
python -m imvu_toolkit emoji restore
python -m imvu_toolkit antibot install
python -m imvu_toolkit antibot restore
python -m imvu_toolkit emoji generate-list
python -m imvu_toolkit tools scale-window --watch
python -m imvu_toolkit dpi clean-layout --restoreLegacy root scripts (patch_imvu_emoji.py, etc.) still work.
See CONTRIBUTING.md.
python -m pip install -e ".[dev]"
pytest
ruff check src testsTag a release (git tag v1.1.0 && git push origin v1.1.0) to build and publish IMVU-Emoji-Installer.exe and IMVU-Antibot-Installer.exe via GitHub Actions.
IMVU Classic cannot render modern Unicode emoji natively. Missing glyphs show up as hex “tofu” boxes (for example 01FAEA). This patch fixes chat rendering and adds a full emoji picker next to Send.
Independent of DPI patches — install emoji support alone.
Recommended if Windows Defender blocked the old .exe — install.ps1 (Python 3.10+)
git clone https://github.com/JSukar/IMVU-TOOLKIT.git
cd IMVU-TOOLKIT
.\install.ps1Restore: .\install.ps1 --restore
Option A — GUI installer (no Python on target PC)
- Download
IMVU-Emoji-Installer.exefrom Releases. - Run it — a window opens with Install / Restore buttons (if IMVU is open, close it when prompted).
- Click the smiley button beside Send in chat.
Option B — GUI from source (Python 3.10+)
git clone https://github.com/JSukar/IMVU-TOOLKIT.git
cd IMVU-TOOLKIT
.\install_gui.ps1Restore: .\install_gui.ps1 --restore
Option C — CLI script (Defender-safe, no window)
.\install.ps1Defender still blocks the .exe? Use install.ps1 above, or see FAQ → Defender.
Windows SmartScreen: the installer is unsigned. Click More info → Run anyway. See FAQ.
Verify before you run: SHA256 and VirusTotal link for the .exe are on each release page.
Restore: IMVU-Emoji-Installer.exe --restore (GUI) or IMVU-Emoji-Installer.exe --cli --restore (console)
Build locally:
.\build_installer.ps1Output: dist\IMVU-Emoji-Installer.exe
| Picker + search | Shortcuts | Chat rendering |
|---|---|---|
 |
 |
 |
Settings (gear) and about (i): emoji-picker-settings.png · emoji-picker-about.png
- Search — filter ~1,880 Unicode 15.1 emojis by keyword
- Categories — Smileys, People, Nature, Food, Travel, Activity, Objects, Symbols, Flags
- Favorites — ★ button next to i opens your list; click ☆ on any emoji to add or remove (saved locally, persists across IMVU restarts)
- Shortcuts — type
lol,bruh,pog,:), etc.; Tab accepts the suggestion (replace word or append emoji — gear icon); 300+ built-in shortcuts - Cache — Twemoji PNGs from jsDelivr, stored in localStorage after first load
- Restore — timestamped backups +
--restore
| Layer | Change |
|---|---|
library.zip |
im/common.py — UTF-8 decode with Windows-1252 fallback |
imvuContent.jar |
Injects emoji*.js, patches chat HTML/JS/CSS |
Details: Architecture
- IMVU closed while patching
- Write access to
%APPDATA%\IMVUClient\library.zipandui\chrome\imvuContent.jar - Internet on first emoji load per glyph (then cached)
See FAQ and the troubleshooting section in dpi-patches.md (emoji entries).
Auto-boots VuArchives-style promo bots in rooms you own or mod. Shield icon beside Send shows protection status; click for boot log and whitelist.
Quick start: download IMVU-Antibot-Installer.exe from Releases, or run .\install_antibot.ps1 if Defender blocks the .exe.
Restore: IMVU-Antibot-Installer.exe --restore or .\install_antibot.ps1 --restore
Full reference (detection rules, architecture, bot research, screenshots): docs/antibot.md
For high-DPI displays (e.g. 250% scale): registry/window helper, runtime probes, and optional reversible patches to library.zip / imvuContent.jar.
Start here: docs/dpi-patches.md — includes fix_imvu_scaling.py, probe tools, patch runbooks, and troubleshooting.
DPI patches are separate from emoji. Try Windows-level scaling before internal file patches.
This project modifies local IMVU client assets. Use at your own risk. Not affiliated with IMVU, Inc.
MIT — see LICENSE.