Ecobee Web Schedule Editor Overlay

WHAT IT DOES

This tool helps you visualize and analyze your Ecobee thermostat schedule. It scans schedule pages for entries—day, time, comfort setting (Home, Away, Sleep, Other), temperature, and fan mode—and displays a compact time-block view. Each day shows 24 one-hour blocks color-coded by comfort setting (green for Home, red for Away, blue for Sleep, purple for Other). Hovering over any block shows details. The panel calculates temperature variance between comfort settings and estimates potential energy savings from schedule adjustments. Quick copy buttons provide one-click access to copy schedules from one day to another.

WHERE IT RUNS

The script activates on Ecobee pages (ecobee.com), including schedule editors, thermostat settings, and comfort setting views. It automatically detects schedule data using multiple extraction strategies that work across different Ecobee layouts. The panel appears as a draggable overlay that stays accessible as you review your schedule.

HOW TO USE

Navigate to your Ecobee schedule page. The panel will appear showing a color-coded schedule view. Select your preferred temperature unit (F or C) using the dropdown. Toggle "Fan on/off" to show or hide fan mode indicators (blue border on blocks when fan is on). Set the "Variance °" threshold to control when temperature variance is highlighted (default 5°). The "Refresh" button manually updates the data, and the panel automatically refreshes at your configured interval. Click any copy button (e.g., "Copy Monday") to copy that day's schedule—the script will guide you to use Ecobee's built-in copy functionality. The summary shows total entries, days, temperature variance, and estimated savings potential.

THE TECHNICAL MECHANISM

The script employs a multi-strategy DOM extraction approach for Ecobee's schedule interface. It first attempts structured selectors targeting known class names like .schedule-entry, .schedule-item, and .day-schedule, then falls back to heuristic detection of schedule containers based on content patterns including comfort setting keywords (home, away, sleep) and time indicators. Days are extracted from day name patterns, times from time formats, and comfort settings from text patterns. Temperatures are extracted from patterns with degree symbols, and fan modes from "fan on/off/auto" patterns. The time-block visualization creates 24 blocks per day, mapping schedule entries to the corresponding hour based on the extracted time. Temperature variance is calculated as the difference between the maximum and minimum temperatures across all entries. Savings estimation uses a heuristic based on the distribution of comfort settings: higher proportions of Away and Sleep settings suggest more potential savings. The copy actions trigger desktop notifications guiding the user to use Ecobee's native copy functionality. All settings are persisted using GM_setValue.

THE PANEL

The panel is fully draggable by its header and remembers its position on the page across sessions. It can be collapsed to a small bubble using the minimize button, then restored by clicking the bubble. The panel resizes automatically to fit its content and can be closed with the Escape key or by clicking the close button. The panel's position and state persist globally, so it returns to the same location on subsequent visits.

PLEASE NOTE

Requires the free BotGentz extension to run. Ecobee may update its site structure, which could affect the script's ability to detect schedule data — updates will be released as needed. All schedule data is read from the page and displayed locally; nothing is transmitted externally. The script reads data from the visible page and does not access any data beyond what is visibly presented. The script does not modify your Ecobee account or thermostat settings. The copy actions provide guidance but do not automatically copy schedules—you must use Ecobee's interface. Savings estimates are heuristic approximations and for informational purposes only. This tool is for informational purposes only and is not affiliated with Ecobee.