Universal Currency Symbol Normalizer

WHAT IT DOES

Universal Currency Symbol Normalizer scans webpages for currency symbols and codes such as $, €, £, ¥, USD, EUR, GBP, JPY, and more, then normalizes them to a consistent display format based on your preference. For each amount found, the script injects a small badge showing the converted value in your preferred currency using real-time exchange rates fetched from a public API. The script also highlights inconsistent currency usage across the page, helping you identify when different currencies are mixed. A floating control panel lets you select your preferred currency, toggle normalization on or off, and adjust the display format to show symbols only, codes only, or both.

WHERE IT RUNS

This script operates as a userscript within the BotGentz extension on any webpage that contains currency amounts, including e-commerce sites, financial news, product listings, travel sites, and international business pages. It functions on any modern browser that supports the BotGentz extension, including Chrome, Firefox, Edge, Safari, and Opera. The script runs entirely client-side, fetching exchange rates from a public API without sending any user data to external servers.

HOW TO USE

After installation, the script automatically scans the page for currency amounts and displays conversion badges next to each amount, showing the value in your preferred currency. The floating control panel appears in the bottom-left corner, showing your current currency setting. To change your preferred currency, open the main panel and select your currency from the dropdown menu. Adjust the display format to show symbols, codes, or both. Toggle the conversion badges on or off, or enable highlighting of inconsistent currency usage to see where multiple currencies are mixed on the same page. Click "Refresh Exchange Rates" to fetch the latest rates manually.

THE MECHANISM THAT MAKES IT WORK

The script uses a DOM tree walker to traverse all text nodes on the page, scanning for currency patterns using a two-stage detection system. First, it identifies currency symbols ($, €, £, ¥, ₽, etc.) and currency codes (USD, EUR, GBP, JPY, etc.) using a lookup dictionary. Second, it extracts the numeric amount adjacent to the detected symbol or code using regex pattern matching. Exchange rates are fetched from a public API (ExchangeRate-API by default) with caching to minimize requests—rates are stored using GM_setValue and refreshed at a configurable interval. When a rate is available, the script calculates the converted amount by multiplying the original amount by the rate ratio (original currency to base to preferred currency). The display format is controlled by user preference, and the badge color scheme matches the tool's aesthetic. Inconsistent currency detection highlights amounts not matching the preferred currency with a red outline.

THE PANEL

The script panel is built using BotGentz's BGPanel framework and provides comprehensive control over the currency normalizer'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 preferred currency selection, display format (symbol, code, or both), API endpoint input, and refresh interval selection. Toggle switches enable or disable the normalizer, conversion badges, and inconsistency highlighting. A position selector lets you choose whether badges appear left or right of the amount. Action buttons allow you to refresh exchange rates, 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 script relies on a public exchange rate API that may have usage limits or require an API key for high-volume usage. The default API (exchangerate-api.com) offers free access with rate limits; consider upgrading or using an alternative endpoint for heavy usage. Exchange rates are cached locally to reduce API calls—you can adjust the refresh interval or manually refresh rates via the panel. The script may not detect all currency formats, especially those with non-standard spacing or symbols. Conversion badges are estimates based on current exchange rates and should not be used for financial transactions. All data is processed locally and not shared with any third-party services.