SponsorBlock - User contributions [en-ca]

VIP Guide

2022-05-09T16:19:00Z

Whyiswhen: /* Tool Feature Matrix */ locking is confusing with locking category or segment.

__FORCETOC__

This article covers tools and work sequences for [[VIP|VIPs]]. VIPs can help moderate videos and investigate potential abuse if they have the time for it, but there are no expectations for the amount of work or commitment. VIP is a permission level, not a job.

== Code of Conduct ==
Don't question VIPS on submitting a segment with a small difference to yours, unless you believe the new segment is worse than the original. In the end it is about creating good segments and not about your stats.

== Tools and Terminology ==
*[https://sb.ltn.fi/ SponsorBlock Browser] by Lartza. Short: SBB
**[https://gist.github.com/MRuy/ca74d6a359c487d760f4a698e76fb0d6 Userscripts] by Nanobyte. They make SBB prettier and easier to read, aswell as utility.
**[https://gist.github.com/TheJzoli/8a4cd979d433b7359cdf61c238bc0181 Userscripts] by TheJzoli. Small user experience improvements for SBB.
**[https://gist.github.com/FlorianZahn/785599a860328fae0724ad5b2b3f7879 Userscripts] by Deedit. Locking, category change and voting for SBB. SBB opener for YouTube.
**[https://github.com/ducng99/SBBCoolHelper Userscript] by Maxhyt. Locking, category change and voting for SBB.
**Explanations of all features at the top of the respective sites. You will need a userscript manager like [https://www.tampermonkey.net/ Tampermonkey]. Press raw on the right of the filename and then install.
**[[Community|Bookmarklets]]
*[https://mruy.github.io/sponsorBlockControl/ SponsorBlockControl] by Nanobyte. Short: SBC
*[https://github.com/mchangrh/sb-slash sb-slash] by mchangrh.
*👍 is commonly used to show support for a message, supporting a ban or another action taken while ✅ is used to show confirmation. Alt + left click will add an emoji to your favorites.
*For videos in #incorrect-submissions, react with ✅ to indicate that it is done, ❌ if the report is incorrect and ⏲️ to indicate that you are working on a message
**both ✅ and ❌ will trigger the bot to remove embeds on the message
*A full list of community projects and tools are available at [[Community]]

== Moderating Users ==

=== Warnings ===

==== What constitutes a warning and when to lift it? ====
Warnings should be issued to users who misinterpret the rules and can be set straight by simply telling them to review the rules and [[Guidelines|guidelines]], e.g. users who often mislabel the category can just use the flowchart.

The point of a warning is to get the user into matrix or discord so that we can talk to them, make sure they go over the guidelines and hopefully learn from their mistake.

Once they have confirmed they have read the guidelines, checked out their previous mistakes and if applicable, read the corresponding articles, the warning may be lifted. A possible prompt for this can be
<nowiki>Please read the guidelines and confirm if you understand the mistakes, or ask any questions if you have any.</nowiki>
Warnings can be lifted with sb-slash<ref name=":0">https://github.com/mchangrh/sb-slash/blob/main/docs/vip.md</ref>, SBC<ref name=":1">https://mruy.github.io/sponsorBlockControl</ref>

==== How to issue a warning? ====
In <code>#report-a-user</code> post a message with the warning reasons and link their profile on SBB. The message should look like this:
Warning for <nowiki>https://sb.ltn.fi/userid/7a7e6f513cd2a7a9abfd5c3dec7c8e2ea0e5e26f2683a83342ebad0f68d7754e/</nowiki>

Reasons:

Intro covering content:
<nowiki>https://sb.ltn.fi/video/kTZrV4M5Tcs/</nowiki>
<nowiki>https://sb.ltn.fi/video/BoQU3_4o90s/</nowiki>

Sponsor doesn't include segue:
<nowiki>https://sb.ltn.fi/video/NxYPNNftnNQ/</nowiki>
<nowiki>https://sb.ltn.fi/video/Fci_ALdEzGc/</nowiki>

Other unrelated tips...

The warning reason is everything '''after''' "Reasons". On SBC<ref name=":1" /> paste the userID and the warning reason. Please paste the warning reasons! Yes, it can be quite long. If you want to give tips to the user, do it now, as they will see this message. If the user has many wrong segments, but you still feel like a warning is appropriate, consider removing all old segments by banning and unbanning them.

==== What does the user experience? ====
When the user is submitting or voting on a segment, a chat window of <code>#questions</code> will open and automatically post a message with their warning reason. They cannot navigate to any other channels, so don't link to a discord message or other channels. Their username will be set to their userID and they will see an [https://en.wikipedia.org/wiki/Alert_dialog_box alertbox] with the following text:
Submission rejected due to a warning from a moderator. This means that we noticed you were making some common mistakes that are not malicious, and we just want to clarify the rules. Could you please send a message in discord.gg/SponsorBlock or matrix.to/#/#sponsor:ajay.app so we can further help you? Your userID is ${userID}.

Warning reason: ${reason}

=== Bans ===
Bans of users with many submissions need approval of one other VIP. Don't hold back on banning users, when they submit bad segments. They should be mature enough, that their bad segments show up for everyone to see.

==== What constitutes a ban? ====
*A ban should be issued to users who break the rules in a way, that explaining them to them would not be feasible.
*Their submissions show disregard of the guidelines, in such a way that good faith cannot be assumed anymore.
**Censoring people or stuff shown for pretty much all reasons
*Submissions were created to lessen the viewer experience.
*It shows, that the user never bothered reading the category descriptions.

==== How to issue a ban? ====
In #bans post a message with the ban reasons and link their profile on SBB. <code>#bans</code> is a private channel. The message should look like this:
(Recommending) ban for <nowiki>https://sb.ltn.fi/userid/7a7e6f513cd2a7a9abfd5c3dec7c8e2ea0e5e26f2683a83342ebad0f68d7754e/</nowiki>

Reasons:

Intro covering content:
<nowiki>https://sb.ltn.fi/video/kTZrV4M5Tcs/</nowiki>
<nowiki>https://sb.ltn.fi/video/BoQU3_4o90s/</nowiki>

Sponsor doesn't include segue:
<nowiki>https://sb.ltn.fi/video/NxYPNNftnNQ/</nowiki>
<nowiki>https://sb.ltn.fi/video/Fci_ALdEzGc/</nowiki>
Wait for another VIP's support with 👍. After receiving approval, head to SBC<ref name=":1" /> and ban the user. You may choose to hide categories. Confirm your ban with ✅.

==== What does the user experience? ====
The user will not notice they have been banned, as we issue only shadowbans. As long as the user still uses the same IP address, they will continue seeing their segments, but no one else will. Their views will stay at zero, so their time saved and related stats will stop changing.

==== How can I recognize a banned user on SBB? ====
Banned users will have an ❌ in the shadow hidden column of their segments on SBB.

=== Temporary VIPs ===
Permanent VIPs can grant temporary channel-specific VIP voting powers to users.

Temporary VIPs can

* Add/ Remove locks on segments
* Bring back downvoted/ shadowhidden/ hidden segments
* Remove locked segments
* Instantly remove any segment
* Instantly change the category of any segment

Cannot...

* Submit on locked videos
* Do anything non-voting that other VIPs would be able to do

This permission only lasts for 24 hours and can only be granted for one channel at a time.

Temporary VIPs will have their reports show up as "Report by Temporary VIP User" in <code>#submission-downvotes</code>

This can be done on sb-slash<ref name=":0" /> and SBC<ref name=":1" />

== Moderating Videos ==

=== Knowledge of Categories ===
Read the [[Guidelines|guidelines]] and feel free to ask in the discord after checking the wiki.

=== Manipulating Segments ===
Voting and category changing can be done with SBC<ref name=":1" />, Deedit's userscript<ref name=":2">https://gist.github.com/FlorianZahn/785599a860328fae0724ad5b2b3f7879</ref> or on YouTube.
* Upvoting a segment will lock it. This means that it will always be shown and immune to downvotes, even from the submitter.
* Downvoting a segment will immediately remove it, no matter whose it is.
** Locked segments are marked yellow to warn the VIP, that this segment was approved by a VIP. If you aren't sure, search for the videoID/UUID in Discord or ask. Not all decisions are well documented.
* Undoing a vote on will revert the segment's votes to what they were before your downvote or upvote. It will also remove other VIP's locks.
* If a segment is in a wrong category, you can change it directly on YouTube, SBC<ref name=":1" /> or sb-slash<ref name=":0" />
** Locked categories are colored yellow in the category selector. Be careful when changing to a locked category or submitting in one.

=== Locking Categories ===

* Review the entire video and make sure that all displayed segments are correct.
* Make sure to include a reason why segments should not be there if applicable.
* You can lock videos if you are concerned that segments will be spammed, before or after working on a video.
** It is explicitly allowed to lock popular videos at release to prevent spam.
* The most recent lock reason will be displayed.
*This can be done with sb-slash<ref name=":0" />, SBC<ref name=":1" />, SBBCool<ref>https://github.com/ducng99/SBBCoolHelper</ref> and sb.ltn.fi.lockCategories<ref name=":2" />

When users try to submit a category that is locked, they will receive the following message:
New submissions are not allowed for the following category: {category}. A moderator has decided that no new segments are needed on this video and that all current segments of this category are timed perfectly.

Lock reason: {reason}

If you believe this is incorrect, please contact someone on discord.gg/SponsorBlock or matrix.to/#/#sponsor:ajay.app
If the locked category is sponsor, the previous prompt will be expanded by this:
Maybe the segment you are submitting is a different category that you have not enabled and is not a sponsor. Categories that aren't sponsor, such as self-promotion can be enabled in the options.

=== Submitting Segments ===
Your segments should be perfectly accurate and follow the rules. This is because normal users cannot remove your segments and VIPs don't want to remove other VIPs' segments. If you are unsure, feel free to ask.

=== Abuse ===
Don't go around downvoting established segments. Odds are, you probably misunderstood the rules and could lose your VIP status if you are incorrigible.

=== Clearing Cache/ Purging Videos ===
Segments that have segments that are erroneously displaying even after they have been downvoted might need to have their cache cleared. Feel free to do this whenever but only if it does not resolve itself in a few refreshes. This can be done with SBC<ref name=":1" /> and sb-slash<ref name=":0" />

Videos that have been changed post-upload by the submitter (usually to remove a part of the video) and consequently have their segments offset should be cleared with "Purge Video". This can be done in SBC<ref name=":1" /> and sb-slash<ref name=":0" />. If there are segments that are still accurate enough, they can be un-hidden with a VIP upvote.

== SponsorBlock VIP UI ==
Shortly after becoming a VIP, your UI will highlight locked segments, similar to SBB.

Locked segments are usually submitted by VIPs or locked by VIPs. When submitting over a locked category, make sure that it wasn't purposefully excluded, either by checking the lock reason or asking the locking VIP in the discord.
[[File:Vipui-popup.png|none|thumb|Locked segments have a yellow downvote]]
[[File:Vip-ui-category-dropdown.png|none|thumb|Locked categories are highlighted in yellow]]

== Searching Segments ==
When searching for segments en masse, SBB is recommended but has an update delay of 10 minutes.

This can be mitigated with <code>[https://gist.github.com/TheJzoli/8a4cd979d433b7359cdf61c238bc0181 sb.ltn.fi.forceupdate.user.js]</code> by TheJzoli to force get new segments and update existing ones

and <code>[https://gist.github.com/mchangrh/c693f8e1de2b6a5067ae9d5e994f6758/raw/sbltnfi-refresh.user.js sbltnfi-refresh.user.js]</code> by blab to force update a single segment

Alternatively sb-slash can be used to search for segments on videos

* /searchsegements - get all segments on video, regardless of votes or hidden status
* /skipsegments - get segments displayed on video
* /segmentinfo - look up information from the segment UUID including user agent
for quick/convenient moderation sb-slash's [https://github.com/mchangrh/sb-slash/blob/main/docs/vip.md /vip] command can also be used

== Reviewing Other Users For Permanent VIP ==
Applicants should have the <code>requesting VIP</code> role, otherwise approach them privately.

The most important thing for VIPs is to be consistent and receptive to feedback.

* When looking at their segments, we shouldn't give them a warning - see [[Guidelines]]
* They know what's good in their submission
* They know what's bad in their submissions
* They're involved and consistent.
* They should have at least 25 submissions
* They have to have submissions dating back at least a month.
* Their segments should be consistently good
* They should have a good grasp on any category they've made a submission with.

== Tool Feature Matrix ==
{| class="wikitable mw-collapsible"
|+Tool Feature Matrix
!Tool Name
!Voting
!Change
Category
!Locking
Category
!Warning
!Unwarning
!Banning
!Temp
VIP
!Clearing
Cache
!Purging
Videos
|-
|Browser Extension
|✅
|✅
|
|
|
|
|
|
|
|-
|SponsorBlockControl
|✅
|✅
|✅
|✅
|✅
|✅
|✅
|✅
|✅
|-
|sb-slash
|✔️*
|✅
|✔️*
|
|✔️*
|
|✔️*
|✅
|✅
|-
|SBBCool
|✅
|✅
|✅
|
|
|
|
|
|✅
|-
|Deedit's Script
|✅
|✅
|✅
|
|
|
|
|✅
|✅
|}
<nowiki>*</nowiki> Actions done with sb-slash are not as anonymous, as they are logged to a VIP-only channel

=== Citations ===

Intermission/Intro Animation

2022-05-03T13:47:22Z

Whyiswhen: /* Description */ add and fiction/legal disclaimer as they are added in https://wiki.sponsor.ajay.app/w/Intermission/Intro_Animation#:~:text=Copyright%2C%20Fair%20Use%20and%20fiction/legal%20disclaimers%20can%20be%20marked%20as%20Intermission/%20Intro%20Animation

__FORCETOC__
=== Description ===
Usually at the start of a video.

An interval without actual content. This should not be used for transitions containing information.

'''This includes:'''
*Pauses
*Static frames
*Looping animations
*Livestream pauses with no content:
**Looping animations
**Chat window
**Long break with no talking or nothing seemingly happening
*Copyright, Fair Use, Fiction and Legal disclaimers
*Parts of the video that were blurred by the YouTuber after uploading
*Topic themed intro animations and short cinematic openings
*Random unrelated clips with music, similar to [https://www.youtube.com/watch?v=1rzC5qrYZXs an intro of a TV Show]

=== Exceptions/ Edge Cases ===
#As a rule of thumb, you can assume, that anything containing speech should not be submitted.
#A greeting containing speech may be marked as intro if and only if it is separated from the rest of the video with a clear visual '''AND''' audio cut.

'''This category is not for:'''
*Getting to the interesting part of a video. ([[Highlight]] or [[Music: Non-Music Section|Non-Music]])
*Time-lapses
*Slow motion clips
*B-roll
*Bloopers
*Jokes
*Disclaimers that are there to protect the viewer
**Spoiler warnings
**Content warnings
**Photosensitive warnings
**Copyright, Fair Use and fiction/legal disclaimers '''can be marked''' as Intermission/ Intro Animation
* Context relevant to parts immediately after the segment

=== Examples ===
{| class="wikitable" style="width: 80%"
|-
! style="width: 3%" | Description !! style="width: 1%" | Video Link
|-
! colspan="2"|Positive Examples
|-
| The intro animation that is found in Linus Tech Tips' videos. || [https://www.youtube.com/watch?v=SElZABp5M3U I tried Steam Deck early and it's AWESOME!]
|-
| The spoken intro on Daily Dose of Internet may be submitted because it is the same every time and no content is in the background. Normally any speaking would be considered content, but this is an exception. || [https://www.youtube.com/watch?v=evKZGQ-qwEE Bread That Hates Mustard]
|-
| Themed intro cinematic over music || [https://www.youtube.com/watch?v=8eNNJESKjrE OnePlus 9 Pro Review: A Huge Hasselblad Promise!]
|-
| This cut is very seamless. || [https://www.youtube.com/watch?v=Hdoi3p2jHPU&t=23s The Mask of Tutankhamun]
|-
|The intro consists of random unrelated clips with music that give no context for the video
|[https://www.youtube.com/watch?v=5SkJdPp35pM I need HELP with my new house...]
|-
| rowspan="2" |Themed intros for The Studio that differ slightly between videos
|[https://www.youtube.com/watch?v=WZdROTl4b0o Blind Smartphone Guessing Game!]
|-
|[https://www.youtube.com/watch?v=cxp-FCDUkNc The MKBHD Desk Setup Tour 2021!]
|-
| Themed intro. || [https://www.youtube.com/watch?v=yLXflEEQqSU Your Hands Go INSIDE this Keyboard]
|-
| Tv-series like intro || [https://www.youtube.com/watch?v=7_pph8Ilq1E <nowiki>Spec Ops REACT to Call of Duty: Modern Warfare - Night Missions Campaign | Experts React</nowiki>]
|-
! colspan="2"|Negative Examples
|-
| In this trailer the first 5 seconds should not be cut, because you can hear the wind blowing in the background. The wind in this case is content. || [https://www.youtube.com/watch?v=Qah9sSIXJqk <nowiki>KGF Chapter2 TEASER |Yash|Sanjay Dutt|Raveena Tandon|Srinidhi Shetty|Prashanth Neel|Vijay Kiragandur</nowiki>]
|-
| The category shouldn't be used to get to the point of the video. A segment from 0:00 to [https://www.youtube.com/watch?v=maMnRvJVih8&t=13s 0:13] is not permitted.|| [https://www.youtube.com/watch?v=maMnRvJVih8 Kyudo - the sound of an arrow being released from bow]
|-
| The cinematic at the very start should not be cut, because it is vital to the context. Removing it leads to a decreased viewer experience. It doesn't matter that the title references it. || [https://youtu.be/C3xeBlEuufw?t=4 You wouldn’t DOWNLOAD a PC CASE?!]
|}

Community

2022-04-26T14:50:54Z

Whyiswhen: https://sb-openapi.mchang.icu/ is DNS_PROBE_FINISHED_NXDOMAIN as in https://i.imgur.com/YI08vRL.png

== Media ==
[https://github.com/cole8888/SponsorBlock-Flowchart SponsorBlock Flowchart] by E.Coli. Flowchart to help users choose the correct category when making submissions.

Please see the latest version on the [https://github.com/cole8888/SponsorBlock-Flowchart GitHub]
[[File:SB Flowchart small 1.8.0.png|none|thumb|500x500px|Flow chart to help users choose the correct category when making submissions.]]

== Websites ==
[https://sb.ltn.fi/ SponsorBlock Browser] by Lartza. Explore segments on a 5-minute delayed version of the live database

[https://mruy.github.io/sponsorBlockControl/ SponsorBlockControl] by Nanobyte. Vote on segments with UUID, also for VIP operations

=== Userscripts ===
Userscripts require a userscript manager like [https://www.tampermonkey.net/ Tampermonkey].

==== SponsorBlock Browser ====
[https://gist.github.com/MRuy/ca74d6a359c487d760f4a698e76fb0d6 Userscripts] by Nanobyte

* Shows last update time ([https://gist.github.com/MRuy/ca74d6a359c487d760f4a698e76fb0d6/raw/sb.ltn.fi.lastupdate.user.js Install])
* Color highlights segments that are similar ([https://gist.github.com/MRuy/ca74d6a359c487d760f4a698e76fb0d6/raw/sb.ltn.fi.similarsegments.user.js Install])
* Color highlights categories ([https://gist.github.com/MRuy/ca74d6a359c487d760f4a698e76fb0d6/raw/sb.ltn.fi.coloredcategories.user.js Install])
* Make startTime clickable ([https://gist.github.com/MRuy/ca74d6a359c487d760f4a698e76fb0d6/raw/sb.ltn.fi.clickablestarttime.user.js Install])
* Paste YT link into videoID field ([https://gist.github.com/MRuy/ca74d6a359c487d760f4a698e76fb0d6/raw/sb.ltn.fi.sponsorblock.paste.ytlink.user.js Install])

[https://gist.github.com/TheJzoli/8a4cd979d433b7359cdf61c238bc0181 Userscripts] by TheJzoli

* Replace videoID with video title ([https://gist.github.com/TheJzoli/8a4cd979d433b7359cdf61c238bc0181/raw/sb.ltn.fi.videotitles.user.js Install])
* Clicking ellipsis will navigate to specified page ([https://gist.github.com/TheJzoli/8a4cd979d433b7359cdf61c238bc0181/raw/sb.ltn.fi.clickableellipsisnavigation.user.js Install])
* Hide any column you want ([https://gist.github.com/TheJzoli/8a4cd979d433b7359cdf61c238bc0181/raw/sb.ltn.fi.hidecolumns.user.js Install])
* Duplicate page navigation element above table ([https://gist.github.com/TheJzoli/8a4cd979d433b7359cdf61c238bc0181/raw/sb.ltn.fi.pagenavigationabovetable.user.js Install])
* Add button to userID page to copy that userID ([https://gist.github.com/TheJzoli/8a4cd979d433b7359cdf61c238bc0181/raw/sb.ltn.fi.copyuserid.user.js Install])
* "✂" button copies the link to the video's SBB page instead of video ID ([https://gist.github.com/TheJzoli/8a4cd979d433b7359cdf61c238bc0181/raw/sb.ltn.fi.copyvideopagelink.user.js Install])
*Fetches the segments and updated info for the video, so that you don't have to wait for the video page to update ([https://gist.github.com/TheJzoli/8a4cd979d433b7359cdf61c238bc0181/raw/sb.ltn.fi.forceupdate.user.js Install])

[https://gist.github.com/FlorianZahn/785599a860328fae0724ad5b2b3f7879 Userscripts] by Deedit
* Vip tools for [https://sb.ltn.fi/ SBB]. Voting; Category change; Locking ([https://gist.github.com/FlorianZahn/785599a860328fae0724ad5b2b3f7879/raw/sb.ltn.fi.lockCategories.user.js Install])
* Opens the video's page on SBB. ([https://gist.github.com/FlorianZahn/785599a860328fae0724ad5b2b3f7879/raw/sb.ltn.fi.DBBOpener.user.js Install])
* Opens a video outside of its playlist. ([https://gist.github.com/FlorianZahn/785599a860328fae0724ad5b2b3f7879/raw/PlaylistVideoOpener.user.js Install])
Userscripts by blabdude

* Copy sb.mchang.xyz/UUID link. ([https://gist.github.com/mchangrh/603db65fd7dfc177a0eb21cef4ca8270/raw/sbltnfi-requiredSegments.user.js Install])
* Refresh individual segments ([https://gist.github.com/mchangrh/c693f8e1de2b6a5067ae9d5e994f6758/raw/sbltnfi-refresh.user.js Install])

[https://github.com/ducng99/SBBCoolHelper SBBCoolHelper] by Maxhyt

[https://raw.githubusercontent.com/ducng99/SBBCoolHelper/master/SBBCoolHelper.user.js Install]

* VIP tools for SBB
** Voting
** Category Change
** Locking

== Bookmarklets ==
Opening SponsorBlock Browser page while on the YouTube page<syntaxhighlight lang="js">
javascript:(function(){window.open('https://sb.ltn.fi/video/' + new URL(document.URL).searchParams.get("v") + '/')})()
</syntaxhighlight>Open video outside of playlist<syntaxhighlight lang="js">
javascript:(function(){window.open('https://youtube.com/watch?v=' + new URL(document.URL).searchParams.get("v"))})()
</syntaxhighlight>

== 3rd Party Ports ==
[https://github.com/ajayyy/SponsorBlock/wiki/3rd-Party-Ports Github Wiki 3rd Party Ports]

[https://docs.google.com/spreadsheets/d/1vxSx06dPs_X3WCCC0bMztmlxbg_ETzAmp7sL70HFIew/edit?usp=sharing SponsorBlock Port Matrix] by mchangrh. Supported endpoints, segment types and documentation versions for different ports/libraries

== Misc ==
[https://github.com/mchangrh/sb-slash sb-slash] by mchangrh. Interact with SponsorBlock over Discord