BilibiliSponsorBlock is a free, open source browsers & extensions project written in TypeScript and released under GPL-3.0. It has 6,098 GitHub stars, 137 forks and 54 open issues, and was last pushed 19 days ago. On this registry it ranks #44 of 65 tracked projects in Browsers & Extensions, with 5 head-to-head comparisons available. It gained 13 stars over the last 3 tracked days.

What is BilibiliSponsorBlock?

BilibiliSponsorBlock (小电视空降助手) is a GPL-3.0 browser extension for Chrome, Firefox, Edge and Safari that automatically skips crowd-annotated sponsored segments and other marked sections inside Bilibili videos, built for Bilibili viewers who are tired of sponsor reads and soft advertisements interrupting what they are watching.

What it is

BilibiliSponsorBlock is a TypeScript browser extension ported from SponsorBlock, the community segment-skipping project created by ajayyy. It keeps most of the upstream user interface and interaction model, then adds features specific to Bilibili, including the ability to bind re-uploaded ("搬运") videos so their segment information can be pulled automatically from the SponsorBlock database. Segment data is not generated by the extension itself: all marked segments come from viewer submissions, and the project publishes a leaderboard at https://www.bsbsb.top/stats/ so contributors can see how much time has been saved in aggregate.

The concrete problem it solves is that sponsored reads appear in the middle of Bilibili videos, often discovered only after watching half the clip. The extension fetches segment timings and jumps past them automatically, and it extends that behaviour beyond advertising to opening and closing animations, "一键三连" reminders, and a direct jump to the video cover position. In effect, it replaces both the manual scrubbing a viewer would otherwise do and, for Bilibili users specifically, the upstream SponsorBlock extension whose language coverage, mobile H5 support and third-party mirror support are not tailored to this platform.

Key capabilities

  • Skips sponsor segments automatically, and also handles other categories such as opening and closing animations, "一键三连" prompts, and a jump to the video cover position.
  • Relies on crowd-sourced annotations: viewers submit their own segments, and the project exposes a public leaderboard and aggregate statistics at https://www.bsbsb.top/stats/.
  • Binds re-uploaded videos so segment data is retrieved automatically from the SponsorBlock database.
  • Ships to the Chrome Web Store under extension ID eaoelafamejbnggahofapllmfhlhajdd and to Mozilla Add-ons as bilisponsorblock.
  • Provides unpacked builds, ChromiumExtension.zip and FirefoxExtension.zip, for Chromium-based browsers including Edge and 360, and for Firefox.
  • Packages a Safari Web Extension through npm run build:safari:macos, which generates a safari/ Xcode project and accepts BSB_SAFARI_APP_NAME, BSB_SAFARI_BUNDLE_ID and BSB_SAFARI_PROJECT_DIR overrides.
  • Publishes a documented API in the project wiki, with a test video BV14741127BN, plus a downloadable segment database at https://download.bsbsb.top/database.zip.

Who uses it and how

  • Everyday Bilibili viewers on desktop Chrome, Edge, 360, other Chromium-based browsers, or Firefox, who install it once and let it skip segments on every video.
  • Community contributors who mark segments themselves, with the leaderboard at https://www.bsbsb.top/stats/ tracking submissions and total minutes saved, and per-user active-user figures served from bsbsb.top/api/getTotalStats.
  • Developers building second-party tools from the public API or the full database download, which the README explicitly opens up for redevelopment.
  • Safari users on macOS, who must build the extension from source and run the generated Xcode project before enabling it in Safari settings.
  • Community members who coordinate through the Telegram group at https://t.me/bsbsb_top, since the project is maintained by one person in their spare time.

Getting started

Install from the Chrome Web Store or Mozilla Add-ons, or download ChromiumExtension.zip or FirefoxExtension.zip from the GitHub Releases page, enable developer mode in the browser's extension manager and load the unpacked folder. Safari users copy config.json.example to config.json, run npm ci, then npm run build:safari:macos and open the generated safari/ project in Xcode.

How it compares

Among the tools named here, the direct reference point is SponsorBlock, from which this project is ported and with which it shares most core functionality and interaction. The deliberate differences are scope reductions rather than additions: multi-language support is dropped in favour of Simplified and Traditional Chinese only, mobile H5 web support is dropped, and third-party mirror site support is dropped, while binding of re-uploaded videos and a refreshed UI are added. No list of paid products this project replaces is given in the supplied facts.

When to use it — and when not to

Choosing this extension means accepting a Chinese-only interface and a feature set that intentionally leaves out mobile H5 support and third-party mirror sites, so anyone who needs those should look at the upstream SponsorBlock instead. Development rests with a single maintainer working in their spare time, and the README states that a video usage guide is still only planned, so users who depend on thorough English documentation may find the project thin. The licence is clear and the repository is actively pushed, but the project's own notes frame it as a personal, hobby-maintained effort rather than a staffed product.

project readme (upstream, from github) — read inline


Logo by @munadikieh. Modified by Yaodong

小电视空降助手

LICENSE CI Status

用户数量 片段数量 节省时间

Chrome FireFox 讨论群
Chrome Web Store Firefox Group

受够了视频中无处不在的赞助广告了吗?受够了看了一半才发现的软广视频了吗?小电视空降助手是一款帮你精准空降到广告之后的浏览器插件。插件自动获取并跳过广告片段,让你的视频体验毫无中断!

除了广告之外,插件还支持跳过其他类别的片段,例如开场结尾的动画、一键三连提示,或者直接空降到视频封面的位置。插件中所有的标注片段都来自网友标注,您也可以提交自己的片段来为空降指挥部添砖加瓦。

想知道大佬们提交了多少片段?在排行榜看看吧。

目前本项目由我个人在业余时间维护,如果你想支持我,欢迎查看赞助

本插件移植自插件SponsorBlock,保留了大部分的 UI 和使用方法,加入了一些小电视特色的功能。

安装

  • 目前上架了Chrome 应用商店火狐应用商店。如果你知道更多流行的浏览器插件商店,欢迎留言~

  • 如果你无法打开上面的商店,可以尝试从 GitHub Release 页面获取未打包的插件。

    1. 根据您浏览器的类型下载适合的版本,Chrome、Edge、360 和基于 Chromium 的国产浏览器下载 ChromiumExtension.zip;火狐浏览器下载FirefoxExtension.zip。并解压缩。

    2. 打开浏览器的插件管理页面,启用“开发者模式”,点击加载已解压的扩展程序,选择刚刚下载解压的插件文件夹,就可以完成安装。

macOS Safari 安装(源码构建)

Safari 版本通过 Safari Web Extension 打包。项目已提供一键脚本:

# 先准备配置文件和依赖
cp config.json.example config.json
npm ci

# 构建 Safari 扩展并生成 macOS Xcode 工程
npm run build:safari:macos

默认会在项目根目录生成 safari/ Xcode 工程。然后:

  1. 使用 Xcode 打开 safari/ 工程并编译运行。
  2. 打开 Safari -> 设置 -> 扩展,启用对应扩展。

可选环境变量(用于自定义工程信息):

BSB_SAFARI_APP_NAME="小电视空降助手" \
BSB_SAFARI_BUNDLE_ID="top.bsbsb.safari" \
BSB_SAFARI_PROJECT_DIR="safari" \
npm run build:safari:macos

功能

使用说明

如果你使用过原插件,你会发现在核心功能和交互上,本插件基本没有做出大的改动。可以先参照原插件的使用方法尝试使用。

可以先在这个示例视频上试一试精准空降的快乐!

视频使用说明正在计划制作中。

相比原插件变化

  • 放弃了多语言支持,只支持简体和繁体中文。

  • 放弃了移动端H5网页支持。

  • 放弃了第三方镜像站支持。如果有使用人数多的镜像站,欢迎讨论添加支持。

  • 加入了绑定搬运视频的功能。绑定的视频可以自动从 SponsorBlock 数据库中获取片段信息。

  • 更新 UI。

功能更新计划

参考 Github Project

服务端及数据

为了方便大家二次开发,所有片段的数据现在开放下载:https://download.bsbsb.top/database.zip

API

API文档:https://github.com/hanydd/BilibiliSponsorBlock/wiki/API

测试视频 BV14741127BN

本项目对 API 改动不大,也可以先参考原项目文档

搭建项目

详见 CONTRIBUTING.md

维护者发布

Chrome、Firefox 和 Edge 商店可以通过 GitHub Actions 一次提交,首次使用前需要配置商店 API 凭据。参见 发布浏览器扩展

致谢

感谢ajayyy创造的SponsorBlock给我的启发!

开源协议

本项目遵循 GNU GPL v3 开源协议。

Frequently asked questions

Is BilibiliSponsorBlock free to use?

BilibiliSponsorBlock is open source under the GPL-3.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does BilibiliSponsorBlock do?

一款跳过小电视视频中恰饭片段的浏览器插件,移植自 SponsorBlock。A browser extension to skip sponsored segments in videos, ported from the SponsorBlock

What is BilibiliSponsorBlock written in?

BilibiliSponsorBlock is primarily written in TypeScript. Its source is publicly available at https://github.com/hanydd/BilibiliSponsorBlock, and it has 6,098 GitHub stars.