YouTube Spot Saver

YouTube Spot Saver is a Chrome Extension that saves your spot in a YouTube video when you exit the tab, so you can return to the same spot later. It stores the video timestamp in the browser's local storage and automatically redirects you to the saved timestamp when you revisit the video.

Changelog

v1.4

• Fixed distribution script

v1.3

• Added a popup to customize the duration of time the timestamps are saved

v1.2

• Fixed timestamps being applied to ads instead of the video
• When the extension updates, it will clear all timestamps to prevent data compatibility issues.

v1.1

• Cleans up storage every time www.youtube.com/* is loaded.
• Switched to editing video player's current time instead of redirecting.

v1.0

• Automatically saves the current timestamp of a YouTube video when you close or refresh the tab.
• Redirects you to the saved timestamp when you revisit the video.
• Cleans up expired timestamps from local storage (older than 24 hours).

Future Features

• Add ad blocking capabilities?
• Allow users to set the amount of time the spot in the video is saved for
• Detect ads to prevent the timestamp being applied too early

Installation

Chrome Store

1. Download from the Chrome Web Store here

Manual

1. Clone the repository to your local machine.
2. Open your browser and navigate to the extensions page (e.g., chrome://extensions for Chrome).
3. Enable "Developer mode" if it is not already enabled.
4. Click on "Load unpacked" and select the directory where you cloned the repository.

Node.js Setup

1. Install Node.js from nodejs.org.
2. Verify the installation by running:

   node -v
   npm -v

3. Navigate to the cloned repository directory:

   cd youtube-spot-saver

4. Install the project dependencies:

   npm install

Running Tests

npx jest

Usage

1. Open a YouTube video.
2. Watch the video and close or refresh the tab at any point.
3. When you revisit the video, the extension will automatically redirect you to where you left off.

Contributing

Contributions are welcome! Here are some ways you can contribute:

1. Report Bugs: If you find any bugs, please report them by opening an issue on the GitHub repository.
2. Feature Requests: If you have any ideas for new features, feel free to open an issue to discuss them.
3. Pull Requests: If you want to contribute code, you can fork the repository, make your changes, and submit a pull request.

Development Setup

1. Clone the repository

   git clone https://github.com/apknusel/YouTube-Spot-Saver.git
   cd youtube-spot-saver

2. Open the project in your favorite code editor (e.g., Visual Studio Code).

3. Make your changes and test them locally by loading the unpacked extension in your browser.

Code Structure

• js: Contains all javascript for the extension
  • background.js: Handles the clearing of storage when the extension is updated and shows the changelog.
  • contentScript.js: The main script that does the logic when YouTube is open for getting timestamps.
  • popup.js: All the logic involved with the popup when clicking the Chrome extension icon.
• html: Contains all html for the extension.
  • popup.html: HTML content for the popup.
• css: Contains all css for the extension.
  • popup.css: CSS content for the popup.
• manifest.json: The manifest file that defines the extension's metadata and permissions.
• assets: Contains the extension's icons.
• tests: Contains the tests for the extension.
  • contentScript.test.js: Tests for contentScript.js
  • popup.test.js: Tests for popup.test.js

License

This project is licensed under the GPL-3.0 license. See the LICENSE file for details.

Contact

If you have any questions or need further assistance, feel free to contact the project maintainer at apknusel@yahoo.com.