YouTube Gaming Web VOD Chapter Marker

WHAT IT DOES

This tool helps you mark important moments in YouTube VODs (Video on Demand) with a simple keypress. It reads the current video timestamp and provides a panel with keyboard shortcut buttons (keys 1-9) to mark chapters at the current playback position. Each chapter can be labeled and is saved locally per video. A quick navigation menu lets you jump to any saved chapter by clicking its time or pressing the corresponding key. The panel shows the current playback position relative to saved chapters, highlighting the active chapter. Chapters can be exported as JSON for sharing or backup and imported later. The tool is designed for gaming VODs where marking key moments (kills, boss fights, highlights) is essential for review.

WHERE IT RUNS

The script activates on YouTube pages (youtube.com), including watch pages and video player views. It automatically detects the video ID and retrieves saved chapters for that video. The panel appears as a draggable overlay that stays accessible as you watch.

HOW TO USE

Navigate to any YouTube VOD. The panel will appear showing the current video title and playback time. Press any key 1-9 to mark a chapter at the current time—the key becomes highlighted and the chapter is saved. Alternatively, click the numbered buttons in the panel or use the "Mark at current" button with a custom label. To jump to a saved chapter, press its corresponding key or click its time in the chapter list. The panel shows all saved chapters with their keys, labels, and times. Use the "Keys on/off" toggle to enable or disable keyboard shortcuts. The "Clear All" button removes all chapters for the current video. Export your chapters as JSON to your clipboard, and import them using the console command: importChaptersData(data). The current chapter is highlighted with a blue border in the list.

THE TECHNICAL MECHANISM

The script extracts the video ID from the URL and the current timestamp from the HTML5 video player. Keyboard shortcuts are captured using a keydown event listener, with keys 1-9 mapped to chapter marking (if the key is unused) or navigation (if the key corresponds to an existing chapter). The script maintains a per-video chapter list stored using GM_setValue, keyed by video ID. Each chapter stores the key number, timestamp in seconds, a label, and a creation timestamp. The chapter list is sorted by key number. Clicking a chapter time uses the seekToTime function to set video.currentTime. The panel updates the current time display every 2 seconds using setInterval, and highlights the chapter closest to the current playback position. The export function generates a JSON object containing the video ID, video title, and all chapters with formatted times. Import uses a globally exposed function that merges imported chapters with existing ones, avoiding key conflicts. The auto-refresh uses a MutationObserver and URL change detection to handle YouTube's SPA navigation. All settings and data 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. YouTube may update its site structure, which could affect the script's ability to detect video data — updates will be released as needed. All chapter data is stored locally in your browser and is never transmitted externally. The script does not modify YouTube's video player or interface. Keyboard shortcuts are only active when the panel is visible and no input field is focused. Export/Import uses the clipboard and console for manual data transfer; no data is sent externally. The tool is designed for personal use and does not sync chapters across devices automatically. Chapter data is per video and persists across sessions.