Merge pull request #1352 from Stypox/yt-confirm-not-bot

[YouTube] Add custom error for "Sign in to confirm ..."

build.gradle

@@ -68,10 +68,10 @@ subprojects {
 
 // https://discuss.gradle.org/t/best-approach-gradle-multi-module-project-generate-just-one-global-javadoc/18657/21
 tasks.register('aggregatedJavadocs', Javadoc) {
-    destinationDir = file("${layout.buildDirectory}/docs/javadoc")
+    destinationDir = layout.buildDirectory.file("docs/javadoc").get().asFile
     title = "$project.name $version"
     // options.memberLevel = JavadocMemberLevel.PRIVATE
-    options.links 'https://docs.oracle.com/javase/8/docs/api/'
+    options.links 'https://docs.oracle.com/javase/11/docs/api/'
     options.encoding 'UTF-8'
     // Fixes unknown tag @implNote; the other two were added precautionary
     options.tags = [

extractor/build.gradle

@@ -28,14 +28,14 @@ checkstyleTest {
 
 ext {
     rhinoVersion = '1.8.0'
-    protobufVersion = '4.31.1'
+    protobufVersion = '4.32.0'
 }
 
 dependencies {
     implementation project(':timeago-parser')
 
     implementation "com.github.TeamNewPipe:nanojson:$nanojsonVersion"
-    implementation 'org.jsoup:jsoup:1.21.1'
+    implementation 'org.jsoup:jsoup:1.21.2'
     implementation "com.google.code.findbugs:jsr305:$jsr305Version"
     implementation "com.google.protobuf:protobuf-javalite:$protobufVersion"
 

extractor/src/main/java/org/schabi/newpipe/extractor/exceptions/SignInConfirmNotBotException.java

@@ -0,0 +1,11 @@
+package org.schabi.newpipe.extractor.exceptions;
+
+/**
+ * Content can't be extracted because the service requires logging in to confirm the user is not a
+ * bot. Can usually only be solvable by changing IP (e.g. in the case of YouTube).
+ */
+public class SignInConfirmNotBotException extends ParsingException {
+    public SignInConfirmNotBotException(final String message) {
+        super(message);
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/extractors/YoutubeStreamExtractor.java

@@ -53,6 +53,7 @@ import org.schabi.newpipe.extractor.exceptions.PaidContentException;
 import org.schabi.newpipe.extractor.exceptions.ParsingException;
 import org.schabi.newpipe.extractor.exceptions.PrivateContentException;
 import org.schabi.newpipe.extractor.exceptions.YoutubeMusicPremiumContentException;
+import org.schabi.newpipe.extractor.exceptions.SignInConfirmNotBotException;
 import org.schabi.newpipe.extractor.linkhandler.LinkHandler;
 import org.schabi.newpipe.extractor.localization.ContentCountry;
 import org.schabi.newpipe.extractor.localization.DateWrapper;
@@ -901,7 +902,14 @@ public class YoutubeStreamExtractor extends StreamExtractor {
             }
         }
 
-        throw new ContentNotAvailableException("Got error: \"" + reason + "\"");
+        // "Sign in to confirm that you're not a bot"
+        if (reason != null && reason.contains("a bot")) {
+            throw new SignInConfirmNotBotException(
+                    "YouTube probably temporarily blocked this IP, got error "
+                            + status + ": \"" + reason + "\"");
+        }
+
+        throw new ContentNotAvailableException("Got error " + status + ": \"" + reason + "\"");
     }
 
     private void fetchHtml5Client(@Nonnull final Localization localization,

extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/extractors/YoutubeStreamInfoItemLockupExtractor.java

@@ -26,7 +26,7 @@ import javax.annotation.Nullable;
 
 /**
  * Note:
- * This extractor is currently (2025-07) only used to extract related video streams.<br/>
+ * This extractor is currently (2025-07) only used to extract related video streams.<br>
  * The following features are currently not implemented because they have never been observed:
  * <ul>
  *     <li>Shorts</li>