SponsorBlock/README.md

76 lines
4.6 KiB
Markdown
Raw Normal View History

2019-08-20 22:04:47 +02:00
<p align="center">
2020-02-04 07:45:41 +01:00
<a href="https://sponsor.ajay.app"><img src="public/icons/LogoSponsorBlocker256px.png" alt="Logo"></img></a>
2019-08-20 22:06:29 +02:00
<br/>
2019-08-20 22:04:47 +02:00
<sub>Logo by <a href="https://github.com/munadikieh">@munadikieh</a></sub>
</p>
2019-07-10 05:09:18 +02:00
2019-08-20 22:04:47 +02:00
<h1 align="center">SponsorBlock</h1>
<p align="center">
2019-11-23 19:33:22 +01:00
<b>Download:</b>
2019-08-20 22:08:27 +02:00
<a href="https://chrome.google.com/webstore/detail/mnjggcdmjocbbbhaepdhchncahnbgone">Chrome/Chromium</a> |
2019-08-20 22:09:22 +02:00
<a href="https://addons.mozilla.org/addon/sponsorblock/?src=external-github">Firefox</a> |
2019-08-20 22:09:47 +02:00
<a href="https://sponsor.ajay.app">Website</a> |
2019-08-20 22:09:22 +02:00
<a href="https://sponsor.ajay.app/stats">Stats</a>
2019-08-20 22:04:47 +02:00
</p>
2019-07-24 02:06:08 +02:00
2019-11-23 19:33:22 +01:00
<p align="center">
2019-11-23 19:33:55 +01:00
<b>Unofficial Ports:</b>
2019-11-23 19:33:22 +01:00
<a href="https://github.com/ajayyy/SponsorBlock/wiki/Unofficial-Ports#mpv-media-player">MPV</a>
</p>
2019-09-02 03:54:52 +02:00
<p align="center">
<a href="https://addons.mozilla.org/addon/sponsorblock/?src=external-github"><img src="https://img.shields.io/amo/users/sponsorblock?label=Firefox%20Users" alt="Badge"></img></a>
<a href="https://chrome.google.com/webstore/detail/mnjggcdmjocbbbhaepdhchncahnbgone"><img src="https://img.shields.io/chrome-web-store/users/mnjggcdmjocbbbhaepdhchncahnbgone?label=Chome%20Users" alt="Badge"></img></a>
<a href="https://sponsor.ajay.app/stats"><img src="https://img.shields.io/badge/dynamic/json?label=Sponsors%20Submitted&query=totalSubmissions&suffix=%20sponsors&url=http%3A%2F%2Fsponsor.ajay.app%2Fapi%2FgetTotalStats&color=darkred" alt="Badge"></img></a>
2020-01-25 18:20:40 +01:00
<a href="https://sponsor.ajay.app/stats"><img src="https://img.shields.io/badge/dynamic/json?label=Contributing%20Users&query=userCount&url=http%3A%2F%2Fsponsor.ajay.app%2Fapi%2FgetTotalStats&color=darkblue" alt="Badge"></img></a>
2019-09-02 04:41:52 +02:00
<a href="https://sponsor.ajay.app/stats"><img src="https://img.shields.io/badge/dynamic/json?label=Time%20Saved%20From%20Skips&query=daysSaved&url=http%3A%2F%2Fsponsor.ajay.app%2Fapi%2FgetDaysSavedFormatted&color=darkgreen&suffix=%20days" alt="Badge"></img></a>
2019-09-02 03:54:52 +02:00
</p>
2019-07-24 02:06:08 +02:00
2019-08-20 22:04:47 +02:00
SponsorBlock is an extension that will skip over sponsored segments of YouTube videos. SponsorBlock is a crowdsourced browser extension that lets anyone submit the start and end times of sponsored segments of YouTube videos. Once one person submits this information, everyone else with this extension will skip right over the sponsored segment.
2019-07-24 02:06:08 +02:00
2020-01-14 16:32:26 +01:00
Also support Invidio.us.
2019-07-10 05:09:18 +02:00
# Server
The backend server code is available here: https://github.com/ajayyy/SponsorBlockServer
It is a simple Sqlite database that will hold all the timing data.
2020-03-10 05:55:18 +01:00
To make sure that this project doesn't die, I have made the database publicly downloadable at https://api.sponsor.ajay.app/database.db. You can download a backup or get archive.org to take a backup for you if you want.
2019-07-10 05:09:18 +02:00
2020-03-10 05:55:18 +01:00
The dataset and API are now being used [ports](https://github.com/ajayyy/SponsorBlock/wiki/Unofficial-Ports) as well as a [neural network](https://github.com/andrewzlee/NeuralBlock).
A [previous project attempted to]((https://github.com/Sponsoff/sponsorship_remover) create a neural network to predict when sponsored segments happen. That project is sadly abandoned now, so I have decided to attempt to revive this idea starting from a crowd-sourced system instead.
2019-07-10 05:09:18 +02:00
2019-08-04 04:38:21 +02:00
# API
2019-08-04 13:29:43 +02:00
You can read the API docs [here](https://github.com/ajayyy/SponsorBlockServer#api-docs).
2019-08-04 04:38:21 +02:00
2020-03-10 05:55:18 +01:00
# Building
2019-07-15 22:28:41 +02:00
2020-03-10 05:55:18 +01:00
There are also other build scripts available. Install `npm`, then run `npm install` in the repository to install dependencies.
2019-12-30 01:24:05 +01:00
2020-03-10 05:55:18 +01:00
Run `npm run build` to generate a Chrome extension.
2019-12-30 01:24:05 +01:00
2020-03-10 05:55:18 +01:00
Use `npm run build:firefox` to generate a Firefox extension.
2019-12-30 01:24:05 +01:00
2020-03-10 05:55:18 +01:00
The result is in `dist`. This can be loaded as an unpacked extension
2020-02-04 07:45:41 +01:00
2020-03-10 05:55:18 +01:00
## Developing with a clean profile
2020-02-04 07:45:41 +01:00
2020-03-10 05:55:18 +01:00
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`](https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#commands).
2019-12-30 01:24:05 +01:00
2019-07-15 22:28:41 +02:00
# Credit
2020-02-19 18:33:48 +01:00
The awesome [Invidious API](https://github.com/omarroth/invidious/wiki/API) previously was used.
2020-02-19 18:33:48 +01:00
Originally forked from [YTSponsorSkip](https://github.com/OfficialNoob/YTSponsorSkip), but zero code remains.
2019-11-18 03:32:01 +01:00
2019-07-22 00:21:21 +02:00
Some icons made by <a href="https://www.flaticon.com/authors/gregor-cresnar" title="Gregor Cresnar">Gregor Cresnar</a> from <a href="https://www.flaticon.com/" title="Flaticon">www.flaticon.com</a> and are licensed by <a href="http://creativecommons.org/licenses/by/3.0/" title="Creative Commons BY 3.0" target="_blank">CC 3.0 BY</a>
2019-07-29 23:54:21 +02:00
2019-08-04 13:29:43 +02:00
Some icons made by <a href="https://www.flaticon.com/authors/freepik" title="Freepik">Freepik</a> from <a href="https://www.flaticon.com/" title="Flaticon">www.flaticon.com</a> are licensed by <a href="http://creativecommons.org/licenses/by/3.0/" title="Creative Commons BY 3.0" target="_blank">CC 3.0 BY</a>