GitPedia

Mpv sponsorblock

mpv script to skip sponsored segments of YouTube videos

From po5·Updated June 14, 2026·View on GitHub·

A fully-featured port of [SponsorBlock](https://github.com/ajayyy/SponsorBlock) for mpv. The project is written primarily in Lua, distributed under the GNU General Public License v3.0 license, first published in 2019. Key topics include: mpv, mpv-script, sponsorblock, youtube.

mpv_sponsorblock

A fully-featured port of SponsorBlock for mpv.

Requirements

  • Python 3

Installation

Move sponsorblock.lua and sponsorblock_shared into your mpv scripts folder.

mpv/scripts/
├── sponsorblock.lua
└── sponsorblock_shared
    ├── main.lua
    └── sponsorblock.py

Usage

Play a YouTube video, sponsors will be skipped automatically.

Default key bindings:

  • g to set segment boundaries
  • G (shift+g) to submit a segment
  • h to upvote the last segment
  • H (shift+h) to downvote the last segment

These can be remapped with the following script bindings: sponsorblock/set_segment, sponsorblock/submit_segment, sponsorblock/upvote_segment, sponsorblock/downvote_segment

Add lines in the following format to your input.conf: alt+g script-binding sponsorblock/set_segment

Contributors

Showing top 8 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from po5/mpv_sponsorblock via the GitHub API.Last fetched: 6/14/2026