SponsorBlock/README.md

88 lines
5.4 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> |
2020-06-27 17:38:49 +02:00
<a href="https://github.com/ajayyy/SponsorBlock/wiki/Android">Android</a> |
2020-07-09 03:43:26 +02:00
<a href="https://github.com/ajayyy/SponsorBlock/wiki/Edge">Edge</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>
<a href="https://github.com/ajayyy/SponsorBlock/wiki/Unofficial-Ports#mpv-media-player">MPV</a> |
<a href="https://github.com/ajayyy/SponsorBlock/wiki/Unofficial-Ports#kodi">Kodi</a> |
2020-06-27 06:44:38 +02:00
<a href="https://github.com/ajayyy/SponsorBlock/wiki/Unofficial-Ports#ios">iOS</a>
2019-11-23 19:33:22 +01:00
</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=Chrome%20Users" alt="Badge"></img></a>
2020-07-07 23:48:36 +02:00
<a href="https://sponsor.ajay.app/stats"><img src="https://img.shields.io/badge/dynamic/json?label=Submissions&query=totalSubmissions&suffix=%20segments&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
2020-07-18 23:52:47 +02:00
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.
2019-07-24 02:06:08 +02:00
2020-07-18 23:52:47 +02:00
It also supports Invidio.us.
2020-01-14 16:32:26 +01:00
2020-04-26 06:10:31 +02:00
**Translate:** [![Crowdin](https://badges.crowdin.net/sponsorblock/localized.svg)](https://crowdin.com/project/sponsorblock)
2020-04-20 07:22:03 +02:00
2020-04-06 00:34:10 +02:00
# Important Links
See the [Wiki](https://github.com/ajayyy/SponsorBlock/wiki) for important links.
2019-07-10 05:09:18 +02:00
# Server
The backend server code is available here: https://github.com/ajayyy/SponsorBlockServer
2020-04-06 00:34:10 +02:00
It is a simple SQLite database that will hold all the timing data.
2019-07-10 05:09:18 +02:00
2020-06-15 02:29:12 +02:00
To make sure that this project doesn't die, I have made the database publicly downloadable at https://sponsor.ajay.app/database.db ([License](https://github.com/ajayyy/SponsorBlock/wiki/Database-and-API-License)). If you are planning on using the database in another project, please read the [API Docs](https://github.com/ajayyy/SponsorBlock/wiki/API-Docs) page for more information.
2019-07-10 05:09:18 +02:00
2020-03-10 17:11:08 +01:00
The dataset and API are now being used in some [ports](https://github.com/ajayyy/SponsorBlock/wiki/Unofficial-Ports) as well as a [neural network](https://github.com/andrewzlee/NeuralBlock).
2020-03-10 05:55:18 +01:00
2020-03-10 05:57:44 +01:00
A [previous project](https://github.com/Sponsoff/sponsorship_remover) attempted to 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-05-07 02:22:11 +02:00
Rename `config.json.example` to `config.json` and adjust configuration as desired.
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-04-06 00:34:10 +02:00
The awesome [Invidious API](https://github.com/omarroth/invidious/wiki/API) was previously 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>