Jacob Tech Labs - YT Bookmarks

A simple and efficient Chrome extension for saving and managing timestamps in YouTube videos.

Features

• 📌 Quick Bookmarking: Save timestamps with a single click
• 🎯 Easy Navigation: Jump to bookmarked moments instantly
• 📱 Sync Across Devices: Bookmarks sync with your Chrome account
• 🎨 Clean UI: Simple and intuitive interface
• 🔒 Privacy First: All data stored locally, no external servers
• ⚡ Lightweight: Minimal performance impact

Installation

From Chrome Web Store (Recommended)

1. Visit the Chrome Web Store
2. Search for "Jacob Tech Labs - YT Bookmarks"
3. Click "Add to Chrome"
4. The extension icon will appear in your toolbar

Manual Installation (Development)

1. Clone or download this repository
2. Open Chrome and navigate to chrome://extensions/
3. Enable "Developer mode" (toggle in top right)
4. Click "Load unpacked"
5. Select the extension folder

Usage

1. Open a YouTube video

   • Navigate to any YouTube video (e.g., https://www.youtube.com/watch?v=...)

2. Add a bookmark

   • Click the bookmark icon (📑) in the video player controls
   • The timestamp will be saved automatically

3. View bookmarks

   • Click the extension icon in the Chrome toolbar
   • See all bookmarks for the current video

4. Navigate to bookmark

   • Click the play button (▶️) next to any bookmark
   • The video will jump to that timestamp

5. Delete a bookmark

   • Click the delete button (🗑️) next to any bookmark
   • Or click "Clear All Bookmarks" to remove all

Project Structure

youtube_extension/
├── manifest.json         # Extension configuration
├── background.js         # Service worker (background logic)
├── contentScript.js      # Page injection script
├── popup.html            # Popup UI structure
├── popup.js              # Popup functionality
├── popup.css             # Popup styling
├── utils.js              # Utility functions
├── assets/
│   ├── bookmark.png      # Bookmark button icon
│   ├── play.png          # Play button icon
│   ├── delete.png        # Delete button icon
│   ├── edit.png          # Edit button icon
│   ├── save.png          # Save button icon
│   └── ext-icon.png      # Extension icon
├── README.md             # This file
└── PRIVACY.md            # Privacy policy

Development

Requirements

• Google Chrome (version 88 or higher)
• Basic knowledge of JavaScript
• Text editor (VS Code recommended)

Building

No build process required! Chrome extensions run directly from source.

Testing

1. Load the extension in Chrome (see Manual Installation)
2. Visit any YouTube video
3. Click the bookmark button in the video player
4. Open the extension popup to verify bookmarks

Debugging

• Popup: Right-click the extension icon → "Inspect popup"
• Content Script: Right-click the page → "Inspect" → Console tab
• Background: Go to chrome://extensions/ → Details → "Service Worker"

Permissions Explained

Permission	Why It's Needed
storage	Save bookmarks locally
activeTab	Identify current YouTube video
https://*.youtube.com/*	Inject bookmark button on YouTube

Data Storage

• All data is stored locally using chrome.storage.sync
• Bookmarks sync with your Chrome account
• No external servers or databases
• No data collection or analytics

Troubleshooting

Bookmark button not appearing

• Refresh the YouTube page
• Check if the extension is enabled
• Try reloading the extension

Bookmarks not saving

• Check Chrome's storage quota
• Ensure the extension has storage permission
• Try clearing extension data and reloading

Extension not working

• Make sure you're on a YouTube video page (youtube.com/watch)
• Check chrome://extensions/ for errors
• Try disabling and re-enabling the extension

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Roadmap

• Add bookmark categories/tags
• Export/import bookmarks
• Search bookmarks
• Custom bookmark descriptions
• Keyboard shortcuts
• Dark mode support

License

This project is licensed under the MIT License - see the LICENSE file for details.

Privacy

See PRIVACY.md for our privacy policy.

Summary:

• No personal data collected
• No external data transmission
• All data stored locally
• No third-party sharing

Support

If you encounter any issues or have questions:

1. Check the Troubleshooting section
2. Review existing issues on GitHub
3. Create a new issue with details

Credits

• Built with ❤️ by Jacob Tech Labs
• Icons: Custom designed
• Inspired by the need to save video timestamps

---

Enjoy bookmarking your favorite YouTube moments! 🎬