Local Event Calendar Overlay

WHAT IT DOES

Local Event Calendar Overlay places a sleek, floating calendar widget on every webpage you visit, displaying your upcoming events from Google Calendar, Outlook, or iCloud directly within your browsing experience. The widget automatically fetches events from your public ICS feed URLs and shows them in a clean, scrollable list, including event titles, times, locations, and clickable meeting links for virtual conferences. Beyond the widget, the script intelligently scans the current webpage for any date or time mentions and highlights them with a subtle colored underline. When you hover over a highlighted date, a tooltip appears showing the corresponding calendar event from your feeds, seamlessly connecting your schedule to the content you are reading. The widget shows events for the current day and the next three days, ensuring you always have a clear view of what is coming up.

WHERE IT RUNS

This script runs as a userscript within the BotGentz extension on every webpage you visit, across all websites and domains. It functions on any modern browser that supports the BotGentz extension, including Chrome, Firefox, Edge, Safari, and Opera. The script operates entirely client-side, fetching data directly from your calendar feeds without sending any information to external servers. It respects the page's existing content and layout, adding only visual enhancements without interfering with the page's functionality or performance.

HOW TO USE

After installation, open the script panel and add up to three public ICS feed URLs from your calendar providers. Google Calendar users can obtain their ICS link from Settings → Integrate Calendar → Public URL. Outlook users can publish their calendar and copy the ICS link from Calendar settings. iCloud users can find their public calendar URL in iCloud Calendar sharing settings. Once saved, the widget will appear on every page showing your upcoming events. Use the collapse button to minimize the widget to a compact status indicator, or drag it anywhere on the screen by clicking and holding the title bar. The page date highlighting feature works automatically—dates that match events in your calendar will appear with a subtle underline, and hovering reveals the event details. The widget also includes refresh controls to manually update events and settings access for quick adjustments.

THE MECHANISM THAT MAKES IT WORK

Unlike event management tools that require complex OAuth authentication or server-side processing, this script uses a lightweight ICS parsing engine that directly interprets the standardized iCalendar format used by all major calendar providers. The parser extracts event metadata including start and end times, summaries, locations, descriptions, and URL links from the raw ICS data without requiring any authentication tokens or API keys. The script implements a dual-layer event matching system: first, it filters and sorts upcoming events within the next 72 hours using JavaScript's native Date object comparisons; second, it performs a secondary pass to match dates found on the page by converting human-readable date formats (such as "Jan 15, 2024" or "12/25/2024") into timestamps and cross-referencing them against the event list. The tooltip rendering uses CSS positioning and event listeners to display contextual information only on hover, ensuring zero page layout disruption. All event data is cached locally using GM_setValue with a 60-second freshness window, minimizing network requests while keeping information current.

THE PANEL

The script panel is built using BotGentz's BGPanel framework and provides comprehensive control over the widget's behavior. The panel opens as a floating overlay that can be dragged anywhere on your screen, with a clean dark theme matching the widget's aesthetic. It includes input fields for up to three calendar feed URLs, with a save button that immediately refreshes events upon submission. A toggle switch enables or disables the entire widget, while another toggle controls the date highlighting feature independently. Dropdown menus allow you to adjust the number of displayed events (3, 5, 8, or 10), the refresh interval (15 minutes, 30 minutes, 1 hour, or 2 hours), and the widget's default position on screen (top-left, top-right, bottom-left, or bottom-right). The panel also includes action buttons to manually refresh events or reset all settings to defaults. The panel collapses to a small icon when not in use and expands when clicked, remaining accessible but unobtrusive. Press the Escape key at any time to close the panel.

PLEASE NOTE

This script requires the free BotGentz extension to be installed and activated in your browser. The extension is available from the official BotGentz website. This script relies on public ICS feed URLs provided by your calendar services — ensure that your calendars are set to public or unlisted visibility for the script to access them. The script does not store, transmit, or share your calendar data with any external services; all event processing occurs locally within your browser. If your calendar provider changes its ICS feed format or endpoint structure, the script may require updates, which are delivered automatically through the BotGentz extension update channel. The date highlighting feature attempts to match dates on the page to your calendar events — accuracy depends on the clarity and format of date mentions on the page, and some ambiguous dates may not be matched correctly.