T-Mobile Web Data Usage Badge

WHAT IT DOES

T-Mobile Web Data Usage Badge reads data usage and plan details from your T-Mobile account page and displays a floating data usage badge showing used and total data. The badge shows the amount of data used, the total plan data, and a progress bar indicating usage percentage. Color coding shows usage levels—blue for normal, yellow for high (over 70%), and red for critical (over 90%). The badge also shows remaining data, days remaining in the billing cycle, and plan name. The extension tracks usage history per month, storing each usage record with a timestamp. When data usage exceeds 80%, a desktop notification is triggered. The panel displays your current month's usage history and changes over time.

WHERE IT RUNS

This extension works on all T-Mobile pages at t-mobile.com and its subdomains, specifically on account pages where data usage and plan details are displayed. It runs on the main account page, the data usage page, the plan details page, and any page displaying usage information. The extension operates entirely within your browser and does not access T-Mobile's servers directly—it reads only what is visible on the page you are viewing. It works alongside the free BotGentz extension, which provides the necessary scripting environment.

HOW TO USE

Install the extension, then navigate to t-mobile.com and log in to your account. The extension automatically creates a floating data usage badge on the page. Click the extension's icon in your browser toolbar to open the settings panel. Use the "Show Overlay" / "Hide Overlay" button to toggle the badge visibility. The badge shows your data usage, progress bar, and remaining data. Use the "Refresh" button to manually update the badge with the latest usage information. The "Show detailed info" toggle controls whether plan name appears. The "High usage notifications" toggle controls desktop notifications when usage exceeds 80%. Adjust the overlay transparency using the opacity dropdown (70%, 82%, 92%, or 100%). Drag the badge by clicking and holding anywhere inside it. Resize it by dragging the bottom-right corner. Close the badge with the × button.

DATA EXTRACTION WITH USAGE PARSING AND MONTHLY HISTORY TRACKING

Unlike simple data counters, this extension uses a multi-selector extraction engine to find data usage information from T-Mobile's varying page structures. It searches for usage display using multiple selector patterns (.data-usage, .usage-display, .data-used) and falls back to text parsing. The usage parser handles multiple formats, including "12.5 GB / 50 GB" for used/total and standalone values in GB or MB. The parser normalizes all values to GB for consistent display and comparison. Monthly usage history is stored as a key-value object where keys are year-month strings (YYYY-MM) and values are arrays of usage records with timestamps, limited to 20 entries per month. High usage notifications trigger when usage exceeds 80% with a once-per-day cooldown. The billing cycle and days remaining are extracted from cycle-related elements.

THE PANEL

The panel supports drag-to-move anywhere on the page. It remembers its position per site, so it stays where you placed it on t-mobile.com. Click the panel header to collapse it down to just the minimized bubble, or click the expand handle to show the full panel. The panel can be resized by dragging the bottom-right corner. Press the Escape key to close the expanded panel and return to the minimized state. All panel settings, including position, size, collapsed state, opacity, detailed info visibility, notification preference, and monthly usage history, are saved per site and persist across browsing sessions.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and active, as it provides the underlying DOM injection and script execution environment. T-Mobile's website changes periodically, and usage element structures, class names, and page layouts may be updated. When that happens, the extension may stop detecting usage data until an update is released. The extension stores your overlay position, size, opacity, visibility, detailed info preference, notification preference, and monthly usage history locally in your browser's storage using GM_setValue. Usage history is stored as a key-value object where keys are year-month strings and values are arrays of usage records. The data usage displayed is read from the page—the extension does not access T-Mobile's internal data. Always verify with T-Mobile directly for the most accurate data usage information. No data is ever sent to any server, and no personal information is collected. You can clear all stored settings at any time by clearing your browser data for t-mobile.com.