[PeerTube] Fix test for like count

Number changed

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,3 @@
+- [ ] I carefully read the [contribution guidelines](https://github.com/TeamNewPipe/NewPipe/blob/HEAD/.github/CONTRIBUTING.md) and agree to them.
+- [ ] I have tested the API against [NewPipe](https://github.com/TeamNewPipe/NewPipe).
+- [ ] I agree to create a pull request for [NewPipe](https://github.com/TeamNewPipe/NewPipe) as soon as possible to make it compatible with the changed API.

.github/dependabot.yml

@@ -0,0 +1,12 @@
+version: 2
+updates:
+  # Maintain dependencies for Gradle
+  - package-ecosystem: "gradle"
+    directory: "/"
+    schedule:
+      interval: "daily"
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"

.github/workflows/ci.yml

@@ -0,0 +1,51 @@
+name: CI
+
+on:
+  schedule:
+      # once per day
+    - cron: 0 0 * * *
+  push:
+    branches:
+      - dev
+      - master
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: set up JDK 11
+        uses: actions/setup-java@v4
+        with:
+          java-version: '11'
+          distribution: 'temurin'
+
+      - name: Cache Gradle dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.gradle/caches
+          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }}
+          restore-keys: ${{ runner.os }}-gradle
+
+        # See gradle file for difference between downloaders
+      - name: Build and run Tests
+        run: |
+          if [[ "$GITHUB_EVENT_NAME" == 'schedule' ]]; then
+            echo running with real downloader
+            ./gradlew check --stacktrace -Ddownloader=REAL
+          else
+            echo running with mock downloader
+            ./gradlew check --stacktrace -Ddownloader=MOCK
+          fi
+
+      - name: Upload test reports when failure occurs
+        uses: actions/upload-artifact@v4
+        if: failure()
+        with:
+          name: NewPipeExtractor-test-reports
+          path: extractor/build/reports/tests/test/**

.github/workflows/docs.yml

@@ -0,0 +1,38 @@
+name: Build and deploy JavaDocs
+
+on:
+  push:
+    branches:
+      - master
+
+permissions:
+  # The generated docs are written to the `gh-pages` branch.
+  contents: write
+
+jobs:
+  build-and-deploy-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: set up JDK 11
+        uses: actions/setup-java@v4
+        with:
+          java-version: '11'
+          distribution: 'temurin'
+
+      - name: Cache Gradle dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.gradle/caches
+          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }}
+          restore-keys: ${{ runner.os }}-gradle
+
+      - name: Build JavaDocs
+        run: ./gradlew aggregatedJavadocs
+
+      - name: Deploy JavaDocs
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./build/docs

.gitignore

@@ -0,0 +1,26 @@
+.gradle
+build/
+.idea
+local.properties
+out/
+*.iml
+
+# Ignore Gradle GUI config
+gradle-app.setting
+
+# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)
+!gradle-wrapper.jar
+
+# Cache of project
+.gradletasknamecache
+
+# # Work around https://youtrack.jetbrains.com/issue/IDEA-116898
+# gradle/wrapper/gradle-wrapper.properties
+
+# vscode / eclipse files
+*.classpath
+*.project
+*.settings
+**/bin
+**.vscode
+*.code-workspace

AbstractStreamInfo.java

@@ -1,43 +0,0 @@
-package org.schabi.newpipe.extractor;
-
-/**
- * Copyright (C) Christian Schabesberger 2016 <chris.schabesberger@mailbox.org>
- * AbstractStreamInfo.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-import java.io.Serializable;
-
-/**Common properties between StreamInfo and StreamInfoItem.*/
-public abstract class AbstractStreamInfo implements Serializable{
-    public enum StreamType {
-        NONE,   // placeholder to check if stream type was checked or not
-        VIDEO_STREAM,
-        AUDIO_STREAM,
-        LIVE_STREAM,
-        AUDIO_LIVE_STREAM,
-        FILE
-    }
-
-    public StreamType stream_type;
-    public int service_id = -1;
-    public String id = "";
-    public String title = "";
-    public String uploader = "";
-    public String thumbnail_url = "";
-    public String webpage_url = "";
-    public String upload_date = "";
-    public long view_count = -1;
-}

DashMpdParser.java

@@ -1,93 +0,0 @@
-package org.schabi.newpipe.extractor;
-
-import org.schabi.newpipe.extractor.exceptions.ParsingException;
-import org.schabi.newpipe.extractor.exceptions.ReCaptchaException;
-import org.schabi.newpipe.extractor.stream_info.AudioStream;
-import org.w3c.dom.Document;
-import org.w3c.dom.Element;
-import org.w3c.dom.NodeList;
-
-import java.io.ByteArrayInputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.util.List;
-import java.util.Vector;
-
-import javax.xml.parsers.DocumentBuilder;
-import javax.xml.parsers.DocumentBuilderFactory;
-
-/**
- * Created by Christian Schabesberger on 02.02.16.
- *
- * Copyright (C) Christian Schabesberger 2016 <chris.schabesberger@mailbox.org>
- * DashMpdParser.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-public class DashMpdParser {
-
-    private DashMpdParser() {
-    }
-
-    static class DashMpdParsingException extends ParsingException {
-        DashMpdParsingException(String message, Exception e) {
-            super(message, e);
-        }
-    }
-
-    public static List<AudioStream> getAudioStreams(String dashManifestUrl)
-            throws DashMpdParsingException, ReCaptchaException {
-        String dashDoc;
-        Downloader downloader = NewPipe.getDownloader();
-        try {
-            dashDoc = downloader.download(dashManifestUrl);
-        } catch(IOException ioe) {
-            throw new DashMpdParsingException("Could not get dash mpd: " + dashManifestUrl, ioe);
-        } catch (ReCaptchaException e) {
-            throw new ReCaptchaException("reCaptcha Challenge needed");
-        }
-        Vector<AudioStream> audioStreams = new Vector<>();
-
-        try {
-            DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
-            DocumentBuilder builder = factory.newDocumentBuilder();
-            InputStream stream = new ByteArrayInputStream(dashDoc.getBytes());
-
-            Document doc = builder.parse(stream);
-            NodeList adaptationSetList = doc.getElementsByTagName("AdaptationSet");
-            for(int i = 0; i < adaptationSetList.getLength(); i++) {
-                Element adaptationSet = (Element) adaptationSetList.item(i);
-                String memeType = adaptationSet.getAttribute("mimeType");
-                if(memeType.contains("audio")) {
-                    Element representation = (Element) adaptationSet.getElementsByTagName("Representation").item(0);
-                    String url = representation.getElementsByTagName("BaseURL").item(0).getTextContent();
-                    int bandwidth = Integer.parseInt(representation.getAttribute("bandwidth"));
-                    int samplingRate = Integer.parseInt(representation.getAttribute("audioSamplingRate"));
-                    int format = -1;
-                    if(memeType.equals(MediaFormat.WEBMA.mimeType)) {
-                        format = MediaFormat.WEBMA.id;
-                    } else if(memeType.equals(MediaFormat.M4A.mimeType)) {
-                        format = MediaFormat.M4A.id;
-                    }
-                    audioStreams.add(new AudioStream(url, format, 0, bandwidth, samplingRate));
-                }
-            }
-        }
-        catch(Exception e) {
-            throw new DashMpdParsingException("Could not parse Dash mpd", e);
-        }
-        return audioStreams;
-    }
-}

Downloader.java

@@ -1,52 +0,0 @@
-package org.schabi.newpipe.extractor;
-
-import org.schabi.newpipe.extractor.exceptions.ReCaptchaException;
-
-import java.io.IOException;
-import java.util.Map;
-
-/**
- * Created by Christian Schabesberger on 28.01.16.
- *
- * Copyright (C) Christian Schabesberger 2016 <chris.schabesberger@mailbox.org>
- * Downloader.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-public interface Downloader {
-
-    /**Download the text file at the supplied URL as in download(String),
-     * but set the HTTP header field "Accept-Language" to the supplied string.
-     * @param siteUrl the URL of the text file to return the contents of
-     * @param language the language (usually a 2-character code) to set as the preferred language
-     * @return the contents of the specified text file
-     * @throws IOException*/
-    String download(String siteUrl, String language) throws IOException, ReCaptchaException;
-
-    /**Download the text file at the supplied URL as in download(String),
-     * but set the HTTP header field "Accept-Language" to the supplied string.
-     * @param siteUrl the URL of the text file to return the contents of
-     * @param customProperties set request header properties
-     * @return the contents of the specified text file
-     * @throws IOException*/
-    String download(String siteUrl, Map<String, String> customProperties) throws IOException, ReCaptchaException;
-
-    /**Download (via HTTP) the text file located at the supplied URL, and return its contents.
-     * Primarily intended for downloading web pages.
-     * @param siteUrl the URL of the text file to download
-     * @return the contents of the specified text file
-     * @throws IOException*/
-    String download(String siteUrl) throws IOException, ReCaptchaException;
-}

InfoItem.java

@@ -1,35 +0,0 @@
-package org.schabi.newpipe.extractor;
-
-import java.io.Serializable;
-
-/**
- * Created by the-scrabi on 11.02.17.
- *
- * Copyright (C) Christian Schabesberger 2017 <chris.schabesberger@mailbox.org>
- * InfoItem.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-public interface InfoItem extends Serializable{
-    enum InfoType {
-        STREAM,
-        PLAYLIST,
-        CHANNEL
-    }
-
-    InfoType infoType();
-    String getTitle();
-    String getLink();
-}

InfoItemCollector.java

@@ -1,61 +0,0 @@
-package org.schabi.newpipe.extractor;
-
-import org.schabi.newpipe.extractor.exceptions.ExtractionException;
-
-import java.util.List;
-import java.util.Vector;
-
-/**
- * Created by Christian Schabesberger on 12.02.17.
- *
- * Copyright (C) Christian Schabesberger 2017 <chris.schabesberger@mailbox.org>
- * InfoItemCollector.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-public class InfoItemCollector {
-    private List<InfoItem> itemList = new Vector<>();
-    private List<Throwable> errors = new Vector<>();
-    private int serviceId = -1;
-
-    public InfoItemCollector(int serviceId) {
-        this.serviceId = serviceId;
-    }
-
-    public List<InfoItem> getItemList() {
-        return itemList;
-    }
-    public List<Throwable> getErrors() {
-        return errors;
-    }
-    protected void addFromCollector(InfoItemCollector otherC) throws ExtractionException {
-        if(serviceId != otherC.serviceId) {
-            throw new ExtractionException("Service Id does not equal: "
-                    + NewPipe.getNameOfService(serviceId)
-                    + " and " + NewPipe.getNameOfService(otherC.serviceId));
-        }
-        errors.addAll(otherC.errors);
-        itemList.addAll(otherC.itemList);
-    }
-    protected void addError(Exception e) {
-        errors.add(e);
-    }
-    protected void addItem(InfoItem item) {
-        itemList.add(item);
-    }
-    protected int getServiceId() {
-        return serviceId;
-    }
-}

LICENSE

@@ -1,7 +1,7 @@
                     GNU GENERAL PUBLIC LICENSE
                        Version 3, 29 June 2007
 
- Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
  Everyone is permitted to copy and distribute verbatim copies
  of this license document, but changing it is not allowed.
 
@@ -645,7 +645,7 @@ the "copyright" line and a pointer to where the full notice is found.
     GNU General Public License for more details.
 
     You should have received a copy of the GNU General Public License
-    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
 Also add information on how to contact you by electronic and paper mail.
 
@@ -664,11 +664,11 @@ might be different; for a GUI interface, you would use an "about box".
   You should also get your employer (if you work as a programmer) or school,
 if any, to sign a "copyright disclaimer" for the program, if necessary.
 For more information on this, and how to apply and follow the GNU GPL, see
-<http://www.gnu.org/licenses/>.
+<https://www.gnu.org/licenses/>.
 
   The GNU General Public License does not permit incorporating your program
 into proprietary programs.  If your program is a subroutine library, you
 may consider it more useful to permit linking proprietary applications with
 the library.  If this is what you want to do, use the GNU Lesser General
 Public License instead of this License.  But first, please read
-<http://www.gnu.org/philosophy/why-not-lgpl.html>.
+<https://www.gnu.org/licenses/why-not-lgpl.html>.

MediaFormat.java

@@ -1,83 +0,0 @@
-package org.schabi.newpipe.extractor;
-
-/**
- * Created by Adam Howard on 08/11/15.
- *
- * Copyright (c) Christian Schabesberger <chris.schabesberger@mailbox.org>
- *     and Adam Howard <achdisposable1@gmail.com> 2015
- *
- * MediaFormat.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-/**Static data about various media formats support by Newpipe, eg mime type, extension*/
-
-public enum MediaFormat {
-    //video and audio combined formats
-    //           id      name    suffix  mime type
-    MPEG_4      (0x0,   "MPEG-4", "mp4", "video/mp4"),
-    v3GPP       (0x1,   "3GPP",   "3gp", "video/3gpp"),
-    WEBM        (0x2,   "WebM",  "webm", "video/webm"),
-    // audio formats
-    M4A         (0x3,   "m4a",   "m4a",  "audio/mp4"),
-    WEBMA       (0x4,   "WebM",  "webm", "audio/webm");
-
-    public final int id;
-    @SuppressWarnings("WeakerAccess")
-    public final String name;
-    @SuppressWarnings("WeakerAccess")
-    public final String suffix;
-    public final String mimeType;
-
-    MediaFormat(int id, String name, String suffix, String mimeType) {
-        this.id = id;
-        this.name = name;
-        this.suffix = suffix;
-        this.mimeType = mimeType;
-    }
-
-    /**Return the friendly name of the media format with the supplied id
-     * @param ident the id of the media format. Currently an arbitrary, NewPipe-specific number.
-     * @return the friendly name of the MediaFormat associated with this ids,
-     * or an empty String if none match it.*/
-    public static String getNameById(int ident) {
-        for (MediaFormat vf : MediaFormat.values()) {
-            if(vf.id == ident) return vf.name;
-        }
-        return "";
-    }
-
-    /**Return the file extension of the media format with the supplied id
-     * @param ident the id of the media format. Currently an arbitrary, NewPipe-specific number.
-     * @return the file extension of the MediaFormat associated with this ids,
-     * or an empty String if none match it.*/
-    public static String getSuffixById(int ident) {
-        for (MediaFormat vf : MediaFormat.values()) {
-            if(vf.id == ident) return vf.suffix;
-        }
-        return "";
-    }
-
-    /**Return the MIME type of the media format with the supplied id
-     * @param ident the id of the media format. Currently an arbitrary, NewPipe-specific number.
-     * @return the MIME type of the MediaFormat associated with this ids,
-     * or an empty String if none match it.*/
-    public static String getMimeById(int ident) {
-        for (MediaFormat vf : MediaFormat.values()) {
-            if(vf.id == ident) return vf.mimeType;
-        }
-        return "";
-    }
-}

NewPipe.java

@@ -1,88 +0,0 @@
-package org.schabi.newpipe.extractor;
-
-import org.schabi.newpipe.extractor.exceptions.ExtractionException;
-import org.schabi.newpipe.extractor.services.youtube.YoutubeService;
-
-/**
- * Created by Christian Schabesberger on 23.08.15.
- *
- * Copyright (C) Christian Schabesberger 2015 <chris.schabesberger@mailbox.org>
- * NewPipe.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-/**Provides access to the video streaming services supported by NewPipe.
- * Currently only Youtube until the API becomes more stable.*/
-
-@SuppressWarnings("ALL")
-public class NewPipe {
-
-    private NewPipe() {
-    }
-
-    private static final String TAG = NewPipe.class.toString();
-
-
-    private static Downloader downloader = null;
-
-    public static StreamingService[] getServices() {
-        return ServiceList.serviceList;
-    }
-    public static StreamingService getService(int serviceId)throws ExtractionException {
-        for(StreamingService s : ServiceList.serviceList) {
-            if(s.getServiceId() == serviceId) {
-                return s;
-            }
-        }
-        return null;
-    }
-    public static StreamingService getService(String serviceName) throws ExtractionException {
-        return ServiceList.serviceList[getIdOfService(serviceName)];
-    }
-    public static String getNameOfService(int id) {
-        try {
-            return getService(id).getServiceInfo().name;
-        } catch (Exception e) {
-            System.err.println("Service id not known");
-            e.printStackTrace();
-            return "";
-        }
-    }
-    public static int getIdOfService(String serviceName) {
-        for(int i = 0; i < ServiceList.serviceList.length; i++) {
-            if(ServiceList.serviceList[i].getServiceInfo().name.equals(serviceName)) {
-                return i;
-            }
-        }
-        return -1;
-    }
-
-    public static void init(Downloader d) {
-        downloader = d;
-    }
-
-    public static Downloader getDownloader() {
-        return downloader;
-    }
-
-    public static StreamingService getServiceByUrl(String url) {
-        for(StreamingService s : ServiceList.serviceList) {
-            if(s.getLinkTypeByUrl(url) != StreamingService.LinkType.NONE) {
-                return s;
-            }
-        }
-        return null;
-    }
-}

Parser.java

@@ -1,77 +0,0 @@
-package org.schabi.newpipe.extractor;
-
-import org.schabi.newpipe.extractor.exceptions.ParsingException;
-
-import java.io.UnsupportedEncodingException;
-import java.net.URLDecoder;
-import java.util.HashMap;
-import java.util.Map;
-import java.util.regex.Matcher;
-import java.util.regex.Pattern;
-
-/**
- * Created by Christian Schabesberger on 02.02.16.
- *
- * Copyright (C) Christian Schabesberger 2016 <chris.schabesberger@mailbox.org>
- * Parser.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-/** avoid using regex !!! */
-public class Parser {
-
-    private Parser() {
-    }
-
-    public static class RegexException extends ParsingException {
-        public RegexException(String message) {
-            super(message);
-        }
-    }
-
-    public static String matchGroup1(String pattern, String input) throws RegexException {
-        return matchGroup(pattern, input, 1);
-    }
-
-    public static String matchGroup(String pattern, String input, int group) throws RegexException {
-        Pattern pat = Pattern.compile(pattern);
-        Matcher mat = pat.matcher(input);
-        boolean foundMatch = mat.find();
-        if (foundMatch) {
-            return mat.group(group);
-        }
-        else {
-            //Log.e(TAG, "failed to find pattern \""+pattern+"\" inside of \""+input+"\"");
-            if(input.length() > 1024) {
-                throw new RegexException("failed to find pattern \""+pattern);
-            } else {
-                throw new RegexException("failed to find pattern \"" + pattern + " inside of " + input + "\"");
-            }
-        }
-    }
-
-    public static Map<String, String> compatParseMap(final String input) throws UnsupportedEncodingException {
-        Map<String, String> map = new HashMap<>();
-        for(String arg : input.split("&")) {
-            String[] splitArg = arg.split("=");
-            if(splitArg.length > 1) {
-                map.put(splitArg[0], URLDecoder.decode(splitArg[1], "UTF-8"));
-            } else {
-                map.put(splitArg[0], "");
-            }
-        }
-        return map;
-    }
-}

README.md

@@ -1,7 +1,65 @@
-NewPipe Extractor
-=================
+# NewPipe Extractor
 
-This is the system independent core of [NewPipe](https://github.com/TeamNewPipe/NewPipe).
-It can be used to create your own java based NewPipe client.
+[![CI](https://github.com/TeamNewPipe/NewPipeExtractor/actions/workflows/ci.yml/badge.svg?branch=dev&event=schedule)](https://github.com/TeamNewPipe/NewPipeExtractor/actions/workflows/ci.yml) [![JIT Pack Badge](https://jitpack.io/v/TeamNewPipe/NewPipeExtractor.svg)](https://jitpack.io/#TeamNewPipe/NewPipeExtractor) [JDoc](https://teamnewpipe.github.io/NewPipeExtractor/javadoc/) • [Documentation](https://teamnewpipe.github.io/documentation/)
 
-A small exmaple showing how this extractor can be used can be found [here](https://github.com/TeamNewPipe/np-cli).
+NewPipe Extractor is a library for extracting things from streaming sites. It is a core component of [NewPipe](https://github.com/TeamNewPipe/NewPipe), but could be used independently.
+
+## Usage
+
+NewPipe Extractor is available at JitPack's Maven repo.
+
+If you're using Gradle, you could add NewPipe Extractor as a dependency with the following steps:
+
+1. Add `maven { url 'https://jitpack.io' }` to the `repositories` in your `build.gradle`.
+2. Add `implementation 'com.github.TeamNewPipe:NewPipeExtractor:INSERT_VERSION_HERE'` to the `dependencies` in your `build.gradle`. Replace `INSERT_VERSION_HERE` with the [latest release](https://github.com/TeamNewPipe/NewPipeExtractor/releases/latest).
+3. If you are using tools to minimize your project, make sure to keep the files below, by e.g. adding the following lines to your proguard file:
+ ```
+## Rules for NewPipeExtractor
+-keep class org.schabi.newpipe.extractor.timeago.patterns.** { *; }
+-keep class org.mozilla.javascript.** { *; }
+-keep class org.mozilla.classfile.ClassFileWriter
+-dontwarn org.mozilla.javascript.tools.**
+```
+
+**Note:** To use NewPipe Extractor in Android projects with a `minSdk` below 26, [API desugaring](https://developer.android.com/studio/write/java8-support#library-desugaring) is required. If the `minSdk` is below 19, the `desugar_jdk_libs_nio` artifact is required, which requires Android Gradle Plugin (AGP) version 7.4.0.
+
+### Testing changes
+
+To test changes quickly you can build the library locally. A good approach would be to add something like the following to your `settings.gradle`:
+
+```groovy
+includeBuild('../NewPipeExtractor') {
+    dependencySubstitution {
+        substitute module('com.github.TeamNewPipe:NewPipeExtractor') with project(':extractor')
+    }
+}
+```
+
+Another approach would be to use the local Maven repository, here's a gist of how to use it:
+
+1. Add `mavenLocal()` in your project `repositories` list (usually as the first entry to give priority above the others).
+2. It's _recommended_ that you change the `version` of this library (e.g. `LOCAL_SNAPSHOT`).
+3. Run gradle's `ìnstall` task to deploy this library to your local repository (using the wrapper, present in the root of this project: `./gradlew install`)
+4. Change the dependency version used in your project to match the one you chose in step 2 (`implementation 'com.github.TeamNewPipe:NewPipeExtractor:LOCAL_SNAPSHOT'`)
+
+> Tip for Android Studio users: After you make changes and run the `install` task, use the menu option `File → "Sync with File System"` to refresh the library in your project.
+
+## Supported sites
+
+The following sites are currently supported:
+
+- YouTube
+- SoundCloud
+- media.ccc.de
+- PeerTube (no P2P)
+- Bandcamp
+
+## License
+
+[![GNU GPLv3 Image](https://www.gnu.org/graphics/gplv3-127x51.png)](https://www.gnu.org/licenses/gpl-3.0.en.html)  
+
+NewPipe Extractor is Free Software: You can use, study share and improve it at your
+will. Specifically you can redistribute and/or modify it under the terms of the
+[GNU General Public License](https://www.gnu.org/licenses/gpl.html) as
+published by the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.  

ServiceList.java

@@ -1,13 +0,0 @@
-package org.schabi.newpipe.extractor;
-
-import org.schabi.newpipe.extractor.services.youtube.YoutubeService;
-
-/**
- * Created by the-scrabi on 18.02.17.
- */
-
-class ServiceList {
-    public static final StreamingService[] serviceList = {
-            new YoutubeService(0)
-    };
-}

StreamingService.java

@@ -1,85 +0,0 @@
-package org.schabi.newpipe.extractor;
-
-import org.schabi.newpipe.extractor.channel.ChannelExtractor;
-import org.schabi.newpipe.extractor.exceptions.ExtractionException;
-import org.schabi.newpipe.extractor.playlist.PlayListExtractor;
-import org.schabi.newpipe.extractor.search.SearchEngine;
-import org.schabi.newpipe.extractor.stream_info.StreamExtractor;
-
-import java.io.IOException;
-
-/**
- * Created by Christian Schabesberger on 23.08.15.
- *
- * Copyright (C) Christian Schabesberger 2016 <chris.schabesberger@mailbox.org>
- * StreamingService.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-public abstract class StreamingService {
-    public class ServiceInfo {
-        public String name = "";
-    }
-
-    public enum LinkType {
-        NONE,
-        STREAM,
-        CHANNEL,
-        PLAYLIST
-    }
-
-    private int serviceId;
-
-    public StreamingService(int id) {
-        serviceId = id;
-    }
-
-    public abstract ServiceInfo getServiceInfo();
-
-    public abstract StreamExtractor getExtractorInstance(String url)
-            throws IOException, ExtractionException;
-    public abstract SearchEngine getSearchEngineInstance();
-    public abstract UrlIdHandler getStreamUrlIdHandlerInstance();
-    public abstract UrlIdHandler getChannelUrlIdHandlerInstance();
-    public abstract UrlIdHandler getPlayListUrlIdHandlerInstance();
-    public abstract ChannelExtractor getChannelExtractorInstance(String url, int page)
-            throws ExtractionException, IOException;
-    public abstract PlayListExtractor getPlayListExtractorInstance(String url, int page)
-            throws ExtractionException, IOException;
-    public abstract SuggestionExtractor getSuggestionExtractorInstance();
-
-    public final int getServiceId() {
-        return serviceId;
-    }
-
-    /**
-     * figure out where the link is pointing to (a channel, video, playlist, etc.)
-     */
-    public final LinkType getLinkTypeByUrl(String url) {
-        UrlIdHandler sH = getStreamUrlIdHandlerInstance();
-        UrlIdHandler cH = getChannelUrlIdHandlerInstance();
-        UrlIdHandler pH = getPlayListUrlIdHandlerInstance();
-
-        if(sH.acceptUrl(url)) {
-            return LinkType.STREAM;
-        } else if(cH.acceptUrl(url)) {
-            return LinkType.CHANNEL;
-        } else if (pH.acceptUrl(url)) {
-            return LinkType.PLAYLIST;
-        } else {
-            return LinkType.NONE;
-        }
-    }
-}

SuggestionExtractor.java

@@ -1,43 +0,0 @@
-package org.schabi.newpipe.extractor;
-
-import org.schabi.newpipe.extractor.exceptions.ExtractionException;
-
-import java.io.IOException;
-import java.util.List;
-
-/**
- * Created by Christian Schabesberger on 28.09.16.
- *
- * Copyright (C) Christian Schabesberger 2016 <chris.schabesberger@mailbox.org>
- * SuggestionExtractor.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-public abstract class SuggestionExtractor {
-
-    private int serviceId;
-
-    public SuggestionExtractor(int serviceId) {
-        this.serviceId = serviceId;
-    }
-
-    public abstract List<String> suggestionList(
-            String query,String contentCountry)
-            throws ExtractionException, IOException;
-
-    public int getServiceId() {
-        return serviceId;
-    }
-}

UrlIdHandler.java

@@ -1,35 +0,0 @@
-package org.schabi.newpipe.extractor;
-
-import org.schabi.newpipe.extractor.exceptions.ParsingException;
-
-/**
- * Created by Christian Schabesberger on 26.07.16.
- *
- * Copyright (C) Christian Schabesberger 2016 <chris.schabesberger@mailbox.org>
- * UrlIdHandler.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-public interface UrlIdHandler {
-
-    String getUrl(String videoId);
-    String getId(String siteUrl) throws ParsingException;
-    String cleanUrl(String siteUrl) throws ParsingException;
-
-    /**When a VIEW_ACTION is caught this function will test if the url delivered within the calling
-     Intent was meant to be watched with this Service.
-     Return false if this service shall not allow to be called through ACTIONs.*/
-    boolean acceptUrl(String videoUrl);
-}

build.gradle

@@ -0,0 +1,83 @@
+allprojects {
+    apply plugin: 'java-library'
+    apply plugin: 'maven-publish'
+
+    compileJava.options.encoding = 'UTF-8'
+    compileTestJava.options.encoding = 'UTF-8'
+
+    sourceCompatibility = JavaVersion.VERSION_11
+    targetCompatibility = JavaVersion.VERSION_11
+
+    version 'v0.24.0'
+    group 'com.github.TeamNewPipe'
+
+    repositories {
+        mavenCentral()
+        maven { url "https://jitpack.io" }
+    }
+
+    afterEvaluate {
+        publishing {
+            publications {
+                mavenJava(MavenPublication) {
+                    from components.java
+                }
+            }
+        }
+    }
+
+    ext {
+        nanojsonVersion = "1d9e1aea9049fc9f85e68b43ba39fe7be1c1f751"
+        spotbugsVersion = "4.8.5"
+        junitVersion = "5.10.2"
+        checkstyleVersion = "10.4"
+    }
+}
+
+dependencies {
+    api project(':extractor')
+    implementation project(':timeago-parser')
+}
+
+subprojects {
+    task sourcesJar(type: Jar, dependsOn: classes) {
+        archiveClassifier.set('sources')
+        from sourceSets.main.allSource
+    }
+
+    tasks.withType(Test) {
+        testLogging {
+            events "skipped", "failed"
+            showStandardStreams = true
+            exceptionFormat = 'full'
+        }
+    }
+
+    artifacts {
+        archives sourcesJar
+    }
+}
+
+// https://discuss.gradle.org/t/best-approach-gradle-multi-module-project-generate-just-one-global-javadoc/18657/21
+task aggregatedJavadocs(type: Javadoc, group: 'Documentation') {
+    destinationDir = file("$buildDir/docs/javadoc")
+    title = "$project.name $version"
+    // options.memberLevel = JavadocMemberLevel.PRIVATE
+    options.links 'https://docs.oracle.com/javase/8/docs/api/'
+    options.encoding 'UTF-8'
+    // Fixes unknown tag @implNote; the other two were added precautionary
+    options.tags = [
+            "apiNote:a:API Note:",
+            "implSpec:a:Implementation Requirements:",
+            "implNote:a:Implementation Note:"
+    ]
+
+    subprojects.each { project ->
+        project.tasks.withType(Javadoc).each { javadocTask ->
+            source += javadocTask.source
+            classpath += javadocTask.classpath
+            excludes += javadocTask.excludes
+            includes += javadocTask.includes
+        }
+    }
+}

channel/ChannelExtractor.java

@@ -1,62 +0,0 @@
-package org.schabi.newpipe.extractor.channel;
-
-import org.schabi.newpipe.extractor.UrlIdHandler;
-import org.schabi.newpipe.extractor.exceptions.ExtractionException;
-import org.schabi.newpipe.extractor.exceptions.ParsingException;
-import org.schabi.newpipe.extractor.stream_info.StreamInfoItemCollector;
-
-import java.io.IOException;
-
-/**
- * Created by Christian Schabesberger on 25.07.16.
- *
- * Copyright (C) Christian Schabesberger 2016 <chris.schabesberger@mailbox.org>
- * ChannelExtractor.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-public abstract class ChannelExtractor {
-    private int serviceId;
-    private String url;
-    private UrlIdHandler urlIdHandler;
-    private StreamInfoItemCollector previewInfoCollector;
-    private int page = -1;
-
-    public ChannelExtractor(UrlIdHandler urlIdHandler, String url, int page, int serviceId)
-            throws ExtractionException, IOException {
-        this.url = url;
-        this.page = page;
-        this.serviceId = serviceId;
-        this.urlIdHandler = urlIdHandler;
-        previewInfoCollector = new StreamInfoItemCollector(urlIdHandler, serviceId);
-    }
-
-    public String getUrl() { return url; }
-    public UrlIdHandler getUrlIdHandler() { return urlIdHandler; }
-    public StreamInfoItemCollector getStreamPreviewInfoCollector() {
-        return previewInfoCollector;
-    }
-
-    public abstract String getChannelName() throws ParsingException;
-    public abstract String getAvatarUrl() throws ParsingException;
-    public abstract String getBannerUrl() throws ParsingException;
-    public abstract String getFeedUrl() throws ParsingException;
-    public abstract StreamInfoItemCollector getStreams() throws ParsingException;
-    public abstract long getSubscriberCount() throws ParsingException;
-    public abstract boolean hasNextPage() throws ParsingException;
-    public int getServiceId() {
-        return serviceId;
-    }
-}

channel/ChannelInfo.java

@@ -1,86 +0,0 @@
-package org.schabi.newpipe.extractor.channel;
-
-import org.schabi.newpipe.extractor.InfoItem;
-import org.schabi.newpipe.extractor.exceptions.ParsingException;
-import org.schabi.newpipe.extractor.stream_info.StreamInfoItemCollector;
-
-import java.io.Serializable;
-import java.util.List;
-import java.util.Vector;
-
-/**
- * Created by Christian Schabesberger on 31.07.16.
- *
- * Copyright (C) Christian Schabesberger 2016 <chris.schabesberger@mailbox.org>
- * ChannelInfo.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-public class ChannelInfo implements Serializable{
-    public void addException(Exception e) {
-        errors.add(e);
-    }
-
-    public static ChannelInfo getInfo(ChannelExtractor extractor)
-        throws ParsingException {
-        ChannelInfo info = new ChannelInfo();
-
-        // importand data
-        info.service_id = extractor.getServiceId();
-        info.channel_name = extractor.getChannelName();
-        info.hasNextPage = extractor.hasNextPage();
-
-        try {
-            info.avatar_url = extractor.getAvatarUrl();
-        } catch (Exception e) {
-            info.errors.add(e);
-        }
-        try {
-            info.banner_url = extractor.getBannerUrl();
-        } catch (Exception e) {
-            info.errors.add(e);
-        }
-        try {
-            info.feed_url = extractor.getFeedUrl();
-        } catch(Exception e) {
-            info.errors.add(e);
-        }
-        try {
-            StreamInfoItemCollector c = extractor.getStreams();
-            info.related_streams = c.getItemList();
-            info.errors.addAll(c.getErrors());
-        } catch(Exception e) {
-            info.errors.add(e);
-        }
-        try {
-            info.subscriberCount = extractor.getSubscriberCount();
-        } catch (Exception e) {
-            info.errors.add(e);
-        }
-
-        return info;
-    }
-
-    public int service_id = -1;
-    public String channel_name = "";
-    public String avatar_url = "";
-    public String banner_url = "";
-    public String feed_url = "";
-    public List<InfoItem> related_streams = null;
-    public long subscriberCount = -1;
-    public boolean hasNextPage = false;
-
-    public List<Throwable> errors = new Vector<>();
-}

channel/ChannelInfoItem.java

@@ -1,44 +0,0 @@
-package org.schabi.newpipe.extractor.channel;
-
-import org.schabi.newpipe.extractor.InfoItem;
-
-/**
- * Created by Christian Schabesberger on 11.02.17.
- *
- * Copyright (C) Christian Schabesberger 2017 <chris.schabesberger@mailbox.org>
- * ChannelInfoItem.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-public class ChannelInfoItem implements InfoItem {
-
-    public int serviceId = -1;
-    public String channelName = "";
-    public String thumbnailUrl = "";
-    public String webPageUrl = "";
-    public String description = "";
-    public long subscriberCount = -1;
-    public int videoAmount = -1;
-
-    public InfoType infoType() {
-        return InfoType.CHANNEL;
-    }
-    public String getTitle() {
-        return channelName;
-    }
-    public String getLink() {
-        return webPageUrl;
-    }
-}

channel/ChannelInfoItemCollector.java

@@ -1,74 +0,0 @@
-package org.schabi.newpipe.extractor.channel;
-
-import org.schabi.newpipe.extractor.InfoItemCollector;
-import org.schabi.newpipe.extractor.NewPipe;
-import org.schabi.newpipe.extractor.exceptions.FoundAdException;
-import org.schabi.newpipe.extractor.exceptions.ParsingException;
-import org.schabi.newpipe.extractor.stream_info.StreamInfoItem;
-import org.schabi.newpipe.extractor.stream_info.StreamInfoItemExtractor;
-
-/**
- * Created by Christian Schabesberger on 12.02.17.
- *
- * Copyright (C) Christian Schabesberger 2017 <chris.schabesberger@mailbox.org>
- * ChannelInfoItemCollector.java is part of NewPipe.
- *
- * NewPipe is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * NewPipe is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
- */
-
-public class ChannelInfoItemCollector extends InfoItemCollector {
-    public ChannelInfoItemCollector(int serviceId) {
-        super(serviceId);
-    }
-
-    public ChannelInfoItem extract(ChannelInfoItemExtractor extractor) throws ParsingException {
-        ChannelInfoItem resultItem = new ChannelInfoItem();
-        // importand information
-        resultItem.channelName = extractor.getChannelName();
-
-        resultItem.serviceId = getServiceId();
-        resultItem.webPageUrl = extractor.getWebPageUrl();
-
-        // optional information
-        try {
-            resultItem.subscriberCount = extractor.getSubscriberCount();
-        } catch (Exception e) {
-            addError(e);
-        }
-        try {
-            resultItem.videoAmount = extractor.getVideoAmount();
-        } catch (Exception e) {
-            addError(e);
-        }
-        try {
-            resultItem.thumbnailUrl = extractor.getThumbnailUrl();
-        } catch (Exception e) {
-            addError(e);
-        }
-        try {
-            resultItem.description = extractor.getDescription();
-        } catch (Exception e) {
-            addError(e);
-        }
-        return resultItem;
-    }
-
-    public void commit(ChannelInfoItemExtractor extractor) throws ParsingException {
-        try {
-            addItem(extract(extractor));
-        } catch (Exception e) {
-            addError(e);
-        }
-    }
-}

checkstyle/checkstyle.xml

@@ -0,0 +1,195 @@
+<?xml version="1.0"?>
+<!DOCTYPE module PUBLIC
+          "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
+          "https://checkstyle.org/dtds/configuration_1_3.dtd">
+<module name="Checker">
+    <!--
+        If you set the basedir property below, then all reported file
+        names will be relative to the specified directory. See
+        https://checkstyle.org/5.x/config.html#Checker
+
+        <property name="basedir" value="${basedir}"/>
+    -->
+    <property name="severity" value="error"/>
+
+    <property name="fileExtensions" value="java, properties, xml"/>
+
+    <!-- Excludes all 'module-info.java' files              -->
+    <!-- See https://checkstyle.org/config_filefilters.html -->
+    <module name="BeforeExecutionExclusionFileFilter">
+        <property name="fileNamePattern" value="module\-info\.java$"/>
+    </module>
+
+    <!-- Checks that a package-info.java file exists for each package.     -->
+    <!-- See https://checkstyle.org/config_javadoc.html#JavadocPackage -->
+    <!--<module name="JavadocPackage"/>-->
+
+    <!-- Checks whether files end with a new line.                        -->
+    <!-- See https://checkstyle.org/config_misc.html#NewlineAtEndOfFile -->
+    <module name="NewlineAtEndOfFile"/>
+
+    <!-- Checks that property files contain the same keys.         -->
+    <!-- See https://checkstyle.org/config_misc.html#Translation -->
+    <module name="Translation"/>
+
+    <!-- Checks for Size Violations.                    -->
+    <!-- See https://checkstyle.org/config_sizes.html -->
+    <module name="FileLength"/>
+    <module name="LineLength">
+      <property name="max" value="100"/>
+      <property name="fileExtensions" value="java"/>
+        <!-- Also allow links in javadocs to be longer (the default would just cover imports) -->
+        <property name="ignorePattern" value="^((package|import) .*)|( *\* (@see )?&lt;a href ?\= ?&quot;.*&quot;&gt;)$"/>
+    </module>
+
+    <!-- Checks for whitespace                               -->
+    <!-- See https://checkstyle.org/config_whitespace.html -->
+    <module name="FileTabCharacter"/>
+
+    <!-- Miscellaneous other checks.                   -->
+    <!-- See https://checkstyle.org/config_misc.html -->
+    <module name="RegexpSingleline">
+       <property name="format" value="\s+$"/>
+       <property name="minimum" value="0"/>
+       <property name="maximum" value="0"/>
+       <property name="message" value="Line has trailing spaces."/>
+    </module>
+
+    <!-- Checks for Headers                                -->
+    <!-- See https://checkstyle.org/config_header.html   -->
+    <!-- <module name="Header"> -->
+    <!--   <property name="headerFile" value="${checkstyle.header.file}"/> -->
+    <!--   <property name="fileExtensions" value="java"/> -->
+    <!-- </module> -->
+
+    <module name="SuppressWarningsFilter" />
+
+    <module name="SuppressWithPlainTextCommentFilter"/>
+
+    <module name="TreeWalker">
+        <!-- Checks for Javadoc comments.                     -->
+        <!-- See https://checkstyle.org/config_javadoc.html -->
+        <module name="InvalidJavadocPosition"/>
+        <module name="JavadocMethod">
+            <property name="allowMissingParamTags" value="true"/>
+            <property name="allowMissingReturnTag" value="true"/>
+        </module>
+        <module name="JavadocType"/>
+        <!--<module name="JavadocVariable"/>-->
+        <module name="JavadocStyle">
+            <property name="checkFirstSentence" value="false"/>
+        </module>
+        <!--<module name="MissingJavadocMethod"/>-->
+
+        <!-- Checks for Naming Conventions.                  -->
+        <!-- See https://checkstyle.org/config_naming.html -->
+        <module name="ConstantName"/>
+        <module name="LocalFinalVariableName"/>
+        <module name="LocalVariableName"/>
+        <module name="MemberName">
+            <property name="format" value="^(TAG|DEBUG|[a-z][a-zA-Z0-9]*)$"/>
+        </module>
+        <module name="MethodName"/>
+        <module name="PackageName"/>
+        <module name="ParameterName"/>
+        <module name="StaticVariableName"/>
+        <module name="TypeName"/>
+
+        <!-- Checks for imports                              -->
+        <!-- See https://checkstyle.org/config_import.html -->
+        <module name="AvoidStarImport"/>
+        <module name="IllegalImport"> <!-- defaults to sun.* packages -->
+            <property name="illegalClasses" value="
+                org.jetbrains.annotations.Nullable,
+                org.jetbrains.annotations.NotNull,
+                androidx.annotation.Nullable,
+                androidx.annotation.NonNull,
+                io.reactivex.rxjava3.annotations.NonNull,
+                io.reactivex.rxjava3.annotations.Nullable" />
+        </module>
+        <module name="RedundantImport"/>
+        <module name="UnusedImports"/>
+
+        <!-- Checks for Size Violations.                    -->
+        <!-- See https://checkstyle.org/config_sizes.html -->
+        <module name="MethodLength">
+            <property name="severity" value="warning"/>
+        </module>
+        <module name="ParameterNumber">
+            <property name="severity" value="warning"/>
+        </module>
+
+        <!-- Checks for whitespace                               -->
+        <!-- See https://checkstyle.org/config_whitespace.html -->
+        <module name="EmptyForIteratorPad"/>
+        <module name="GenericWhitespace"/>
+        <module name="MethodParamPad"/>
+        <module name="NoWhitespaceAfter"/>
+        <module name="NoWhitespaceBefore"/>
+        <module name="OperatorWrap"/>
+        <module name="ParenPad"/>
+        <module name="TypecastParenPad"/>
+        <module name="WhitespaceAfter"/>
+        <module name="WhitespaceAround"/>
+
+        <!-- Modifier Checks                                    -->
+        <!-- See https://checkstyle.org/config_modifiers.html -->
+        <module name="ModifierOrder"/>
+        <module name="RedundantModifier"/>
+
+        <!-- Checks for blocks. You know, those {}'s         -->
+        <!-- See https://checkstyle.org/config_blocks.html -->
+        <module name="AvoidNestedBlocks"/>
+        <module name="EmptyBlock"/>
+        <module name="LeftCurly"/>
+        <module name="NeedBraces"/>
+        <module name="RightCurly"/>
+
+        <!-- Checks for common coding problems               -->
+        <!-- See https://checkstyle.org/config_coding.html -->
+        <module name="EmptyStatement"/>
+        <module name="EqualsHashCode">
+            <property name="severity" value="warning"/>
+        </module>
+        <module name="HiddenField">
+            <property name="ignoreConstructorParameter" value="true"/>
+            <property name="ignoreSetter" value="true"/>
+        </module>
+        <module name="IllegalInstantiation"/>
+        <module name="InnerAssignment"/>
+        <!--<module name="MagicNumber"/>-->
+        <!--<module name="MissingSwitchDefault">
+            <property name="severity" value="warning"/>
+        </module>-->
+        <module name="MultipleVariableDeclarations"/>
+        <module name="SimplifyBooleanExpression"/>
+        <module name="SimplifyBooleanReturn"/>
+        <module name="FinalLocalVariable">
+            <property name="tokens" value="VARIABLE_DEF,PARAMETER_DEF"/>
+            <property name="validateEnhancedForLoopVariable" value="true"/>
+        </module>
+
+        <!-- Checks for class design                         -->
+        <!-- See https://checkstyle.org/config_design.html -->
+        <!--<module name="DesignForExtension"/>-->
+        <module name="FinalClass"/>
+        <module name="HideUtilityClassConstructor"/>
+        <module name="InterfaceIsType"/>
+        <!--<module name="VisibilityModifier">
+            <property name="ignoreAnnotationCanonicalNames" value="State,ColumnInfo"/>
+            <property name="severity" value="warning"/>
+        </module>-->
+
+        <!-- Miscellaneous other checks.                   -->
+        <!-- See https://checkstyle.org/config_misc.html -->
+        <module name="ArrayTypeStyle"/>
+        <module name="FinalParameters"/>
+        <!--<module name="TodoComment">
+            <property name="format" value="(TODO:|FIXME:)"/>
+            <property name="severity" value="warning"/>
+        </module>-->
+        <module name="UpperEll"/>
+
+        <module name="SuppressWarningsHolder" />
+    </module>
+</module>

copyright

@@ -1,15 +0,0 @@
-Copyright: 2017 Christian Schabesberger <chris.schabesberger@mailbox.com>
-
-License: GPL-3.0+
- This program is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation, either version 3 of the License, or
- (at your option) any later version.
- 
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
- 
- You should have received a copy of the GNU General Public License
- along with this program. If not, see <http://www.gnu.org/licenses/>.

extractor/build.gradle

@@ -0,0 +1,45 @@
+plugins {
+    id 'checkstyle'
+}
+
+test {
+    // Pass on downloader type to tests for different CI jobs. See DownloaderFactory.java and ci.yml
+    if (System.properties.containsKey('downloader')) {
+        systemProperty('downloader', System.getProperty('downloader'))
+    }
+    useJUnitPlatform()
+    dependsOn checkstyleMain // run checkstyle when testing
+}
+
+checkstyle {
+    getConfigDirectory().set(rootProject.file("checkstyle"))
+    ignoreFailures false
+    showViolations true
+    toolVersion checkstyleVersion
+}
+
+checkstyleTest {
+    enabled false // do not checkstyle test files
+}
+
+dependencies {
+    implementation project(':timeago-parser')
+
+    implementation "com.github.TeamNewPipe:nanojson:$nanojsonVersion"
+    implementation 'org.jsoup:jsoup:1.17.2'
+    implementation "com.github.spotbugs:spotbugs-annotations:$spotbugsVersion"
+
+    // do not upgrade to 1.7.14, since in 1.7.14 Rhino uses the `SourceVersion` class, which is not
+    // available on Android (even when using desugaring), and `NoClassDefFoundError` is thrown
+    implementation 'org.mozilla:rhino:1.7.15'
+
+    checkstyle "com.puppycrawl.tools:checkstyle:$checkstyleVersion"
+
+    testImplementation platform("org.junit:junit-bom:$junitVersion")
+    testImplementation 'org.junit.jupiter:junit-jupiter-api'
+    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine'
+    testImplementation 'org.junit.jupiter:junit-jupiter-params'
+
+    testImplementation "com.squareup.okhttp3:okhttp:3.12.13"
+    testImplementation 'com.google.code.gson:gson:2.10.1'
+}

extractor/src/main/java/org/schabi/newpipe/extractor/Collector.java

@@ -0,0 +1,46 @@
+package org.schabi.newpipe.extractor;
+
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+
+import java.util.List;
+
+/**
+ * Collectors are used to simplify the collection of information
+ * from extractors
+ * @param <I> the item type
+ * @param <E> the extractor type
+ */
+public interface Collector<I, E> {
+
+    /**
+     * Try to add an extractor to the collection
+     * @param extractor the extractor to add
+     */
+    void commit(E extractor);
+
+    /**
+     * Try to extract the item from an extractor without adding it to the collection
+     * @param extractor the extractor to use
+     * @return the item
+     * @throws ParsingException thrown if there is an error extracting the
+     *                          <b>required</b> fields of the item.
+     */
+    I extract(E extractor) throws ParsingException;
+
+    /**
+     * Get all items
+     * @return the items
+     */
+    List<I> getItems();
+
+    /**
+     * Get all errors
+     * @return the errors
+     */
+    List<Throwable> getErrors();
+
+    /**
+     * Reset all collected items and errors
+     */
+    void reset();
+}

extractor/src/main/java/org/schabi/newpipe/extractor/Extractor.java

@@ -0,0 +1,154 @@
+package org.schabi.newpipe.extractor;
+
+import org.schabi.newpipe.extractor.downloader.Downloader;
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.linkhandler.LinkHandler;
+import org.schabi.newpipe.extractor.localization.ContentCountry;
+import org.schabi.newpipe.extractor.localization.Localization;
+import org.schabi.newpipe.extractor.localization.TimeAgoParser;
+
+import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
+
+import java.io.IOException;
+import java.util.Objects;
+
+public abstract class Extractor {
+    /**
+     * {@link StreamingService} currently related to this extractor.<br>
+     * Useful for getting other things from a service (like the url handlers for
+     * cleaning/accepting/get id from urls).
+     */
+    private final StreamingService service;
+    private final LinkHandler linkHandler;
+
+    @Nullable
+    private Localization forcedLocalization = null;
+    @Nullable
+    private ContentCountry forcedContentCountry = null;
+
+    private boolean pageFetched = false;
+    // called like this to prevent checkstyle errors about "hiding a field"
+    private final Downloader downloader;
+
+    protected Extractor(final StreamingService service, final LinkHandler linkHandler) {
+        this.service = Objects.requireNonNull(service, "service is null");
+        this.linkHandler = Objects.requireNonNull(linkHandler, "LinkHandler is null");
+        this.downloader = Objects.requireNonNull(NewPipe.getDownloader(), "downloader is null");
+    }
+
+    /**
+     * @return The {@link LinkHandler} of the current extractor object (e.g. a ChannelExtractor
+     *         should return a channel url handler).
+     */
+    @Nonnull
+    public LinkHandler getLinkHandler() {
+        return linkHandler;
+    }
+
+    /**
+     * Fetch the current page.
+     *
+     * @throws IOException         if the page can not be loaded
+     * @throws ExtractionException if the pages content is not understood
+     */
+    public void fetchPage() throws IOException, ExtractionException {
+        if (pageFetched) {
+            return;
+        }
+        onFetchPage(downloader);
+        pageFetched = true;
+    }
+
+    protected void assertPageFetched() {
+        if (!pageFetched) {
+            throw new IllegalStateException("Page is not fetched. Make sure you call fetchPage()");
+        }
+    }
+
+    protected boolean isPageFetched() {
+        return pageFetched;
+    }
+
+    /**
+     * Fetch the current page.
+     *
+     * @param downloader the downloader to use
+     * @throws IOException         if the page can not be loaded
+     * @throws ExtractionException if the pages content is not understood
+     */
+    @SuppressWarnings("HiddenField")
+    public abstract void onFetchPage(@Nonnull Downloader downloader)
+            throws IOException, ExtractionException;
+
+    @Nonnull
+    public String getId() throws ParsingException {
+        return linkHandler.getId();
+    }
+
+    /**
+     * Get the name
+     *
+     * @return the name
+     * @throws ParsingException if the name cannot be extracted
+     */
+    @Nonnull
+    public abstract String getName() throws ParsingException;
+
+    @Nonnull
+    public String getOriginalUrl() throws ParsingException {
+        return linkHandler.getOriginalUrl();
+    }
+
+    @Nonnull
+    public String getUrl() throws ParsingException {
+        return linkHandler.getUrl();
+    }
+
+    @Nonnull
+    public String getBaseUrl() throws ParsingException {
+        return linkHandler.getBaseUrl();
+    }
+
+    @Nonnull
+    public StreamingService getService() {
+        return service;
+    }
+
+    public int getServiceId() {
+        return service.getServiceId();
+    }
+
+    public Downloader getDownloader() {
+        return downloader;
+    }
+
+    /*//////////////////////////////////////////////////////////////////////////
+    // Localization
+    //////////////////////////////////////////////////////////////////////////*/
+
+    public void forceLocalization(final Localization localization) {
+        this.forcedLocalization = localization;
+    }
+
+    public void forceContentCountry(final ContentCountry contentCountry) {
+        this.forcedContentCountry = contentCountry;
+    }
+
+    @Nonnull
+    public Localization getExtractorLocalization() {
+        return forcedLocalization == null ? getService().getLocalization() : forcedLocalization;
+    }
+
+    @Nonnull
+    public ContentCountry getExtractorContentCountry() {
+        return forcedContentCountry == null ? getService().getContentCountry()
+                : forcedContentCountry;
+    }
+
+    @Nonnull
+    public TimeAgoParser getTimeAgoParser() {
+        return getService().getTimeAgoParser(getExtractorLocalization());
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/Image.java

@@ -0,0 +1,211 @@
+package org.schabi.newpipe.extractor;
+
+import javax.annotation.Nonnull;
+import java.io.Serializable;
+import java.util.Objects;
+
+/**
+ * Class representing images in the extractor.
+ *
+ * <p>
+ * An image has four properties: its URL, its height, its width and its estimated quality level.
+ * </p>
+ *
+ * <p>
+ * Depending of the services, the height, the width or both properties may be not known.
+ * Implementations <b>must use</b> the relevant unknown constants in this case
+ * ({@link #HEIGHT_UNKNOWN} and {@link #WIDTH_UNKNOWN}), to ensure properly the lack of knowledge
+ * of one or both of these properties to extractor clients.
+ * </p>
+ *
+ * <p>
+ * They should also respect the ranges defined in the estimated image resolution levels as much as
+ * possible, to ensure consistency to extractor clients.
+ * </p>
+ */
+public final class Image implements Serializable {
+
+    /**
+     * Constant representing that the height of an {@link Image} is unknown.
+     */
+    public static final int HEIGHT_UNKNOWN = -1;
+
+    /**
+     * Constant representing that the width of an {@link Image} is unknown.
+     */
+    public static final int WIDTH_UNKNOWN = -1;
+
+    @Nonnull
+    private final String url;
+    private final int height;
+    private final int width;
+    @Nonnull
+    private final ResolutionLevel estimatedResolutionLevel;
+
+    /**
+     * Construct an {@link Image} instance.
+     *
+     * @param url                      the URL to the image, which should be not null or empty
+     * @param height                   the image's height
+     * @param width                    the image's width
+     * @param estimatedResolutionLevel the image's estimated resolution level, which must not be
+     *                                 null
+     * @throws NullPointerException if {@code estimatedResolutionLevel} is null
+     */
+    public Image(@Nonnull final String url,
+                 final int height,
+                 final int width,
+                 @Nonnull final ResolutionLevel estimatedResolutionLevel)
+            throws NullPointerException {
+        this.url = url;
+        this.height = height;
+        this.width = width;
+        this.estimatedResolutionLevel = Objects.requireNonNull(
+                estimatedResolutionLevel, "estimatedResolutionLevel is null");
+    }
+
+    /**
+     * Get the URL of this {@link Image}.
+     *
+     * @return the {@link Image}'s URL.
+     */
+    @Nonnull
+    public String getUrl() {
+        return url;
+    }
+
+    /**
+     * Get the height of this {@link Image}.
+     *
+     * <p>
+     * If it is unknown, {@link #HEIGHT_UNKNOWN} is returned instead.
+     * </p>
+     *
+     * @return the {@link Image}'s height or {@link #HEIGHT_UNKNOWN}
+     */
+    public int getHeight() {
+        return height;
+    }
+
+    /**
+     * Get the width of this {@link Image}.
+     *
+     * <p>
+     * If it is unknown, {@link #WIDTH_UNKNOWN} is returned instead.
+     * </p>
+     *
+     * @return the {@link Image}'s width or {@link #WIDTH_UNKNOWN}
+     */
+    public int getWidth() {
+        return width;
+    }
+
+    /**
+     * Get the estimated resolution level of this image.
+     *
+     * <p>
+     * If it is unknown, {@link ResolutionLevel#UNKNOWN} is returned instead.
+     * </p>
+     *
+     * @return the estimated resolution level, which is never {@code null}
+     * @see ResolutionLevel
+     */
+    @Nonnull
+    public ResolutionLevel getEstimatedResolutionLevel() {
+        return estimatedResolutionLevel;
+    }
+
+    /**
+     * Get a string representation of this {@link Image} instance.
+     *
+     * <p>
+     * The representation will be in the following format, where {@code url}, {@code height},
+     * {@code width} and {@code estimatedResolutionLevel} represent the corresponding properties:
+     * <br>
+     * <br>
+     * {@code Image {url=url, height='height, width=width,
+     * estimatedResolutionLevel=estimatedResolutionLevel}'}
+     * </p>
+     *
+     * @return a string representation of this {@link Image} instance
+     */
+    @Nonnull
+    @Override
+    public String toString() {
+        return "Image {" + "url=" + url + ", height=" + height + ", width=" + width
+                + ", estimatedResolutionLevel=" + estimatedResolutionLevel + "}";
+    }
+
+    /**
+     * The estimated resolution level of an {@link Image}.
+     *
+     * <p>
+     * Some services don't return the size of their images, but we may know for a specific image
+     * type that a service returns, according to real data, an approximation of the resolution
+     * level.
+     * </p>
+     */
+    public enum ResolutionLevel {
+
+        /**
+         * The high resolution level.
+         *
+         * <p>
+         * This level applies to images with a height greater than or equal to 720px.
+         * </p>
+         */
+        HIGH,
+
+        /**
+         * The medium resolution level.
+         *
+         * <p>
+         * This level applies to images with a height between 175px inclusive and 720px exclusive.
+         * </p>
+         */
+        MEDIUM,
+
+        /**
+         * The low resolution level.
+         *
+         * <p>
+         * This level applies to images with a height between 1px inclusive and 175px exclusive.
+         * </p>
+         */
+        LOW,
+
+        /**
+         * The unknown resolution level.
+         *
+         * <p>
+         * This value is returned when the extractor doesn't know what resolution level an image
+         * could have, for example if the extractor loops in an array of images with different
+         * resolution levels without knowing the height.
+         * </p>
+         */
+        UNKNOWN;
+
+        /**
+         * Get a {@link ResolutionLevel} based from the given height.
+         *
+         * @param heightPx the height from which returning the good {@link ResolutionLevel}
+         * @return the {@link ResolutionLevel} corresponding to the height provided. See the
+         * {@link ResolutionLevel} values for details about what value is returned.
+         */
+        public static ResolutionLevel fromHeight(final int heightPx) {
+            if (heightPx <= 0) {
+                return UNKNOWN;
+            }
+
+            if (heightPx < 175) {
+                return LOW;
+            }
+
+            if (heightPx < 720) {
+                return MEDIUM;
+            }
+
+            return HIGH;
+        }
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/Info.java

@@ -0,0 +1,111 @@
+package org.schabi.newpipe.extractor;
+
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.linkhandler.LinkHandler;
+
+import java.io.Serializable;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.List;
+
+public abstract class Info implements Serializable {
+
+    private final int serviceId;
+    /**
+     * Id of this Info object <br>
+     * e.g. Youtube:  https://www.youtube.com/watch?v=RER5qCTzZ7     &gt;    RER5qCTzZ7
+     */
+    private final String id;
+    /**
+     * Different than the {@link #originalUrl} in the sense that it <i>may</i> be set as a cleaned
+     * url.
+     *
+     * @see LinkHandler#getUrl()
+     * @see Extractor#getOriginalUrl()
+     */
+    private final String url;
+    /**
+     * The url used to start the extraction of this {@link Info} object.
+     *
+     * @see Extractor#getOriginalUrl()
+     */
+    private String originalUrl;
+    private final String name;
+
+    private final List<Throwable> errors = new ArrayList<>();
+
+    public void addError(final Throwable throwable) {
+        this.errors.add(throwable);
+    }
+
+    public void addAllErrors(final Collection<Throwable> throwables) {
+        this.errors.addAll(throwables);
+    }
+
+    public Info(final int serviceId,
+                final String id,
+                final String url,
+                final String originalUrl,
+                final String name) {
+        this.serviceId = serviceId;
+        this.id = id;
+        this.url = url;
+        this.originalUrl = originalUrl;
+        this.name = name;
+    }
+
+    public Info(final int serviceId, final LinkHandler linkHandler, final String name) {
+        this(serviceId,
+                linkHandler.getId(),
+                linkHandler.getUrl(),
+                linkHandler.getOriginalUrl(),
+                name);
+    }
+
+    @Override
+    public String toString() {
+        final String ifDifferentString
+                = url.equals(originalUrl) ? "" : " (originalUrl=\"" + originalUrl + "\")";
+        return getClass().getSimpleName() + "[url=\"" + url + "\"" + ifDifferentString
+                + ", name=\"" + name + "\"]";
+    }
+
+    // if you use an api and want to handle the website url
+    // overriding original url is essential
+    public void setOriginalUrl(final String originalUrl) {
+        this.originalUrl = originalUrl;
+    }
+
+    public int getServiceId() {
+        return serviceId;
+    }
+
+    public StreamingService getService() {
+        try {
+            return NewPipe.getService(serviceId);
+        } catch (final ExtractionException e) {
+            // this should be unreachable, as serviceId certainly refers to a valid service
+            throw new RuntimeException("Info object has invalid service id", e);
+        }
+    }
+
+    public String getId() {
+        return id;
+    }
+
+    public String getUrl() {
+        return url;
+    }
+
+    public String getOriginalUrl() {
+        return originalUrl;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public List<Throwable> getErrors() {
+        return errors;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/InfoItem.java

@@ -0,0 +1,81 @@
+/*
+ * Created by Christian Schabesberger on 11.02.17.
+ *
+ * Copyright (C) 2017 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * InfoItem.java is part of NewPipe Extractor.
+ *
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * NewPipe Extractor is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NewPipe Extractor.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package org.schabi.newpipe.extractor;
+
+import javax.annotation.Nonnull;
+import java.io.Serializable;
+import java.util.List;
+
+public abstract class InfoItem implements Serializable {
+    private final InfoType infoType;
+    private final int serviceId;
+    private final String url;
+    private final String name;
+    @Nonnull
+    private List<Image> thumbnails = List.of();
+
+    public InfoItem(final InfoType infoType,
+                    final int serviceId,
+                    final String url,
+                    final String name) {
+        this.infoType = infoType;
+        this.serviceId = serviceId;
+        this.url = url;
+        this.name = name;
+    }
+
+    public InfoType getInfoType() {
+        return infoType;
+    }
+
+    public int getServiceId() {
+        return serviceId;
+    }
+
+    public String getUrl() {
+        return url;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setThumbnails(@Nonnull final List<Image> thumbnails) {
+        this.thumbnails = thumbnails;
+    }
+
+    @Nonnull
+    public List<Image> getThumbnails() {
+        return thumbnails;
+    }
+
+    @Override
+    public String toString() {
+        return getClass().getSimpleName() + "[url=\"" + url + "\", name=\"" + name + "\"]";
+    }
+
+    public enum InfoType {
+        STREAM,
+        PLAYLIST,
+        CHANNEL,
+        COMMENT
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/InfoItemExtractor.java

@@ -0,0 +1,13 @@
+package org.schabi.newpipe.extractor;
+
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+
+import javax.annotation.Nonnull;
+import java.util.List;
+
+public interface InfoItemExtractor {
+    String getName() throws ParsingException;
+    String getUrl() throws ParsingException;
+    @Nonnull
+    List<Image> getThumbnails() throws ParsingException;
+}

extractor/src/main/java/org/schabi/newpipe/extractor/InfoItemsCollector.java

@@ -0,0 +1,111 @@
+package org.schabi.newpipe.extractor;
+
+import org.schabi.newpipe.extractor.exceptions.FoundAdException;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+
+import javax.annotation.Nullable;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.List;
+
+/*
+ * Created by Christian Schabesberger on 12.02.17.
+ *
+ * Copyright (C) 2017 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * InfoItemsCollector.java is part of NewPipe Extractor.
+ *
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * NewPipe Extractor is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+public abstract class InfoItemsCollector<I extends InfoItem, E extends InfoItemExtractor>
+        implements Collector<I, E> {
+
+    private final List<I> itemList = new ArrayList<>();
+    private final List<Throwable> errors = new ArrayList<>();
+    private final int serviceId;
+    @Nullable
+    private final Comparator<I> comparator;
+
+    /**
+     * Create a new collector with no comparator / sorting function
+     * @param serviceId the service id
+     */
+    public InfoItemsCollector(final int serviceId) {
+        this(serviceId, null);
+    }
+
+    /**
+     * Create a new collector
+     * @param serviceId the service id
+     */
+    public InfoItemsCollector(final int serviceId, @Nullable final Comparator<I> comparator) {
+        this.serviceId = serviceId;
+        this.comparator = comparator;
+    }
+
+    @Override
+    public List<I> getItems() {
+        if (comparator != null) {
+            itemList.sort(comparator);
+        }
+        return Collections.unmodifiableList(itemList);
+    }
+
+    @Override
+    public List<Throwable> getErrors() {
+        return Collections.unmodifiableList(errors);
+    }
+
+    @Override
+    public void reset() {
+        itemList.clear();
+        errors.clear();
+    }
+
+    /**
+     * Add an error
+     * @param error the error
+     */
+    protected void addError(final Exception error) {
+        errors.add(error);
+    }
+
+    /**
+     * Add an item
+     * @param item the item
+     */
+    protected void addItem(final I item) {
+        itemList.add(item);
+    }
+
+    /**
+     * Get the service id
+     * @return the service id
+     */
+    public int getServiceId() {
+        return serviceId;
+    }
+
+    @Override
+    public void commit(final E extractor) {
+        try {
+            addItem(extract(extractor));
+        } catch (final FoundAdException ae) {
+            // found an ad. Maybe a debug line could be placed here
+        } catch (final ParsingException e) {
+            addError(e);
+        }
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/ListExtractor.java

@@ -0,0 +1,132 @@
+package org.schabi.newpipe.extractor;
+
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+
+import javax.annotation.Nonnull;
+
+
+/**
+ * Base class to extractors that have a list (e.g. playlists, users).
+ * @param <R> the info item type this list extractor provides
+ */
+public abstract class ListExtractor<R extends InfoItem> extends Extractor {
+    /**
+     * Constant that should be returned whenever
+     * a list has an unknown number of items.
+     */
+    public static final long ITEM_COUNT_UNKNOWN = -1;
+    /**
+     * Constant that should be returned whenever a list has an
+     * infinite number of items. For example a YouTube mix.
+     */
+    public static final long ITEM_COUNT_INFINITE = -2;
+    /**
+     * Constant that should be returned whenever a list
+     * has an unknown number of items bigger than 100.
+     */
+    public static final long ITEM_COUNT_MORE_THAN_100 = -3;
+
+    public ListExtractor(final StreamingService service, final ListLinkHandler linkHandler) {
+        super(service, linkHandler);
+    }
+
+    /**
+     * A {@link InfoItemsPage InfoItemsPage} corresponding to the initial page
+     * where the items are from the initial request and the nextPage relative to it.
+     *
+     * @return a {@link InfoItemsPage} corresponding to the initial page
+     */
+    @Nonnull
+    public abstract InfoItemsPage<R> getInitialPage() throws IOException, ExtractionException;
+
+    /**
+     * Get a list of items corresponding to the specific requested page.
+     *
+     * @param page any page got from the exclusive implementation of the list extractor
+     * @return a {@link InfoItemsPage} corresponding to the requested page
+     * @see InfoItemsPage#getNextPage()
+     */
+    public abstract InfoItemsPage<R> getPage(Page page) throws IOException, ExtractionException;
+
+    @Nonnull
+    @Override
+    public ListLinkHandler getLinkHandler() {
+        return (ListLinkHandler) super.getLinkHandler();
+    }
+
+    /*//////////////////////////////////////////////////////////////////////////
+    // Inner
+    //////////////////////////////////////////////////////////////////////////*/
+
+    /**
+     * A class that is used to wrap a list of gathered items and eventual errors, it
+     * also contains a field that points to the next available page ({@link #nextPage}).
+     * @param <T> the info item type that this page is supposed to store and provide
+     */
+    public static class InfoItemsPage<T extends InfoItem> {
+        private static final InfoItemsPage<InfoItem> EMPTY =
+                new InfoItemsPage<>(Collections.emptyList(), null, Collections.emptyList());
+
+        /**
+         * A convenient method that returns a representation of an empty page.
+         *
+         * @return a type-safe page with the list of items and errors empty and the nextPage set to
+         *         {@code null}.
+         */
+        public static <T extends InfoItem> InfoItemsPage<T> emptyPage() {
+            //noinspection unchecked
+            return (InfoItemsPage<T>) EMPTY;
+        }
+
+        /**
+         * The current list of items of this page
+         */
+        private final List<T> itemsList;
+
+        /**
+         * Url pointing to the next page relative to this one
+         *
+         * @see ListExtractor#getPage(Page)
+         * @see Page
+         */
+        private final Page nextPage;
+
+        /**
+         * Errors that happened during the extraction
+         */
+        private final List<Throwable> errors;
+
+        public InfoItemsPage(final InfoItemsCollector<T, ?> collector, final Page nextPage) {
+            this(collector.getItems(), nextPage, collector.getErrors());
+        }
+
+        public InfoItemsPage(final List<T> itemsList,
+                             final Page nextPage,
+                             final List<Throwable> errors) {
+            this.itemsList = itemsList;
+            this.nextPage = nextPage;
+            this.errors = errors;
+        }
+
+        public boolean hasNextPage() {
+            return Page.isValid(nextPage);
+        }
+
+        public List<T> getItems() {
+            return itemsList;
+        }
+
+        public Page getNextPage() {
+            return nextPage;
+        }
+
+        public List<Throwable> getErrors() {
+            return errors;
+        }
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/ListInfo.java

@@ -0,0 +1,60 @@
+package org.schabi.newpipe.extractor;
+
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+
+import java.util.List;
+
+public abstract class ListInfo<T extends InfoItem> extends Info {
+    private List<T> relatedItems;
+    private Page nextPage = null;
+    private final List<String> contentFilters;
+    private final String sortFilter;
+
+    public ListInfo(final int serviceId,
+                    final String id,
+                    final String url,
+                    final String originalUrl,
+                    final String name,
+                    final List<String> contentFilter,
+                    final String sortFilter) {
+        super(serviceId, id, url, originalUrl, name);
+        this.contentFilters = contentFilter;
+        this.sortFilter = sortFilter;
+    }
+
+    public ListInfo(final int serviceId,
+                    final ListLinkHandler listUrlIdHandler,
+                    final String name) {
+        super(serviceId, listUrlIdHandler, name);
+        this.contentFilters = listUrlIdHandler.getContentFilters();
+        this.sortFilter = listUrlIdHandler.getSortFilter();
+    }
+
+    public List<T> getRelatedItems() {
+        return relatedItems;
+    }
+
+    public void setRelatedItems(final List<T> relatedItems) {
+        this.relatedItems = relatedItems;
+    }
+
+    public boolean hasNextPage() {
+        return Page.isValid(nextPage);
+    }
+
+    public Page getNextPage() {
+        return nextPage;
+    }
+
+    public void setNextPage(final Page page) {
+        this.nextPage = page;
+    }
+
+    public List<String> getContentFilters() {
+        return contentFilters;
+    }
+
+    public String getSortFilter() {
+        return sortFilter;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/MediaFormat.java

@@ -0,0 +1,213 @@
+package org.schabi.newpipe.extractor;
+
+/*
+ * Created by Adam Howard on 08/11/15.
+ *
+ * Copyright (c) 2015 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ *     and Adam Howard <achdisposable1@gmail.com>
+ *
+ * MediaFormat.java is part of NewPipe Extractor.
+ *
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * NewPipe Extractor is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
+import java.util.Arrays;
+import java.util.List;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+
+/**
+ * Static data about various media formats support by NewPipe, eg mime type, extension
+ */
+
+@SuppressWarnings("MethodParamPad") // we want the media format table below to be aligned
+public enum MediaFormat {
+    // @formatter:off
+    //video and audio combined formats
+    //         id     name         suffix  mimeType
+    MPEG_4    (0x0,   "MPEG-4",    "mp4",  "video/mp4"),
+    v3GPP     (0x10,  "3GPP",      "3gp",  "video/3gpp"),
+    WEBM      (0x20,  "WebM",      "webm", "video/webm"),
+    // audio formats
+    M4A       (0x100, "m4a",       "m4a",  "audio/mp4"),
+    WEBMA     (0x200, "WebM",      "webm", "audio/webm"),
+    MP3       (0x300, "MP3",       "mp3",  "audio/mpeg"),
+    MP2       (0x310, "MP2",       "mp2",  "audio/mpeg"),
+    OPUS      (0x400, "opus",      "opus", "audio/opus"),
+    OGG       (0x500, "ogg",       "ogg",  "audio/ogg"),
+    WEBMA_OPUS(0x200, "WebM Opus", "webm", "audio/webm"),
+    AIFF      (0x600, "AIFF",      "aiff", "audio/aiff"),
+    /**
+     * Same as {@link MediaFormat#AIFF}, just with the shorter suffix/file extension
+     */
+    AIF       (0x600, "AIFF",      "aif",  "audio/aiff"),
+    WAV       (0x700, "WAV",       "wav",  "audio/wav"),
+    FLAC      (0x800, "FLAC",      "flac", "audio/flac"),
+    ALAC      (0x900, "ALAC",      "alac", "audio/alac"),
+    // subtitles formats
+    VTT        (0x1000, "WebVTT",                     "vtt",  "text/vtt"),
+    TTML       (0x2000, "Timed Text Markup Language", "ttml", "application/ttml+xml"),
+    TRANSCRIPT1(0x3000, "TranScript v1",              "srv1", "text/xml"),
+    TRANSCRIPT2(0x4000, "TranScript v2",              "srv2", "text/xml"),
+    TRANSCRIPT3(0x5000, "TranScript v3",              "srv3", "text/xml"),
+    SRT        (0x6000, "SubRip file format",         "srt",  "text/srt");
+    // @formatter:on
+
+    public final int id;
+    @Nonnull
+    public final String name;
+    @Nonnull
+    public final String suffix;
+    @Nonnull
+    public final String mimeType;
+
+    MediaFormat(final int id, @Nonnull final String name,
+                @Nonnull final String suffix, @Nonnull final String mimeType) {
+        this.id = id;
+        this.name = name;
+        this.suffix = suffix;
+        this.mimeType = mimeType;
+    }
+
+    private static <T> T getById(final int id,
+                                 final Function<MediaFormat, T> field,
+                                 final T orElse) {
+        return Arrays.stream(MediaFormat.values())
+                .filter(mediaFormat -> mediaFormat.id == id)
+                .map(field)
+                .findFirst()
+                .orElse(orElse);
+    }
+
+    /**
+     * Return the friendly name of the media format with the supplied id
+     *
+     * @param id the id of the media format. Currently an arbitrary, NewPipe-specific number.
+     * @return the friendly name of the MediaFormat associated with this ids,
+     * or an empty String if none match it.
+     */
+    @Nonnull
+    public static String getNameById(final int id) {
+        return getById(id, MediaFormat::getName, "");
+    }
+
+    /**
+     * Return the file extension of the media format with the supplied id
+     *
+     * @param id the id of the media format. Currently an arbitrary, NewPipe-specific number.
+     * @return the file extension of the MediaFormat associated with this ids,
+     * or an empty String if none match it.
+     */
+    @Nonnull
+    public static String getSuffixById(final int id) {
+        return getById(id, MediaFormat::getSuffix, "");
+    }
+
+    /**
+     * Return the MIME type of the media format with the supplied id
+     *
+     * @param id the id of the media format. Currently an arbitrary, NewPipe-specific number.
+     * @return the MIME type of the MediaFormat associated with this ids,
+     * or an empty String if none match it.
+     */
+    @Nullable
+    public static String getMimeById(final int id) {
+        return getById(id, MediaFormat::getMimeType, null);
+    }
+
+    /**
+     * Return the first {@link MediaFormat} with the supplied mime type.
+     * There might be more formats which have the same mime type.
+     * To retrieve those, use {@link #getAllFromMimeType(String)}.
+     *
+     * @return MediaFormat associated with this mime type,
+     * or null if none match it.
+     */
+    @Nullable
+    public static MediaFormat getFromMimeType(final String mimeType) {
+        return Arrays.stream(MediaFormat.values())
+                .filter(mediaFormat -> mediaFormat.mimeType.equals(mimeType))
+                .findFirst()
+                .orElse(null);
+    }
+
+    /**
+     * Get all media formats which have the given mime type.
+     * @param mimeType the mime type to search for
+     * @return a modifiable {@link List} which contains the {@link MediaFormat}s
+     * that have the given mime type.
+     */
+    @Nonnull
+    public static List<MediaFormat> getAllFromMimeType(final String mimeType) {
+        return Arrays.stream(MediaFormat.values())
+                .filter(mediaFormat -> mediaFormat.mimeType.equals(mimeType))
+                .collect(Collectors.toList());
+    }
+
+    /**
+     * Get the media format by its id.
+     *
+     * @param id the id
+     * @return the id of the media format or null.
+     */
+    @Nullable
+    public static MediaFormat getFormatById(final int id) {
+        return getById(id, mediaFormat -> mediaFormat, null);
+    }
+
+    /**
+     * Get the first media format that has the given suffix/file extension.
+     * @return the matching {@link MediaFormat} or {@code null} if no associated format is found
+     */
+    @Nullable
+    public static MediaFormat getFromSuffix(final String suffix) {
+        return Arrays.stream(MediaFormat.values())
+                .filter(mediaFormat -> mediaFormat.suffix.equals(suffix))
+                .findFirst()
+                .orElse(null);
+    }
+
+    /**
+     * Get the name of the format
+     *
+     * @return the name of the format
+     */
+    @Nonnull
+    public String getName() {
+        return name;
+    }
+
+    /**
+     * Get the filename extension
+     *
+     * @return the filename extension
+     */
+    @Nonnull
+    public String getSuffix() {
+        return suffix;
+    }
+
+    /**
+     * Get the mime type
+     *
+     * @return the mime type
+     */
+    @Nonnull
+    public String getMimeType() {
+        return mimeType;
+    }
+
+}

extractor/src/main/java/org/schabi/newpipe/extractor/MetaInfo.java

@@ -0,0 +1,78 @@
+package org.schabi.newpipe.extractor;
+
+import org.schabi.newpipe.extractor.stream.Description;
+
+import java.io.Serializable;
+import java.net.URL;
+import java.util.ArrayList;
+import java.util.List;
+
+import javax.annotation.Nonnull;
+
+public class MetaInfo implements Serializable {
+
+    private String title = "";
+    private Description content;
+    private List<URL> urls = new ArrayList<>();
+    private List<String> urlTexts = new ArrayList<>();
+
+    public MetaInfo(@Nonnull final String title,
+                    @Nonnull final Description content,
+                    @Nonnull final List<URL> urls,
+                    @Nonnull final List<String> urlTexts) {
+        this.title = title;
+        this.content = content;
+        this.urls = urls;
+        this.urlTexts = urlTexts;
+    }
+
+    public MetaInfo() {
+    }
+
+    /**
+     * @return Title of the info. Can be empty.
+     */
+    @Nonnull
+    public String getTitle() {
+        return title;
+    }
+
+    public void setTitle(@Nonnull final String title) {
+        this.title = title;
+    }
+
+    @Nonnull
+    public Description getContent() {
+        return content;
+    }
+
+    public void setContent(@Nonnull final Description content) {
+        this.content = content;
+    }
+
+    @Nonnull
+    public List<URL> getUrls() {
+        return urls;
+    }
+
+    public void setUrls(@Nonnull final List<URL> urls) {
+        this.urls = urls;
+    }
+
+    public void addUrl(@Nonnull final URL url) {
+        urls.add(url);
+    }
+
+    @Nonnull
+    public List<String> getUrlTexts() {
+        return urlTexts;
+    }
+
+    public void setUrlTexts(@Nonnull final List<String> urlTexts) {
+        this.urlTexts = urlTexts;
+    }
+
+    public void addUrlText(@Nonnull final String urlText) {
+        urlTexts.add(urlText);
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/MultiInfoItemsCollector.java

@@ -0,0 +1,91 @@
+package org.schabi.newpipe.extractor;
+
+import org.schabi.newpipe.extractor.channel.ChannelInfoItemExtractor;
+import org.schabi.newpipe.extractor.channel.ChannelInfoItemsCollector;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.playlist.PlaylistInfoItemExtractor;
+import org.schabi.newpipe.extractor.playlist.PlaylistInfoItemsCollector;
+import org.schabi.newpipe.extractor.stream.StreamInfoItemExtractor;
+import org.schabi.newpipe.extractor.stream.StreamInfoItemsCollector;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+/*
+ * Created by Christian Schabesberger on 12.02.17.
+ *
+ * Copyright (C) 2017 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * InfoItemsSearchCollector.java is part of NewPipe Extractor.
+ *
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * NewPipe Extractor is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+/**
+ * A collector that can handle many extractor types, to be used when a list contains items of
+ * different types (e.g. search)
+ * <p>
+ * This collector can handle the following extractor types:
+ * <ul>
+ *     <li>{@link StreamInfoItemExtractor}</li>
+ *     <li>{@link ChannelInfoItemExtractor}</li>
+ *     <li>{@link PlaylistInfoItemExtractor}</li>
+ * </ul>
+ * Calling {@link #extract(InfoItemExtractor)} or {@link #commit(InfoItemExtractor)} with any
+ * other extractor type will raise an exception.
+ */
+public class MultiInfoItemsCollector extends InfoItemsCollector<InfoItem, InfoItemExtractor> {
+    private final StreamInfoItemsCollector streamCollector;
+    private final ChannelInfoItemsCollector userCollector;
+    private final PlaylistInfoItemsCollector playlistCollector;
+
+    public MultiInfoItemsCollector(final int serviceId) {
+        super(serviceId);
+        streamCollector = new StreamInfoItemsCollector(serviceId);
+        userCollector = new ChannelInfoItemsCollector(serviceId);
+        playlistCollector = new PlaylistInfoItemsCollector(serviceId);
+    }
+
+    @Override
+    public List<Throwable> getErrors() {
+        final List<Throwable> errors = new ArrayList<>(super.getErrors());
+        errors.addAll(streamCollector.getErrors());
+        errors.addAll(userCollector.getErrors());
+        errors.addAll(playlistCollector.getErrors());
+
+        return Collections.unmodifiableList(errors);
+    }
+
+    @Override
+    public void reset() {
+        super.reset();
+        streamCollector.reset();
+        userCollector.reset();
+        playlistCollector.reset();
+    }
+
+    @Override
+    public InfoItem extract(final InfoItemExtractor extractor) throws ParsingException {
+        // Use the corresponding collector for each item extractor type
+        if (extractor instanceof StreamInfoItemExtractor) {
+            return streamCollector.extract((StreamInfoItemExtractor) extractor);
+        } else if (extractor instanceof ChannelInfoItemExtractor) {
+            return userCollector.extract((ChannelInfoItemExtractor) extractor);
+        } else if (extractor instanceof PlaylistInfoItemExtractor) {
+            return playlistCollector.extract((PlaylistInfoItemExtractor) extractor);
+        } else {
+            throw new IllegalArgumentException("Invalid extractor type: " + extractor);
+        }
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/NewPipe.java

@@ -0,0 +1,135 @@
+package org.schabi.newpipe.extractor;
+
+/*
+ * Created by Christian Schabesberger on 23.08.15.
+ *
+ * Copyright (C) 2015 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * NewPipe Extractor.java is part of NewPipe Extractor.
+ *
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * NewPipe Extractor is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+import org.schabi.newpipe.extractor.downloader.Downloader;
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.localization.ContentCountry;
+import org.schabi.newpipe.extractor.localization.Localization;
+
+import java.util.List;
+
+import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
+
+/**
+ * Provides access to streaming services supported by NewPipe.
+ */
+public final class NewPipe {
+    private static Downloader downloader;
+    private static Localization preferredLocalization;
+    private static ContentCountry preferredContentCountry;
+
+    private NewPipe() {
+    }
+
+    public static void init(final Downloader d) {
+        init(d, Localization.DEFAULT);
+    }
+
+    public static void init(final Downloader d, final Localization l) {
+        init(d, l, l.getCountryCode().isEmpty()
+                ? ContentCountry.DEFAULT : new ContentCountry(l.getCountryCode()));
+    }
+
+    public static void init(final Downloader d, final Localization l, final ContentCountry c) {
+        downloader = d;
+        preferredLocalization = l;
+        preferredContentCountry = c;
+    }
+
+    public static Downloader getDownloader() {
+        return downloader;
+    }
+
+    /*//////////////////////////////////////////////////////////////////////////
+    // Utils
+    //////////////////////////////////////////////////////////////////////////*/
+
+    public static List<StreamingService> getServices() {
+        return ServiceList.all();
+    }
+
+    public static StreamingService getService(final int serviceId) throws ExtractionException {
+        return ServiceList.all().stream()
+                .filter(service -> service.getServiceId() == serviceId)
+                .findFirst()
+                .orElseThrow(() -> new ExtractionException(
+                        "There's no service with the id = \"" + serviceId + "\""));
+    }
+
+    public static StreamingService getService(final String serviceName) throws ExtractionException {
+        return ServiceList.all().stream()
+                .filter(service -> service.getServiceInfo().getName().equals(serviceName))
+                .findFirst()
+                .orElseThrow(() -> new ExtractionException(
+                        "There's no service with the name = \"" + serviceName + "\""));
+    }
+
+    public static StreamingService getServiceByUrl(final String url) throws ExtractionException {
+        for (final StreamingService service : ServiceList.all()) {
+            if (service.getLinkTypeByUrl(url) != StreamingService.LinkType.NONE) {
+                return service;
+            }
+        }
+        throw new ExtractionException("No service can handle the url = \"" + url + "\"");
+    }
+
+    /*//////////////////////////////////////////////////////////////////////////
+    // Localization
+    //////////////////////////////////////////////////////////////////////////*/
+
+    public static void setupLocalization(final Localization thePreferredLocalization) {
+        setupLocalization(thePreferredLocalization, null);
+    }
+
+    public static void setupLocalization(
+            final Localization thePreferredLocalization,
+            @Nullable final ContentCountry thePreferredContentCountry) {
+        NewPipe.preferredLocalization = thePreferredLocalization;
+
+        if (thePreferredContentCountry != null) {
+            NewPipe.preferredContentCountry = thePreferredContentCountry;
+        } else {
+            NewPipe.preferredContentCountry = thePreferredLocalization.getCountryCode().isEmpty()
+                    ? ContentCountry.DEFAULT
+                    : new ContentCountry(thePreferredLocalization.getCountryCode());
+        }
+    }
+
+    @Nonnull
+    public static Localization getPreferredLocalization() {
+        return preferredLocalization == null ? Localization.DEFAULT : preferredLocalization;
+    }
+
+    public static void setPreferredLocalization(final Localization preferredLocalization) {
+        NewPipe.preferredLocalization = preferredLocalization;
+    }
+
+    @Nonnull
+    public static ContentCountry getPreferredContentCountry() {
+        return preferredContentCountry == null ? ContentCountry.DEFAULT : preferredContentCountry;
+    }
+
+    public static void setPreferredContentCountry(final ContentCountry preferredContentCountry) {
+        NewPipe.preferredContentCountry = preferredContentCountry;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/Page.java

@@ -0,0 +1,85 @@
+package org.schabi.newpipe.extractor;
+
+import java.io.Serializable;
+import java.util.List;
+import java.util.Map;
+
+import javax.annotation.Nullable;
+
+import static org.schabi.newpipe.extractor.utils.Utils.isNullOrEmpty;
+
+public class Page implements Serializable {
+    private final String url;
+    private final String id;
+    private final List<String> ids;
+    private final Map<String, String> cookies;
+
+    @Nullable
+    private final byte[] body;
+
+    public Page(final String url,
+                final String id,
+                final List<String> ids,
+                final Map<String, String> cookies,
+                @Nullable final byte[] body) {
+        this.url = url;
+        this.id = id;
+        this.ids = ids;
+        this.cookies = cookies;
+        this.body = body;
+    }
+
+    public Page(final String url) {
+        this(url, null, null, null, null);
+    }
+
+    public Page(final String url, final String id) {
+        this(url, id, null, null, null);
+    }
+
+    public Page(final String url, final String id, final byte[] body) {
+        this(url, id, null, null, body);
+    }
+
+    public Page(final String url, final byte[] body) {
+        this(url, null, null, null, body);
+    }
+
+    public Page(final String url, final Map<String, String> cookies) {
+        this(url, null, null, cookies, null);
+    }
+
+    public Page(final List<String> ids) {
+        this(null, null, ids, null, null);
+    }
+
+    public Page(final List<String> ids, final Map<String, String> cookies) {
+        this(null, null, ids, cookies, null);
+    }
+
+    public String getUrl() {
+        return url;
+    }
+
+    public String getId() {
+        return id;
+    }
+
+    public List<String> getIds() {
+        return ids;
+    }
+
+    public Map<String, String> getCookies() {
+        return cookies;
+    }
+
+    public static boolean isValid(final Page page) {
+        return page != null && (!isNullOrEmpty(page.getUrl())
+                || !isNullOrEmpty(page.getIds()));
+    }
+
+    @Nullable
+    public byte[] getBody() {
+        return body;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/ServiceList.java

@@ -0,0 +1,59 @@
+package org.schabi.newpipe.extractor;
+
+import org.schabi.newpipe.extractor.services.bandcamp.BandcampService;
+import org.schabi.newpipe.extractor.services.media_ccc.MediaCCCService;
+import org.schabi.newpipe.extractor.services.peertube.PeertubeService;
+import org.schabi.newpipe.extractor.services.soundcloud.SoundcloudService;
+import org.schabi.newpipe.extractor.services.youtube.YoutubeService;
+
+import java.util.List;
+
+/*
+ * Copyright (C) 2018 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * ServiceList.java is part of NewPipe Extractor.
+ *
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * NewPipe Extractor is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+/**
+ * A list of supported services.
+ */
+@SuppressWarnings({"ConstantName", "InnerAssignment"}) // keep unusual names and inner assignments
+public final class ServiceList {
+    private ServiceList() {
+        // no instance
+    }
+
+    public static final YoutubeService YouTube = new YoutubeService(0);
+    public static final SoundcloudService SoundCloud = new SoundcloudService(1);
+    public static final MediaCCCService MediaCCC = new MediaCCCService(2);
+    public static final PeertubeService PeerTube = new PeertubeService(3);
+    public static final BandcampService Bandcamp = new BandcampService(4);
+
+    /**
+     * When creating a new service, put this service in the end of this list,
+     * and give it the next free id.
+     */
+    private static final List<StreamingService> SERVICES = List.of(
+            YouTube, SoundCloud, MediaCCC, PeerTube, Bandcamp);
+
+    /**
+     * Get all the supported services.
+     *
+     * @return a unmodifiable list of all the supported services
+     */
+    public static List<StreamingService> all() {
+        return SERVICES;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/StreamingService.java

@@ -0,0 +1,436 @@
+package org.schabi.newpipe.extractor;
+
+import org.schabi.newpipe.extractor.channel.ChannelExtractor;
+import org.schabi.newpipe.extractor.channel.tabs.ChannelTabExtractor;
+import org.schabi.newpipe.extractor.comments.CommentsExtractor;
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.feed.FeedExtractor;
+import org.schabi.newpipe.extractor.kiosk.KioskList;
+import org.schabi.newpipe.extractor.linkhandler.LinkHandler;
+import org.schabi.newpipe.extractor.linkhandler.LinkHandlerFactory;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandlerFactory;
+import org.schabi.newpipe.extractor.linkhandler.SearchQueryHandler;
+import org.schabi.newpipe.extractor.linkhandler.SearchQueryHandlerFactory;
+import org.schabi.newpipe.extractor.localization.ContentCountry;
+import org.schabi.newpipe.extractor.localization.Localization;
+import org.schabi.newpipe.extractor.localization.TimeAgoParser;
+import org.schabi.newpipe.extractor.localization.TimeAgoPatternsManager;
+import org.schabi.newpipe.extractor.playlist.PlaylistExtractor;
+import org.schabi.newpipe.extractor.search.SearchExtractor;
+import org.schabi.newpipe.extractor.stream.StreamExtractor;
+import org.schabi.newpipe.extractor.subscription.SubscriptionExtractor;
+import org.schabi.newpipe.extractor.suggestion.SuggestionExtractor;
+import org.schabi.newpipe.extractor.utils.Utils;
+
+import javax.annotation.Nullable;
+import java.util.Collections;
+import java.util.List;
+
+/*
+ * Copyright (C) 2018 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * StreamingService.java is part of NewPipe Extractor.
+ *
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * NewPipe Extractor is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+public abstract class StreamingService {
+
+    /**
+     * This class holds meta information about the service implementation.
+     */
+    public static class ServiceInfo {
+        private final String name;
+
+        private final List<MediaCapability> mediaCapabilities;
+
+        /**
+         * Creates a new instance of a ServiceInfo
+         * @param name the name of the service
+         * @param mediaCapabilities the type of media this service can handle
+         */
+        public ServiceInfo(final String name, final List<MediaCapability> mediaCapabilities) {
+            this.name = name;
+            this.mediaCapabilities = Collections.unmodifiableList(mediaCapabilities);
+        }
+
+        public String getName() {
+            return name;
+        }
+
+        public List<MediaCapability> getMediaCapabilities() {
+            return mediaCapabilities;
+        }
+
+        public enum MediaCapability {
+            AUDIO, VIDEO, LIVE, COMMENTS
+        }
+    }
+
+    /**
+     * LinkType will be used to determine which type of URL you are handling, and therefore which
+     * part of NewPipe should handle a certain URL.
+     */
+    public enum LinkType {
+        NONE,
+        STREAM,
+        CHANNEL,
+        PLAYLIST
+    }
+
+    private final int serviceId;
+    private final ServiceInfo serviceInfo;
+
+    /**
+     * Creates a new Streaming service.
+     * If you Implement one do not set id within your implementation of this extractor, instead
+     * set the id when you put the extractor into {@link ServiceList}
+     * All other parameters can be set directly from the overriding constructor.
+     * @param id the number of the service to identify him within the NewPipe frontend
+     * @param name the name of the service
+     * @param capabilities the type of media this service can handle
+     */
+    public StreamingService(final int id,
+                            final String name,
+                            final List<ServiceInfo.MediaCapability> capabilities) {
+        this.serviceId = id;
+        this.serviceInfo = new ServiceInfo(name, capabilities);
+    }
+
+    public final int getServiceId() {
+        return serviceId;
+    }
+
+    public ServiceInfo getServiceInfo() {
+        return serviceInfo;
+    }
+
+    @Override
+    public String toString() {
+        return serviceId + ":" + serviceInfo.getName();
+    }
+
+    public abstract String getBaseUrl();
+
+    /*//////////////////////////////////////////////////////////////////////////
+    // Url Id handler
+    //////////////////////////////////////////////////////////////////////////*/
+
+    /**
+     * Must return a new instance of an implementation of LinkHandlerFactory for streams.
+     * @return an instance of a LinkHandlerFactory for streams
+     */
+    public abstract LinkHandlerFactory getStreamLHFactory();
+
+    /**
+     * Must return a new instance of an implementation of ListLinkHandlerFactory for channels.
+     * If support for channels is not given null must be returned.
+     * @return an instance of a ListLinkHandlerFactory for channels or null
+     */
+    public abstract ListLinkHandlerFactory getChannelLHFactory();
+
+    /**
+     * Must return a new instance of an implementation of ListLinkHandlerFactory for channel tabs.
+     * If support for channel tabs is not given null must be returned.
+     *
+     * @return an instance of a ListLinkHandlerFactory for channels or null
+     */
+    public abstract ListLinkHandlerFactory getChannelTabLHFactory();
+
+    /**
+     * Must return a new instance of an implementation of ListLinkHandlerFactory for playlists.
+     * If support for playlists is not given null must be returned.
+     * @return an instance of a ListLinkHandlerFactory for playlists or null
+     */
+    public abstract ListLinkHandlerFactory getPlaylistLHFactory();
+
+    /**
+     * Must return an instance of an implementation of SearchQueryHandlerFactory.
+     * @return an instance of a SearchQueryHandlerFactory
+     */
+    public abstract SearchQueryHandlerFactory getSearchQHFactory();
+    public abstract ListLinkHandlerFactory getCommentsLHFactory();
+
+    /*//////////////////////////////////////////////////////////////////////////
+    // Extractors
+    //////////////////////////////////////////////////////////////////////////*/
+
+    /**
+     * Must create a new instance of a SearchExtractor implementation.
+     * @param queryHandler specifies the keyword lock for, and the filters which should be applied.
+     * @return a new SearchExtractor instance
+     */
+    public abstract SearchExtractor getSearchExtractor(SearchQueryHandler queryHandler);
+
+    /**
+     * Must create a new instance of a SuggestionExtractor implementation.
+     * @return a new SuggestionExtractor instance
+     */
+    public abstract SuggestionExtractor getSuggestionExtractor();
+
+    /**
+     * Outdated or obsolete. null can be returned.
+     * @return just null
+     */
+    public abstract SubscriptionExtractor getSubscriptionExtractor();
+
+    /**
+     * This method decides which strategy will be chosen to fetch the feed. In YouTube, for example,
+     * a separate feed exists which is lightweight and made specifically to be used like this.
+     * <p>
+     * In services which there's no other way to retrieve them, null should be returned.
+     *
+     * @return a {@link FeedExtractor} instance or null.
+     */
+    @Nullable
+    public FeedExtractor getFeedExtractor(final String url) throws ExtractionException {
+        return null;
+    }
+
+    /**
+     * Must create a new instance of a KioskList implementation.
+     * @return a new KioskList instance
+     */
+    public abstract KioskList getKioskList() throws ExtractionException;
+
+    /**
+     * Must create a new instance of a ChannelExtractor implementation.
+     * @param linkHandler is pointing to the channel which should be handled by this new instance.
+     * @return a new ChannelExtractor
+     */
+    public abstract ChannelExtractor getChannelExtractor(ListLinkHandler linkHandler)
+            throws ExtractionException;
+
+    /**
+     * Must create a new instance of a ChannelTabExtractor implementation.
+     *
+     * @param linkHandler is pointing to the channel which should be handled by this new instance.
+     * @return a new ChannelTabExtractor
+     */
+    public abstract ChannelTabExtractor getChannelTabExtractor(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.
+     * @return a new PlaylistExtractor
+     */
+    public abstract PlaylistExtractor getPlaylistExtractor(ListLinkHandler linkHandler)
+            throws ExtractionException;
+
+    /**
+     * Must create a new instance of a StreamExtractor implementation.
+     * @param linkHandler is pointing to the stream which should be handled by this new instance.
+     * @return a new StreamExtractor
+     */
+    public abstract StreamExtractor getStreamExtractor(LinkHandler linkHandler)
+            throws ExtractionException;
+
+    public abstract CommentsExtractor getCommentsExtractor(ListLinkHandler linkHandler)
+            throws ExtractionException;
+
+    /*//////////////////////////////////////////////////////////////////////////
+    // Extractors without link handler
+    //////////////////////////////////////////////////////////////////////////*/
+
+    public SearchExtractor getSearchExtractor(final String query,
+                                              final List<String> contentFilter,
+                                              final String sortFilter) throws ExtractionException {
+        return getSearchExtractor(getSearchQHFactory()
+                .fromQuery(query, contentFilter, sortFilter));
+    }
+
+    public ChannelExtractor getChannelExtractor(final String id,
+                                                final List<String> contentFilter,
+                                                final String sortFilter)
+            throws ExtractionException {
+        return getChannelExtractor(getChannelLHFactory()
+                .fromQuery(id, contentFilter, sortFilter));
+    }
+
+    public PlaylistExtractor getPlaylistExtractor(final String id,
+                                                  final List<String> contentFilter,
+                                                  final String sortFilter)
+            throws ExtractionException {
+        return getPlaylistExtractor(getPlaylistLHFactory()
+                .fromQuery(id, contentFilter, sortFilter));
+    }
+
+    /*//////////////////////////////////////////////////////////////////////////
+    // Short extractors overloads
+    //////////////////////////////////////////////////////////////////////////*/
+
+    public SearchExtractor getSearchExtractor(final String query) throws ExtractionException {
+        return getSearchExtractor(getSearchQHFactory().fromQuery(query));
+    }
+
+    public ChannelExtractor getChannelExtractor(final String url) throws ExtractionException {
+        return getChannelExtractor(getChannelLHFactory().fromUrl(url));
+    }
+
+    public ChannelTabExtractor getChannelTabExtractorFromId(final String id, final String tab)
+            throws ExtractionException {
+        return getChannelTabExtractor(getChannelTabLHFactory().fromQuery(
+                id, Collections.singletonList(tab), ""));
+    }
+
+    public ChannelTabExtractor getChannelTabExtractorFromIdAndBaseUrl(final String id,
+                                                                      final String tab,
+                                                                      final String baseUrl)
+            throws ExtractionException {
+        return getChannelTabExtractor(getChannelTabLHFactory().fromQuery(
+                id, Collections.singletonList(tab), "", baseUrl));
+    }
+
+    public PlaylistExtractor getPlaylistExtractor(final String url) throws ExtractionException {
+        return getPlaylistExtractor(getPlaylistLHFactory().fromUrl(url));
+    }
+
+    public StreamExtractor getStreamExtractor(final String url) throws ExtractionException {
+        return getStreamExtractor(getStreamLHFactory().fromUrl(url));
+    }
+
+    public CommentsExtractor getCommentsExtractor(final String url) throws ExtractionException {
+        final ListLinkHandlerFactory listLinkHandlerFactory = getCommentsLHFactory();
+        if (listLinkHandlerFactory == null) {
+            return null;
+        }
+        return getCommentsExtractor(listLinkHandlerFactory.fromUrl(url));
+    }
+
+    /*//////////////////////////////////////////////////////////////////////////
+    // Utils
+    //////////////////////////////////////////////////////////////////////////*/
+
+    /**
+     * Figures out where the link is pointing to (a channel, a video, a playlist, etc.)
+     * @param url the url on which it should be decided of which link type it is
+     * @return the link type of url
+     */
+    public final LinkType getLinkTypeByUrl(final String url) throws ParsingException {
+        final String polishedUrl = Utils.followGoogleRedirectIfNeeded(url);
+
+        final LinkHandlerFactory sH = getStreamLHFactory();
+        final LinkHandlerFactory cH = getChannelLHFactory();
+        final LinkHandlerFactory pH = getPlaylistLHFactory();
+
+        if (sH != null && sH.acceptUrl(polishedUrl)) {
+            return LinkType.STREAM;
+        } else if (cH != null && cH.acceptUrl(polishedUrl)) {
+            return LinkType.CHANNEL;
+        } else if (pH != null && pH.acceptUrl(polishedUrl)) {
+            return LinkType.PLAYLIST;
+        } else {
+            return LinkType.NONE;
+        }
+    }
+
+    /*//////////////////////////////////////////////////////////////////////////
+    // Localization
+    //////////////////////////////////////////////////////////////////////////*/
+
+    /**
+     * Returns a list of localizations that this service supports.
+     */
+    public List<Localization> getSupportedLocalizations() {
+        return Collections.singletonList(Localization.DEFAULT);
+    }
+
+    /**
+     * Returns a list of countries that this service supports.<br>
+     */
+    public List<ContentCountry> getSupportedCountries() {
+        return Collections.singletonList(ContentCountry.DEFAULT);
+    }
+
+    /**
+     * Returns the localization that should be used in this service. It will get which localization
+     * the user prefer (using {@link NewPipe#getPreferredLocalization()}), then it will:
+     * <ul>
+     * <li>Check if the exactly localization is supported by this service.</li>
+     * <li>If not, check if a less specific localization is available, using only the language
+     * code.</li>
+     * <li>Fallback to the {@link Localization#DEFAULT default} localization.</li>
+     * </ul>
+     */
+    public Localization getLocalization() {
+        final Localization preferredLocalization = NewPipe.getPreferredLocalization();
+
+        // Check the localization's language and country
+        if (getSupportedLocalizations().contains(preferredLocalization)) {
+            return preferredLocalization;
+        }
+
+        // Fallback to the first supported language that matches the preferred language
+        for (final Localization supportedLanguage : getSupportedLocalizations()) {
+            if (supportedLanguage.getLanguageCode()
+                    .equals(preferredLocalization.getLanguageCode())) {
+                return supportedLanguage;
+            }
+        }
+
+        return Localization.DEFAULT;
+    }
+
+    /**
+     * Returns the country that should be used to fetch content in this service. It will get which
+     * country the user prefer (using {@link NewPipe#getPreferredContentCountry()}), then it will:
+     * <ul>
+     * <li>Check if the country is supported by this service.</li>
+     * <li>If not, fallback to the {@link ContentCountry#DEFAULT default} country.</li>
+     * </ul>
+     */
+    public ContentCountry getContentCountry() {
+        final ContentCountry preferredContentCountry = NewPipe.getPreferredContentCountry();
+
+        if (getSupportedCountries().contains(preferredContentCountry)) {
+            return preferredContentCountry;
+        }
+
+        return ContentCountry.DEFAULT;
+    }
+
+    /**
+     * Get an instance of the time ago parser using the patterns related to the passed localization.
+     * <br><br>
+     * Just like {@link #getLocalization()}, it will also try to fallback to a less specific
+     * localization if the exact one is not available/supported.
+     *
+     * @throws IllegalArgumentException if the localization is not supported (parsing patterns are
+     *                                  not present).
+     */
+    public TimeAgoParser getTimeAgoParser(final Localization localization) {
+        final TimeAgoParser targetParser = TimeAgoPatternsManager.getTimeAgoParserFor(localization);
+
+        if (targetParser != null) {
+            return targetParser;
+        }
+
+        if (!localization.getCountryCode().isEmpty()) {
+            final Localization lessSpecificLocalization
+                    = new Localization(localization.getLanguageCode());
+            final TimeAgoParser lessSpecificParser
+                    = TimeAgoPatternsManager.getTimeAgoParserFor(lessSpecificLocalization);
+
+            if (lessSpecificParser != null) {
+                return lessSpecificParser;
+            }
+        }
+
+        throw new IllegalArgumentException(
+                "Localization is not supported (\"" + localization + "\")");
+    }
+
+}

extractor/src/main/java/org/schabi/newpipe/extractor/channel/ChannelExtractor.java

@@ -0,0 +1,58 @@
+/*
+ * Created by Christian Schabesberger on 25.07.16.
+ *
+ * Copyright (C) 2016 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * ChannelExtractor.java is part of NewPipe Extractor.
+ *
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * NewPipe Extractor is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NewPipe Extractor.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package org.schabi.newpipe.extractor.channel;
+
+import org.schabi.newpipe.extractor.Extractor;
+import org.schabi.newpipe.extractor.Image;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+
+import javax.annotation.Nonnull;
+import java.util.List;
+
+public abstract class ChannelExtractor extends Extractor {
+
+    public static final long UNKNOWN_SUBSCRIBER_COUNT = -1;
+
+    protected ChannelExtractor(final StreamingService service, final ListLinkHandler linkHandler) {
+        super(service, linkHandler);
+    }
+
+    @Nonnull
+    public abstract List<Image> getAvatars() throws ParsingException;
+    @Nonnull
+    public abstract List<Image> getBanners() throws ParsingException;
+    public abstract String getFeedUrl() throws ParsingException;
+    public abstract long getSubscriberCount() throws ParsingException;
+    public abstract String getDescription() throws ParsingException;
+    public abstract String getParentChannelName() throws ParsingException;
+    public abstract String getParentChannelUrl() throws ParsingException;
+    @Nonnull
+    public abstract List<Image> getParentChannelAvatars() throws ParsingException;
+    public abstract boolean isVerified() throws ParsingException;
+    @Nonnull
+    public abstract List<ListLinkHandler> getTabs() throws ParsingException;
+    @Nonnull
+    public List<String> getTags() throws ParsingException {
+        return List.of();
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/channel/ChannelInfo.java

@@ -0,0 +1,252 @@
+/*
+ * Created by Christian Schabesberger on 31.07.16.
+ *
+ * Copyright (C) 2016 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * ChannelInfo.java is part of NewPipe Extractor.
+ *
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * NewPipe Extractor is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NewPipe Extractor.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package org.schabi.newpipe.extractor.channel;
+
+import org.schabi.newpipe.extractor.Info;
+import org.schabi.newpipe.extractor.Image;
+import org.schabi.newpipe.extractor.NewPipe;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+
+import java.io.IOException;
+import java.util.List;
+
+import javax.annotation.Nonnull;
+
+public class ChannelInfo extends Info {
+
+    public ChannelInfo(final int serviceId,
+                       final String id,
+                       final String url,
+                       final String originalUrl,
+                       final String name) {
+        super(serviceId, id, url, originalUrl, name);
+    }
+
+    public static ChannelInfo getInfo(final String url) throws IOException, ExtractionException {
+        return getInfo(NewPipe.getServiceByUrl(url), url);
+    }
+
+    public static ChannelInfo getInfo(final StreamingService service, final String url)
+            throws IOException, ExtractionException {
+        final ChannelExtractor extractor = service.getChannelExtractor(url);
+        extractor.fetchPage();
+        return getInfo(extractor);
+    }
+
+    public static ChannelInfo getInfo(final ChannelExtractor extractor)
+            throws IOException, ExtractionException {
+
+        final int serviceId = extractor.getServiceId();
+        final String id = extractor.getId();
+        final String url = extractor.getUrl();
+        final String originalUrl = extractor.getOriginalUrl();
+        final String name = extractor.getName();
+
+        final ChannelInfo info = new ChannelInfo(serviceId, id, url, originalUrl, name);
+
+        try {
+            info.setAvatars(extractor.getAvatars());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        try {
+            info.setBanners(extractor.getBanners());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        try {
+            info.setFeedUrl(extractor.getFeedUrl());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        try {
+            info.setSubscriberCount(extractor.getSubscriberCount());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        try {
+            info.setDescription(extractor.getDescription());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        try {
+            info.setParentChannelName(extractor.getParentChannelName());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        try {
+            info.setParentChannelUrl(extractor.getParentChannelUrl());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        try {
+            info.setParentChannelAvatars(extractor.getParentChannelAvatars());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        try {
+            info.setVerified(extractor.isVerified());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        try {
+            info.setTabs(extractor.getTabs());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        try {
+            info.setTags(extractor.getTags());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        return info;
+    }
+
+    private String parentChannelName;
+    private String parentChannelUrl;
+    private String feedUrl;
+    private long subscriberCount = -1;
+    private String description;
+    private String[] donationLinks;
+    @Nonnull
+    private List<Image> avatars = List.of();
+    @Nonnull
+    private List<Image> banners = List.of();
+    @Nonnull
+    private List<Image> parentChannelAvatars = List.of();
+    private boolean verified;
+    private List<ListLinkHandler> tabs = List.of();
+    private List<String> tags = List.of();
+
+    public String getParentChannelName() {
+        return parentChannelName;
+    }
+
+    public void setParentChannelName(final String parentChannelName) {
+        this.parentChannelName = parentChannelName;
+    }
+
+    public String getParentChannelUrl() {
+        return parentChannelUrl;
+    }
+
+    public void setParentChannelUrl(final String parentChannelUrl) {
+        this.parentChannelUrl = parentChannelUrl;
+    }
+
+    @Nonnull
+    public List<Image> getParentChannelAvatars() {
+        return parentChannelAvatars;
+    }
+
+    public void setParentChannelAvatars(@Nonnull final List<Image> parentChannelAvatars) {
+        this.parentChannelAvatars = parentChannelAvatars;
+    }
+
+    @Nonnull
+    public List<Image> getAvatars() {
+        return avatars;
+    }
+
+    public void setAvatars(@Nonnull final List<Image> avatars) {
+        this.avatars = avatars;
+    }
+
+    @Nonnull
+    public List<Image> getBanners() {
+        return banners;
+    }
+
+    public void setBanners(@Nonnull final List<Image> banners) {
+        this.banners = banners;
+    }
+
+    public String getFeedUrl() {
+        return feedUrl;
+    }
+
+    public void setFeedUrl(final String feedUrl) {
+        this.feedUrl = feedUrl;
+    }
+
+    public long getSubscriberCount() {
+        return subscriberCount;
+    }
+
+    public void setSubscriberCount(final long subscriberCount) {
+        this.subscriberCount = subscriberCount;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+
+    public void setDescription(final String description) {
+        this.description = description;
+    }
+
+    public String[] getDonationLinks() {
+        return donationLinks;
+    }
+
+    public void setDonationLinks(final String[] donationLinks) {
+        this.donationLinks = donationLinks;
+    }
+
+    public boolean isVerified() {
+        return verified;
+    }
+
+    public void setVerified(final boolean verified) {
+        this.verified = verified;
+    }
+
+    @Nonnull
+    public List<ListLinkHandler> getTabs() {
+        return tabs;
+    }
+
+    public void setTabs(@Nonnull final List<ListLinkHandler> tabs) {
+        this.tabs = tabs;
+    }
+
+    @Nonnull
+    public List<String> getTags() {
+        return tags;
+    }
+
+    public void setTags(@Nonnull final List<String> tags) {
+        this.tags = tags;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/channel/ChannelInfoItem.java

@@ -0,0 +1,67 @@
+package org.schabi.newpipe.extractor.channel;
+
+import org.schabi.newpipe.extractor.InfoItem;
+
+/*
+ * Created by Christian Schabesberger on 11.02.17.
+ *
+ * Copyright (C) 2017 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * ChannelInfoItem.java is part of NewPipe Extractor.
+ *
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * NewPipe Extractor is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+public class ChannelInfoItem extends InfoItem {
+
+    private String description;
+    private long subscriberCount = -1;
+    private long streamCount = -1;
+    private boolean verified = false;
+
+    public ChannelInfoItem(final int serviceId, final String url, final String name) {
+        super(InfoType.CHANNEL, serviceId, url, name);
+    }
+
+    public String getDescription() {
+        return description;
+    }
+
+    public void setDescription(final String description) {
+        this.description = description;
+    }
+
+    public long getSubscriberCount() {
+        return subscriberCount;
+    }
+
+    public void setSubscriberCount(final long subscriberCount) {
+        this.subscriberCount = subscriberCount;
+    }
+
+    public long getStreamCount() {
+        return streamCount;
+    }
+
+    public void setStreamCount(final long streamCount) {
+        this.streamCount = streamCount;
+    }
+
+    public boolean isVerified() {
+        return verified;
+    }
+
+    public void setVerified(final boolean verified) {
+        this.verified = verified;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/channel/ChannelInfoItemExtractor.java

@@ -1,32 +1,34 @@
 package org.schabi.newpipe.extractor.channel;
 
+import org.schabi.newpipe.extractor.InfoItemExtractor;
 import org.schabi.newpipe.extractor.exceptions.ParsingException;
 
-/**
+/*
  * Created by Christian Schabesberger on 12.02.17.
  *
- * Copyright (C) Christian Schabesberger 2017 <chris.schabesberger@mailbox.org>
- * ChannelInfoItemExtractor.java is part of NewPipe.
+ * Copyright (C) 2017 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * ChannelInfoItemExtractor.java is part of NewPipe Extractor.
  *
- * NewPipe is free software: you can redistribute it and/or modify
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * NewPipe is distributed in the hope that it will be useful,
+ * NewPipe Extractor is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-public interface ChannelInfoItemExtractor {
-    String getThumbnailUrl() throws ParsingException;
-    String getChannelName() throws ParsingException;
-    String getWebPageUrl() throws ParsingException;
+public interface ChannelInfoItemExtractor extends InfoItemExtractor {
     String getDescription() throws ParsingException;
+
     long getSubscriberCount() throws ParsingException;
-    int getVideoAmount() throws ParsingException;
+
+    long getStreamCount() throws ParsingException;
+
+    boolean isVerified() throws ParsingException;
 }

extractor/src/main/java/org/schabi/newpipe/extractor/channel/ChannelInfoItemsCollector.java

@@ -0,0 +1,67 @@
+/*
+ * Created by Christian Schabesberger on 12.02.17.
+ *
+ * Copyright (C) 2017 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * ChannelInfoItemsCollector.java is part of NewPipe Extractor.
+ *
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * NewPipe Extractor is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NewPipe Extractor.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package org.schabi.newpipe.extractor.channel;
+
+import org.schabi.newpipe.extractor.InfoItemsCollector;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+
+public final class ChannelInfoItemsCollector
+        extends InfoItemsCollector<ChannelInfoItem, ChannelInfoItemExtractor> {
+    public ChannelInfoItemsCollector(final int serviceId) {
+        super(serviceId);
+    }
+
+    @Override
+    public ChannelInfoItem extract(final ChannelInfoItemExtractor extractor)
+            throws ParsingException {
+        final ChannelInfoItem resultItem = new ChannelInfoItem(
+                getServiceId(), extractor.getUrl(), extractor.getName());
+
+        // optional information
+        try {
+            resultItem.setSubscriberCount(extractor.getSubscriberCount());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setStreamCount(extractor.getStreamCount());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setThumbnails(extractor.getThumbnails());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setDescription(extractor.getDescription());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setVerified(extractor.isVerified());
+        } catch (final Exception e) {
+            addError(e);
+        }
+
+        return resultItem;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/channel/tabs/ChannelTabExtractor.java

@@ -0,0 +1,25 @@
+package org.schabi.newpipe.extractor.channel.tabs;
+
+import org.schabi.newpipe.extractor.InfoItem;
+import org.schabi.newpipe.extractor.ListExtractor;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+
+import javax.annotation.Nonnull;
+
+/**
+ * A {@link ListExtractor} of {@link InfoItem}s for tabs of channels.
+ */
+public abstract class ChannelTabExtractor extends ListExtractor<InfoItem> {
+
+    protected ChannelTabExtractor(@Nonnull final StreamingService service,
+                                  @Nonnull final ListLinkHandler linkHandler) {
+        super(service, linkHandler);
+    }
+
+    @Nonnull
+    @Override
+    public String getName() {
+        return getLinkHandler().getContentFilters().get(0);
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/channel/tabs/ChannelTabInfo.java

@@ -0,0 +1,70 @@
+package org.schabi.newpipe.extractor.channel.tabs;
+
+import org.schabi.newpipe.extractor.InfoItem;
+import org.schabi.newpipe.extractor.ListExtractor;
+import org.schabi.newpipe.extractor.ListInfo;
+import org.schabi.newpipe.extractor.Page;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.channel.ChannelInfo;
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+import org.schabi.newpipe.extractor.utils.ExtractorHelper;
+
+import javax.annotation.Nonnull;
+import java.io.IOException;
+
+public class ChannelTabInfo extends ListInfo<InfoItem> {
+
+    public ChannelTabInfo(final int serviceId,
+                          @Nonnull final ListLinkHandler linkHandler) {
+        super(serviceId, linkHandler, linkHandler.getContentFilters().get(0));
+    }
+
+    /**
+     * Get a {@link ChannelTabInfo} instance from the given service and tab handler.
+     *
+     * @param service streaming service
+     * @param linkHandler Channel tab handler (from {@link ChannelInfo})
+     * @return the extracted {@link ChannelTabInfo}
+     */
+    @Nonnull
+    public static ChannelTabInfo getInfo(@Nonnull final StreamingService service,
+                                         @Nonnull final ListLinkHandler linkHandler)
+            throws ExtractionException, IOException {
+        final ChannelTabExtractor extractor = service.getChannelTabExtractor(linkHandler);
+        extractor.fetchPage();
+        return getInfo(extractor);
+    }
+
+    /**
+     * Get a {@link ChannelTabInfo} instance from a {@link ChannelTabExtractor}.
+     *
+     * @param extractor an extractor where {@code fetchPage()} was already got called on
+     * @return the extracted {@link ChannelTabInfo}
+     */
+    @Nonnull
+    public static ChannelTabInfo getInfo(@Nonnull final ChannelTabExtractor extractor) {
+        final ChannelTabInfo info =
+                new ChannelTabInfo(extractor.getServiceId(), extractor.getLinkHandler());
+
+        try {
+            info.setOriginalUrl(extractor.getOriginalUrl());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        final ListExtractor.InfoItemsPage<InfoItem> page
+                = ExtractorHelper.getItemsPageOrLogError(info, extractor);
+        info.setRelatedItems(page.getItems());
+        info.setNextPage(page.getNextPage());
+
+        return info;
+    }
+
+    public static ListExtractor.InfoItemsPage<InfoItem> getMoreItems(
+            @Nonnull final StreamingService service,
+            @Nonnull final ListLinkHandler linkHandler,
+            @Nonnull final Page page) throws ExtractionException, IOException {
+        return service.getChannelTabExtractor(linkHandler).getPage(page);
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/channel/tabs/ChannelTabs.java

@@ -0,0 +1,17 @@
+package org.schabi.newpipe.extractor.channel.tabs;
+
+/**
+ * Constants of channel tabs supported by the extractor.
+ */
+public final class ChannelTabs {
+    public static final String VIDEOS = "videos";
+    public static final String TRACKS = "tracks";
+    public static final String SHORTS = "shorts";
+    public static final String LIVESTREAMS = "livestreams";
+    public static final String CHANNELS = "channels";
+    public static final String PLAYLISTS = "playlists";
+    public static final String ALBUMS = "albums";
+
+    private ChannelTabs() {
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/comments/CommentsExtractor.java

@@ -0,0 +1,37 @@
+package org.schabi.newpipe.extractor.comments;
+
+import org.schabi.newpipe.extractor.ListExtractor;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+
+import javax.annotation.Nonnull;
+
+public abstract class CommentsExtractor extends ListExtractor<CommentsInfoItem> {
+
+    public CommentsExtractor(final StreamingService service, final ListLinkHandler uiHandler) {
+        super(service, uiHandler);
+    }
+
+    /**
+     * @apiNote Warning: This method is experimental and may get removed in a future release.
+     * @return <code>true</code> if the comments are disabled otherwise <code>false</code> (default)
+     */
+    public boolean isCommentsDisabled() throws ExtractionException {
+        return false;
+    }
+
+    /**
+     * @return the total number of comments
+     */
+    public int getCommentsCount() throws ExtractionException {
+        return -1;
+    }
+
+    @Nonnull
+    @Override
+    public String getName() throws ParsingException {
+        return "Comments";
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/comments/CommentsInfo.java

@@ -0,0 +1,126 @@
+package org.schabi.newpipe.extractor.comments;
+
+import org.schabi.newpipe.extractor.ListExtractor.InfoItemsPage;
+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.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+import org.schabi.newpipe.extractor.utils.ExtractorHelper;
+
+import java.io.IOException;
+
+public final class CommentsInfo extends ListInfo<CommentsInfoItem> {
+
+    private CommentsInfo(
+            final int serviceId,
+            final ListLinkHandler listUrlIdHandler,
+            final String name) {
+        super(serviceId, listUrlIdHandler, name);
+    }
+
+    public static CommentsInfo getInfo(final String url) throws IOException, ExtractionException {
+        return getInfo(NewPipe.getServiceByUrl(url), url);
+    }
+
+    public static CommentsInfo getInfo(final StreamingService service, final String url)
+            throws ExtractionException, IOException {
+        return getInfo(service.getCommentsExtractor(url));
+    }
+
+    public static CommentsInfo getInfo(final CommentsExtractor commentsExtractor)
+            throws IOException, ExtractionException {
+        // for services which do not have a comments extractor
+        if (commentsExtractor == null) {
+            return null;
+        }
+
+        commentsExtractor.fetchPage();
+
+        final String name = commentsExtractor.getName();
+        final int serviceId = commentsExtractor.getServiceId();
+        final ListLinkHandler listUrlIdHandler = commentsExtractor.getLinkHandler();
+
+        final CommentsInfo commentsInfo = new CommentsInfo(serviceId, listUrlIdHandler, name);
+        commentsInfo.setCommentsExtractor(commentsExtractor);
+        final InfoItemsPage<CommentsInfoItem> initialCommentsPage =
+                ExtractorHelper.getItemsPageOrLogError(commentsInfo, commentsExtractor);
+        commentsInfo.setCommentsDisabled(commentsExtractor.isCommentsDisabled());
+        commentsInfo.setRelatedItems(initialCommentsPage.getItems());
+        try {
+            commentsInfo.setCommentsCount(commentsExtractor.getCommentsCount());
+        } catch (final Exception e) {
+            commentsInfo.addError(e);
+        }
+        commentsInfo.setNextPage(initialCommentsPage.getNextPage());
+
+        return commentsInfo;
+    }
+
+    public static InfoItemsPage<CommentsInfoItem> getMoreItems(
+            final CommentsInfo commentsInfo,
+            final Page page) throws ExtractionException, IOException {
+        return getMoreItems(NewPipe.getService(commentsInfo.getServiceId()), commentsInfo.getUrl(),
+                page);
+    }
+
+    public static InfoItemsPage<CommentsInfoItem> getMoreItems(
+            final StreamingService service,
+            final CommentsInfo commentsInfo,
+            final Page page) throws IOException, ExtractionException {
+        return getMoreItems(service, commentsInfo.getUrl(), page);
+    }
+
+    public static InfoItemsPage<CommentsInfoItem> getMoreItems(
+            final StreamingService service,
+            final String url,
+            final Page page) throws IOException, ExtractionException {
+        return service.getCommentsExtractor(url).getPage(page);
+    }
+
+    private transient CommentsExtractor commentsExtractor;
+    private boolean commentsDisabled = false;
+    private int commentsCount;
+
+    public CommentsExtractor getCommentsExtractor() {
+        return commentsExtractor;
+    }
+
+    public void setCommentsExtractor(final CommentsExtractor commentsExtractor) {
+        this.commentsExtractor = commentsExtractor;
+    }
+
+    /**
+     * @return {@code true} if the comments are disabled otherwise {@code false} (default)
+     * @see CommentsExtractor#isCommentsDisabled()
+     */
+    public boolean isCommentsDisabled() {
+        return commentsDisabled;
+    }
+
+    /**
+     * @param commentsDisabled {@code true} if the comments are disabled otherwise {@code false}
+     */
+    public void setCommentsDisabled(final boolean commentsDisabled) {
+        this.commentsDisabled = commentsDisabled;
+    }
+
+    /**
+     * Returns the total number of comments.
+     *
+     * @return the total number of comments
+     */
+    public int getCommentsCount() {
+        return commentsCount;
+    }
+
+    /**
+     * Sets the total number of comments.
+     *
+     * @param commentsCount the commentsCount to set.
+     */
+    public void setCommentsCount(final int commentsCount) {
+        this.commentsCount = commentsCount;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/comments/CommentsInfoItem.java

@@ -0,0 +1,197 @@
+package org.schabi.newpipe.extractor.comments;
+
+import org.schabi.newpipe.extractor.Image;
+import org.schabi.newpipe.extractor.InfoItem;
+import org.schabi.newpipe.extractor.Page;
+import org.schabi.newpipe.extractor.localization.DateWrapper;
+import org.schabi.newpipe.extractor.stream.Description;
+
+import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
+import java.util.List;
+
+public class CommentsInfoItem extends InfoItem {
+
+    private String commentId;
+    @Nonnull
+    private Description commentText = Description.EMPTY_DESCRIPTION;
+    private String uploaderName;
+    @Nonnull
+    private List<Image> uploaderAvatars = List.of();
+    private String uploaderUrl;
+    private boolean uploaderVerified;
+    private String textualUploadDate;
+    @Nullable
+    private DateWrapper uploadDate;
+    private int likeCount;
+    private String textualLikeCount;
+    private boolean heartedByUploader;
+    private boolean pinned;
+    private int streamPosition;
+    private int replyCount;
+    @Nullable
+    private Page replies;
+    private boolean isChannelOwner;
+    private boolean creatorReply;
+
+    public static final int NO_LIKE_COUNT = -1;
+    public static final int NO_STREAM_POSITION = -1;
+
+    public static final int UNKNOWN_REPLY_COUNT = -1;
+
+    public CommentsInfoItem(final int serviceId, final String url, final String name) {
+        super(InfoType.COMMENT, serviceId, url, name);
+    }
+
+    public String getCommentId() {
+        return commentId;
+    }
+
+    public void setCommentId(final String commentId) {
+        this.commentId = commentId;
+    }
+
+    @Nonnull
+    public Description getCommentText() {
+        return commentText;
+    }
+
+    public void setCommentText(@Nonnull final Description commentText) {
+        this.commentText = commentText;
+    }
+
+    public String getUploaderName() {
+        return uploaderName;
+    }
+
+    public void setUploaderName(final String uploaderName) {
+        this.uploaderName = uploaderName;
+    }
+
+    @Nonnull
+    public List<Image> getUploaderAvatars() {
+        return uploaderAvatars;
+    }
+
+    public void setUploaderAvatars(@Nonnull final List<Image> uploaderAvatars) {
+        this.uploaderAvatars = uploaderAvatars;
+    }
+
+    public String getUploaderUrl() {
+        return uploaderUrl;
+    }
+
+    public void setUploaderUrl(final String uploaderUrl) {
+        this.uploaderUrl = uploaderUrl;
+    }
+
+    public String getTextualUploadDate() {
+        return textualUploadDate;
+    }
+
+    public void setTextualUploadDate(final String textualUploadDate) {
+        this.textualUploadDate = textualUploadDate;
+    }
+
+    @Nullable
+    public DateWrapper getUploadDate() {
+        return uploadDate;
+    }
+
+    public void setUploadDate(@Nullable final DateWrapper uploadDate) {
+        this.uploadDate = uploadDate;
+    }
+
+    /**
+     * @return the comment's like count or {@link CommentsInfoItem#NO_LIKE_COUNT} if it is
+     * unavailable
+     */
+    public int getLikeCount() {
+        return likeCount;
+    }
+
+    public void setLikeCount(final int likeCount) {
+        this.likeCount = likeCount;
+    }
+
+    public String getTextualLikeCount() {
+        return textualLikeCount;
+    }
+
+    public void setTextualLikeCount(final String textualLikeCount) {
+        this.textualLikeCount = textualLikeCount;
+    }
+
+    public void setHeartedByUploader(final boolean isHeartedByUploader) {
+        this.heartedByUploader = isHeartedByUploader;
+    }
+
+    public boolean isHeartedByUploader() {
+        return this.heartedByUploader;
+    }
+
+    public boolean isPinned() {
+        return pinned;
+    }
+
+    public void setPinned(final boolean pinned) {
+        this.pinned = pinned;
+    }
+
+    public void setUploaderVerified(final boolean uploaderVerified) {
+        this.uploaderVerified = uploaderVerified;
+    }
+
+    public boolean isUploaderVerified() {
+        return uploaderVerified;
+    }
+
+    public void setStreamPosition(final int streamPosition) {
+        this.streamPosition = streamPosition;
+    }
+
+    /**
+     * Get the playback position of the stream to which this comment belongs.
+     * This is not supported by all services.
+     *
+     * @return the playback position in seconds or {@link #NO_STREAM_POSITION} if not available
+     */
+    public int getStreamPosition() {
+        return streamPosition;
+    }
+
+    public void setReplyCount(final int replyCount) {
+        this.replyCount = replyCount;
+    }
+
+    public int getReplyCount() {
+        return replyCount;
+    }
+
+    public void setReplies(@Nullable final Page replies) {
+        this.replies = replies;
+    }
+
+    @Nullable
+    public Page getReplies() {
+        return this.replies;
+    }
+
+    public void setChannelOwner(final boolean channelOwner) {
+        this.isChannelOwner = channelOwner;
+    }
+
+    public boolean isChannelOwner() {
+        return isChannelOwner;
+    }
+
+
+    public void setCreatorReply(final boolean creatorReply) {
+        this.creatorReply = creatorReply;
+    }
+
+    public boolean hasCreatorReply() {
+        return creatorReply;
+    }
+
+}

extractor/src/main/java/org/schabi/newpipe/extractor/comments/CommentsInfoItemExtractor.java

@@ -0,0 +1,152 @@
+package org.schabi.newpipe.extractor.comments;
+
+import org.schabi.newpipe.extractor.Image;
+import org.schabi.newpipe.extractor.InfoItemExtractor;
+import org.schabi.newpipe.extractor.Page;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.localization.DateWrapper;
+import org.schabi.newpipe.extractor.services.youtube.extractors.YoutubeCommentsInfoItemExtractor;
+import org.schabi.newpipe.extractor.stream.Description;
+import org.schabi.newpipe.extractor.stream.StreamExtractor;
+
+import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
+import java.util.List;
+
+public interface CommentsInfoItemExtractor extends InfoItemExtractor {
+
+    /**
+     * Return the like count of the comment,
+     * or {@link CommentsInfoItem#NO_LIKE_COUNT} if it is unavailable.
+     *
+     * <br>
+     * <p>
+     * NOTE: Currently only implemented for YT {@link
+     * YoutubeCommentsInfoItemExtractor#getLikeCount()}
+     * with limitations (only approximate like count is returned)
+     *
+     * @return the comment's like count
+     * or {@link CommentsInfoItem#NO_LIKE_COUNT} if it is unavailable
+     * @see StreamExtractor#getLikeCount()
+     */
+    default int getLikeCount() throws ParsingException {
+        return CommentsInfoItem.NO_LIKE_COUNT;
+    }
+
+    /**
+     * The unmodified like count given by the service
+     * <br>
+     * It may be language dependent
+     */
+    default String getTextualLikeCount() throws ParsingException {
+        return "";
+    }
+
+    /**
+     * The text of the comment
+     */
+    @Nonnull
+    default Description getCommentText() throws ParsingException {
+        return Description.EMPTY_DESCRIPTION;
+    }
+
+    /**
+     * The upload date given by the service, unmodified
+     *
+     * @see StreamExtractor#getTextualUploadDate()
+     */
+    default String getTextualUploadDate() throws ParsingException {
+        return "";
+    }
+
+    /**
+     * The upload date wrapped with DateWrapper class
+     *
+     * @see StreamExtractor#getUploadDate()
+     */
+    @Nullable
+    default DateWrapper getUploadDate() throws ParsingException {
+        return null;
+    }
+
+    default String getCommentId() throws ParsingException {
+        return "";
+    }
+
+    default String getUploaderUrl() throws ParsingException {
+        return "";
+    }
+
+    default String getUploaderName() throws ParsingException {
+        return "";
+    }
+
+    @Nonnull
+    default List<Image> getUploaderAvatars() throws ParsingException {
+        return List.of();
+    }
+
+    /**
+     * Whether the comment has been hearted by the uploader
+     */
+    default boolean isHeartedByUploader() throws ParsingException {
+        return false;
+    }
+
+    /**
+     * Whether the comment is pinned
+     */
+    default boolean isPinned() throws ParsingException {
+        return false;
+    }
+
+    /**
+     * Whether the uploader is verified by the service
+     */
+    default boolean isUploaderVerified() throws ParsingException {
+        return false;
+    }
+
+    /**
+     * The playback position of the stream to which this comment belongs.
+     *
+     * @see CommentsInfoItem#getStreamPosition()
+     */
+    default int getStreamPosition() throws ParsingException {
+        return CommentsInfoItem.NO_STREAM_POSITION;
+    }
+
+    /**
+     * The count of comment replies.
+     *
+     * @return the count of the replies
+     * or {@link CommentsInfoItem#UNKNOWN_REPLY_COUNT} if replies are not supported
+     */
+    default int getReplyCount() throws ParsingException {
+        return CommentsInfoItem.UNKNOWN_REPLY_COUNT;
+    }
+
+    /**
+     * The continuation page which is used to get comment replies from.
+     *
+     * @return the continuation Page for the replies, or null if replies are not supported
+     */
+    @Nullable
+    default Page getReplies() throws ParsingException {
+        return null;
+    }
+
+    /**
+     * Whether the comment was made by the channel owner.
+     */
+    default boolean isChannelOwner() throws ParsingException {
+        return false;
+    }
+
+    /**
+     * Whether the comment was replied to by the creator.
+     */
+    default boolean hasCreatorReply() throws ParsingException {
+        return false;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/comments/CommentsInfoItemsCollector.java

@@ -0,0 +1,133 @@
+package org.schabi.newpipe.extractor.comments;
+
+import org.schabi.newpipe.extractor.InfoItemsCollector;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public final class CommentsInfoItemsCollector
+        extends InfoItemsCollector<CommentsInfoItem, CommentsInfoItemExtractor> {
+
+    public CommentsInfoItemsCollector(final int serviceId) {
+        super(serviceId);
+    }
+
+    @Override
+    public CommentsInfoItem extract(final CommentsInfoItemExtractor extractor)
+            throws ParsingException {
+        final CommentsInfoItem resultItem = new CommentsInfoItem(
+                getServiceId(), extractor.getUrl(), extractor.getName());
+
+        // optional information
+        try {
+            resultItem.setCommentId(extractor.getCommentId());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setCommentText(extractor.getCommentText());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setUploaderName(extractor.getUploaderName());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setUploaderAvatars(extractor.getUploaderAvatars());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setUploaderUrl(extractor.getUploaderUrl());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setTextualUploadDate(extractor.getTextualUploadDate());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setUploadDate(extractor.getUploadDate());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setLikeCount(extractor.getLikeCount());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setTextualLikeCount(extractor.getTextualLikeCount());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setThumbnails(extractor.getThumbnails());
+        } catch (final Exception e) {
+            addError(e);
+        }
+
+        try {
+            resultItem.setHeartedByUploader(extractor.isHeartedByUploader());
+        } catch (final Exception e) {
+            addError(e);
+        }
+
+        try {
+            resultItem.setPinned(extractor.isPinned());
+        } catch (final Exception e) {
+            addError(e);
+        }
+
+        try {
+            resultItem.setStreamPosition(extractor.getStreamPosition());
+        } catch (final Exception e) {
+            addError(e);
+        }
+
+        try {
+            resultItem.setReplyCount(extractor.getReplyCount());
+        } catch (final Exception e) {
+            addError(e);
+        }
+
+        try {
+            resultItem.setReplies(extractor.getReplies());
+        } catch (final Exception e) {
+            addError(e);
+        }
+
+        try {
+            resultItem.setChannelOwner(extractor.isChannelOwner());
+        } catch (final Exception e) {
+            addError(e);
+        }
+
+
+        try {
+            resultItem.setCreatorReply(extractor.hasCreatorReply());
+        } catch (final Exception e) {
+            addError(e);
+        }
+
+
+        return resultItem;
+    }
+
+    @Override
+    public void commit(final CommentsInfoItemExtractor extractor) {
+        try {
+            addItem(extract(extractor));
+        } catch (final Exception e) {
+            addError(e);
+        }
+    }
+
+    public List<CommentsInfoItem> getCommentsInfoItemList() {
+        return new ArrayList<>(super.getItems());
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/downloader/Downloader.java

@@ -0,0 +1,246 @@
+package org.schabi.newpipe.extractor.downloader;
+
+import org.schabi.newpipe.extractor.NewPipe;
+import org.schabi.newpipe.extractor.exceptions.ReCaptchaException;
+import org.schabi.newpipe.extractor.localization.Localization;
+
+import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
+import java.io.IOException;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * A base for downloader implementations that NewPipe will use
+ * to download needed resources during extraction.
+ */
+public abstract class Downloader {
+
+    /**
+     * Do a GET request to get the resource that the url is pointing to.<br>
+     * <br>
+     * This method calls {@link #get(String, Map, Localization)} with the default preferred
+     * localization. It should only be used when the resource that will be fetched won't be affected
+     * by the localization.
+     *
+     * @param url the URL that is pointing to the wanted resource
+     * @return the result of the GET request
+     */
+    public Response get(final String url) throws IOException, ReCaptchaException {
+        return get(url, null, NewPipe.getPreferredLocalization());
+    }
+
+    /**
+     * Do a GET request to get the resource that the url is pointing to.<br>
+     * <br>
+     * It will set the {@code Accept-Language} header to the language of the localization parameter.
+     *
+     * @param url          the URL that is pointing to the wanted resource
+     * @param localization the source of the value of the {@code Accept-Language} header
+     * @return the result of the GET request
+     */
+    public Response get(final String url, final Localization localization)
+            throws IOException, ReCaptchaException {
+        return get(url, null, localization);
+    }
+
+    /**
+     * Do a GET request with the specified headers.
+     *
+     * @param url     the URL that is pointing to the wanted resource
+     * @param headers a list of headers that will be used in the request.
+     *                Any default headers <b>should</b> be overridden by these.
+     * @return the result of the GET request
+     */
+    public Response get(final String url, @Nullable final Map<String, List<String>> headers)
+            throws IOException, ReCaptchaException {
+        return get(url, headers, NewPipe.getPreferredLocalization());
+    }
+
+    /**
+     * Do a GET request with the specified headers.<br>
+     * <br>
+     * It will set the {@code Accept-Language} header to the language of the localization parameter.
+     *
+     * @param url          the URL that is pointing to the wanted resource
+     * @param headers      a list of headers that will be used in the request.
+     *                     Any default headers <b>should</b> be overridden by these.
+     * @param localization the source of the value of the {@code Accept-Language} header
+     * @return the result of the GET request
+     */
+    public Response get(final String url,
+                        @Nullable final Map<String, List<String>> headers,
+                        final Localization localization)
+            throws IOException, ReCaptchaException {
+        return execute(Request.newBuilder()
+                .get(url)
+                .headers(headers)
+                .localization(localization)
+                .build());
+    }
+
+    /**
+     * Do a HEAD request.
+     *
+     * @param url the URL that is pointing to the wanted resource
+     * @return the result of the HEAD request
+     */
+    public Response head(final String url) throws IOException, ReCaptchaException {
+        return head(url, null);
+    }
+
+    /**
+     * Do a HEAD request with the specified headers.
+     *
+     * @param url     the URL that is pointing to the wanted resource
+     * @param headers a list of headers that will be used in the request.
+     *                Any default headers <b>should</b> be overridden by these.
+     * @return the result of the HEAD request
+     */
+    public Response head(final String url, @Nullable final Map<String, List<String>> headers)
+            throws IOException, ReCaptchaException {
+        return execute(Request.newBuilder()
+                .head(url)
+                .headers(headers)
+                .build());
+    }
+
+    /**
+     * Do a POST request with the specified headers, sending the data array.
+     *
+     * @param url        the URL that is pointing to the wanted resource
+     * @param headers    a list of headers that will be used in the request.
+     *                   Any default headers <b>should</b> be overridden by these.
+     * @param dataToSend byte array that will be sent when doing the request.
+     * @return the result of the POST request
+     */
+    public Response post(final String url,
+                         @Nullable final Map<String, List<String>> headers,
+                         @Nullable final byte[] dataToSend)
+            throws IOException, ReCaptchaException {
+        return post(url, headers, dataToSend, NewPipe.getPreferredLocalization());
+    }
+
+    /**
+     * Do a POST request with the specified headers, sending the data array.
+     * <br>
+     * It will set the {@code Accept-Language} header to the language of the localization parameter.
+     *
+     * @param url          the URL that is pointing to the wanted resource
+     * @param headers      a list of headers that will be used in the request.
+     *                     Any default headers <b>should</b> be overridden by these.
+     * @param dataToSend   byte array that will be sent when doing the request.
+     * @param localization the source of the value of the {@code Accept-Language} header
+     * @return the result of the POST request
+     */
+    public Response post(final String url,
+                         @Nullable final Map<String, List<String>> headers,
+                         @Nullable final byte[] dataToSend,
+                         final Localization localization)
+            throws IOException, ReCaptchaException {
+        return execute(Request.newBuilder()
+                .post(url, dataToSend)
+                .headers(headers)
+                .localization(localization)
+                .build());
+    }
+
+    /**
+     * Convenient method to send a POST request using the specified value of the
+     * {@code Content-Type} header with a given {@link Localization}.
+     *
+     * @param url          the URL that is pointing to the wanted resource
+     * @param headers      a list of headers that will be used in the request.
+     *                     Any default headers <b>should</b> be overridden by these.
+     * @param dataToSend   byte array that will be sent when doing the request.
+     * @param localization the source of the value of the {@code Accept-Language} header
+     * @param contentType  the mime type of the body sent, which will be set as the value of the
+     *                     {@code Content-Type} header
+     * @return the result of the POST request
+     * @see #post(String, Map, byte[], Localization)
+     */
+    public Response postWithContentType(final String url,
+                                        @Nullable final Map<String, List<String>> headers,
+                                        @Nullable final byte[] dataToSend,
+                                        final Localization localization,
+                                        final String contentType)
+            throws IOException, ReCaptchaException {
+        final Map<String, List<String>> actualHeaders = new HashMap<>();
+        if (headers != null) {
+            actualHeaders.putAll(headers);
+        }
+        actualHeaders.put("Content-Type", Collections.singletonList(contentType));
+        return post(url, actualHeaders, dataToSend, localization);
+    }
+
+    /**
+     * Convenient method to send a POST request using the specified value of the
+     * {@code Content-Type} header.
+     *
+     * @param url         the URL that is pointing to the wanted resource
+     * @param headers     a list of headers that will be used in the request.
+     *                    Any default headers <b>should</b> be overridden by these.
+     * @param dataToSend  byte array that will be sent when doing the request.
+     * @param contentType the mime type of the body sent, which will be set as the value of the
+     *                    {@code Content-Type} header
+     * @return the result of the POST request
+     * @see #post(String, Map, byte[], Localization)
+     */
+    public Response postWithContentType(final String url,
+                                        @Nullable final Map<String, List<String>> headers,
+                                        @Nullable final byte[] dataToSend,
+                                        final String contentType)
+            throws IOException, ReCaptchaException {
+        return postWithContentType(url, headers, dataToSend, NewPipe.getPreferredLocalization(),
+                contentType);
+    }
+
+    /**
+     * Convenient method to send a POST request the JSON mime type as the value of the
+     * {@code Content-Type} header with a given {@link Localization}.
+     *
+     * @param url          the URL that is pointing to the wanted resource
+     * @param headers      a list of headers that will be used in the request.
+     *                     Any default headers <b>should</b> be overridden by these.
+     * @param dataToSend   byte array that will be sent when doing the request.
+     * @param localization the source of the value of the {@code Accept-Language} header
+     * @return the result of the POST request
+     * @see #post(String, Map, byte[], Localization)
+     */
+    public Response postWithContentTypeJson(final String url,
+                                            @Nullable final Map<String, List<String>> headers,
+                                            @Nullable final byte[] dataToSend,
+                                            final Localization localization)
+            throws IOException, ReCaptchaException {
+        return postWithContentType(url, headers, dataToSend, localization, "application/json");
+    }
+
+    /**
+     * Convenient method to send a POST request the JSON mime type as the value of the
+     * {@code Content-Type} header.
+     *
+     * @param url         the URL that is pointing to the wanted resource
+     * @param headers     a list of headers that will be used in the request.
+     *                    Any default headers <b>should</b> be overridden by these.
+     * @param dataToSend  byte array that will be sent when doing the request.
+     * @return the result of the POST request
+     * @see #post(String, Map, byte[], Localization)
+     */
+    public Response postWithContentTypeJson(final String url,
+                                            @Nullable final Map<String, List<String>> headers,
+                                            @Nullable final byte[] dataToSend)
+            throws IOException, ReCaptchaException {
+        return postWithContentTypeJson(url, headers, dataToSend,
+                NewPipe.getPreferredLocalization());
+    }
+
+    /**
+     * Do a request using the specified {@link Request} object.
+     *
+     * @return the result of the request
+     */
+    public abstract Response execute(@Nonnull Request request)
+            throws IOException, ReCaptchaException;
+}

extractor/src/main/java/org/schabi/newpipe/extractor/downloader/Request.java

@@ -0,0 +1,280 @@
+package org.schabi.newpipe.extractor.downloader;
+
+import org.schabi.newpipe.extractor.localization.Localization;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+
+import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
+
+/**
+ * An object that holds request information used when {@link Downloader#execute(Request) executing}
+ * a request.
+ */
+public class Request {
+    private final String httpMethod;
+    private final String url;
+    private final Map<String, List<String>> headers;
+    @Nullable
+    private final byte[] dataToSend;
+    @Nullable
+    private final Localization localization;
+
+    public Request(final String httpMethod,
+                   final String url,
+                   @Nullable final Map<String, List<String>> headers,
+                   @Nullable final byte[] dataToSend,
+                   @Nullable final Localization localization,
+                   final boolean automaticLocalizationHeader) {
+        this.httpMethod = Objects.requireNonNull(httpMethod, "Request's httpMethod is null");
+        this.url = Objects.requireNonNull(url, "Request's url is null");
+        this.dataToSend = dataToSend;
+        this.localization = localization;
+
+        final Map<String, List<String>> actualHeaders = new LinkedHashMap<>();
+        if (headers != null) {
+            actualHeaders.putAll(headers);
+        }
+        if (automaticLocalizationHeader && localization != null) {
+            actualHeaders.putAll(getHeadersFromLocalization(localization));
+        }
+
+        this.headers = Collections.unmodifiableMap(actualHeaders);
+    }
+
+    private Request(final Builder builder) {
+        this(builder.httpMethod, builder.url, builder.headers, builder.dataToSend,
+                builder.localization, builder.automaticLocalizationHeader);
+    }
+
+    /**
+     * A http method (i.e. {@code GET, POST, HEAD}).
+     */
+    public String httpMethod() {
+        return httpMethod;
+    }
+
+    /**
+     * The URL that is pointing to the wanted resource.
+     */
+    public String url() {
+        return url;
+    }
+
+    /**
+     * A list of headers that will be used in the request.<br>
+     * Any default headers that the implementation may have, <b>should</b> be overridden by these.
+     */
+    public Map<String, List<String>> headers() {
+        return headers;
+    }
+
+    /**
+     * An optional byte array that will be sent when doing the request, very commonly used in
+     * {@code POST} requests.<br>
+     * <br>
+     * The implementation should make note of some recommended headers
+     * (for example, {@code Content-Length} in a post request).
+     */
+    @Nullable
+    public byte[] dataToSend() {
+        return dataToSend;
+    }
+
+    /**
+     * A localization object that should be used when executing a request.<br>
+     * <br>
+     * Usually the {@code Accept-Language} will be set to this value (a helper
+     * method to do this easily: {@link Request#getHeadersFromLocalization(Localization)}).
+     */
+    @Nullable
+    public Localization localization() {
+        return localization;
+    }
+
+    public static Builder newBuilder() {
+        return new Builder();
+    }
+
+    public static final class Builder {
+        private String httpMethod;
+        private String url;
+        private final Map<String, List<String>> headers = new LinkedHashMap<>();
+        private byte[] dataToSend;
+        private Localization localization;
+        private boolean automaticLocalizationHeader = true;
+
+        public Builder() {
+        }
+
+        /**
+         * A http method (i.e. {@code GET, POST, HEAD}).
+         */
+        public Builder httpMethod(final String httpMethodToSet) {
+            this.httpMethod = httpMethodToSet;
+            return this;
+        }
+
+        /**
+         * The URL that is pointing to the wanted resource.
+         */
+        public Builder url(final String urlToSet) {
+            this.url = urlToSet;
+            return this;
+        }
+
+        /**
+         * A list of headers that will be used in the request.<br>
+         * Any default headers that the implementation may have, <b>should</b> be overridden by
+         * these.
+         */
+        public Builder headers(@Nullable final Map<String, List<String>> headersToSet) {
+            this.headers.clear();
+            if (headersToSet != null) {
+                this.headers.putAll(headersToSet);
+            }
+            return this;
+        }
+
+        /**
+         * An optional byte array that will be sent when doing the request, very commonly used in
+         * {@code POST} requests.<br>
+         * <br>
+         * The implementation should make note of some recommended headers
+         * (for example, {@code Content-Length} in a post request).
+         */
+        public Builder dataToSend(final byte[] dataToSendToSet) {
+            this.dataToSend = dataToSendToSet;
+            return this;
+        }
+
+        /**
+         * A localization object that should be used when executing a request.<br>
+         * <br>
+         * Usually the {@code Accept-Language} will be set to this value (a helper
+         * method to do this easily: {@link Request#getHeadersFromLocalization(Localization)}).
+         */
+        public Builder localization(final Localization localizationToSet) {
+            this.localization = localizationToSet;
+            return this;
+        }
+
+        /**
+         * If localization headers should automatically be included in the request.
+         */
+        public Builder automaticLocalizationHeader(final boolean automaticLocalizationHeaderToSet) {
+            this.automaticLocalizationHeader = automaticLocalizationHeaderToSet;
+            return this;
+        }
+
+
+        public Request build() {
+            return new Request(this);
+        }
+
+        /*//////////////////////////////////////////////////////////////////////////
+        // Http Methods Utils
+        //////////////////////////////////////////////////////////////////////////*/
+
+        public Builder get(final String urlToSet) {
+            this.httpMethod = "GET";
+            this.url = urlToSet;
+            return this;
+        }
+
+        public Builder head(final String urlToSet) {
+            this.httpMethod = "HEAD";
+            this.url = urlToSet;
+            return this;
+        }
+
+        public Builder post(final String urlToSet, @Nullable final byte[] dataToSendToSet) {
+            this.httpMethod = "POST";
+            this.url = urlToSet;
+            this.dataToSend = dataToSendToSet;
+            return this;
+        }
+
+        /*//////////////////////////////////////////////////////////////////////////
+        // Additional Headers Utils
+        //////////////////////////////////////////////////////////////////////////*/
+
+        public Builder setHeaders(final String headerName, final List<String> headerValueList) {
+            this.headers.remove(headerName);
+            this.headers.put(headerName, headerValueList);
+            return this;
+        }
+
+        public Builder addHeaders(final String headerName, final List<String> headerValueList) {
+            @Nullable List<String> currentHeaderValueList = this.headers.get(headerName);
+            if (currentHeaderValueList == null) {
+                currentHeaderValueList = new ArrayList<>();
+            }
+
+            currentHeaderValueList.addAll(headerValueList);
+            this.headers.put(headerName, headerValueList);
+            return this;
+        }
+
+        public Builder setHeader(final String headerName, final String headerValue) {
+            return setHeaders(headerName, Collections.singletonList(headerValue));
+        }
+
+        public Builder addHeader(final String headerName, final String headerValue) {
+            return addHeaders(headerName, Collections.singletonList(headerValue));
+        }
+
+    }
+
+    /*//////////////////////////////////////////////////////////////////////////
+    // Utils
+    //////////////////////////////////////////////////////////////////////////*/
+
+    @SuppressWarnings("WeakerAccess")
+    @Nonnull
+    public static Map<String, List<String>> getHeadersFromLocalization(
+            @Nullable final Localization localization) {
+        if (localization == null) {
+            return Collections.emptyMap();
+        }
+
+        final String languageCode = localization.getLanguageCode();
+        final List<String> languageCodeList = Collections.singletonList(
+                localization.getCountryCode().isEmpty() ? languageCode
+                        : localization.getLocalizationCode() + ", " + languageCode + ";q=0.9");
+        return Collections.singletonMap("Accept-Language", languageCodeList);
+    }
+
+    /*//////////////////////////////////////////////////////////////////////////
+    // Generated
+    //////////////////////////////////////////////////////////////////////////*/
+
+    @Override
+    public boolean equals(final Object o) {
+        if (this == o) {
+            return true;
+        }
+        if (o == null || getClass() != o.getClass()) {
+            return false;
+        }
+        final Request request = (Request) o;
+        return httpMethod.equals(request.httpMethod)
+                && url.equals(request.url)
+                && headers.equals(request.headers)
+                && Arrays.equals(dataToSend, request.dataToSend)
+                && Objects.equals(localization, request.localization);
+    }
+
+    @Override
+    public int hashCode() {
+        int result = Objects.hash(httpMethod, url, headers, localization);
+        result = 31 * result + Arrays.hashCode(dataToSend);
+        return result;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/downloader/Response.java

@@ -0,0 +1,83 @@
+package org.schabi.newpipe.extractor.downloader;
+
+import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * A Data class used to hold the results from requests made by the Downloader implementation.
+ */
+public class Response {
+    private final int responseCode;
+    private final String responseMessage;
+    private final Map<String, List<String>> responseHeaders;
+    private final String responseBody;
+
+    private final String latestUrl;
+
+    public Response(final int responseCode,
+                    final String responseMessage,
+                    @Nullable final Map<String, List<String>> responseHeaders,
+                    @Nullable final String responseBody,
+                    @Nullable final String latestUrl) {
+        this.responseCode = responseCode;
+        this.responseMessage = responseMessage;
+        this.responseHeaders = responseHeaders == null ? Collections.emptyMap() : responseHeaders;
+
+        this.responseBody = responseBody == null ? "" : responseBody;
+        this.latestUrl = latestUrl;
+    }
+
+    public int responseCode() {
+        return responseCode;
+    }
+
+    public String responseMessage() {
+        return responseMessage;
+    }
+
+    public Map<String, List<String>> responseHeaders() {
+        return responseHeaders;
+    }
+
+    @Nonnull
+    public String responseBody() {
+        return responseBody;
+    }
+
+    /**
+     * Used for detecting a possible redirection, limited to the latest one.
+     *
+     * @return latest url known right before this response object was created
+     */
+    @Nonnull
+    public String latestUrl() {
+        return latestUrl;
+    }
+
+    /*//////////////////////////////////////////////////////////////////////////
+    // Utils
+    //////////////////////////////////////////////////////////////////////////*/
+
+    /**
+     * For easy access to some header value that (usually) don't repeat itself.
+     * <p>For getting all the values associated to the header, use {@link #responseHeaders()} (e.g.
+     * {@code Set-Cookie}).
+     *
+     * @param name the name of the header
+     * @return the first value assigned to this header
+     */
+    @Nullable
+    public String getHeader(final String name) {
+        for (final Map.Entry<String, List<String>> headerEntry : responseHeaders.entrySet()) {
+            final String key = headerEntry.getKey();
+            if (key != null && key.equalsIgnoreCase(name) && !headerEntry.getValue().isEmpty()) {
+                return headerEntry.getValue().get(0);
+            }
+        }
+
+        return null;
+    }
+}

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

@@ -0,0 +1,31 @@
+package org.schabi.newpipe.extractor.exceptions;
+
+public class AccountTerminatedException extends ContentNotAvailableException {
+
+    private Reason reason = Reason.UNKNOWN;
+
+    public AccountTerminatedException(final String message) {
+        super(message);
+    }
+
+    public AccountTerminatedException(final String message, final Reason reason) {
+        super(message);
+        this.reason = reason;
+    }
+
+    public AccountTerminatedException(final String message, final Throwable cause) {
+        super(message, cause);
+    }
+
+    /**
+     * The reason for the violation. There should also be more info in the exception's message.
+     */
+    public Reason getReason() {
+        return reason;
+    }
+
+    public enum Reason {
+        UNKNOWN,
+        VIOLATION
+    }
+}

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

@@ -0,0 +1,11 @@
+package org.schabi.newpipe.extractor.exceptions;
+
+public class AgeRestrictedContentException extends ContentNotAvailableException {
+    public AgeRestrictedContentException(final String message) {
+        super(message);
+    }
+
+    public AgeRestrictedContentException(final String message, final Throwable cause) {
+        super(message, cause);
+    }
+}

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

@@ -0,0 +1,11 @@
+package org.schabi.newpipe.extractor.exceptions;
+
+public class ContentNotAvailableException extends ParsingException {
+    public ContentNotAvailableException(final String message) {
+        super(message);
+    }
+
+    public ContentNotAvailableException(final String message, final Throwable cause) {
+        super(message, cause);
+    }
+}

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

@@ -0,0 +1,11 @@
+package org.schabi.newpipe.extractor.exceptions;
+
+public class ContentNotSupportedException extends ParsingException {
+    public ContentNotSupportedException(final String message) {
+        super(message);
+    }
+
+    public ContentNotSupportedException(final String message, final Throwable cause) {
+        super(message, cause);
+    }
+}

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

@@ -1,33 +1,35 @@
 package org.schabi.newpipe.extractor.exceptions;
 
-/**
+/*
  * Created by Christian Schabesberger on 30.01.16.
  *
- * Copyright (C) Christian Schabesberger 2016 <chris.schabesberger@mailbox.org>
- * ExtractionException.java is part of NewPipe.
+ * Copyright (C) 2016 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * ExtractionException.java is part of NewPipe Extractor.
  *
- * NewPipe is free software: you can redistribute it and/or modify
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * NewPipe is distributed in the hope that it will be useful,
+ * NewPipe Extractor is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
  */
 
 public class ExtractionException extends Exception {
-    public ExtractionException(String message) {
+    public ExtractionException(final String message) {
         super(message);
     }
-    public ExtractionException(Throwable cause) {
+
+    public ExtractionException(final Throwable cause) {
         super(cause);
     }
-    public ExtractionException(String message, Throwable cause) {
+
+    public ExtractionException(final String message, final Throwable cause) {
         super(message, cause);
     }
-}
+}

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

@@ -1,30 +1,31 @@
 package org.schabi.newpipe.extractor.exceptions;
 
-/**
+/*
  * Created by Christian Schabesberger on 12.09.16.
  *
- * Copyright (C) Christian Schabesberger 2016 <chris.schabesberger@mailbox.org>
- * FoundAdException.java is part of NewPipe.
+ * Copyright (C) 2016 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * FoundAdException.java is part of NewPipe Extractor.
  *
- * NewPipe is free software: you can redistribute it and/or modify
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * NewPipe is distributed in the hope that it will be useful,
+ * NewPipe Extractor is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
  */
 
 public class FoundAdException extends ParsingException {
-    public FoundAdException(String message) {
+    public FoundAdException(final String message) {
         super(message);
     }
-    public FoundAdException(String message, Throwable cause) {
+
+    public FoundAdException(final String message, final Throwable cause) {
         super(message, cause);
     }
 }

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

@@ -0,0 +1,11 @@
+package org.schabi.newpipe.extractor.exceptions;
+
+public class GeographicRestrictionException extends ContentNotAvailableException {
+    public GeographicRestrictionException(final String message) {
+        super(message);
+    }
+
+    public GeographicRestrictionException(final String message, final Throwable cause) {
+        super(message, cause);
+    }
+}

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

@@ -0,0 +1,11 @@
+package org.schabi.newpipe.extractor.exceptions;
+
+public class PaidContentException extends ContentNotAvailableException {
+    public PaidContentException(final String message) {
+        super(message);
+    }
+
+    public PaidContentException(final String message, final Throwable cause) {
+        super(message, cause);
+    }
+}

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

@@ -1,31 +1,32 @@
 package org.schabi.newpipe.extractor.exceptions;
 
-/**
+/*
  * Created by Christian Schabesberger on 31.01.16.
  *
- * Copyright (C) Christian Schabesberger 2016 <chris.schabesberger@mailbox.org>
- * ParsingException.java is part of NewPipe.
+ * Copyright (C) 2016 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * ParsingException.java is part of NewPipe Extractor.
  *
- * NewPipe is free software: you can redistribute it and/or modify
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * NewPipe is distributed in the hope that it will be useful,
+ * NewPipe Extractor is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
  */
 
 
 public class ParsingException extends ExtractionException {
-    public ParsingException(String message) {
+    public ParsingException(final String message) {
         super(message);
     }
-    public ParsingException(String message, Throwable cause) {
+
+    public ParsingException(final String message, final Throwable cause) {
         super(message, cause);
     }
-}
+}

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

@@ -0,0 +1,11 @@
+package org.schabi.newpipe.extractor.exceptions;
+
+public class PrivateContentException extends ContentNotAvailableException {
+    public PrivateContentException(final String message) {
+        super(message);
+    }
+
+    public PrivateContentException(final String message, final Throwable cause) {
+        super(message, cause);
+    }
+}

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

@@ -1,27 +1,34 @@
 package org.schabi.newpipe.extractor.exceptions;
 
-/**
+/*
  * Created by beneth <bmauduit@beneth.fr> on 07.12.16.
  *
- * Copyright (C) Christian Schabesberger 2016 <chris.schabesberger@mailbox.org>
- * ReCaptchaException.java is part of NewPipe.
+ * Copyright (C) 2016 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * ReCaptchaException.java is part of NewPipe Extractor.
  *
- * NewPipe is free software: you can redistribute it and/or modify
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * NewPipe is distributed in the hope that it will be useful,
+ * NewPipe Extractor is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with NewPipe.  If not, see <http://www.gnu.org/licenses/>.
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
  */
 
 public class ReCaptchaException extends ExtractionException {
-    public ReCaptchaException(String message) {
+    private final String url;
+
+    public ReCaptchaException(final String message, final String url) {
         super(message);
+        this.url = url;
+    }
+
+    public String getUrl() {
+        return url;
     }
 }

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

@@ -0,0 +1,11 @@
+package org.schabi.newpipe.extractor.exceptions;
+
+public class SoundCloudGoPlusContentException extends ContentNotAvailableException {
+    public SoundCloudGoPlusContentException() {
+        super("This track is a SoundCloud Go+ track");
+    }
+
+    public SoundCloudGoPlusContentException(final Throwable cause) {
+        super("This track is a SoundCloud Go+ track", cause);
+    }
+}

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

@@ -0,0 +1,7 @@
+package org.schabi.newpipe.extractor.exceptions;
+
+public final class UnsupportedTabException extends UnsupportedOperationException {
+    public UnsupportedTabException(final String unsupportedTab) {
+        super("Unsupported tab " + unsupportedTab);
+    }
+}

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

@@ -0,0 +1,11 @@
+package org.schabi.newpipe.extractor.exceptions;
+
+public class YoutubeMusicPremiumContentException extends ContentNotAvailableException {
+    public YoutubeMusicPremiumContentException() {
+        super("This video is a YouTube Music Premium video");
+    }
+
+    public YoutubeMusicPremiumContentException(final Throwable cause) {
+        super("This video is a YouTube Music Premium video", cause);
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/feed/FeedExtractor.java

@@ -0,0 +1,17 @@
+package org.schabi.newpipe.extractor.feed;
+
+import org.schabi.newpipe.extractor.ListExtractor;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+import org.schabi.newpipe.extractor.stream.StreamInfoItem;
+
+/**
+ * This class helps to extract items from lightweight feeds that the services may provide.
+ * <p>
+ * YouTube is an example of a service that has this alternative available.
+ */
+public abstract class FeedExtractor extends ListExtractor<StreamInfoItem> {
+    public FeedExtractor(final StreamingService service, final ListLinkHandler listLinkHandler) {
+        super(service, listLinkHandler);
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/feed/FeedInfo.java

@@ -0,0 +1,62 @@
+package org.schabi.newpipe.extractor.feed;
+
+import org.schabi.newpipe.extractor.ListExtractor.InfoItemsPage;
+import org.schabi.newpipe.extractor.ListInfo;
+import org.schabi.newpipe.extractor.NewPipe;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.stream.StreamInfoItem;
+import org.schabi.newpipe.extractor.utils.ExtractorHelper;
+
+import java.io.IOException;
+import java.util.List;
+
+public class FeedInfo extends ListInfo<StreamInfoItem> {
+
+    public FeedInfo(final int serviceId,
+                    final String id,
+                    final String url,
+                    final String originalUrl,
+                    final String name,
+                    final List<String> contentFilter,
+                    final String sortFilter) {
+        super(serviceId, id, url, originalUrl, name, contentFilter, sortFilter);
+    }
+
+    public static FeedInfo getInfo(final String url) throws IOException, ExtractionException {
+        return getInfo(NewPipe.getServiceByUrl(url), url);
+    }
+
+    public static FeedInfo getInfo(final StreamingService service, final String url)
+            throws IOException, ExtractionException {
+        final FeedExtractor extractor = service.getFeedExtractor(url);
+
+        if (extractor == null) {
+            throw new IllegalArgumentException("Service \"" + service.getServiceInfo().getName()
+                    + "\" doesn't support FeedExtractor.");
+        }
+
+        extractor.fetchPage();
+        return getInfo(extractor);
+    }
+
+    public static FeedInfo getInfo(final FeedExtractor extractor)
+            throws IOException, ExtractionException {
+        extractor.fetchPage();
+
+        final int serviceId = extractor.getServiceId();
+        final String id = extractor.getId();
+        final String url = extractor.getUrl();
+        final String originalUrl = extractor.getOriginalUrl();
+        final String name = extractor.getName();
+
+        final FeedInfo info = new FeedInfo(serviceId, id, url, originalUrl, name, null, null);
+
+        final InfoItemsPage<StreamInfoItem> itemsPage
+                = ExtractorHelper.getItemsPageOrLogError(info, extractor);
+        info.setRelatedItems(itemsPage.getItems());
+        info.setNextPage(itemsPage.getNextPage());
+
+        return info;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/kiosk/KioskExtractor.java

@@ -0,0 +1,57 @@
+package org.schabi.newpipe.extractor.kiosk;
+
+/*
+ * Created by Christian Schabesberger on 12.08.17.
+ *
+ * Copyright (C) 2017 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * KioskExtractor.java is part of NewPipe Extractor.
+ *
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * NewPipe Extractor is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+import org.schabi.newpipe.extractor.InfoItem;
+import org.schabi.newpipe.extractor.ListExtractor;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+
+import javax.annotation.Nonnull;
+
+public abstract class KioskExtractor<T extends InfoItem> extends ListExtractor<T> {
+    private final String id;
+
+    public KioskExtractor(final StreamingService streamingService,
+                          final ListLinkHandler linkHandler,
+                          final String kioskId) {
+        super(streamingService, linkHandler);
+        this.id = kioskId;
+    }
+
+    @Nonnull
+    @Override
+    public String getId() {
+        return id;
+    }
+
+    /**
+     * Id should be the name of the kiosk, tho Id is used for identifying it in the frontend,
+     * so id should be kept in english.
+     * In order to get the name of the kiosk in the desired language we have to
+     * crawl if from the website.
+     * @return the translated version of id
+     */
+    @Nonnull
+    @Override
+    public abstract String getName() throws ParsingException;
+}

extractor/src/main/java/org/schabi/newpipe/extractor/kiosk/KioskInfo.java

@@ -0,0 +1,75 @@
+package org.schabi.newpipe.extractor.kiosk;
+
+/*
+ * Created by Christian Schabesberger on 12.08.17.
+ *
+ * Copyright (C) 2017 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * KioskInfo.java is part of NewPipe Extractor.
+ *
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * NewPipe Extractor is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+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.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+import org.schabi.newpipe.extractor.stream.StreamInfoItem;
+import org.schabi.newpipe.extractor.utils.ExtractorHelper;
+
+import java.io.IOException;
+
+public final class KioskInfo extends ListInfo<StreamInfoItem> {
+    private KioskInfo(final int serviceId, final ListLinkHandler linkHandler, final String name) {
+        super(serviceId, linkHandler, name);
+    }
+
+    public static ListExtractor.InfoItemsPage<StreamInfoItem> getMoreItems(
+            final StreamingService service, final String url, final Page page)
+            throws IOException, ExtractionException {
+        return service.getKioskList().getExtractorByUrl(url, page).getPage(page);
+    }
+
+    public static KioskInfo getInfo(final String url) throws IOException, ExtractionException {
+        return getInfo(NewPipe.getServiceByUrl(url), url);
+    }
+
+    public static KioskInfo getInfo(final StreamingService service, final String url)
+            throws IOException, ExtractionException {
+        final KioskExtractor extractor = service.getKioskList().getExtractorByUrl(url, null);
+        extractor.fetchPage();
+        return getInfo(extractor);
+    }
+
+    /**
+     * Get KioskInfo from KioskExtractor
+     *
+     * @param extractor an extractor where fetchPage() was already got called on.
+     */
+    public static KioskInfo getInfo(final KioskExtractor extractor) throws ExtractionException {
+
+        final KioskInfo info = new KioskInfo(extractor.getServiceId(),
+                extractor.getLinkHandler(),
+                extractor.getName());
+
+        final ListExtractor.InfoItemsPage<StreamInfoItem> itemsPage
+                = ExtractorHelper.getItemsPageOrLogError(info, extractor);
+        info.setRelatedItems(itemsPage.getItems());
+        info.setNextPage(itemsPage.getNextPage());
+
+        return info;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/kiosk/KioskList.java

@@ -0,0 +1,156 @@
+package org.schabi.newpipe.extractor.kiosk;
+
+import static org.schabi.newpipe.extractor.utils.Utils.isNullOrEmpty;
+
+import org.schabi.newpipe.extractor.NewPipe;
+import org.schabi.newpipe.extractor.Page;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandlerFactory;
+import org.schabi.newpipe.extractor.localization.ContentCountry;
+import org.schabi.newpipe.extractor.localization.Localization;
+
+import java.io.IOException;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Set;
+
+import javax.annotation.Nullable;
+
+public class KioskList {
+
+    public interface KioskExtractorFactory {
+        KioskExtractor createNewKiosk(StreamingService streamingService,
+                                      String url,
+                                      String kioskId)
+                throws ExtractionException, IOException;
+    }
+
+    private final StreamingService service;
+    private final HashMap<String, KioskEntry> kioskList = new HashMap<>();
+    private String defaultKiosk = null;
+
+    @Nullable
+    private Localization forcedLocalization;
+    @Nullable
+    private ContentCountry forcedContentCountry;
+
+    private static class KioskEntry {
+        KioskEntry(final KioskExtractorFactory ef, final ListLinkHandlerFactory h) {
+            extractorFactory = ef;
+            handlerFactory = h;
+        }
+
+        final KioskExtractorFactory extractorFactory;
+        final ListLinkHandlerFactory handlerFactory;
+    }
+
+    public KioskList(final StreamingService service) {
+        this.service = service;
+    }
+
+    public void addKioskEntry(final KioskExtractorFactory extractorFactory,
+                              final ListLinkHandlerFactory handlerFactory,
+                              final String id)
+            throws Exception {
+        if (kioskList.get(id) != null) {
+            throw new Exception("Kiosk with type " + id + " already exists.");
+        }
+        kioskList.put(id, new KioskEntry(extractorFactory, handlerFactory));
+    }
+
+    public void setDefaultKiosk(final String kioskType) {
+        defaultKiosk = kioskType;
+    }
+
+    public KioskExtractor getDefaultKioskExtractor()
+            throws ExtractionException, IOException {
+        return getDefaultKioskExtractor(null);
+    }
+
+    public KioskExtractor getDefaultKioskExtractor(final Page nextPage)
+            throws ExtractionException, IOException {
+        return getDefaultKioskExtractor(nextPage, NewPipe.getPreferredLocalization());
+    }
+
+    public KioskExtractor getDefaultKioskExtractor(final Page nextPage,
+                                                   final Localization localization)
+            throws ExtractionException, IOException {
+        if (!isNullOrEmpty(defaultKiosk)) {
+            return getExtractorById(defaultKiosk, nextPage, localization);
+        } else {
+            final String first = kioskList.keySet().stream().findAny().orElse(null);
+            if (first != null) {
+                // if not set get any entry
+                return getExtractorById(first, nextPage, localization);
+            } else {
+                return null;
+            }
+        }
+    }
+
+    public String getDefaultKioskId() {
+        return defaultKiosk;
+    }
+
+    public KioskExtractor getExtractorById(final String kioskId, final Page nextPage)
+            throws ExtractionException, IOException {
+        return getExtractorById(kioskId, nextPage, NewPipe.getPreferredLocalization());
+    }
+
+    public KioskExtractor getExtractorById(final String kioskId,
+                                           final Page nextPage,
+                                           final Localization localization)
+            throws ExtractionException, IOException {
+        final KioskEntry ke = kioskList.get(kioskId);
+        if (ke == null) {
+            throw new ExtractionException("No kiosk found with the type: " + kioskId);
+        } else {
+            final KioskExtractor kioskExtractor = ke.extractorFactory.createNewKiosk(service,
+                    ke.handlerFactory.fromId(kioskId).getUrl(), kioskId);
+
+            if (forcedLocalization != null) {
+                kioskExtractor.forceLocalization(forcedLocalization);
+            }
+            if (forcedContentCountry != null) {
+                kioskExtractor.forceContentCountry(forcedContentCountry);
+            }
+
+            return kioskExtractor;
+        }
+    }
+
+    public Set<String> getAvailableKiosks() {
+        return kioskList.keySet();
+    }
+
+    public KioskExtractor getExtractorByUrl(final String url, final Page nextPage)
+            throws ExtractionException, IOException {
+        return getExtractorByUrl(url, nextPage, NewPipe.getPreferredLocalization());
+    }
+
+    public KioskExtractor getExtractorByUrl(final String url,
+                                            final Page nextPage,
+                                            final Localization localization)
+            throws ExtractionException, IOException {
+        for (final Map.Entry<String, KioskEntry> e : kioskList.entrySet()) {
+            final KioskEntry ke = e.getValue();
+            if (ke.handlerFactory.acceptUrl(url)) {
+                return getExtractorById(ke.handlerFactory.getId(url), nextPage, localization);
+            }
+        }
+        throw new ExtractionException("Could not find a kiosk that fits to the url: " + url);
+    }
+
+    public ListLinkHandlerFactory getListLinkHandlerFactoryByType(final String type) {
+        return kioskList.get(type).handlerFactory;
+    }
+
+    public void forceLocalization(@Nullable final Localization localization) {
+        this.forcedLocalization = localization;
+    }
+
+    public void forceContentCountry(@Nullable final ContentCountry contentCountry) {
+        this.forcedContentCountry = contentCountry;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/linkhandler/LinkHandler.java

@@ -0,0 +1,38 @@
+package org.schabi.newpipe.extractor.linkhandler;
+
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.utils.Utils;
+
+import java.io.Serializable;
+
+public class LinkHandler implements Serializable {
+    protected final String originalUrl;
+    protected final String url;
+    protected final String id;
+
+    public LinkHandler(final String originalUrl, final String url, final String id) {
+        this.originalUrl = originalUrl;
+        this.url = url;
+        this.id = id;
+    }
+
+    public LinkHandler(final LinkHandler handler) {
+        this(handler.originalUrl, handler.url, handler.id);
+    }
+
+    public String getOriginalUrl() {
+        return originalUrl;
+    }
+
+    public String getUrl() {
+        return url;
+    }
+
+    public String getId() {
+        return id;
+    }
+
+    public String getBaseUrl() throws ParsingException {
+        return Utils.getBaseUrl(url);
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/linkhandler/LinkHandlerFactory.java

@@ -0,0 +1,107 @@
+package org.schabi.newpipe.extractor.linkhandler;
+
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.utils.Utils;
+
+import java.util.Objects;
+
+/*
+ * Created by Christian Schabesberger on 26.07.16.
+ *
+ * Copyright (C) 2016 Christian Schabesberger <chris.schabesberger@mailbox.org>
+ * LinkHandlerFactory.java is part of NewPipe Extractor.
+ *
+ * NewPipe Extractor is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * NewPipe Extractor is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NewPipe Extractor.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+public abstract class LinkHandlerFactory {
+
+    ///////////////////////////////////
+    // To Override
+    ///////////////////////////////////
+
+    public abstract String getId(String url) throws ParsingException, UnsupportedOperationException;
+
+    public abstract String getUrl(String id) throws ParsingException, UnsupportedOperationException;
+
+    public abstract boolean onAcceptUrl(String url) throws ParsingException;
+
+    public String getUrl(final String id, final String baseUrl)
+            throws ParsingException, UnsupportedOperationException {
+        return getUrl(id);
+    }
+
+    ///////////////////////////////////
+    // Logic
+    ///////////////////////////////////
+
+    /**
+     * Builds a {@link LinkHandler} from a url.<br>
+     * Be sure to call {@link Utils#followGoogleRedirectIfNeeded(String)} on the url if overriding
+     * this function.
+     *
+     * @param url the url to extract path and id from
+     * @return a {@link LinkHandler} complete with information
+     */
+    public LinkHandler fromUrl(final String url) throws ParsingException {
+        if (Utils.isNullOrEmpty(url)) {
+            throw new IllegalArgumentException("The url is null or empty");
+        }
+        final String polishedUrl = Utils.followGoogleRedirectIfNeeded(url);
+        final String baseUrl = Utils.getBaseUrl(polishedUrl);
+        return fromUrl(polishedUrl, baseUrl);
+    }
+
+    /**
+     * Builds a {@link LinkHandler} from an URL and a base URL. The URL is expected to be already
+     * polished from Google search redirects (otherwise how could {@code baseUrl} have been
+     * extracted?).<br>
+     * So do not call {@link Utils#followGoogleRedirectIfNeeded(String)} on the URL if overriding
+     * this function, since that should be done in {@link #fromUrl(String)}.
+     *
+     * @param url     the URL without Google search redirects to extract id from
+     * @param baseUrl the base URL
+     * @return a {@link LinkHandler} complete with information
+     */
+    public LinkHandler fromUrl(final String url, final String baseUrl) throws ParsingException {
+        Objects.requireNonNull(url, "URL cannot be null");
+        if (!acceptUrl(url)) {
+            throw new ParsingException("URL not accepted: " + url);
+        }
+
+        final String id = getId(url);
+        return new LinkHandler(url, getUrl(id, baseUrl), id);
+    }
+
+    public LinkHandler fromId(final String id) throws ParsingException {
+        Objects.requireNonNull(id, "ID cannot be null");
+        final String url = getUrl(id);
+        return new LinkHandler(url, url, id);
+    }
+
+    public LinkHandler fromId(final String id, final String baseUrl) throws ParsingException {
+        Objects.requireNonNull(id, "ID cannot be null");
+        final String url = getUrl(id, baseUrl);
+        return new LinkHandler(url, url, id);
+    }
+
+    /**
+     * When a VIEW_ACTION is caught this function will test if the url delivered within the calling
+     * Intent was meant to be watched with this Service.
+     * Return false if this service shall not allow to be called through ACTIONs.
+     */
+    public boolean acceptUrl(final String url) throws ParsingException {
+        return onAcceptUrl(url);
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/linkhandler/ListLinkHandler.java

@@ -0,0 +1,43 @@
+package org.schabi.newpipe.extractor.linkhandler;
+
+import java.util.Collections;
+import java.util.List;
+
+public class ListLinkHandler extends LinkHandler {
+    protected final List<String> contentFilters;
+    protected final String sortFilter;
+
+    public ListLinkHandler(final String originalUrl,
+                           final String url,
+                           final String id,
+                           final List<String> contentFilters,
+                           final String sortFilter) {
+        super(originalUrl, url, id);
+        this.contentFilters = Collections.unmodifiableList(contentFilters);
+        this.sortFilter = sortFilter;
+    }
+
+    public ListLinkHandler(final ListLinkHandler handler) {
+        this(handler.originalUrl,
+                handler.url,
+                handler.id,
+                handler.contentFilters,
+                handler.sortFilter);
+    }
+
+    public ListLinkHandler(final LinkHandler handler) {
+        this(handler.originalUrl,
+                handler.url,
+                handler.id,
+                Collections.emptyList(),
+                "");
+    }
+
+    public List<String> getContentFilters() {
+        return contentFilters;
+    }
+
+    public String getSortFilter() {
+        return sortFilter;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/linkhandler/ListLinkHandlerFactory.java

@@ -0,0 +1,104 @@
+package org.schabi.newpipe.extractor.linkhandler;
+
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.utils.Utils;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Objects;
+
+public abstract class ListLinkHandlerFactory extends LinkHandlerFactory {
+
+    ///////////////////////////////////
+    // To Override
+    ///////////////////////////////////
+
+    public abstract String getUrl(String id, List<String> contentFilter, String sortFilter)
+            throws ParsingException, UnsupportedOperationException;
+
+    public String getUrl(final String id,
+                         final List<String> contentFilter,
+                         final String sortFilter,
+                         final String baseUrl)
+            throws ParsingException, UnsupportedOperationException {
+        return getUrl(id, contentFilter, sortFilter);
+    }
+
+    ///////////////////////////////////
+    // Logic
+    ///////////////////////////////////
+
+    @Override
+    public ListLinkHandler fromUrl(final String url) throws ParsingException {
+        final String polishedUrl = Utils.followGoogleRedirectIfNeeded(url);
+        final String baseUrl = Utils.getBaseUrl(polishedUrl);
+        return fromUrl(polishedUrl, baseUrl);
+    }
+
+    @Override
+    public ListLinkHandler fromUrl(final String url, final String baseUrl) throws ParsingException {
+        Objects.requireNonNull(url, "URL may not be null");
+        return new ListLinkHandler(super.fromUrl(url, baseUrl));
+    }
+
+    @Override
+    public ListLinkHandler fromId(final String id) throws ParsingException {
+        return new ListLinkHandler(super.fromId(id));
+    }
+
+    @Override
+    public ListLinkHandler fromId(final String id, final String baseUrl) throws ParsingException {
+        return new ListLinkHandler(super.fromId(id, baseUrl));
+    }
+
+    public ListLinkHandler fromQuery(final String id,
+                                     final List<String> contentFilters,
+                                     final String sortFilter) throws ParsingException {
+        final String url = getUrl(id, contentFilters, sortFilter);
+        return new ListLinkHandler(url, url, id, contentFilters, sortFilter);
+    }
+
+    public ListLinkHandler fromQuery(final String id,
+                                     final List<String> contentFilters,
+                                     final String sortFilter,
+                                     final String baseUrl) throws ParsingException {
+        final String url = getUrl(id, contentFilters, sortFilter, baseUrl);
+        return new ListLinkHandler(url, url, id, contentFilters, sortFilter);
+    }
+
+
+    /**
+     * For making ListLinkHandlerFactory compatible with LinkHandlerFactory we need to override
+     * this, however it should not be overridden by the actual implementation.
+     *
+     * @return the url corresponding to id without any filters applied
+     */
+    public String getUrl(final String id) throws ParsingException, UnsupportedOperationException {
+        return getUrl(id, new ArrayList<>(0), "");
+    }
+
+    @Override
+    public String getUrl(final String id, final String baseUrl) throws ParsingException {
+        return getUrl(id, new ArrayList<>(0), "", baseUrl);
+    }
+
+    /**
+     * Will returns content filter the corresponding extractor can handle like "channels", "videos",
+     * "music", etc.
+     *
+     * @return filter that can be applied when building a query for getting a list
+     */
+    public String[] getAvailableContentFilter() {
+        return new String[0];
+    }
+
+    /**
+     * Will returns sort filter the corresponding extractor can handle like "A-Z", "oldest first",
+     * "size", etc.
+     *
+     * @return filter that can be applied when building a query for getting a list
+     */
+    public String[] getAvailableSortFilter() {
+        return new String[0];
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/linkhandler/ReadyChannelTabListLinkHandler.java

@@ -0,0 +1,54 @@
+package org.schabi.newpipe.extractor.linkhandler;
+
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.channel.tabs.ChannelTabExtractor;
+
+import javax.annotation.Nonnull;
+import java.io.Serializable;
+import java.util.List;
+
+/**
+ * A {@link ListLinkHandler} which can be used to be returned from {@link
+ * org.schabi.newpipe.extractor.channel.ChannelInfo#getTabs() ChannelInfo#getTabs()} when a
+ * specific tab's data has already been fetched.
+ *
+ * <p>
+ * This class allows passing a builder for a {@link ChannelTabExtractor} that can hold references
+ * to variables.
+ * </p>
+ *
+ * <p>
+ * Note: a service that wishes to use this class in one of its {@link
+ * org.schabi.newpipe.extractor.channel.ChannelExtractor ChannelExtractor}s must also add the
+ * following snippet of code in the service's
+ * {@link StreamingService#getChannelTabExtractor(ListLinkHandler)}:
+ * <pre>
+ * if (linkHandler instanceof ReadyChannelTabListLinkHandler) {
+ *     return ((ReadyChannelTabListLinkHandler) linkHandler).getChannelTabExtractor(this);
+ * }
+ * </pre>
+ */
+public class ReadyChannelTabListLinkHandler extends ListLinkHandler {
+
+    public interface ChannelTabExtractorBuilder extends Serializable {
+        @Nonnull
+        ChannelTabExtractor build(@Nonnull StreamingService service,
+                                  @Nonnull ListLinkHandler linkHandler);
+    }
+
+    private final ChannelTabExtractorBuilder extractorBuilder;
+
+    public ReadyChannelTabListLinkHandler(
+            final String url,
+            final String channelId,
+            @Nonnull final String channelTab,
+            @Nonnull final ChannelTabExtractorBuilder extractorBuilder) {
+        super(url, url, channelId, List.of(channelTab), "");
+        this.extractorBuilder = extractorBuilder;
+    }
+
+    @Nonnull
+    public ChannelTabExtractor getChannelTabExtractor(@Nonnull final StreamingService service) {
+        return extractorBuilder.build(service, new ListLinkHandler(this));
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/linkhandler/SearchQueryHandler.java

@@ -0,0 +1,33 @@
+package org.schabi.newpipe.extractor.linkhandler;
+
+import java.util.List;
+
+public class SearchQueryHandler extends ListLinkHandler {
+
+    public SearchQueryHandler(final String originalUrl,
+                              final String url,
+                              final String searchString,
+                              final List<String> contentFilters,
+                              final String sortFilter) {
+        super(originalUrl, url, searchString, contentFilters, sortFilter);
+    }
+
+    public SearchQueryHandler(final ListLinkHandler handler) {
+        this(handler.originalUrl,
+                handler.url,
+                handler.id,
+                handler.contentFilters,
+                handler.sortFilter);
+    }
+
+
+    /**
+     * Returns the search string. Since ListQIHandler is based on ListLinkHandler
+     * getSearchString() is equivalent to calling getId().
+     *
+     * @return the search string
+     */
+    public String getSearchString() {
+        return getId();
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/linkhandler/SearchQueryHandlerFactory.java

@@ -0,0 +1,50 @@
+package org.schabi.newpipe.extractor.linkhandler;
+
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+
+import java.util.Collections;
+import java.util.List;
+
+public abstract class SearchQueryHandlerFactory extends ListLinkHandlerFactory {
+
+    ///////////////////////////////////
+    // To Override
+    ///////////////////////////////////
+
+    @Override
+    public abstract String getUrl(String query, List<String> contentFilter, String sortFilter)
+            throws ParsingException, UnsupportedOperationException;
+
+    @SuppressWarnings("unused")
+    public String getSearchString(final String url) {
+        return "";
+    }
+
+    ///////////////////////////////////
+    // Logic
+    ///////////////////////////////////
+
+    @Override
+    public String getId(final String url) throws ParsingException, UnsupportedOperationException {
+        return getSearchString(url);
+    }
+
+    @Override
+    public SearchQueryHandler fromQuery(final String query,
+                                        final List<String> contentFilter,
+                                        final String sortFilter) throws ParsingException {
+        return new SearchQueryHandler(super.fromQuery(query, contentFilter, sortFilter));
+    }
+
+    public SearchQueryHandler fromQuery(final String query) throws ParsingException {
+        return fromQuery(query, Collections.emptyList(), "");
+    }
+
+    /**
+     * It's not mandatory for NewPipe to handle the Url
+     */
+    @Override
+    public boolean onAcceptUrl(final String url) {
+        return false;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/localization/ContentCountry.java

@@ -0,0 +1,64 @@
+package org.schabi.newpipe.extractor.localization;
+
+import javax.annotation.Nonnull;
+
+import java.io.Serializable;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+/**
+ * Represents a country that should be used when fetching content.
+ * <p>
+ * YouTube, for example, give different results in their feed depending on which country is
+ * selected.
+ * </p>
+ */
+public class ContentCountry implements Serializable {
+    public static final ContentCountry DEFAULT =
+            new ContentCountry(Localization.DEFAULT.getCountryCode());
+
+    @Nonnull
+    private final String countryCode;
+
+    public static List<ContentCountry> listFrom(final String... countryCodeList) {
+        final List<ContentCountry> toReturn = new ArrayList<>();
+        for (final String countryCode : countryCodeList) {
+            toReturn.add(new ContentCountry(countryCode));
+        }
+        return Collections.unmodifiableList(toReturn);
+    }
+
+    public ContentCountry(@Nonnull final String countryCode) {
+        this.countryCode = countryCode;
+    }
+
+    @Nonnull
+    public String getCountryCode() {
+        return countryCode;
+    }
+
+    @Override
+    public String toString() {
+        return getCountryCode();
+    }
+
+    @Override
+    public boolean equals(final Object o) {
+        if (this == o) {
+            return true;
+        }
+        if (!(o instanceof ContentCountry)) {
+            return false;
+        }
+
+        final ContentCountry that = (ContentCountry) o;
+
+        return countryCode.equals(that.countryCode);
+    }
+
+    @Override
+    public int hashCode() {
+        return countryCode.hashCode();
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/localization/DateWrapper.java

@@ -0,0 +1,72 @@
+package org.schabi.newpipe.extractor.localization;
+
+
+import javax.annotation.Nonnull;
+import java.io.Serializable;
+import java.time.OffsetDateTime;
+import java.time.ZoneOffset;
+import java.util.Calendar;
+import java.util.GregorianCalendar;
+
+/**
+ * A wrapper class that provides a field to describe if the date/time is precise or just an
+ * approximation.
+ */
+public class DateWrapper implements Serializable {
+    @Nonnull
+    private final OffsetDateTime offsetDateTime;
+    private final boolean isApproximation;
+
+    /**
+     * @deprecated Use {@link #DateWrapper(OffsetDateTime)} instead.
+     */
+    @Deprecated
+    public DateWrapper(@Nonnull final Calendar calendar) {
+        //noinspection deprecation
+        this(calendar, false);
+    }
+
+    /**
+     * @deprecated Use {@link #DateWrapper(OffsetDateTime, boolean)} instead.
+     */
+    @Deprecated
+    public DateWrapper(@Nonnull final Calendar calendar, final boolean isApproximation) {
+        this(OffsetDateTime.ofInstant(calendar.toInstant(), ZoneOffset.UTC), isApproximation);
+    }
+
+    public DateWrapper(@Nonnull final OffsetDateTime offsetDateTime) {
+        this(offsetDateTime, false);
+    }
+
+    public DateWrapper(@Nonnull final OffsetDateTime offsetDateTime,
+                       final boolean isApproximation) {
+        this.offsetDateTime = offsetDateTime.withOffsetSameInstant(ZoneOffset.UTC);
+        this.isApproximation = isApproximation;
+    }
+
+    /**
+     * @return the wrapped date/time as a {@link Calendar}.
+     * @deprecated use {@link #offsetDateTime()} instead.
+     */
+    @Deprecated
+    @Nonnull
+    public Calendar date() {
+        return GregorianCalendar.from(offsetDateTime.toZonedDateTime());
+    }
+
+    /**
+     * @return the wrapped date/time.
+     */
+    @Nonnull
+    public OffsetDateTime offsetDateTime() {
+        return offsetDateTime;
+    }
+
+    /**
+     * @return if the date is considered is precise or just an approximation (e.g. service only
+     * returns an approximation like 2 weeks ago instead of a precise date).
+     */
+    public boolean isApproximation() {
+        return isApproximation;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/localization/Localization.java

@@ -0,0 +1,137 @@
+package org.schabi.newpipe.extractor.localization;
+
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.utils.LocaleCompat;
+
+import java.io.Serializable;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Optional;
+
+import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
+
+
+public class Localization implements Serializable {
+    public static final Localization DEFAULT = new Localization("en", "GB");
+
+    @Nonnull
+    private final String languageCode;
+    @Nullable
+    private final String countryCode;
+
+    /**
+     * @param localizationCodeList a list of localization code, formatted like {@link
+     *                             #getLocalizationCode()}
+     * @throws IllegalArgumentException If any of the localizationCodeList is formatted incorrectly
+     * @return list of Localization objects
+     */
+    @Nonnull
+    public static List<Localization> listFrom(final String... localizationCodeList) {
+        final List<Localization> toReturn = new ArrayList<>();
+        for (final String localizationCode : localizationCodeList) {
+            toReturn.add(fromLocalizationCode(localizationCode)
+                    .orElseThrow(() -> new IllegalArgumentException(
+                            "Not a localization code: " + localizationCode
+                    )));
+        }
+        return Collections.unmodifiableList(toReturn);
+    }
+
+    /**
+     * @param localizationCode a localization code, formatted like {@link #getLocalizationCode()}
+     * @return A Localization, if the code was valid.
+     */
+    @Nonnull
+    public static Optional<Localization> fromLocalizationCode(final String localizationCode) {
+        return LocaleCompat.forLanguageTag(localizationCode).map(Localization::fromLocale);
+    }
+
+    public Localization(@Nonnull final String languageCode, @Nullable final String countryCode) {
+        this.languageCode = languageCode;
+        this.countryCode = countryCode;
+    }
+
+    public Localization(@Nonnull final String languageCode) {
+        this(languageCode, null);
+    }
+
+    @Nonnull
+    public String getLanguageCode() {
+        return languageCode;
+    }
+
+    @Nonnull
+    public String getCountryCode() {
+        return countryCode == null ? "" : countryCode;
+    }
+
+    public static Localization fromLocale(@Nonnull final Locale locale) {
+        return new Localization(locale.getLanguage(), locale.getCountry());
+    }
+
+    /**
+     * Return a formatted string in the form of: {@code language-Country}, or
+     * just {@code language} if country is {@code null}.
+     *
+     * @return A correctly formatted localizationCode for this localization.
+     */
+    public String getLocalizationCode() {
+        return languageCode + (countryCode == null ? "" : "-" + countryCode);
+    }
+
+    @Override
+    public String toString() {
+        return "Localization[" + getLocalizationCode() + "]";
+    }
+
+    @Override
+    public boolean equals(final Object o) {
+        if (this == o) {
+            return true;
+        }
+        if (!(o instanceof Localization)) {
+            return false;
+        }
+
+        final Localization that = (Localization) o;
+
+        return languageCode.equals(that.languageCode)
+                && Objects.equals(countryCode, that.countryCode);
+    }
+
+    @Override
+    public int hashCode() {
+        int result = languageCode.hashCode();
+        result = 31 * result + Objects.hashCode(countryCode);
+        return result;
+    }
+
+    /**
+     * Converts a three letter language code (ISO 639-2/T) to a Locale
+     * because limits of Java Locale class.
+     *
+     * @param code a three letter language code
+     * @return the Locale corresponding
+     */
+    public static Locale getLocaleFromThreeLetterCode(@Nonnull final String code)
+            throws ParsingException {
+        final String[] languages = Locale.getISOLanguages();
+        final Map<String, Locale> localeMap = new HashMap<>(languages.length);
+        for (final String language : languages) {
+            final Locale locale = new Locale(language);
+            localeMap.put(locale.getISO3Language(), locale);
+        }
+        if (localeMap.containsKey(code)) {
+            return localeMap.get(code);
+        } else {
+            throw new ParsingException(
+                    "Could not get Locale from this three letter language code" + code);
+        }
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/localization/TimeAgoParser.java

@@ -0,0 +1,188 @@
+package org.schabi.newpipe.extractor.localization;
+
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.timeago.PatternsHolder;
+import org.schabi.newpipe.extractor.utils.Parser;
+
+import java.time.OffsetDateTime;
+import java.time.ZoneOffset;
+import java.time.temporal.ChronoUnit;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.regex.Pattern;
+import java.util.regex.Matcher;
+import java.util.regex.MatchResult;
+
+/**
+ * A helper class that is meant to be used by services that need to parse durations such as
+ * {@code 23 seconds} and/or upload dates in the format {@code 2 days ago} or similar.
+ */
+public class TimeAgoParser {
+
+    private static final Pattern DURATION_PATTERN = Pattern.compile("(?:(\\d+) )?([A-z]+)");
+
+    private final PatternsHolder patternsHolder;
+    private final OffsetDateTime now;
+
+    /**
+     * Creates a helper to parse upload dates in the format '2 days ago'.
+     * <p>
+     * Instantiate a new {@link TimeAgoParser} every time you extract a new batch of items.
+     * </p>
+     *
+     * @param patternsHolder An object that holds the "time ago" patterns, special cases, and the
+     *                       language word separator.
+     */
+    public TimeAgoParser(final PatternsHolder patternsHolder) {
+        this.patternsHolder = patternsHolder;
+        now = OffsetDateTime.now(ZoneOffset.UTC);
+    }
+
+    /**
+     * Parses a textual date in the format '2 days ago' into a Calendar representation which is then
+     * wrapped in a {@link DateWrapper} object.
+     * <p>
+     * Beginning with days ago, the date is considered as an approximation.
+     *
+     * @param textualDate The original date as provided by the streaming service
+     * @return The parsed time (can be approximated)
+     * @throws ParsingException if the time unit could not be recognized
+     */
+    public DateWrapper parse(final String textualDate) throws ParsingException {
+        for (final Map.Entry<ChronoUnit, Map<String, Integer>> caseUnitEntry
+                : patternsHolder.specialCases().entrySet()) {
+            final ChronoUnit chronoUnit = caseUnitEntry.getKey();
+            for (final Map.Entry<String, Integer> caseMapToAmountEntry
+                    : caseUnitEntry.getValue().entrySet()) {
+                final String caseText = caseMapToAmountEntry.getKey();
+                final Integer caseAmount = caseMapToAmountEntry.getValue();
+
+                if (textualDateMatches(textualDate, caseText)) {
+                    return getResultFor(caseAmount, chronoUnit);
+                }
+            }
+        }
+
+        return getResultFor(parseTimeAgoAmount(textualDate), parseChronoUnit(textualDate));
+    }
+
+    /**
+     * Parses a textual duration into a duration computer number.
+     *
+     * @param textualDuration the textual duration to parse
+     * @return the textual duration parsed, as a primitive {@code long}
+     * @throws ParsingException if the textual duration could not be parsed
+     */
+    public long parseDuration(final String textualDuration) throws ParsingException {
+        // We can't use Matcher.results, as it is only available on Android 14 and above
+        final Matcher matcher = DURATION_PATTERN.matcher(textualDuration);
+        final List<MatchResult> results = new ArrayList<>();
+        while (matcher.find()) {
+            results.add(matcher.toMatchResult());
+        }
+
+        return results.stream()
+                .map(match -> {
+                    final String digits = match.group(1);
+                    final String word = match.group(2);
+
+                    int amount;
+                    try {
+                        amount = Integer.parseInt(digits);
+                    } catch (final NumberFormatException ignored) {
+                        amount = 1;
+                    }
+
+                    final ChronoUnit unit;
+                    try {
+                        unit = parseChronoUnit(word);
+                    } catch (final ParsingException ignored) {
+                        return 0L;
+                    }
+
+                    return amount * unit.getDuration().getSeconds();
+                })
+                .filter(n -> n > 0)
+                .reduce(Long::sum)
+                .orElseThrow(() -> new ParsingException(
+                        "Could not parse duration \"" + textualDuration + "\""));
+    }
+
+    private int parseTimeAgoAmount(final String textualDate) {
+        try {
+            return Integer.parseInt(textualDate.replaceAll("\\D+", ""));
+        } catch (final NumberFormatException ignored) {
+            // If there is no valid number in the textual date,
+            // assume it is 1 (as in 'a second ago').
+            return 1;
+        }
+    }
+
+    private ChronoUnit parseChronoUnit(final String textualDate) throws ParsingException {
+        return patternsHolder.asMap().entrySet().stream()
+                .filter(e -> e.getValue().stream()
+                        .anyMatch(agoPhrase -> textualDateMatches(textualDate, agoPhrase)))
+                .map(Map.Entry::getKey)
+                .findFirst()
+                .orElseThrow(() ->
+                        new ParsingException("Unable to parse the date: " + textualDate));
+    }
+
+    private boolean textualDateMatches(final String textualDate, final String agoPhrase) {
+        if (textualDate.equals(agoPhrase)) {
+            return true;
+        }
+
+        if (patternsHolder.wordSeparator().isEmpty()) {
+            return textualDate.toLowerCase().contains(agoPhrase.toLowerCase());
+        }
+
+        final String escapedPhrase = Pattern.quote(agoPhrase.toLowerCase());
+        final String escapedSeparator = patternsHolder.wordSeparator().equals(" ")
+                // From JDK8 → \h - Treat horizontal spaces as a normal one
+                // (non-breaking space, thin space, etc.)
+                // Also split the string on numbers to be able to parse strings like "2wk"
+                ? "[ \\t\\xA0\\u1680\\u180e\\u2000-\\u200a\\u202f\\u205f\\u3000\\d]"
+                : Pattern.quote(patternsHolder.wordSeparator());
+
+        // (^|separator)pattern($|separator)
+        // Check if the pattern is surrounded by separators or start/end of the string.
+        final String pattern =
+                "(^|" + escapedSeparator + ")" + escapedPhrase + "($|" + escapedSeparator + ")";
+
+        return Parser.isMatch(pattern, textualDate.toLowerCase());
+    }
+
+    private DateWrapper getResultFor(final int timeAgoAmount, final ChronoUnit chronoUnit) {
+        OffsetDateTime offsetDateTime = now;
+        boolean isApproximation = false;
+
+        switch (chronoUnit) {
+            case SECONDS:
+            case MINUTES:
+            case HOURS:
+                offsetDateTime = offsetDateTime.minus(timeAgoAmount, chronoUnit);
+                break;
+
+            case DAYS:
+            case WEEKS:
+            case MONTHS:
+                offsetDateTime = offsetDateTime.minus(timeAgoAmount, chronoUnit);
+                isApproximation = true;
+                break;
+
+            case YEARS:
+                // minusDays is needed to prevent `PrettyTime` from showing '12 months ago'.
+                offsetDateTime = offsetDateTime.minusYears(timeAgoAmount).minusDays(1);
+                isApproximation = true;
+                break;
+        }
+
+        if (isApproximation) {
+            offsetDateTime = offsetDateTime.truncatedTo(ChronoUnit.HOURS);
+        }
+
+        return new DateWrapper(offsetDateTime, isApproximation);
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/localization/TimeAgoPatternsManager.java

@@ -0,0 +1,29 @@
+package org.schabi.newpipe.extractor.localization;
+
+import org.schabi.newpipe.extractor.timeago.PatternsHolder;
+import org.schabi.newpipe.extractor.timeago.PatternsManager;
+
+import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
+
+public final class TimeAgoPatternsManager {
+    private TimeAgoPatternsManager() {
+    }
+
+    @Nullable
+    private static PatternsHolder getPatternsFor(@Nonnull final Localization localization) {
+        return PatternsManager.getPatterns(localization.getLanguageCode(),
+                localization.getCountryCode());
+    }
+
+    @Nullable
+    public static TimeAgoParser getTimeAgoParserFor(@Nonnull final Localization localization) {
+        final PatternsHolder holder = getPatternsFor(localization);
+
+        if (holder == null) {
+            return null;
+        }
+
+        return new TimeAgoParser(holder);
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/playlist/PlaylistExtractor.java

@@ -0,0 +1,61 @@
+package org.schabi.newpipe.extractor.playlist;
+
+import org.schabi.newpipe.extractor.Image;
+import org.schabi.newpipe.extractor.ListExtractor;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+import org.schabi.newpipe.extractor.stream.Description;
+import org.schabi.newpipe.extractor.stream.StreamInfoItem;
+
+import javax.annotation.Nonnull;
+
+import java.util.Collections;
+import java.util.List;
+
+public abstract class PlaylistExtractor extends ListExtractor<StreamInfoItem> {
+
+    public PlaylistExtractor(final StreamingService service, final ListLinkHandler linkHandler) {
+        super(service, linkHandler);
+    }
+
+    public abstract String getUploaderUrl() throws ParsingException;
+    public abstract String getUploaderName() throws ParsingException;
+    @Nonnull
+    public abstract List<Image> getUploaderAvatars() throws ParsingException;
+    public abstract boolean isUploaderVerified() throws ParsingException;
+
+    public abstract long getStreamCount() throws ParsingException;
+
+    @Nonnull
+    public abstract Description getDescription() throws ParsingException;
+
+    @Nonnull
+    public List<Image> getThumbnails() throws ParsingException {
+        return Collections.emptyList();
+    }
+
+    @Nonnull
+    public List<Image> getBanners() throws ParsingException {
+        return List.of();
+    }
+
+    @Nonnull
+    public String getSubChannelName() throws ParsingException {
+        return "";
+    }
+
+    @Nonnull
+    public String getSubChannelUrl() throws ParsingException {
+        return "";
+    }
+
+    @Nonnull
+    public List<Image> getSubChannelAvatars() throws ParsingException {
+        return List.of();
+    }
+
+    public PlaylistInfo.PlaylistType getPlaylistType() throws ParsingException {
+        return PlaylistInfo.PlaylistType.NORMAL;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/playlist/PlaylistInfo.java

@@ -0,0 +1,280 @@
+package org.schabi.newpipe.extractor.playlist;
+
+import org.schabi.newpipe.extractor.Image;
+import org.schabi.newpipe.extractor.ListExtractor.InfoItemsPage;
+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.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+import org.schabi.newpipe.extractor.stream.Description;
+import org.schabi.newpipe.extractor.stream.StreamInfoItem;
+import org.schabi.newpipe.extractor.utils.ExtractorHelper;
+
+import javax.annotation.Nonnull;
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+
+public final class PlaylistInfo extends ListInfo<StreamInfoItem> {
+
+    /**
+     * Mixes are handled as particular playlists in NewPipeExtractor. {@link PlaylistType#NORMAL} is
+     * for non-mixes, while other values are for the different types of mixes. The type of a mix
+     * depends on how its contents are autogenerated.
+     */
+    public enum PlaylistType {
+        /**
+         * A normal playlist (not a mix)
+         */
+        NORMAL,
+
+        /**
+         * A mix made only of streams related to a particular stream, for example YouTube mixes
+         */
+        MIX_STREAM,
+
+        /**
+         * A mix made only of music streams related to a particular stream, for example YouTube
+         * music mixes
+         */
+        MIX_MUSIC,
+
+        /**
+         * A mix made only of streams from (or related to) the same channel, for example YouTube
+         * channel mixes
+         */
+        MIX_CHANNEL,
+
+        /**
+         * A mix made only of streams related to a particular (musical) genre, for example YouTube
+         * genre mixes
+         */
+        MIX_GENRE,
+    }
+
+    @SuppressWarnings("RedundantThrows")
+    private PlaylistInfo(final int serviceId, final ListLinkHandler linkHandler, final String name)
+            throws ParsingException {
+        super(serviceId, linkHandler, name);
+    }
+
+    public static PlaylistInfo getInfo(final String url) throws IOException, ExtractionException {
+        return getInfo(NewPipe.getServiceByUrl(url), url);
+    }
+
+    public static PlaylistInfo getInfo(final StreamingService service, final String url)
+            throws IOException, ExtractionException {
+        final PlaylistExtractor extractor = service.getPlaylistExtractor(url);
+        extractor.fetchPage();
+        return getInfo(extractor);
+    }
+
+    public static InfoItemsPage<StreamInfoItem> getMoreItems(final StreamingService service,
+                                                             final String url,
+                                                             final Page page)
+            throws IOException, ExtractionException {
+        return service.getPlaylistExtractor(url).getPage(page);
+    }
+
+    /**
+     * Get PlaylistInfo from PlaylistExtractor
+     *
+     * @param extractor an extractor where fetchPage() was already got called on.
+     */
+    public static PlaylistInfo getInfo(final PlaylistExtractor extractor)
+            throws ExtractionException {
+
+        final PlaylistInfo info = new PlaylistInfo(
+                extractor.getServiceId(),
+                extractor.getLinkHandler(),
+                extractor.getName());
+        // collect uploader extraction failures until we are sure this is not
+        // just a playlist without an uploader
+        final List<Throwable> uploaderParsingErrors = new ArrayList<>();
+
+        try {
+            info.setOriginalUrl(extractor.getOriginalUrl());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+        try {
+            info.setStreamCount(extractor.getStreamCount());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+        try {
+            info.setDescription(extractor.getDescription());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+        try {
+            info.setThumbnails(extractor.getThumbnails());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+        try {
+            info.setUploaderUrl(extractor.getUploaderUrl());
+        } catch (final Exception e) {
+            uploaderParsingErrors.add(e);
+        }
+        try {
+            info.setUploaderName(extractor.getUploaderName());
+        } catch (final Exception e) {
+            uploaderParsingErrors.add(e);
+        }
+        try {
+            info.setUploaderAvatars(extractor.getUploaderAvatars());
+        } catch (final Exception e) {
+            uploaderParsingErrors.add(e);
+        }
+        try {
+            info.setSubChannelUrl(extractor.getSubChannelUrl());
+        } catch (final Exception e) {
+            uploaderParsingErrors.add(e);
+        }
+        try {
+            info.setSubChannelName(extractor.getSubChannelName());
+        } catch (final Exception e) {
+            uploaderParsingErrors.add(e);
+        }
+        try {
+            info.setSubChannelAvatars(extractor.getSubChannelAvatars());
+        } catch (final Exception e) {
+            uploaderParsingErrors.add(e);
+        }
+        try {
+            info.setBanners(extractor.getBanners());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+        try {
+            info.setPlaylistType(extractor.getPlaylistType());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        // do not fail if everything but the uploader infos could be collected (TODO better comment)
+        if (!uploaderParsingErrors.isEmpty()
+                && (!info.getErrors().isEmpty() || uploaderParsingErrors.size() < 3)) {
+            info.addAllErrors(uploaderParsingErrors);
+        }
+
+        final InfoItemsPage<StreamInfoItem> itemsPage
+                = ExtractorHelper.getItemsPageOrLogError(info, extractor);
+        info.setRelatedItems(itemsPage.getItems());
+        info.setNextPage(itemsPage.getNextPage());
+
+        return info;
+    }
+
+    private String uploaderUrl = "";
+    private String uploaderName = "";
+    private String subChannelUrl;
+    private String subChannelName;
+    private Description description;
+    @Nonnull
+    private List<Image> banners = List.of();
+    @Nonnull
+    private List<Image> subChannelAvatars = List.of();
+    @Nonnull
+    private List<Image> thumbnails = List.of();
+    @Nonnull
+    private List<Image> uploaderAvatars = List.of();
+    private long streamCount;
+    private PlaylistType playlistType;
+
+    @Nonnull
+    public List<Image> getThumbnails() {
+        return thumbnails;
+    }
+
+    public void setThumbnails(@Nonnull final List<Image> thumbnails) {
+        this.thumbnails = thumbnails;
+    }
+
+    @Nonnull
+    public List<Image> getBanners() {
+        return banners;
+    }
+
+    public void setBanners(@Nonnull final List<Image> banners) {
+        this.banners = banners;
+    }
+
+    public String getUploaderUrl() {
+        return uploaderUrl;
+    }
+
+    public void setUploaderUrl(final String uploaderUrl) {
+        this.uploaderUrl = uploaderUrl;
+    }
+
+    public String getUploaderName() {
+        return uploaderName;
+    }
+
+    public void setUploaderName(final String uploaderName) {
+        this.uploaderName = uploaderName;
+    }
+
+    @Nonnull
+    public List<Image> getUploaderAvatars() {
+        return uploaderAvatars;
+    }
+
+    public void setUploaderAvatars(@Nonnull final List<Image> uploaderAvatars) {
+        this.uploaderAvatars = uploaderAvatars;
+    }
+
+    public String getSubChannelUrl() {
+        return subChannelUrl;
+    }
+
+    public void setSubChannelUrl(final String subChannelUrl) {
+        this.subChannelUrl = subChannelUrl;
+    }
+
+    public String getSubChannelName() {
+        return subChannelName;
+    }
+
+    public void setSubChannelName(final String subChannelName) {
+        this.subChannelName = subChannelName;
+    }
+
+    @Nonnull
+    public List<Image> getSubChannelAvatars() {
+        return subChannelAvatars;
+    }
+
+    public void setSubChannelAvatars(@Nonnull final List<Image> subChannelAvatars) {
+        this.subChannelAvatars = subChannelAvatars;
+    }
+
+    public long getStreamCount() {
+        return streamCount;
+    }
+
+    public void setStreamCount(final long streamCount) {
+        this.streamCount = streamCount;
+    }
+
+    public Description getDescription() {
+        return description;
+    }
+
+    public void setDescription(final Description description) {
+        this.description = description;
+    }
+
+    public PlaylistType getPlaylistType() {
+        return playlistType;
+    }
+
+    public void setPlaylistType(final PlaylistType playlistType) {
+        this.playlistType = playlistType;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/playlist/PlaylistInfoItem.java

@@ -0,0 +1,72 @@
+package org.schabi.newpipe.extractor.playlist;
+
+import org.schabi.newpipe.extractor.InfoItem;
+import org.schabi.newpipe.extractor.stream.Description;
+
+import javax.annotation.Nullable;
+
+public class PlaylistInfoItem extends InfoItem {
+
+    private String uploaderName;
+    private String uploaderUrl;
+    private boolean uploaderVerified;
+    /**
+     * How many streams this playlist have
+     */
+    private long streamCount = 0;
+    private Description description;
+    private PlaylistInfo.PlaylistType playlistType;
+
+    public PlaylistInfoItem(final int serviceId, final String url, final String name) {
+        super(InfoType.PLAYLIST, serviceId, url, name);
+    }
+
+    public String getUploaderName() {
+        return uploaderName;
+    }
+
+    public void setUploaderName(final String uploaderName) {
+        this.uploaderName = uploaderName;
+    }
+
+    @Nullable
+    public String getUploaderUrl() {
+        return uploaderUrl;
+    }
+
+    public void setUploaderUrl(@Nullable final String uploaderUrl) {
+        this.uploaderUrl = uploaderUrl;
+    }
+
+    public boolean isUploaderVerified() {
+        return uploaderVerified;
+    }
+
+    public void setUploaderVerified(final boolean uploaderVerified) {
+        this.uploaderVerified = uploaderVerified;
+    }
+
+    public long getStreamCount() {
+        return streamCount;
+    }
+
+    public void setStreamCount(final long streamCount) {
+        this.streamCount = streamCount;
+    }
+
+    public Description getDescription() {
+        return description;
+    }
+
+    public void setDescription(final Description description) {
+        this.description = description;
+    }
+
+    public PlaylistInfo.PlaylistType getPlaylistType() {
+        return playlistType;
+    }
+
+    public void setPlaylistType(final PlaylistInfo.PlaylistType playlistType) {
+        this.playlistType = playlistType;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/playlist/PlaylistInfoItemExtractor.java

@@ -0,0 +1,53 @@
+package org.schabi.newpipe.extractor.playlist;
+
+import org.schabi.newpipe.extractor.InfoItemExtractor;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.stream.Description;
+
+import javax.annotation.Nonnull;
+
+public interface PlaylistInfoItemExtractor extends InfoItemExtractor {
+
+    /**
+     * Get the uploader name
+     * @return the uploader name
+     */
+    String getUploaderName() throws ParsingException;
+
+    /**
+     * Get the uploader url
+     * @return the uploader url
+     */
+    String getUploaderUrl() throws ParsingException;
+
+    /**
+     * Get whether the uploader is verified
+     * @return whether the uploader is verified
+     */
+    boolean isUploaderVerified() throws ParsingException;
+
+    /**
+     * Get the number of streams
+     * @return the number of streams
+     */
+    long getStreamCount() throws ParsingException;
+
+    /**
+     * Get the description of the playlist if there is any.
+     * Otherwise, an {@link Description#EMPTY_DESCRIPTION EMPTY_DESCRIPTION} is returned.
+     * @return the playlist's description
+     */
+    @Nonnull
+    default Description getDescription() throws ParsingException {
+        return Description.EMPTY_DESCRIPTION;
+    }
+
+    /**
+     * @return the type of this playlist, see {@link PlaylistInfo.PlaylistType} for a description
+     *         of types. If not overridden always returns {@link PlaylistInfo.PlaylistType#NORMAL}.
+     */
+    @Nonnull
+    default PlaylistInfo.PlaylistType getPlaylistType() throws ParsingException {
+        return PlaylistInfo.PlaylistType.NORMAL;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/playlist/PlaylistInfoItemsCollector.java

@@ -0,0 +1,56 @@
+package org.schabi.newpipe.extractor.playlist;
+
+import org.schabi.newpipe.extractor.InfoItemsCollector;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+
+public class PlaylistInfoItemsCollector
+        extends InfoItemsCollector<PlaylistInfoItem, PlaylistInfoItemExtractor> {
+
+    public PlaylistInfoItemsCollector(final int serviceId) {
+        super(serviceId);
+    }
+
+    @Override
+    public PlaylistInfoItem extract(final PlaylistInfoItemExtractor extractor)
+            throws ParsingException {
+        final PlaylistInfoItem resultItem = new PlaylistInfoItem(
+                getServiceId(), extractor.getUrl(), extractor.getName());
+
+        try {
+            resultItem.setUploaderName(extractor.getUploaderName());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setUploaderUrl(extractor.getUploaderUrl());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setUploaderVerified(extractor.isUploaderVerified());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setThumbnails(extractor.getThumbnails());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setStreamCount(extractor.getStreamCount());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setDescription(extractor.getDescription());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        try {
+            resultItem.setPlaylistType(extractor.getPlaylistType());
+        } catch (final Exception e) {
+            addError(e);
+        }
+        return resultItem;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/search/SearchExtractor.java

@@ -0,0 +1,72 @@
+package org.schabi.newpipe.extractor.search;
+
+import org.schabi.newpipe.extractor.InfoItem;
+import org.schabi.newpipe.extractor.ListExtractor;
+import org.schabi.newpipe.extractor.MetaInfo;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.linkhandler.SearchQueryHandler;
+
+import javax.annotation.Nonnull;
+import java.util.List;
+
+public abstract class SearchExtractor extends ListExtractor<InfoItem> {
+
+    public static class NothingFoundException extends ExtractionException {
+        public NothingFoundException(final String message) {
+            super(message);
+        }
+    }
+
+    public SearchExtractor(final StreamingService service, final SearchQueryHandler linkHandler) {
+        super(service, linkHandler);
+    }
+
+    public String getSearchString() {
+        return getLinkHandler().getSearchString();
+    }
+
+    /**
+     * The search suggestion provided by the service.
+     * <p>
+     * This method also returns the corrected query if
+     * {@link SearchExtractor#isCorrectedSearch()} is true.
+     *
+     * @return a suggestion to another query, the corrected query, or an empty String.
+     */
+    @Nonnull
+    public abstract String getSearchSuggestion() throws ParsingException;
+
+    @Nonnull
+    @Override
+    public SearchQueryHandler getLinkHandler() {
+        return (SearchQueryHandler) super.getLinkHandler();
+    }
+
+    @Nonnull
+    @Override
+    public String getName() {
+        return getLinkHandler().getSearchString();
+    }
+
+    /**
+     * Tell if the search was corrected by the service (if it's not exactly the search you typed).
+     * <p>
+     * Example: on YouTube, if you search for "pewdeipie",
+     * it will give you results for "pewdiepie", then isCorrectedSearch should return true.
+     *
+     * @return whether the results comes from a corrected query or not.
+     */
+    public abstract boolean isCorrectedSearch() throws ParsingException;
+
+    /**
+     * Meta information about the search query.
+     * <p>
+     * Example: on YouTube, if you search for "Covid-19",
+     * there is a box with information from the WHO about Covid-19 and a link to the WHO's website.
+     * @return additional meta information about the search query
+     */
+    @Nonnull
+    public abstract List<MetaInfo> getMetaInfo() throws ParsingException;
+}

extractor/src/main/java/org/schabi/newpipe/extractor/search/SearchInfo.java

@@ -0,0 +1,113 @@
+package org.schabi.newpipe.extractor.search;
+
+import org.schabi.newpipe.extractor.InfoItem;
+import org.schabi.newpipe.extractor.ListExtractor;
+import org.schabi.newpipe.extractor.ListInfo;
+import org.schabi.newpipe.extractor.MetaInfo;
+import org.schabi.newpipe.extractor.Page;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.linkhandler.SearchQueryHandler;
+import org.schabi.newpipe.extractor.utils.ExtractorHelper;
+
+import java.io.IOException;
+import java.util.List;
+
+import javax.annotation.Nonnull;
+
+public class SearchInfo extends ListInfo<InfoItem> {
+    private final String searchString;
+    private String searchSuggestion;
+    private boolean isCorrectedSearch;
+    private List<MetaInfo> metaInfo = List.of();
+
+    public SearchInfo(final int serviceId,
+                      final SearchQueryHandler qIHandler,
+                      final String searchString) {
+        super(serviceId, qIHandler, "Search");
+        this.searchString = searchString;
+    }
+
+
+    public static SearchInfo getInfo(final StreamingService service,
+                                     final SearchQueryHandler searchQuery)
+            throws ExtractionException, IOException {
+        final SearchExtractor extractor = service.getSearchExtractor(searchQuery);
+        extractor.fetchPage();
+        return getInfo(extractor);
+    }
+
+    public static SearchInfo getInfo(final SearchExtractor extractor)
+            throws ExtractionException, IOException {
+        final SearchInfo info = new SearchInfo(
+                extractor.getServiceId(),
+                extractor.getLinkHandler(),
+                extractor.getSearchString());
+
+        try {
+            info.setOriginalUrl(extractor.getOriginalUrl());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+        try {
+            info.setSearchSuggestion(extractor.getSearchSuggestion());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+        try {
+            info.setIsCorrectedSearch(extractor.isCorrectedSearch());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+        try {
+            info.setMetaInfo(extractor.getMetaInfo());
+        } catch (final Exception e) {
+            info.addError(e);
+        }
+
+        final ListExtractor.InfoItemsPage<InfoItem> page
+                = ExtractorHelper.getItemsPageOrLogError(info, extractor);
+        info.setRelatedItems(page.getItems());
+        info.setNextPage(page.getNextPage());
+
+        return info;
+    }
+
+
+    public static ListExtractor.InfoItemsPage<InfoItem> getMoreItems(final StreamingService service,
+                                                                     final SearchQueryHandler query,
+                                                                     final Page page)
+            throws IOException, ExtractionException {
+        return service.getSearchExtractor(query).getPage(page);
+    }
+
+    // Getter
+    public String getSearchString() {
+        return this.searchString;
+    }
+
+    public String getSearchSuggestion() {
+        return this.searchSuggestion;
+    }
+
+    public boolean isCorrectedSearch() {
+        return this.isCorrectedSearch;
+    }
+
+    public void setIsCorrectedSearch(final boolean isCorrectedSearch) {
+        this.isCorrectedSearch = isCorrectedSearch;
+    }
+
+    public void setSearchSuggestion(final String searchSuggestion) {
+        this.searchSuggestion = searchSuggestion;
+    }
+
+    @Nonnull
+    public List<MetaInfo> getMetaInfo() {
+        return metaInfo;
+    }
+
+    public void setMetaInfo(@Nonnull final List<MetaInfo> metaInfo) {
+        this.metaInfo = metaInfo;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/services/bandcamp/BandcampService.java

@@ -0,0 +1,174 @@
+// Created by Fynn Godau 2019, licensed GNU GPL version 3 or later
+
+package org.schabi.newpipe.extractor.services.bandcamp;
+
+import static org.schabi.newpipe.extractor.StreamingService.ServiceInfo.MediaCapability.AUDIO;
+import static org.schabi.newpipe.extractor.StreamingService.ServiceInfo.MediaCapability.COMMENTS;
+import static org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampExtractorHelper.BASE_URL;
+import static org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampFeaturedExtractor.FEATURED_API_URL;
+import static org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampFeaturedExtractor.KIOSK_FEATURED;
+import static org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampRadioExtractor.KIOSK_RADIO;
+import static org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampRadioExtractor.RADIO_API_URL;
+
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.channel.ChannelExtractor;
+import org.schabi.newpipe.extractor.channel.tabs.ChannelTabExtractor;
+import org.schabi.newpipe.extractor.comments.CommentsExtractor;
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.kiosk.KioskList;
+import org.schabi.newpipe.extractor.linkhandler.LinkHandler;
+import org.schabi.newpipe.extractor.linkhandler.LinkHandlerFactory;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandlerFactory;
+import org.schabi.newpipe.extractor.linkhandler.ReadyChannelTabListLinkHandler;
+import org.schabi.newpipe.extractor.linkhandler.SearchQueryHandler;
+import org.schabi.newpipe.extractor.linkhandler.SearchQueryHandlerFactory;
+import org.schabi.newpipe.extractor.playlist.PlaylistExtractor;
+import org.schabi.newpipe.extractor.search.SearchExtractor;
+import org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampChannelExtractor;
+import org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampChannelTabExtractor;
+import org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampCommentsExtractor;
+import org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampExtractorHelper;
+import org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampFeaturedExtractor;
+import org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampPlaylistExtractor;
+import org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampRadioExtractor;
+import org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampRadioStreamExtractor;
+import org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampSearchExtractor;
+import org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampStreamExtractor;
+import org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampSuggestionExtractor;
+import org.schabi.newpipe.extractor.services.bandcamp.linkHandler.BandcampChannelLinkHandlerFactory;
+import org.schabi.newpipe.extractor.services.bandcamp.linkHandler.BandcampChannelTabLinkHandlerFactory;
+import org.schabi.newpipe.extractor.services.bandcamp.linkHandler.BandcampCommentsLinkHandlerFactory;
+import org.schabi.newpipe.extractor.services.bandcamp.linkHandler.BandcampFeaturedLinkHandlerFactory;
+import org.schabi.newpipe.extractor.services.bandcamp.linkHandler.BandcampPlaylistLinkHandlerFactory;
+import org.schabi.newpipe.extractor.services.bandcamp.linkHandler.BandcampSearchQueryHandlerFactory;
+import org.schabi.newpipe.extractor.services.bandcamp.linkHandler.BandcampStreamLinkHandlerFactory;
+import org.schabi.newpipe.extractor.stream.StreamExtractor;
+import org.schabi.newpipe.extractor.subscription.SubscriptionExtractor;
+import org.schabi.newpipe.extractor.suggestion.SuggestionExtractor;
+
+import java.util.Arrays;
+
+public class BandcampService extends StreamingService {
+
+    public BandcampService(final int id) {
+        super(id, "Bandcamp", Arrays.asList(AUDIO, COMMENTS));
+    }
+
+    @Override
+    public String getBaseUrl() {
+        return BASE_URL;
+    }
+
+    @Override
+    public LinkHandlerFactory getStreamLHFactory() {
+        return BandcampStreamLinkHandlerFactory.getInstance();
+    }
+
+    @Override
+    public ListLinkHandlerFactory getChannelLHFactory() {
+        return BandcampChannelLinkHandlerFactory.getInstance();
+    }
+
+    @Override
+    public ListLinkHandlerFactory getChannelTabLHFactory() {
+        return BandcampChannelTabLinkHandlerFactory.getInstance();
+    }
+
+    @Override
+    public ListLinkHandlerFactory getPlaylistLHFactory() {
+        return BandcampPlaylistLinkHandlerFactory.getInstance();
+    }
+
+    @Override
+    public SearchQueryHandlerFactory getSearchQHFactory() {
+        return BandcampSearchQueryHandlerFactory.getInstance();
+    }
+
+    @Override
+    public ListLinkHandlerFactory getCommentsLHFactory() {
+        return BandcampCommentsLinkHandlerFactory.getInstance();
+    }
+
+    @Override
+    public SearchExtractor getSearchExtractor(final SearchQueryHandler queryHandler) {
+        return new BandcampSearchExtractor(this, queryHandler);
+    }
+
+    @Override
+    public SuggestionExtractor getSuggestionExtractor() {
+        return new BandcampSuggestionExtractor(this);
+    }
+
+    @Override
+    public SubscriptionExtractor getSubscriptionExtractor() {
+        return null;
+    }
+
+    @Override
+    public KioskList getKioskList() throws ExtractionException {
+        final KioskList kioskList = new KioskList(this);
+        final ListLinkHandlerFactory h = BandcampFeaturedLinkHandlerFactory.getInstance();
+
+        try {
+            kioskList.addKioskEntry(
+                    (streamingService, url, kioskId) -> new BandcampFeaturedExtractor(
+                            BandcampService.this,
+                            h.fromUrl(FEATURED_API_URL),
+                            kioskId
+                    ),
+                    h,
+                    KIOSK_FEATURED
+            );
+
+            kioskList.addKioskEntry(
+                    (streamingService, url, kioskId) -> new BandcampRadioExtractor(
+                            BandcampService.this,
+                            h.fromUrl(RADIO_API_URL),
+                            kioskId
+                    ),
+                    h,
+                    KIOSK_RADIO
+            );
+
+            kioskList.setDefaultKiosk(KIOSK_FEATURED);
+
+        } catch (final Exception e) {
+            throw new ExtractionException(e);
+        }
+
+        return kioskList;
+    }
+
+    @Override
+    public ChannelExtractor getChannelExtractor(final ListLinkHandler linkHandler) {
+        return new BandcampChannelExtractor(this, linkHandler);
+    }
+
+    @Override
+    public ChannelTabExtractor getChannelTabExtractor(final ListLinkHandler linkHandler) {
+        if (linkHandler instanceof ReadyChannelTabListLinkHandler) {
+            return ((ReadyChannelTabListLinkHandler) linkHandler).getChannelTabExtractor(this);
+        } else {
+            return new BandcampChannelTabExtractor(this, linkHandler);
+        }
+    }
+
+    @Override
+    public PlaylistExtractor getPlaylistExtractor(final ListLinkHandler linkHandler) {
+        return new BandcampPlaylistExtractor(this, linkHandler);
+    }
+
+    @Override
+    public StreamExtractor getStreamExtractor(final LinkHandler linkHandler) {
+        if (BandcampExtractorHelper.isRadioUrl(linkHandler.getUrl())) {
+            return new BandcampRadioStreamExtractor(this, linkHandler);
+        }
+        return new BandcampStreamExtractor(this, linkHandler);
+    }
+
+    @Override
+    public CommentsExtractor getCommentsExtractor(final ListLinkHandler linkHandler) {
+        return new BandcampCommentsExtractor(this, linkHandler);
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/services/bandcamp/extractors/BandcampAlbumInfoItemExtractor.java

@@ -0,0 +1,62 @@
+package org.schabi.newpipe.extractor.services.bandcamp.extractors;
+
+import com.grack.nanojson.JsonObject;
+
+import org.schabi.newpipe.extractor.Image;
+import org.schabi.newpipe.extractor.ListExtractor;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.playlist.PlaylistInfoItemExtractor;
+
+import java.util.List;
+
+import javax.annotation.Nonnull;
+
+public class BandcampAlbumInfoItemExtractor implements PlaylistInfoItemExtractor {
+    private final JsonObject albumInfoItem;
+    private final String uploaderUrl;
+
+    public BandcampAlbumInfoItemExtractor(final JsonObject albumInfoItem,
+                                          final String uploaderUrl) {
+        this.albumInfoItem = albumInfoItem;
+        this.uploaderUrl = uploaderUrl;
+    }
+
+    @Override
+    public String getName() throws ParsingException {
+        return albumInfoItem.getString("title");
+    }
+
+    @Override
+    public String getUrl() throws ParsingException {
+        return BandcampExtractorHelper.getStreamUrlFromIds(
+                albumInfoItem.getLong("band_id"),
+                albumInfoItem.getLong("item_id"),
+                albumInfoItem.getString("item_type"));
+    }
+
+    @Nonnull
+    @Override
+    public List<Image> getThumbnails() throws ParsingException {
+        return BandcampExtractorHelper.getImagesFromImageId(albumInfoItem.getLong("art_id"), true);
+    }
+
+    @Override
+    public String getUploaderName() throws ParsingException {
+        return albumInfoItem.getString("band_name");
+    }
+
+    @Override
+    public String getUploaderUrl() {
+        return uploaderUrl;
+    }
+
+    @Override
+    public boolean isUploaderVerified() {
+        return false;
+    }
+
+    @Override
+    public long getStreamCount() {
+        return ListExtractor.ITEM_COUNT_UNKNOWN;
+    }
+}

extractor/src/main/java/org/schabi/newpipe/extractor/services/bandcamp/extractors/BandcampChannelExtractor.java

@@ -0,0 +1,192 @@
+// Created by Fynn Godau 2019, licensed GNU GPL version 3 or later
+
+package org.schabi.newpipe.extractor.services.bandcamp.extractors;
+
+import static org.schabi.newpipe.extractor.Image.HEIGHT_UNKNOWN;
+import static org.schabi.newpipe.extractor.Image.WIDTH_UNKNOWN;
+import static org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampExtractorHelper.getArtistDetails;
+import static org.schabi.newpipe.extractor.services.bandcamp.extractors.BandcampExtractorHelper.getImagesFromImageId;
+import static org.schabi.newpipe.extractor.utils.Utils.replaceHttpWithHttps;
+
+import com.grack.nanojson.JsonArray;
+import com.grack.nanojson.JsonObject;
+
+import org.jsoup.Jsoup;
+import org.schabi.newpipe.extractor.Image;
+import org.schabi.newpipe.extractor.Image.ResolutionLevel;
+import org.schabi.newpipe.extractor.StreamingService;
+import org.schabi.newpipe.extractor.channel.ChannelExtractor;
+import org.schabi.newpipe.extractor.channel.tabs.ChannelTabExtractor;
+import org.schabi.newpipe.extractor.downloader.Downloader;
+import org.schabi.newpipe.extractor.exceptions.ExtractionException;
+import org.schabi.newpipe.extractor.exceptions.ParsingException;
+import org.schabi.newpipe.extractor.exceptions.ReCaptchaException;
+import org.schabi.newpipe.extractor.channel.tabs.ChannelTabs;
+import org.schabi.newpipe.extractor.linkhandler.ListLinkHandler;
+import org.schabi.newpipe.extractor.linkhandler.ReadyChannelTabListLinkHandler;
+import org.schabi.newpipe.extractor.services.bandcamp.linkHandler.BandcampChannelTabLinkHandlerFactory;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Objects;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+
+import javax.annotation.Nonnull;
+
+public class BandcampChannelExtractor extends ChannelExtractor {
+
+    private JsonObject channelInfo;
+
+    public BandcampChannelExtractor(final StreamingService service,
+                                    final ListLinkHandler linkHandler) {
+        super(service, linkHandler);
+    }
+
+    @Nonnull
+    @Override
+    public List<Image> getAvatars() {
+        return getImagesFromImageId(channelInfo.getLong("bio_image_id"), false);
+    }
+
+    @Nonnull
+    @Override
+    public List<Image> getBanners() throws ParsingException {
+        /*
+         * Mobile API does not return the header or not the correct header.
+         * Therefore, we need to query the website
+         */
+        try {
+            final String html = getDownloader()
+                    .get(replaceHttpWithHttps(channelInfo.getString("bandcamp_url")))
+                    .responseBody();
+
+            return Stream.of(Jsoup.parse(html).getElementById("customHeader"))
+                    .filter(Objects::nonNull)
+                    .flatMap(element -> element.getElementsByTag("img").stream())
+                    .map(element -> element.attr("src"))
+                    .filter(url -> !url.isEmpty())
+                    .map(url -> new Image(
+                            replaceHttpWithHttps(url), HEIGHT_UNKNOWN, WIDTH_UNKNOWN,
+                            ResolutionLevel.UNKNOWN))
+                    .collect(Collectors.toUnmodifiableList());
+
+        } catch (final IOException | ReCaptchaException e) {
+            throw new ParsingException("Could not download artist web site", e);
+        }
+    }
+
+    /**
+     * Bandcamp discontinued their RSS feeds because it hadn't been used enough.
+     */
+    @Override
+    public String getFeedUrl() {
+        return null;
+    }
+
+    @Override
+    public long getSubscriberCount() {
+        return -1;
+    }
+
+    @Override
+    public String getDescription() {
+        return channelInfo.getString("bio");
+    }
+
+    @Override
+    public String getParentChannelName() {
+        return null;
+    }
+
+    @Override
+    public String getParentChannelUrl() {
+        return null;
+    }
+
+    @Nonnull
+    @Override
+    public List<Image> getParentChannelAvatars() {
+        return List.of();
+    }
+
+    @Override
+    public boolean isVerified() throws ParsingException {
+        return false;
+    }
+
+    @Nonnull
+    @Override
+    public List<ListLinkHandler> getTabs() throws ParsingException {
+        final JsonArray discography = channelInfo.getArray("discography");
+        final TabExtractorBuilder builder = new TabExtractorBuilder(discography);
+
+        final List<ListLinkHandler> tabs = new ArrayList<>();
+
+        boolean foundTrackItem = false;
+        boolean foundAlbumItem = false;
+
+        for (final Object discographyItem : discography) {
+            if (foundTrackItem && foundAlbumItem) {
+                break;
+            }
+
+            if (!(discographyItem instanceof JsonObject)) {
+                continue;
+            }
+
+            final JsonObject discographyJsonItem = (JsonObject) discographyItem;
+            final String itemType = discographyJsonItem.getString("item_type");
+
+            if (!foundTrackItem && "track".equals(itemType)) {
+                foundTrackItem = true;
+                tabs.add(new ReadyChannelTabListLinkHandler(getUrl()
+                        + BandcampChannelTabLinkHandlerFactory.getUrlSuffix(ChannelTabs.TRACKS),
+                        getId(),
+                        ChannelTabs.TRACKS,
+                        builder));
+            }
+
+            if (!foundAlbumItem && "album".equals(itemType)) {
+                foundAlbumItem = true;
+                tabs.add(new ReadyChannelTabListLinkHandler(getUrl()
+                        + BandcampChannelTabLinkHandlerFactory.getUrlSuffix(ChannelTabs.ALBUMS),
+                        getId(),
+                        ChannelTabs.ALBUMS,
+                        builder));
+            }
+        }
+
+        return Collections.unmodifiableList(tabs);
+    }
+
+    @Override
+    public void onFetchPage(@Nonnull final Downloader downloader)
+            throws IOException, ExtractionException {
+        channelInfo = getArtistDetails(getId());
+    }
+
+    @Nonnull
+    @Override
+    public String getName() {
+        return channelInfo.getString("name");
+    }
+
+    private static final class TabExtractorBuilder
+            implements ReadyChannelTabListLinkHandler.ChannelTabExtractorBuilder {
+        private final JsonArray discography;
+
+        TabExtractorBuilder(final JsonArray discography) {
+            this.discography = discography;
+        }
+
+        @Nonnull
+        @Override
+        public ChannelTabExtractor build(@Nonnull final StreamingService service,
+                                         @Nonnull final ListLinkHandler linkHandler) {
+            return BandcampChannelTabExtractor.fromDiscography(service, linkHandler, discography);
+        }
+    }
+}