channel list extractor

ChanGu3 · ChanGu3 · commit a6e57cddc21d · 2026-03-01T19:47:20.000-08:00
diff --git a/extractor/src/main/java/org/schabi/newpipe/extractor/StreamingService.java b/extractor/src/main/java/org/schabi/newpipe/extractor/StreamingService.java
@@ -1,6 +1,7 @@
 package org.schabi.newpipe.extractor;
 
 import org.schabi.newpipe.extractor.channel.ChannelExtractor;
+import org.schabi.newpipe.extractor.channel.list.ChannelListExtractor;
 import org.schabi.newpipe.extractor.channel.tabs.ChannelTabExtractor;
 import org.schabi.newpipe.extractor.comments.CommentsExtractor;
 import org.schabi.newpipe.extractor.exceptions.ExtractionException;
@@ -87,7 +88,7 @@ public enum LinkType {
         NONE,
         STREAM,
         CHANNEL,
-        PLAYLIST
+        PLAYLIST,
     }
 
     private final int serviceId;
@@ -222,6 +223,17 @@ public abstract ChannelExtractor getChannelExtractor(ListLinkHandler linkHandler
     public abstract ChannelTabExtractor getChannelTabExtractor(ListLinkHandler linkHandler)
             throws ExtractionException;
 
+    /**
+     * Must create a new instance of a ChannelListExtractor implementation.
+     * @param linkHandler is pointing to the channel which should be handled by this new instance.
+     * @return a new ChannelListExtractor
+     * <p>
+     * In services which there's no other way to retrieve them, null should be returned.
+     *
+     */
+    public abstract ChannelListExtractor getChannelListExtractor(ListLinkHandler linkHandler)
+            throws ExtractionException;
+
     /**
      * Must crete a new instance of a PlaylistExtractor implementation.
      * @param linkHandler is pointing to the playlist which should be handled by this new instance.
@@ -294,6 +306,20 @@ public ChannelTabExtractor getChannelTabExtractorFromIdAndBaseUrl(final String i
                 id, Collections.singletonList(tab), "", baseUrl));
     }
 
+    public ChannelListExtractor getChannelListExtractor(final String url)
+            throws ExtractionException {
+        return getChannelListExtractor(getChannelTabLHFactory().fromUrl(url));
+    }
+
+    public ChannelListExtractor getChannelListExtractor(final String id,
+                                                        final List<String> contentFilter,
+                                                        final String baseUrl)
+            throws ExtractionException {
+        return getChannelListExtractor(getChannelTabLHFactory().fromQuery(
+                id, contentFilter, "", baseUrl));
+    }
+
+
     public PlaylistExtractor getPlaylistExtractor(final String url) throws ExtractionException {
         return getPlaylistExtractor(getPlaylistLHFactory().fromUrl(url));
     }
diff --git a/extractor/src/main/java/org/schabi/newpipe/extractor/channel/list/ChannelListExtractor.java b/extractor/src/main/java/org/schabi/newpipe/extractor/channel/list/ChannelListExtractor.java
@@ -0,0 +1,13 @@
+package org.schabi.newpipe.extractor.channel.list;
+
+import org.schabi.newpipe.extractor.ListExtractor;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.channel.ChannelInfoItem;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+
+public abstract class ChannelListExtractor extends ListExtractor<ChannelInfoItem> {
+    public ChannelListExtractor(final StreamingService service,
+                                final ListLinkHandler linkHandler) {
+        super(service, linkHandler);
+    }
+}
diff --git a/extractor/src/main/java/org/schabi/newpipe/extractor/channel/list/ChannelListInfo.java b/extractor/src/main/java/org/schabi/newpipe/extractor/channel/list/ChannelListInfo.java
@@ -0,0 +1,89 @@
+package org.schabi.newpipe.extractor.channel.list;
+
+import org.schabi.newpipe.extractor.ListExtractor;
+import org.schabi.newpipe.extractor.ListInfo;
+import org.schabi.newpipe.extractor.NewPipe;
+import org.schabi.newpipe.extractor.Page;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.channel.ChannelInfoItem;
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+import org.schabi.newpipe.extractor.utils.ExtractorHelper;
+
+import java.io.IOException;
+
+import javax.annotation.Nonnull;
+
+public class ChannelListInfo extends ListInfo<ChannelInfoItem> {
+    public ChannelListInfo(final int serviceId,
+                           @Nonnull final ListLinkHandler linkHandler,
+                           final String name) {
+        super(serviceId, linkHandler, name);
+    }
+
+    public static ChannelListInfo getInfo(final String url)
+            throws IOException, ExtractionException {
+        return getInfo(NewPipe.getServiceByUrl(url), url);
+    }
+
+    public static ChannelListInfo getInfo(final StreamingService service, final String url)
+            throws IOException, ExtractionException {
+        final ChannelListExtractor extractor = service.getChannelListExtractor(url);
+        extractor.fetchPage();
+        return getInfo(extractor);
+    }
+
+    /**
+     * Get a {@link ChannelListInfo} instance from the given service and link handler.
+     *
+     * @param service streaming service
+     * @param linkHandler Channel list handler (from {@link ChannelListInfo})
+     * @return the extracted {@link ChannelListInfo}
+     */
+    @Nonnull
+    public static ChannelListInfo getInfo(@Nonnull final StreamingService service,
+                                         @Nonnull final ListLinkHandler linkHandler)
+            throws ExtractionException, IOException {
+        final ChannelListExtractor extractor = service.getChannelListExtractor(linkHandler);
+        extractor.fetchPage();
+
+        return getInfo(extractor);
+    }
+
+    /**
+     * Get a {@link ChannelListInfo} instance from a {@link ChannelListExtractor}.
+     *
+     * @param extractor an extractor where {@code fetchPage()} was already got called on
+     * @return the extracted {@link ChannelListInfo}
+     */
+    @Nonnull
+    public static ChannelListInfo getInfo(@Nonnull final ChannelListExtractor extractor)
+            throws ParsingException {
+        final ChannelListInfo info =
+                new ChannelListInfo(extractor.getServiceId(),
+                        extractor.getLinkHandler(),
+                        extractor.getName());
+        try {
+
+            info.setOriginalUrl(extractor.getOriginalUrl());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        final ListExtractor.InfoItemsPage<ChannelInfoItem> page
+                = ExtractorHelper.getItemsPageOrLogError(info, extractor);
+        info.setRelatedItems(page.getItems());
+        info.setNextPage(page.getNextPage());
+
+        return info;
+    }
+
+    public static ListExtractor.InfoItemsPage<ChannelInfoItem> getMoreItems(
+            @Nonnull final StreamingService service,
+            @Nonnull final ListLinkHandler linkHandler,
+            @Nonnull final Page page) throws ExtractionException, IOException {
+        return service.getChannelListExtractor(linkHandler).getPage(page);
+    }
+
+}
diff --git a/extractor/src/main/java/org/schabi/newpipe/extractor/services/bandcamp/BandcampService.java b/extractor/src/main/java/org/schabi/newpipe/extractor/services/bandcamp/BandcampService.java
@@ -12,6 +12,7 @@
 
 import org.schabi.newpipe.extractor.StreamingService;
 import org.schabi.newpipe.extractor.channel.ChannelExtractor;
+import org.schabi.newpipe.extractor.channel.list.ChannelListExtractor;
 import org.schabi.newpipe.extractor.channel.tabs.ChannelTabExtractor;
 import org.schabi.newpipe.extractor.comments.CommentsExtractor;
 import org.schabi.newpipe.extractor.exceptions.ExtractionException;
@@ -154,6 +155,12 @@ public ChannelTabExtractor getChannelTabExtractor(final ListLinkHandler linkHand
         }
     }
 
+    @Override
+    public ChannelListExtractor getChannelListExtractor(final ListLinkHandler linkHandler)
+            throws ExtractionException {
+        return null;
+    }
+
     @Override
     public PlaylistExtractor getPlaylistExtractor(final ListLinkHandler linkHandler) {
         return new BandcampPlaylistExtractor(this, linkHandler);
diff --git a/extractor/src/main/java/org/schabi/newpipe/extractor/services/media_ccc/MediaCCCService.java b/extractor/src/main/java/org/schabi/newpipe/extractor/services/media_ccc/MediaCCCService.java
@@ -6,6 +6,7 @@
 
 import org.schabi.newpipe.extractor.StreamingService;
 import org.schabi.newpipe.extractor.channel.ChannelExtractor;
+import org.schabi.newpipe.extractor.channel.list.ChannelListExtractor;
 import org.schabi.newpipe.extractor.channel.tabs.ChannelTabExtractor;
 import org.schabi.newpipe.extractor.comments.CommentsExtractor;
 import org.schabi.newpipe.extractor.exceptions.ExtractionException;
@@ -100,6 +101,12 @@ public ChannelTabExtractor getChannelTabExtractor(final ListLinkHandler linkHand
         }
     }
 
+    @Override
+    public ChannelListExtractor getChannelListExtractor(final ListLinkHandler linkHandler)
+            throws ExtractionException {
+        return null;
+    }
+
     @Override
     public PlaylistExtractor getPlaylistExtractor(final ListLinkHandler linkHandler) {
         return null;
diff --git a/extractor/src/main/java/org/schabi/newpipe/extractor/services/peertube/PeertubeService.java b/extractor/src/main/java/org/schabi/newpipe/extractor/services/peertube/PeertubeService.java
@@ -6,6 +6,7 @@
 
 import org.schabi.newpipe.extractor.StreamingService;
 import org.schabi.newpipe.extractor.channel.ChannelExtractor;
+import org.schabi.newpipe.extractor.channel.list.ChannelListExtractor;
 import org.schabi.newpipe.extractor.channel.tabs.ChannelTabExtractor;
 import org.schabi.newpipe.extractor.comments.CommentsExtractor;
 import org.schabi.newpipe.extractor.exceptions.ExtractionException;
@@ -117,6 +118,12 @@ public ChannelTabExtractor getChannelTabExtractor(final ListLinkHandler linkHand
         return new PeertubeChannelTabExtractor(this, linkHandler);
     }
 
+    @Override
+    public ChannelListExtractor getChannelListExtractor(final ListLinkHandler linkHandler)
+            throws ExtractionException {
+        return null;
+    }
+
     @Override
     public PlaylistExtractor getPlaylistExtractor(final ListLinkHandler linkHandler)
             throws ExtractionException {
diff --git a/extractor/src/main/java/org/schabi/newpipe/extractor/services/soundcloud/SoundcloudService.java b/extractor/src/main/java/org/schabi/newpipe/extractor/services/soundcloud/SoundcloudService.java
@@ -6,6 +6,7 @@
 
 import org.schabi.newpipe.extractor.StreamingService;
 import org.schabi.newpipe.extractor.channel.ChannelExtractor;
+import org.schabi.newpipe.extractor.channel.list.ChannelListExtractor;
 import org.schabi.newpipe.extractor.channel.tabs.ChannelTabExtractor;
 import org.schabi.newpipe.extractor.comments.CommentsExtractor;
 import org.schabi.newpipe.extractor.exceptions.ExtractionException;
@@ -99,6 +100,12 @@ public ChannelTabExtractor getChannelTabExtractor(final ListLinkHandler linkHand
         return new SoundcloudChannelTabExtractor(this, linkHandler);
     }
 
+    @Override
+    public ChannelListExtractor getChannelListExtractor(final ListLinkHandler linkHandler)
+            throws ExtractionException {
+        return null;
+    }
+
     @Override
     public PlaylistExtractor getPlaylistExtractor(final ListLinkHandler linkHandler) {
         return new SoundcloudPlaylistExtractor(this, linkHandler);
diff --git a/extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/YoutubeService.java b/extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/YoutubeService.java
@@ -8,6 +8,7 @@
 
 import org.schabi.newpipe.extractor.StreamingService;
 import org.schabi.newpipe.extractor.channel.ChannelExtractor;
+import org.schabi.newpipe.extractor.channel.list.ChannelListExtractor;
 import org.schabi.newpipe.extractor.channel.tabs.ChannelTabExtractor;
 import org.schabi.newpipe.extractor.comments.CommentsExtractor;
 import org.schabi.newpipe.extractor.exceptions.ExtractionException;
@@ -25,6 +26,7 @@
 import org.schabi.newpipe.extractor.playlist.PlaylistExtractor;
 import org.schabi.newpipe.extractor.search.SearchExtractor;
 import org.schabi.newpipe.extractor.services.youtube.extractors.YoutubeChannelExtractor;
+import org.schabi.newpipe.extractor.services.youtube.extractors.YoutubeFeaturedChannelListExtractor;
 import org.schabi.newpipe.extractor.services.youtube.extractors.YoutubeChannelTabExtractor;
 import org.schabi.newpipe.extractor.services.youtube.extractors.YoutubeCommentsExtractor;
 import org.schabi.newpipe.extractor.services.youtube.extractors.YoutubeFeedExtractor;
@@ -136,6 +138,12 @@ public ChannelTabExtractor getChannelTabExtractor(final ListLinkHandler linkHand
         }
     }
 
+    @Override
+    public ChannelListExtractor getChannelListExtractor(final ListLinkHandler linkHandler)
+            throws ExtractionException {
+        return new YoutubeFeaturedChannelListExtractor(this, linkHandler);
+    }
+
     @Override
     public PlaylistExtractor getPlaylistExtractor(final ListLinkHandler linkHandler) {
         if (YoutubeParsingHelper.isYoutubeMixId(linkHandler.getId())) {
