Step Goal Progress Badge

WHAT IT DOES

Step Goal Progress Badge displays a compact, always-visible badge showing your daily step count progress towards a configurable goal. The badge includes a visual progress bar, percentage complete, and motivational messages that change as you approach and reach your goal. You can either enter your steps manually or let the tool automatically detect step counts from fitness dashboard pages. This keeps your fitness goals front and center, motivating you to stay active throughout the day while browsing the web.

WHERE IT RUNS

This extension works on any website across the entire web. It functions on fitness tracking sites, health dashboards, social media, news sites, and any page where you want to keep your step goal visible. The tool works across all domains and adapts to dynamically loaded content and single-page applications.

HOW TO USE

Install the extension and navigate to any webpage. A compact step badge appears in the corner of the page showing your current steps, goal, progress bar, and percentage. The tool automatically detects steps from fitness dashboard pages when present. For sites without step detection, toggle "Manual step entry" and enter your current step count directly. Click the badge to refresh the step count. Use the overlay panel to customize your daily goal (default 10,000 steps), toggle manual mode on or off, choose whether to show the progress bar, percentage, and motivational messages, and select the badge position (top-right, top-left, bottom-right, or bottom-left). Click "Refresh Steps" to manually update the badge.

TECHNICAL SECTION — STEP DETECTION AND PROGRESS TRACKING

The extension uses a multi-strategy step detection engine to find step counts on fitness dashboard pages. It queries common step selectors including .step-count, .steps, .daily-steps, and any element with "step" in the class name. If no specific selector matches, it scans the page text for step-like patterns using regex — looking for numbers followed by "steps" or "step." Manual mode allows users to enter steps directly, which are stored in GM_setValue. The daily goal is also stored, and steps auto-reset at midnight using date-based checking. The progress bar calculates the percentage of the goal reached, capped at 100%, and a color-coded system (blue for below 75%, yellow for 75-99%, green for 100%+) provides visual feedback. Motivational messages change at 25%, 50%, 75%, and 100% thresholds.

THE PANEL — DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The overlay panel is fully interactive and designed for seamless multitasking. Drag it anywhere on the screen using the handle at the top of the panel; the position is saved per site so it stays where you left it across sessions. The panel includes a snap-to-edge feature that gently anchors the overlay to the nearest screen edge when released. Click the collapse button to minimize the panel to a compact pill showing the current step status; expand it again with a single click. Resize the panel vertically by dragging the bottom-right corner to view more controls. Press the Escape key at any time to instantly close the overlay; it reappears on the next page navigation or refresh.

PLEASE NOTE

This extension requires the free BotGentz companion extension to function, as it provides the underlying content script injection and cross-origin communication framework. No personal data, browsing history, or step data is stored, transmitted, or shared. Step counts and goals are stored locally in your browser using GM_setValue and are never sent to any external server. The extension does not access or store login credentials, financial data, or personally identifiable information. Step detection relies on visible step counts on the page and may not work on all fitness sites. Manual entry is provided as a fallback for full control. The tool is a motivational aid and should not replace professional health advice. The step count resets daily at midnight based on your system time.