feat: Featured Tab (Only Featured Channels RendererList supported)

ChanGu3 · ChanGu3 · commit c7e7404ff66c · 2026-02-27T20:51:36.000-08:00
diff --git a/extractor/src/main/java/org/schabi/newpipe/extractor/MultiInfoItemsCollector.java b/extractor/src/main/java/org/schabi/newpipe/extractor/MultiInfoItemsCollector.java
@@ -2,6 +2,8 @@
 
 import org.schabi.newpipe.extractor.channel.ChannelInfoItemExtractor;
 import org.schabi.newpipe.extractor.channel.ChannelInfoItemsCollector;
+import org.schabi.newpipe.extractor.channel.tabs.rendererlist.RendererListInfoItemExtractor;
+import org.schabi.newpipe.extractor.channel.tabs.rendererlist.RendererListInfoItemsCollector;
 import org.schabi.newpipe.extractor.exceptions.ParsingException;
 import org.schabi.newpipe.extractor.playlist.PlaylistInfoItemExtractor;
 import org.schabi.newpipe.extractor.playlist.PlaylistInfoItemsCollector;
@@ -41,6 +43,7 @@
  *     <li>{@link StreamInfoItemExtractor}</li>
  *     <li>{@link ChannelInfoItemExtractor}</li>
  *     <li>{@link PlaylistInfoItemExtractor}</li>
+ *     <li>{@link RendererListInfoItemExtractor}</li>
  * </ul>
  * Calling {@link #extract(InfoItemExtractor)} or {@link #commit(InfoItemExtractor)} with any
  * other extractor type will raise an exception.
@@ -49,12 +52,14 @@ public class MultiInfoItemsCollector extends InfoItemsCollector<InfoItem, InfoIt
     private final StreamInfoItemsCollector streamCollector;
     private final ChannelInfoItemsCollector userCollector;
     private final PlaylistInfoItemsCollector playlistCollector;
+    private final RendererListInfoItemsCollector rendererListCollector;
 
     public MultiInfoItemsCollector(final int serviceId) {
         super(serviceId);
         streamCollector = new StreamInfoItemsCollector(serviceId);
         userCollector = new ChannelInfoItemsCollector(serviceId);
         playlistCollector = new PlaylistInfoItemsCollector(serviceId);
+        rendererListCollector = new RendererListInfoItemsCollector(serviceId);
     }
 
     @Override
@@ -63,6 +68,7 @@ public List<Throwable> getErrors() {
         errors.addAll(streamCollector.getErrors());
         errors.addAll(userCollector.getErrors());
         errors.addAll(playlistCollector.getErrors());
+        errors.addAll(rendererListCollector.getErrors());
 
         return Collections.unmodifiableList(errors);
     }
@@ -73,6 +79,7 @@ public void reset() {
         streamCollector.reset();
         userCollector.reset();
         playlistCollector.reset();
+        rendererListCollector.reset();
     }
 
     @Override
@@ -84,6 +91,8 @@ public InfoItem extract(final InfoItemExtractor extractor) throws ParsingExcepti
             return userCollector.extract((ChannelInfoItemExtractor) extractor);
         } else if (extractor instanceof PlaylistInfoItemExtractor) {
             return playlistCollector.extract((PlaylistInfoItemExtractor) extractor);
+        } else if (extractor instanceof RendererListInfoItemExtractor) {
+            return rendererListCollector.extract((RendererListInfoItemExtractor) extractor);
         } else {
             throw new IllegalArgumentException("Invalid extractor type: " + extractor);
         }
diff --git a/extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/extractors/YoutubeChannelTabExtractor.java b/extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/extractors/YoutubeChannelTabExtractor.java
@@ -36,8 +36,8 @@
  * A {@link ChannelTabExtractor} implementation for the YouTube service.
  *
  * <p>
- * It currently supports {@code Videos}, {@code Shorts}, {@code Live}, {@code Playlists},
- * {@code Albums} and {@code Channels} tabs.
+ * It currently supports {@code Featured}, {@code Videos}, {@code Shorts}, {@code Live},
+ * {@code Playlists}, {@code Albums} and {@code Channels} tabs.
  * </p>
  */
 public class YoutubeChannelTabExtractor extends ChannelTabExtractor {
@@ -48,6 +48,8 @@ public class YoutubeChannelTabExtractor extends ChannelTabExtractor {
     private JsonObject jsonResponse;
     private String channelId;
 
+    private final String itemIndexKey = "itemIndex";
+
     public YoutubeChannelTabExtractor(final StreamingService service,
                                       final ListLinkHandler linkHandler) {
         super(service, linkHandler);
@@ -57,6 +59,8 @@ public YoutubeChannelTabExtractor(final StreamingService service,
     private String getChannelTabsParameters() throws ParsingException {
         final String name = getName();
         switch (name) {
+            case ChannelTabs.FEATURED:
+                return "EghmZWF0dXJlZPIGBAoCMgA%3D";
             case ChannelTabs.VIDEOS:
                 return "EgZ2aWRlb3PyBgQKAjoA";
             case ChannelTabs.SHORTS:
@@ -157,7 +161,7 @@ public InfoItemsPage<InfoItem> getInitialPage() throws IOException, ExtractionEx
         final String channelName = getChannelName();
         final String channelUrl = getUrl();
 
-        final JsonObject continuation = collectItemsFrom(collector, items, verifiedStatus,
+        final JsonObject continuation = collectItemsFrom(collector, -1, items, verifiedStatus,
                 channelName, channelUrl)
                 .orElse(null);
 
@@ -249,23 +253,38 @@ private Optional<JsonObject> collectItemsFrom(@Nonnull final MultiInfoItemsColle
             verifiedStatus = VerifiedStatus.UNKNOWN;
         }
 
-        return collectItemsFrom(collector, items, verifiedStatus, channelName, channelUrl);
+        return collectItemsFrom(collector, -1, items, verifiedStatus, channelName, channelUrl);
     }
 
     private Optional<JsonObject> collectItemsFrom(@Nonnull final MultiInfoItemsCollector collector,
+                                                  @Nonnull final int rootItemIndex,
                                                   @Nonnull final JsonArray items,
                                                   @Nonnull final VerifiedStatus verifiedStatus,
                                                   @Nullable final String channelName,
                                                   @Nullable final String channelUrl) {
+
+        // creating ItemIndex of the collectItemsFrom first call
+        if (rootItemIndex == -1) {
+            for (int i = 0; i < items.size(); i++) {
+                if (items.get(i) instanceof JsonObject) {
+                    ((JsonObject) items.get(i)).put(itemIndexKey, i);
+                }
+            }
+        }
+
         return items.stream()
                 .filter(JsonObject.class::isInstance)
                 .map(JsonObject.class::cast)
-                .map(item -> collectItem(
-                        collector, item, verifiedStatus, channelName, channelUrl))
+                .map(item ->
+                    collectItem(collector,
+                            (rootItemIndex == -1 ? item.getInt(itemIndexKey) : rootItemIndex),
+                            item, verifiedStatus, channelName, channelUrl)
+                )
                 .reduce(Optional.empty(), (c1, c2) -> c1.or(() -> c2));
     }
 
     private Optional<JsonObject> collectItem(@Nonnull final MultiInfoItemsCollector collector,
+                                             @Nonnull final int rootItemIndex,
                                              @Nonnull final JsonObject item,
                                              @Nonnull final VerifiedStatus channelVerifiedStatus,
                                              @Nullable final String channelName,
@@ -300,17 +319,35 @@ private Optional<JsonObject> collectItem(@Nonnull final MultiInfoItemsCollector
                     item.getObject("gridShowRenderer"), channelVerifiedStatus, channelName,
                     channelUrl));
         } else if (item.has("shelfRenderer")) {
-            return collectItem(collector, item.getObject("shelfRenderer")
-                    .getObject("content"), channelVerifiedStatus, channelName, channelUrl);
+            if (item.getObject("shelfRenderer").getObject("content")
+                    .getObject("horizontalListRenderer").has("items")) {
+                commitRendererList(collector,
+                        rootItemIndex, item.getObject("shelfRenderer"),
+                        channelVerifiedStatus, channelName, channelUrl);
+            } else {
+                return collectItem(collector, rootItemIndex, item.getObject("shelfRenderer")
+                        .getObject("content"), channelVerifiedStatus, channelName, channelUrl);
+            }
+        } else if (item.has("channelVideoPlayerRenderer")) {
+            // Different InfoItem
+            // skips until implemented
+            return Optional.empty();
+        } else if (item.has("recognitionShelfRenderer")) {
+            // Probably use RendererList with an extra extractor similar to FeaturedChannels
+            // skips until implemented
+            return Optional.empty();
         } else if (item.has("itemSectionRenderer")) {
-            return collectItemsFrom(collector, item.getObject("itemSectionRenderer")
-                    .getArray("contents"), channelVerifiedStatus, channelName, channelUrl);
+            return collectItemsFrom(collector, rootItemIndex,
+                    item.getObject("itemSectionRenderer").getArray("contents"),
+                    channelVerifiedStatus, channelName, channelUrl);
         } else if (item.has("horizontalListRenderer")) {
-            return collectItemsFrom(collector, item.getObject("horizontalListRenderer")
-                    .getArray("items"), channelVerifiedStatus, channelName, channelUrl);
+            return collectItemsFrom(collector, rootItemIndex,
+                    item.getObject("horizontalListRenderer").getArray("items"),
+                    channelVerifiedStatus, channelName, channelUrl);
         } else if (item.has("expandedShelfContentsRenderer")) {
-            return collectItemsFrom(collector, item.getObject("expandedShelfContentsRenderer")
-                    .getArray("items"), channelVerifiedStatus, channelName, channelUrl);
+            return collectItemsFrom(collector, rootItemIndex,
+                    item.getObject("expandedShelfContentsRenderer").getArray("items"),
+                    channelVerifiedStatus, channelName, channelUrl);
         } else if (item.has("lockupViewModel")) {
             final JsonObject lockupViewModel = item.getObject("lockupViewModel");
             final String contentType = lockupViewModel.getString("contentType");
@@ -498,6 +535,52 @@ public boolean isUploaderVerified() throws ParsingException {
                 });
     }
 
+
+    private void commitRendererList(@Nonnull final MultiInfoItemsCollector collector,
+                                        final int itemIndex,
+                                        @Nonnull final JsonObject jsonObject,
+                                        @Nonnull final VerifiedStatus channelVerifiedStatus,
+                                        @Nullable final String channelName,
+                                        @Nullable final String channelUrl
+    ) {
+
+        String listItemsType = null;
+        if (jsonObject.getObject("content")
+                .getObject("horizontalListRenderer").getArray("items").getObject(0)
+                .has("gridChannelRenderer")) {
+            listItemsType = YoutubeShelfRendererListInfoItemExtractor.FEATURED_CHANNEL_LIST;
+        }
+
+        if (listItemsType != null) {
+            collector.commit(new YoutubeShelfRendererListInfoItemExtractor(jsonObject,
+                    itemIndex, listItemsType) {
+                @Override
+                public String getUploaderName() throws ParsingException {
+                    return isNullOrEmpty(channelName) ? super.getUploaderName() : channelName;
+                }
+
+                @Override
+                public String getUploaderUrl() throws ParsingException {
+                    return isNullOrEmpty(channelUrl) ? super.getUploaderUrl() : channelUrl;
+                }
+
+                @SuppressWarnings("DuplicatedCode")
+                @Override
+                public boolean isUploaderVerified() throws ParsingException {
+                    switch (channelVerifiedStatus) {
+                        case VERIFIED:
+                            return true;
+                        case UNVERIFIED:
+                            return false;
+                        default:
+                            return super.isUploaderVerified();
+                    }
+                }
+            });
+        }
+    }
+
+
     @Nullable
     private Page getNextPageFrom(final JsonObject continuations,
                                  final List<String> channelIds) throws IOException,
diff --git a/extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/extractors/YoutubeShelfRendererListInfoItemExtractor.java b/extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/extractors/YoutubeShelfRendererListInfoItemExtractor.java
@@ -0,0 +1,115 @@
+package org.schabi.newpipe.extractor.services.youtube.extractors;
+
+import static org.schabi.newpipe.extractor.services.youtube.YoutubeParsingHelper.getTextFromObject;
+import static org.schabi.newpipe.extractor.services.youtube.YoutubeParsingHelper.getUrlFromObject;
+
+import com.grack.nanojson.JsonObject;
+
+import org.schabi.newpipe.extractor.Image;
+import org.schabi.newpipe.extractor.channel.tabs.ChannelTabs;
+import org.schabi.newpipe.extractor.channel.tabs.rendererlist.RendererListInfoItemExtractor;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.services.youtube.linkHandler.YoutubeChannelTabLinkHandlerFactory;
+
+import java.util.List;
+
+import javax.annotation.Nonnull;
+
+public class YoutubeShelfRendererListInfoItemExtractor implements RendererListInfoItemExtractor {
+
+    public static final String FEATURED_CHANNEL_LIST = "FEATURED_CHANNELS_LIST";
+    private final JsonObject rendererListInfoItem;
+    private final int parentListIndex;
+
+    private final String rendererListItemType;
+
+    public YoutubeShelfRendererListInfoItemExtractor(final JsonObject rendererListInfoItem,
+            final int parentListIndex, final String rendererListItemType) {
+        this.rendererListInfoItem = rendererListInfoItem;
+        this.parentListIndex = parentListIndex;
+        this.rendererListItemType = rendererListItemType;
+    }
+
+
+    @Override
+    public String getName() throws ParsingException {
+        try {
+            final JsonObject title = this.rendererListInfoItem.getObject("title");
+            String name = getTextFromObject(title);
+
+            if (name == null && this.rendererListInfoItem.isString("title")) {
+                name = this.rendererListInfoItem.getString("title");
+            }
+
+            return name;
+        } catch (final Exception e) {
+            throw new ParsingException("Could not get name", e);
+        }
+    }
+
+    @Override
+    public String getUrl() throws ParsingException {
+        try {
+            final String url = getUrlFromObject(rendererListInfoItem.getObject("title"));
+
+            if (url == null) {
+                final String uploaderTabURL = getUploaderTabUrl();
+
+                if (uploaderTabURL != null) {
+                    return uploaderTabURL + "/rendererlist/" + parentListIndex; // virtual url
+                }
+            }
+
+            return url;
+        } catch (final Exception e) {
+            throw new ParsingException("Could not get uploader url", e);
+        }
+    }
+
+    @Nonnull
+    @Override
+    public List<Image> getThumbnails() throws ParsingException {
+        return List.of();
+    }
+
+    @Override
+    public int getParentListIndex() throws ParsingException {
+        return parentListIndex;
+    }
+
+    @Override
+    public String getRendererListItemType() throws ParsingException {
+        return this.rendererListItemType;
+    }
+
+    @Override
+    public String getUploaderTabUrl() throws ParsingException {
+        try {
+            final String uploaderUrl = getUploaderUrl();
+            if (uploaderUrl != null) {
+                return uploaderUrl
+                        + YoutubeChannelTabLinkHandlerFactory
+                                .getUrlSuffix(ChannelTabs.FEATURED);
+            }
+
+            return null;
+        } catch (final Exception e) {
+            throw new ParsingException("Could not get uploader url", e);
+        }
+    }
+
+    @Override
+    public String getUploaderName() throws ParsingException {
+        return null; // will not exist in rendererListInfoItem
+    }
+
+    @Override
+    public String getUploaderUrl() throws ParsingException {
+        return null; // will not exist in rendererListInfoItem
+    }
+
+    @Override
+    public boolean isUploaderVerified() throws ParsingException {
+        return false; // will not exist in rendererListInfoItem
+    }
+}
