Lecture Note Timestamp Linker

WHAT IT DOES

Lecture Note Timestamp Linker scans web pages for timestamp patterns such as MM:SS and HH:MM:SS, converting them into clickable links that seek to the corresponding position in embedded video players. When you click a timestamp, the script automatically finds the video on the page—whether it is a YouTube embed, Vimeo player, or HTML5 video—and jumps to the exact moment you need. This makes it effortless to follow along with lecture notes, study guides, or transcripts that reference specific moments in video content. A floating panel displays all extracted timestamps grouped by section, with a "Copy Timestamps" button to copy the complete list to your clipboard for further reference. The script also works with dynamically loaded content, updating timestamps as new content appears on the page.

WHERE IT RUNS

This script operates as a userscript within the BotGentz extension on any webpage that contains video content and timestamped notes. It works seamlessly on lecture platforms, course websites, video documentation pages, and any site where timestamps are used to reference video content. It functions on any modern browser that supports the BotGentz extension, including Chrome, Firefox, Edge, Safari, and Opera. The script runs entirely client-side without sending any data to external servers.

HOW TO USE

After installation, the script automatically scans the page for timestamp patterns and converts them into clickable links. Hover over any timestamp to see it highlighted, then click to instantly seek the video to that position. The floating timestamp panel appears in the corner of your screen, listing all extracted timestamps. Click any timestamp in the panel to seek the video. Use the "Copy All" button in the panel to copy every timestamp to your clipboard. If the video does not seek, check that the page contains an embedded video player and that the video has loaded. Use the "Scan Page Now" button in the settings panel to rescan the page for timestamps if new content loads.

THE MECHANISM THAT MAKES IT WORK

Unlike simple regex search tools, this script uses a DOM tree walker to traverse all text nodes on the page, extracting timestamps without disturbing other elements or breaking the page layout. The script supports both MM:SS and HH:MM:SS formats, detecting the pattern based on user preference. For video seeking, the script first attempts to locate HTML5 video elements by checking readyState and src attributes. If no HTML5 video is found, it looks for embedded iframes from YouTube and Vimeo, modifying the iframe URL to include a start parameter at the specified timestamp. This dual-layer detection mechanism ensures compatibility across a wide range of video platforms. The timestamp panel uses an SVG-based progress visualization and groups timestamps by the text context around them, helping users quickly locate relevant references. Timestamps are stored in a Set to avoid duplication while preserving the original display format.

THE PANEL

The script panel is built using BotGentz's BGPanel framework and provides comprehensive control over the timestamp linker's behavior. The panel opens as a floating overlay that can be dragged anywhere on your screen, with a clean dark theme matching the script's aesthetic. It includes dropdown menus for timestamp format selection (MM:SS or HH:MM:SS) and highlight style (underline, background highlight, or color-only). Toggle switches enable or disable the linker and control the visibility of the timestamp panel. A dropdown menu lets you set the panel's default position to top-left, top-right, bottom-left, or bottom-right. Action buttons allow you to scan the page for timestamps 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. The script relies on standard timestamp patterns commonly found in lecture notes and transcripts. For best results, ensure your video player has loaded before clicking timestamps. The script modifies the page by replacing timestamp text with clickable links; you can disable this behavior by toggling the linker off in the panel. All settings and state are stored locally using GM_setValue and are not shared with any third-party services. If the page dynamically adds new content after loading, use the "Scan Page Now" button to update the timestamp list.