A lightweight, hotkey-first Chrome/Edge extension for creating timestamped markers on any web page with video elements. Perfect for creating YouTube chapters, taking notes during videos, and exporting timestamps in multiple formats.
- Universal Video Support: Works on YouTube, Twitch, Vimeo, and any site with HTML5 video
- Hotkey-First Design: Quick marking with Alt+M, no clicking required
- Multiple Export Formats:
- YouTube chapters format (with automatic 00:00 intro)
- Markdown with deep links
- CSV spreadsheet
- JSON for developers
- HTML with screenshots
- Smart Deep Links: Automatically generates time-stamped URLs for supported platforms
- Optional Screenshots: Capture visual references with each marker
- SPA Support: Seamlessly handles single-page navigation on YouTube and Twitch
- Manual Timer Mode: Falls back to manual timing for DRM-protected content
- Local Storage: All data stays on your device - no cloud, no login required
- Session Management: Auto-saves progress and allows switching between videos
- Download or clone this repository
- Open Chrome or Edge and navigate to
chrome://extensions/ - Enable "Developer mode" in the top right
- Click "Load unpacked"
- Select the
waymarkfolder - The extension icon should appear in your toolbar
- Navigate to any video page (YouTube, Twitch, Vimeo, etc.)
- The overlay will appear in the bottom-right corner
- Use hotkeys or click buttons to add markers:
- Alt+M: Add marker at current time
- Alt+Shift+M: Show/hide overlay
- Alt+E: Export markers
- With Title: Type a title in the input field, then press Alt+M
- Quick Mark: Press Alt+M without typing to create a marker with auto-generated title
- With Screenshot: Enable "Auto-screenshot each marker" checkbox before marking
- Press Alt+E or click Export button
- Choose your format:
- YouTube Chapters: Copy to clipboard for video descriptions
- Markdown: Copy formatted list with clickable timestamps
- CSV: Download spreadsheet file
- JSON: Download structured data
- HTML: Download visual report with screenshots
- Click "More" button to see saved sessions
- Sessions are automatically created per video per day
- Load previous sessions or delete old ones
- Export all data for backup
| Shortcut | Action |
|---|---|
| Alt+M | Add marker at current timestamp |
| Alt+Shift+M | Toggle overlay visibility |
| Alt+E | Open export menu |
Access settings through the overlay's "More" menu:
- Auto-screenshot: Capture tab screenshot with each marker
- Insert 00:00 intro: Automatically add intro chapter when exporting
- Overlay position: Drag the header to reposition
00:00 Introduction
02:45 Main Topic
05:30 Example Demo
08:15 Conclusion
- **00:02:45** – [Main Topic](https://youtube.com/watch?v=xxx&t=165s)
- **00:05:30** – [Example Demo](https://youtube.com/watch?v=xxx&t=330s)timestamp,title,seconds,source_url,created_at
00:02:45,Main Topic,165,https://youtube.com/watch?v=xxx,2024-01-15T10:30:00Z- storage: Save markers and settings locally
- downloads: Export files to your computer
- tabs: Capture screenshots (optional feature)
- activeTab: Interact with video elements
- ✅ All data stored locally on your device
- ✅ No external servers or API calls
- ✅ No tracking or analytics
- ✅ No login or account required
- ✅ Works completely offline
- DRM-Protected Sites: Netflix, Disney+, Amazon Prime, etc. will use manual timer mode
- Cross-Origin iFrames: Cannot access videos in iframes from different domains
- Fullscreen Mode: Overlay may be hidden (hotkeys still work)
- Mobile Browsers: Extension requires desktop Chrome/Edge
- Refresh the page after installing
- Check if site is in excluded list (DRM sites)
- Click extension icon in toolbar to toggle
- Ensure overlay is loaded (icon in toolbar)
- Click outside any input field
- Check for conflicts with other extensions
This happens on DRM-protected content:
- Use Manual Timer mode
- Click Start when video begins
- Markers will use timer instead of video time
- Click "More" in overlay
- Click "Clear All Data"
- Or go to
chrome://extensions/→ Details → Clear Storage
The extension automatically detects navigation on single-page applications:
- YouTube: Saves session when switching videos
- Twitch: Handles VOD navigation
- Vimeo: Detects video changes
Previous sessions are auto-saved and can be reloaded from the "More" menu.
When video time cannot be read (DRM content):
- Manual timer appears automatically
- Click "Start" when video begins playing
- Use Pause/Resume as needed
- Markers use timer time instead of video time
- Export works normally (without deep links)
- Export all sessions at once
- Import/export backup JSON files
- Bulk delete old sessions
Sessions are keyed by: {domain}|{video-id}|{date}
- Automatically created per video
- Restored on page reload
- Separate markers for each day
- Optional per-marker screenshots
- Included in HTML exports
- Stored as base64 data URLs
- Automatically compressed
Found an issue? Please report it with:
- Browser version (Chrome/Edge)
- Website where issue occurred
- Steps to reproduce
- Console errors (F12 → Console)
MIT License - Free to use and modify
- Manifest Version: V3
- No Frameworks: Plain JavaScript for instant loading
- No Bundlers: Direct file access
- Storage: chrome.storage.local API
- Modern APIs: ES6+, async/await
✅ YouTube chapter export with 00:00 intro
✅ Markdown with working deep links
✅ CSV/JSON download functionality
✅ SPA navigation handling
✅ Multi-video element support
✅ Manual timer for DRM content
✅ Screenshot capture (optional)
✅ Draggable overlay
✅ Keyboard shortcuts
✅ Local storage only
✅ Session management
✅ Auto-save and restore
Version: 1.0.0
Last Updated: January 2025
Compatibility: Chrome 88+, Edge 88+