Skip to content

aprestoes/loopcontrol

Repository files navigation

Loop Control (Video Section Loop)

Firefox AMO

CI Status

What It Does

LoopControl is a browser extension for Chrome and Firefox that lets you loop custom sections of videos - not just from the beginning to end. A controller overlays all videos, letting you set a start and end point for the loop.

Why Use It?

  • 🪶 Skip the fluff - loop just the part that you care about
  • 🧑‍🍳 Master that recipe, riff, or dance move by repeating important sections
  • 🔁 Turn any video segment into a gif-like loop
  • ⌨️ Utilize the visual controller overlay or keybindings
  • 🔥 Works on virtually any HTML5 video across Chrome and Firefox

How?

All HTML5 videos will display a moveable and hideable controller that indicates if loops are currently toggled on or off. Here you can set the start and end times of the sections you want to loop.

loopcontrol-example

You can also manually toggle LoopControl by right-clicking the video and selecting loop.

Default Keybindings (targets the last video controller you interacted with):

  • Q - Set loop start
  • E - Set loop end
  • R - Toggle loop
  • H - Hide controller

Cross-platform Browser Support

Since 2024, Google deprecated Manifest V2 for Chrome extensions in favour of Manifest V3. So while Firefox supports both Manifest V2 and Manifest V3 extensions, Chrome will only support Manifest V3 moving forward. Among other changes, Manifest V3 was interfering with how Firefox prompted for required permissions. Therefore two different manifests exist in the ./manifests/ folder.

To switch manifest types before testing/building:

npm run prepare:chrome # Copies Manifest V3
npm run prepare:firefox # Copies Manifest V2

Installation

Install from Addons.Mozilla.Org (AMO)

Install through the official Firefox Add-ons Web Store link.

Firefox Temporary Add-on (For testing purposes)

  1. Download this repo as a .zip file
  2. Unzip the file. The folder is loopcontrol-main
  3. Change into the directory with cd loopcontrol
  4. Copy the proper manifest version for Firefox with npm run prepare:firefox
  5. In Firefox, go to about:debugging
  6. Click on This Firefox -> Load Temporary Add-on
  7. Select manifest.json within the loopcontrol-main folder

Chrome Temporary Add-on (For testing purposes)

  1. Download this repo as a .zip file
  2. Unzip the file. The folder is loopcontrol-main
  3. Change into the directory with cd loopcontrol
  4. Copy the proper manifest version for Chrome with npm run prepare:chrome
  5. In Chrome, go to chrome://extensions
  6. Enable Developer Mode in the top-right
  7. Click 'Load unpacked extension...'
  8. Select the loopcontrol-main folder

Testing

  1. Change into the project directory with cd loopcontrol
  2. Install test dependencies with npm install
  3. Run the automated Jest tests with npm test

To-do

  • 48x48 and 128x128 logos for Chrome store

Credit

Huge thanks to Video Speed Controller, the Firefox fork (seemingly abandoned) and the more updated gediminasel fork with a few helpful fixes. The loop UI and settings pages were adapted from these extensions.

Credit to Samplelib's videos for the test .mp4.

Extension icon created by Pixel perfect - Flaticon

Mockup assets used in extension listings from MockupDen and Shaping Rain

About

A Firefox and Chrome extension that lets you loop specific sections of any HTML 5 video.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •