Trip Distance Cumulative Calculator

WHAT IT DOES

Trip Distance Cumulative Calculator scans any webpage for distance measurements and calculates the total cumulative distance from all segments found. Whether you're looking at a travel itinerary, a road trip plan, a hiking route, or a delivery route, the extension finds distances in miles, kilometers, meters, feet, yards, and nautical miles, then sums them up. A floating badge shows the total distance in your preferred unit, and clicking the badge reveals a detailed breakdown of each individual segment. The extension automatically detects cumulative expressions like "5 miles + 3 miles + 2 miles" and treats them as a single grouped segment. All distances are converted to your preferred unit for consistent display.

WHERE IT RUNS

The extension works on every website with distance measurements, including travel blogs, itinerary pages, road trip planners, delivery tracking pages, fitness and running sites, hiking and trail websites, and any page with numeric distance data. It runs locally in your browser, scanning the page's text content and performing calculations without sending any data to external servers. The extension supports all major browsers and adapts to both desktop and mobile viewports seamlessly.

HOW TO USE

After installation, the extension automatically scans the page for distances (if auto-scan is enabled). A floating badge appears showing the total distance in your preferred unit. Click the badge to open a detailed breakdown popup showing each individual distance segment and the unit breakdown. To customize the experience, open the extension panel and choose your preferred distance unit (Miles, Kilometers, Meters, Feet, Yards, or Nautical Miles). Toggle "Show breakdown in badge" to display a brief summary of segments directly in the badge. Toggle "Auto-scan on page load" to enable or disable automatic scanning. Choose the badge position (Top-left, Top-right, Bottom-left, Bottom-right). Click "Scan & Calculate" to manually trigger a scan. For per-site customization, enable or disable the extension on specific websites using the per-site controls.

THE ACTUAL MECHANISM — DISTANCE PATTERN DETECTION WITH UNIT CONVERSION PIPELINE

The extension uses a comprehensive regex-based distance detection system. It scans the page's text content using multiple patterns: simple distances (e.g., "5 miles"), cumulative expressions (e.g., "5 miles + 3 miles + 2 miles"), hyphenated distances (e.g., "5-mile"), parenthetical distances (e.g., "(10 km)"), and approximate distances (e.g., "about 3 miles"). Each detected distance is parsed to extract the numeric value and the unit. The unit is normalized and looked up in a conversion table that maps units to their equivalent in meters (e.g., 1 mile = 1609.344 meters, 1 km = 1000 meters). All distances are converted to meters for aggregation, then converted back to the user's preferred unit for display. Cumulative expressions are detected by matching patterns with plus signs (+) and treated as grouped segments, preserving the individual components for breakdown display. The extension deduplicates detected distances using a Set to avoid counting the same text multiple times. The badge updates dynamically when the page content changes, and a MutationObserver watches for DOM changes to re-scan when new content is loaded.

THE PANEL

The settings panel is a lightweight, draggable overlay that appears in the center of your screen. You can reposition it by clicking and dragging the title bar; release it near the screen edge and it will snap into place automatically. To collapse the panel into a compact title bar, click the minimize button, expanding it again with the same control. The panel is fully responsive, adapting to different screen resolutions with a minimum width of 300px and a maximum of 480px. Press the Escape key at any time to dismiss the panel without applying changes. All controls—the enable/disable toggle, scan & calculate button, preferred unit selector, breakdown toggle, auto-scan toggle, badge position selector, and per-site controls—are accessible within a clean, high-contrast interface that respects your system's color scheme.

PLEASE NOTE

This extension requires the free BotGentz companion extension to be installed and active, which provides the underlying DOM access and storage engine. The distance detection uses regex patterns and may not detect all distance formats, particularly those with unusual spacing or non-standard abbreviations. The extension works with the page's current text content and may not detect distances that are dynamically loaded after the initial scan. The badge displays the total distance as a single number; clicking it shows the detailed breakdown. No personal data, browsing history, or page content is ever collected, stored, or transmitted. All settings are saved using the browser's storage API and remain solely on your device. The extension does not inject ads, trackers, or analytics of any kind.