Skip to content

RUMMANRK/youtube-bookmarker

Repository files navigation

YouTube Video Bookmarker

Version: 1.0

Author: Rumman Kalam

Overview

YouTube Video Bookmarker is a Firefox extension that allows you to save bookmarks of YouTube videos with timestamps. This extension enhances your YouTube experience by letting you save multiple timestamps, organize your bookmarks, and easily resume watching from where you left off.

Features

  • Effortless Bookmarking: Save your current position in any YouTube video with a single click.
  • Multiple Bookmarks: Keep multiple bookmarks across different videos.
  • Light and Dark Mode Support: Switch between Light Mode and Dark Mode to suit your preference.
  • Archive Functionality: Move bookmarks to an archive to keep your main list organized.
  • User-Friendly Interface: Clean and intuitive design with thumbnail previews and video details.
  • Theme Toggle Button: Easily switch themes with an icon-based toggle button.
  • Bookmark Management: Remove, archive, and restore bookmarks as needed.

Installation

  1. Download the Extension:

  2. Install in Firefox:

    • Open Firefox and navigate to about:debugging#/runtime/this-firefox.
    • Click on "Load Temporary Add-on" (for testing) or "Install Add-on From File" (for permanent installation).
    • Select the manifest.json file from the extension's directory.
  3. Pin the Extension Icon (Optional):

    • Click on the extensions icon in the toolbar.
    • Find "YouTube Video Bookmarker" and click the pin icon to add it to the toolbar for easy access.

Usage

Adding a Bookmark

  1. Navigate to a YouTube Video:

    • Open a YouTube video and play it to the point you want to bookmark.
  2. Add Bookmark:

    • Click on the YouTube Video Bookmarker extension icon.
    • Click the "+" button to save your current timestamp.
  3. Confirmation:

    • The bookmark will appear in the list with a thumbnail, title, and timestamp.

Viewing and Managing Bookmarks

  • Access Bookmarks:

    • Click on the extension icon to view all saved bookmarks.
  • Play a Bookmark:

    • Click on a bookmark's thumbnail or title to open the video at the saved timestamp in a new tab.
  • Remove a Bookmark:

    • Click the remove button (minus icon) to delete a bookmark from the list.
  • Archive a Bookmark:

    • Click the archive button to move a bookmark to the archive.

Viewing and Managing Archived Bookmarks

  • View Archive:

    • Click on the "View Archive" button to access archived bookmarks.
  • Restore a Bookmark:

    • In the archive view, click "Restore" to move a bookmark back to the main list.
  • Remove from Archive:

    • Click the remove button to delete a bookmark from the archive.

Theme Switching

  • Toggle Theme:
    • Click the theme toggle button (moon or sun icon) to switch between Light Mode and Dark Mode.

Future Enhancements

  • Multiple Timestamps per Video:

    • Save multiple bookmarks within the same video entry for easy navigation between different moments.
  • Tabs/Lists for Bookmark Sets:

    • Create custom tabs or lists to categorize and organize bookmarks by topic, purpose, or personal preference.

Development Setup

Prerequisites

  • Node.js and NPM: For any build tools or dependency management (if applicable).

Installation for Development

  1. Clone the Repository:

    git clone https://github.com/yourusername/youtube-video-bookmarker.git
  2. Navigate to the Project Directory:

    cd youtube-video-bookmarker

Loading the Extension Temporarily

  1. Open Firefox and Navigate to Add-ons Debugging:

    • Go to about:debugging#/runtime/this-firefox.
  2. Load Temporary Add-on:

    • Click on "Load Temporary Add-on".
    • Select the manifest.json file from the project directory.
  3. Test the Extension:

    • The extension will appear in your browser for testing purposes.

Contributing

Contributions are welcome! If you'd like to contribute to the project, please:

  1. Fork the Repository.

  2. Create a Feature Branch:

    git checkout -b feature/YourFeature
  3. Commit Your Changes:

    git commit -m 'Add YourFeature'
  4. Push to the Branch:

    git push origin feature/YourFeature
  5. Open a Pull Request.

License

MIT License

Support and Contact

If you have any questions, issues, or suggestions, please open an issue on the GitHub repository or contact [Your Contact Information].


Disclaimer: This extension is not affiliated with or endorsed by YouTube.


Acknowledgments

  • Icons and Assets:

    • Icons used in the extension are from Material Design Icons and are licensed under the Apache License Version 2.0.
  • Inspiration:

    • Inspired by the need for better control over YouTube's bookmarking and video resuming capabilities.

About

A Firefox extension that bookmarks YouTube videos

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published