Skip YouTube video sponsors (browser extension)
Find a file
2021-08-20 13:28:31 -04:00
.github Add browser stack support to selenium test 2021-07-31 00:56:49 -04:00
manifest Added skip button in control bar instead of using skip notice 2021-08-18 02:07:24 -04:00
oss-attribution feat(lint): add default .eslintrc.js 2020-12-12 22:56:14 +01:00
public New Crowdin updates (#883) 2021-08-20 03:57:46 -04:00
src Add tooltip about highlight feature 2021-08-20 03:54:49 -04:00
test Add browser stack support to selenium test 2021-07-31 00:56:49 -04:00
webpack Add option to disable $ link 2021-08-20 00:04:42 -04:00
.editorconfig Revert dependency changes 2020-08-27 21:18:21 -04:00
.eslintrc.js Add basic selenium test 2021-07-30 15:04:05 -04:00
.gitignore added .DS_Store to not commit by mistake 2021-05-15 01:02:58 +02:00
config.json.example Move highlight category on options page 2021-08-18 13:29:02 -04:00
CONTRIBUTING.md Fix typo 2021-04-20 18:56:16 -04:00
crowdin.yml Update Crowdin configuration file 2020-04-14 23:44:15 -04:00
jest.config.js Add basic selenium test 2021-07-30 15:04:05 -04:00
LICENSE Revert "Add back header" 2021-06-09 20:07:03 -04:00
package-lock.json Merge branch 'master' of https://github.com/ajayyy/SponsorBlock into selenium 2021-08-20 13:28:31 -04:00
package.json Merge branch 'master' of https://github.com/ajayyy/SponsorBlock into selenium 2021-08-20 13:28:31 -04:00
README.md Add Safari link to readme 2021-06-25 12:18:56 -04:00
tsconfig.json Switch back to es6 2021-07-15 14:09:10 -04:00

Logo
Logo by @munadikieh

SponsorBlock

Download: Chrome/Chromium | Firefox | Android | Edge | Safari for MacOS | 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

Rename config.json.example to config.json and adjust configuration as desired.

There are also other build scripts available. Install npm, then run npm install in the repository to install dependencies.

Run npm run build to generate a Chrome extension.

Use npm run build:firefox to generate a Firefox extension.

The result is in dist. This can be loaded as an unpacked extension

Developing with a clean profile

Run npm run dev to run the extension using a clean browser profile with hot reloading. Use npm run dev:firefox for Firefox. 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.

Attribution Generation

If you contribute and add a dependency, update the attribution file using the following steps:

Make sure the attribution generator is installed: npm i -g oss-attribution-generator

generate-attribution
mv ./oss-attribution/attribution.txt ./public/oss-attribution/attribution.txt

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