Skip YouTube video sponsors (browser extension)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Ajay 3aabc0d051 Merge branch 'master' of https://github.com/ajayyy/SponsorBlock 1 day ago
.github fix broken funding file 1 week ago
ci sort invidiousList for consistency, update from failed CI 3 months ago
manifest bump version 2 days ago
oss-attribution update depndencies 8 months ago
public locked colour is important 3 days ago
src Remove chance from chapter tooltip 1 day ago
test Add action type to preview bar test 2 weeks ago
webpack rebase document script out of videoInfo #1312 1 month ago
.editorconfig Revert dependency changes 2 years ago
.eslintrc.json specify jest as cjs, change eslintrc to .json 4 months ago
.gitignore Save file on test failure 4 months ago
CONTRIBUTING.md Fix typo 1 year ago
LICENSE Revert "Add back header" 1 year ago
README.md Add iOS info (#1307) 5 months ago
config.json.example Put chapter option higher up 3 months ago
crowdin.yml Update Crowdin configuration file 3 years ago
jest.config.js revert module conversion 3 months ago
package-lock.json Merge branch 'master' of https://github.com/ajayyy/SponsorBlock into chapters 1 month ago
package.json Merge branch 'master' of https://github.com/ajayyy/SponsorBlock into chapters 1 month ago
tsconfig-production.json Create source maps in dev 3 months ago
tsconfig.json Create source maps in dev 3 months ago

README.md

Logo
Logo by @munadikieh

SponsorBlock

Download: Chrome/Chromium | Firefox | Android | Edge | Safari for MacOS and iOS | Website | Stats

3rd-Party Ports: MPV | Kodi | Chromecast | iOS

Badge Badge Badge Badge Badge

SponsorBlock is an open-source crowdsourced browser extension to skip sponsor segments in YouTube videos. Users submit when a sponsor happens from the extension, and the extension automatically skips sponsors it knows about. It also supports skipping other categories, such as intros, outros and reminders to subscribe.

It also supports Invidio.us.

Translate: Crowdin

Important Links

See the Wiki for important links.

Server

The backend server code is available here: https://github.com/ajayyy/SponsorBlockServer

To make sure that this project doesn't die, I have made the database publicly downloadable at https://sponsor.ajay.app/database (License). If you are planning on using the database in another project, please read the API Docs page for more information.

The dataset and API are now being used in some ports as well as a neural network.

API

You can read the API docs here.

Building

You must have Node.js 16 and npm installed.

  1. Copy the file config.json.example to config.json and adjust configuration as desired.

    • You will need to repeat this step in the future if you get build errors related to CompileConfig. This can happen for example when a new category is added.
  2. Run npm install in the repository to install dependencies.

  3. Run npm run build:dev (for Chrome) or npm run build:dev:firefox (for Firefox) to generate a development version of the extension with source maps.

    • You can also run npm run build (for Chrome) or npm run build:firefox (for Firefox) to generate a production build.
  4. The built extension is now in dist/. You can load this folder directly in Chrome as an unpacked extension, or convert it to a zip file to load it as a temporary extension in Firefox.

Developing with a clean profile and hot reloading

Run npm run dev (for Chrome) or npm run dev:firefox (for Firefox) to run the extension using a clean browser profile with hot reloading. This uses web-ext run.

Known chromium bug: Extension is not loaded properly on first start. Visit chrome://extensions/ and reload the extension.

For Firefox for Android, use npm run dev:firefox-android -- --adb-device <ip-address of the device>. See the Firefox documentation for more information.

Credit

The awesome Invidious API was previously used, and the server is now using NewLeaf as a to get video info from YouTube.

Originally forked from YTSponsorSkip, but very little code remains.

Icons made by:

License

This project is licensed under GNU LGPL v3 or any later version