PG&E Web Usage Trend Chart

WHAT IT DOES

PG&E Web Usage Trend Chart reads energy usage data from your PG&E account dashboard and displays a floating usage trend chart overlay showing daily, weekly, or monthly usage patterns. The overlay displays a bar chart with color-coded bars—red for peak usage days, yellow for high usage, green for low usage, and blue for normal usage. Stats show peak usage, average usage, and total usage. The extension tracks usage history per month, storing total usage, average, and peak values with timestamps. When a usage spike exceeds twice the average, 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 PG&E pages at pge.com and its subdomains, specifically on account dashboard and energy usage pages. It runs on the main dashboard, the energy usage page, the usage details page, and any page displaying usage information. The extension operates entirely within your browser and does not access PG&E'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 pge.com and log in to your account. The extension automatically creates a floating usage trend chart overlay 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 chart shows your energy usage patterns with color-coded bars. Use the "Refresh" button to manually update the chart with the latest usage information. The "Show trend lines" toggle controls whether trend lines appear on the chart. The "Usage spike notifications" toggle controls desktop notifications when usage spikes are detected. 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.

ENERGY USAGE EXTRACTION WITH MULTI-UNIT NORMALIZATION AND SPIKE DETECTION

Unlike simple data display tools, this extension uses a multi-selector extraction engine to find energy usage data from PG&E's varying page structures. It searches for usage values using multiple selector patterns (.usage-value, .usage-item, .daily-usage) and falls back to text parsing. The usage parser handles multiple units (kWh, kW, W, MW, therm) and normalizes all values to kWh for consistent display and comparison. The chart displays up to 14 days of usage data with color coding based on relative values. The spike detection algorithm compares each day's usage to the rolling average and triggers a notification when usage exceeds twice the average. Monthly usage history is stored as a key-value object where keys are year-month strings and values are arrays of usage records with timestamps, limited to 20 entries per month.

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 pge.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, trend line 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. PG&E'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, trend line 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 usage data displayed is read from the page—the extension does not access PG&E's internal data. Always verify with PG&E directly for the most accurate energy 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 pge.com.