From 217edc7ad8bc77db608ea3918c680f4374331aea Mon Sep 17 00:00:00 2001
From: Christian Schabesberger <chris.schabesberger@mailbox.org>
Date: Sat, 12 Jan 2019 22:17:21 +0100
Subject: [PATCH] Deployed 2980431 with MkDocs version: 1.0.4

---
 05_documentation/index.html |  21 ++++++++++++++-------
 img/termux_files.png        | Bin 0 -> 38973 bytes
 index.html                  |   2 +-
 search/search_index.json    |   2 +-
 sitemap.xml.gz              | Bin 199 -> 199 bytes
 5 files changed, 16 insertions(+), 9 deletions(-)
 create mode 100644 img/termux_files.png

diff --git a/05_documentation/index.html b/05_documentation/index.html
index 43e4778..dd350fb 100644
--- a/05_documentation/index.html
+++ b/05_documentation/index.html
@@ -98,14 +98,11 @@
         
             <li><a class="toctree-l3" href="#linuxbsd">Linux/*BSD</a></li>
         
+            <li><a class="toctree-l3" href="#androidchromeos">Android/ChromeOS</a></li>
+        
             <li><a class="toctree-l3" href="#update">Update</a></li>
         
-        </ul>
-    
-
-    <li class="toctree-l2"><a href="#using-mkdocs">Using mkdocs</a></li>
-    
-        <ul>
+            <li><a class="toctree-l3" href="#using-mkdocs">Using mkdocs</a></li>
         
             <li><a class="toctree-l3" href="#write-and-deploy">Write and Deploy</a></li>
         
@@ -182,9 +179,19 @@
 <li>Run <code>pip3 install mkdocs</code> to install mkdocs only for the current user,
 or run <code>sudo pip3 install mkdocs</code> to install mkdocs systemwide. Last one has the higher chance to work properly.</li>
 </ol>
+<h2 id="androidchromeos">Android/ChromeOS</h2>
+<p>This might sound funny, but according to the growing amount of ChromeBooks and Android tablets with keyboard this might actually be useful.</p>
+<ol>
+<li>Install the <a href="https://termux.com/">Tremux App</a> from <a href="https://f-droid.org/packages/com.termux/">f-droid</a>.</li>
+<li>Launch Termux and type <code>apt update</code></li>
+<li>Install python and git with the command: <code>apt install git python</code></li>
+<li>Now install mkdocs with <code>pip install mkdocs</code>.</li>
+</ol>
+<p>From here on everything will be the same as on Desktop. If you want to edit the files you can (besides vim or emacs which are available through Termux) use your favourite text editor on android. This is possible by opening the files with the Termux integration of the build in android file manager:</p>
+<p><img alt="termux_files" src="/img/termux_files.png" /></p>
 <h2 id="update">Update</h2>
 <p>Sometimes mkdocs changes the way how to serve, or the syntax will differ. This is why you should make sure to always run the latest version of mkdocs. To ensure this simply run <code>pip3 install --upgrade mkdocs</code> or <code>sudo pip3 install --upgrade mkdocs</code> if you installed pip system wide on a linux/bsd system.</p>
-<h1 id="using-mkdocs">Using mkdocs</h1>
+<h2 id="using-mkdocs">Using mkdocs</h2>
 <p>In order to extend this documentation you have to clone it from its <a href="https://github.com/TeamNewPipe/documentation">git repository</a>. When you cloned it, you will find a <a href="https://github.com/TeamNewPipe/documentation/blob/master/mkdocs.yml">mkdocs.yml</a> file, and a <a href="https://github.com/TeamNewPipe/documentation/tree/master/docs">docs</a> directory inside. The yaml file is the <a href="https://www.mkdocs.org/user-guide/configuration/">config file</a> while in the directory docs the documentation files are stored. <a href="https://www.mkdocs.org/user-guide/writing-your-docs/">here</a> is a guide about how to use mkdocs.</p>
 <h2 id="write-and-deploy">Write and Deploy</h2>
 <p>If you are writing a documentation page, and want a live preview of it you can enter the root directory of this documentation project, and then run <code>mkdocs serve</code> this will start the mkdocs internal webserver on port <code>8000</code>. So all you have to do is type <code>localhost:8000</code> into the addressbar of your browser, and here you go. If you modify a file, and save it, mkdocs will reload the page and show you the new content.</p>
diff --git a/img/termux_files.png b/img/termux_files.png
new file mode 100644
index 0000000000000000000000000000000000000000..3851f6835afab7776b98825960e0b04777d90dc5
GIT binary patch
literal 38973
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
P2slU<w&qNtSHiymije=R

literal 0
HcmV?d00001

diff --git a/index.html b/index.html
index 347b715..74c3ccf 100644
--- a/index.html
+++ b/index.html
@@ -187,5 +187,5 @@ It focuses on making it possible for the creator of a scraper for a streaming se
 
 <!--
 MkDocs version : 1.0.4
-Build Date UTC : 2019-01-12 15:30:55
+Build Date UTC : 2019-01-12 21:17:21
 -->
diff --git a/search/search_index.json b/search/search_index.json
index a85783e..31e1bd4 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"Welcome to the NewPipe Documentation. This site is/should be a beginner friendly tutorial and documentation for people who want to use, or write services for the NewPipe Extractor . It is an addition to our auto generated jdoc documentation . Please be aware that it is also in an early state, so help and feedback is always welcome :D Introduction The NewPipeExtractor is a Java framework for scraping video platform websites in a way that they can be accessed like a normal API. The extractor is the core of the popular YouTube and streaming App NewPipe for android, however it's system independent and also available for other platforms. The beauty behind this framework is it takes care of the extracting process, error handling etc., so you can take care about what is important: Scraping the website. It focuses on making it possible for the creator of a scraper for a streaming service to create the best outcome with the least amount of written code.","title":"Welcome to the NewPipe Documentation."},{"location":"#welcome-to-the-newpipe-documentation","text":"This site is/should be a beginner friendly tutorial and documentation for people who want to use, or write services for the NewPipe Extractor . It is an addition to our auto generated jdoc documentation . Please be aware that it is also in an early state, so help and feedback is always welcome :D","title":"Welcome to the NewPipe Documentation."},{"location":"#introduction","text":"The NewPipeExtractor is a Java framework for scraping video platform websites in a way that they can be accessed like a normal API. The extractor is the core of the popular YouTube and streaming App NewPipe for android, however it's system independent and also available for other platforms. The beauty behind this framework is it takes care of the extracting process, error handling etc., so you can take care about what is important: Scraping the website. It focuses on making it possible for the creator of a scraper for a streaming service to create the best outcome with the least amount of written code.","title":"Introduction"},{"location":"00_Prepare_everything/","text":"Prepare everything Welcome to the NewPipeExtractor documentation. This tutorial will guide you through the process of creating your own Extractor service with which NewPipe will gain support for a dedicated streaming service like YouTube, Vimeo or SoundCloud. The whole documentation consists of this page, which explains the general concept of the NewPipeExtractor, as well as our Jdoc setup. IMPORTANT!!! this is likely to be the worst documentation you have ever read, so do not hesitate to report if you find any spelling errors, incomplete parts or you simply don't understand something. We are an open community and are open for everyone to help :) Setup your dev environment First and foremost you need to meet certain conditions in order to write your own service. What you need to know Basic understanding of git Good Java knowledge Good understanding of web technology Basic understanding of unit testing and JUnit Flawless understanding of how to contribute to the NewPipe project What you need to have A dev environment/ide that supports: git java 8 gradle unit testing I highly recommend IDEA Community since it has everything we need. A Github account A lot of patience and excitement ;D After making sure all these conditions are provided fork the NewPipeExtractor , using the fork button . This way you have your own working repository. Now clone this repository into your local folder in which you want to work in. Next import the cloned project into your IDE and run it. If all the checks are green you did everything right, and you are good to go to move on to the next chapter. Running test in Android Studio Go to run > edit configurations > add new configuration and select \"Gradle\". As Gradle Project, select NewPipeExtractor. As task add \"test\". Now save and you should be able to run. Inclusion criteria for services After creating you own service you will need to submit it to our NewPipeExtractor repository. However in order to include your changes you need to follow these rules: Stick to our Code contribution guidelines Do not send services that present content we don't allow on NewPipe. You need to be willing to keep on maintaining your service after submission. Be patient and do the requested changes when one of our maintainers rejects your code. Allowed Content Basically anything except NOT allowed content . Any kind of porn/NSFW that is allowed according to the US Porn act . Advertisement (may be handled specially though) NOT allowed Content NSFL (Not Safe For Life) Porn that is not allowed according to US Porn act . Any form of violence Child pornography Media that harms others Media that violates human rights Copyright infringement/pirated media","title":"Prepare everything"},{"location":"00_Prepare_everything/#prepare-everything","text":"Welcome to the NewPipeExtractor documentation. This tutorial will guide you through the process of creating your own Extractor service with which NewPipe will gain support for a dedicated streaming service like YouTube, Vimeo or SoundCloud. The whole documentation consists of this page, which explains the general concept of the NewPipeExtractor, as well as our Jdoc setup. IMPORTANT!!! this is likely to be the worst documentation you have ever read, so do not hesitate to report if you find any spelling errors, incomplete parts or you simply don't understand something. We are an open community and are open for everyone to help :)","title":"Prepare everything"},{"location":"00_Prepare_everything/#setup-your-dev-environment","text":"First and foremost you need to meet certain conditions in order to write your own service.","title":"Setup your dev environment"},{"location":"00_Prepare_everything/#what-you-need-to-know","text":"Basic understanding of git Good Java knowledge Good understanding of web technology Basic understanding of unit testing and JUnit Flawless understanding of how to contribute to the NewPipe project","title":"What you need to know"},{"location":"00_Prepare_everything/#what-you-need-to-have","text":"A dev environment/ide that supports: git java 8 gradle unit testing I highly recommend IDEA Community since it has everything we need. A Github account A lot of patience and excitement ;D After making sure all these conditions are provided fork the NewPipeExtractor , using the fork button . This way you have your own working repository. Now clone this repository into your local folder in which you want to work in. Next import the cloned project into your IDE and run it. If all the checks are green you did everything right, and you are good to go to move on to the next chapter.","title":"What you need to have"},{"location":"00_Prepare_everything/#running-test-in-android-studio","text":"Go to run > edit configurations > add new configuration and select \"Gradle\". As Gradle Project, select NewPipeExtractor. As task add \"test\". Now save and you should be able to run.","title":"Running test in Android Studio"},{"location":"00_Prepare_everything/#inclusion-criteria-for-services","text":"After creating you own service you will need to submit it to our NewPipeExtractor repository. However in order to include your changes you need to follow these rules: Stick to our Code contribution guidelines Do not send services that present content we don't allow on NewPipe. You need to be willing to keep on maintaining your service after submission. Be patient and do the requested changes when one of our maintainers rejects your code.","title":"Inclusion criteria for services"},{"location":"00_Prepare_everything/#allowed-content","text":"Basically anything except NOT allowed content . Any kind of porn/NSFW that is allowed according to the US Porn act . Advertisement (may be handled specially though)","title":"Allowed Content"},{"location":"00_Prepare_everything/#not-allowed-content","text":"NSFL (Not Safe For Life) Porn that is not allowed according to US Porn act . Any form of violence Child pornography Media that harms others Media that violates human rights Copyright infringement/pirated media","title":"NOT allowed Content"},{"location":"01_Concept_of_the_extractor/","text":"Concept of the Extractor Collector/Extractor pattern Before we can start coding our own service we need to understand the basic concept of the extractor. There is a pattern you will find all over the code. It is called the extractor/collector pattern. The idea behind it is that the extractor would produce single pieces of data, and the collector would collect it to form usable data for the front end. The collector also controls the parsing process, and takes care of error handling. So if the extractor fails at any point, the collector will decide whether or not it should continue parsing. This requires the extractor to be made out of many small methods. One method for every data field the collector wants to have. The collectors are provided by NewPipe. You need to take care of the extractors. Usage in the front end So typical call for retrieving data from a website would look like this: Info info; try { // Create a new Extractor with a given context provided as parameter. Extractor extractor = new Extractor(some_meta_info); // Retrieves the data form extractor and builds info package. info = Info.getInfo(extractor); } catch(Exception e) { // handle errors when collector decided to break up extraction } Typical implementation of a single data extractor The typical implementation of a single data extractor on the other hand would look like this: class MyExtractor extends FutureExtractor { public MyExtractor(RequiredInfo requiredInfo, ForExtraction forExtraction) { super(requiredInfo, forExtraction); ... } @Override public void fetch() { // Actually fetch the page data here } @Override public String someDataFiled() throws ExtractionException { //The exception needs to be thrown if someting failed // get piece of information and return it } ... // More datafields } Collector/Extractor pattern for lists Sometimes information can be represented as a list. In NewPipe a list is represented by a InfoItemsCollector . A InfoItemCollector will collect and assemble a list of InfoItem . For each item that should be extracted a new Extractor must be created, and given to the InfoItemCollector via commit() . If you are implementing a list for your service you need to extend InfoItem containing the extracted information, and implement an InfoItemExtractor that will return the data of one InfoItem. A common Implementation would look like this: private MyInfoItemCollector collectInfoItemsFromElement(Element e) { MyInfoItemCollector collector = new MyInfoItemCollector(getServiceId()); for(final Element li : element.children()) { collector.commit(new InfoItemExtractor() { @Override public String getName() throws ParsingException { ... } @Override public String getUrl() throws ParsingException { ... } ... } return collector; } InfoItems encapsulated in pages When a streaming site shows a list of items it usually offers some additional information about that list, like it's title, a thumbnail, or its creator. Such info can be called list header . When a website shows a long list of items it usually does not load the whole list, but only a part of it. In order to get more items you may have to click on a next page button, or scroll down. This is why a list in NewPipe lists are chopped down into smaller lists called InfoItemsPage s. Each page has its own URL, and needs to be extracted separately. Additional metainformation about the list such as its title a thumbnail or its creator, and extracting multiple pages can be handled by a ListExtractor , and it's ListExtractor.InfoItemsPage . For extracting list header information it behaves like a regular extractor. For handling InfoItemsPages it adds methods such as: getInitialPage() which will return the first page of InfoItems. getNextPageUrl() If a second Page of InfoItems is available this will return the URL pointing to them. getPage() returns a ListExtractor.InfoItemsPage by its URL which was retrieved by the getNextPageUrl() method of the previous page. The reason why the first page is handled special is because many Websites such as YouTube will load the first page of items like a regular webpage, but all the others as an AJAX request.","title":"Concept of the Extractor"},{"location":"01_Concept_of_the_extractor/#concept-of-the-extractor","text":"","title":"Concept of the Extractor"},{"location":"01_Concept_of_the_extractor/#collectorextractor-pattern","text":"Before we can start coding our own service we need to understand the basic concept of the extractor. There is a pattern you will find all over the code. It is called the extractor/collector pattern. The idea behind it is that the extractor would produce single pieces of data, and the collector would collect it to form usable data for the front end. The collector also controls the parsing process, and takes care of error handling. So if the extractor fails at any point, the collector will decide whether or not it should continue parsing. This requires the extractor to be made out of many small methods. One method for every data field the collector wants to have. The collectors are provided by NewPipe. You need to take care of the extractors.","title":"Collector/Extractor pattern"},{"location":"01_Concept_of_the_extractor/#usage-in-the-front-end","text":"So typical call for retrieving data from a website would look like this: Info info; try { // Create a new Extractor with a given context provided as parameter. Extractor extractor = new Extractor(some_meta_info); // Retrieves the data form extractor and builds info package. info = Info.getInfo(extractor); } catch(Exception e) { // handle errors when collector decided to break up extraction }","title":"Usage in the front end"},{"location":"01_Concept_of_the_extractor/#typical-implementation-of-a-single-data-extractor","text":"The typical implementation of a single data extractor on the other hand would look like this: class MyExtractor extends FutureExtractor { public MyExtractor(RequiredInfo requiredInfo, ForExtraction forExtraction) { super(requiredInfo, forExtraction); ... } @Override public void fetch() { // Actually fetch the page data here } @Override public String someDataFiled() throws ExtractionException { //The exception needs to be thrown if someting failed // get piece of information and return it } ... // More datafields }","title":"Typical implementation of a single data extractor"},{"location":"01_Concept_of_the_extractor/#collectorextractor-pattern-for-lists","text":"Sometimes information can be represented as a list. In NewPipe a list is represented by a InfoItemsCollector . A InfoItemCollector will collect and assemble a list of InfoItem . For each item that should be extracted a new Extractor must be created, and given to the InfoItemCollector via commit() . If you are implementing a list for your service you need to extend InfoItem containing the extracted information, and implement an InfoItemExtractor that will return the data of one InfoItem. A common Implementation would look like this: private MyInfoItemCollector collectInfoItemsFromElement(Element e) { MyInfoItemCollector collector = new MyInfoItemCollector(getServiceId()); for(final Element li : element.children()) { collector.commit(new InfoItemExtractor() { @Override public String getName() throws ParsingException { ... } @Override public String getUrl() throws ParsingException { ... } ... } return collector; }","title":"Collector/Extractor pattern for lists"},{"location":"01_Concept_of_the_extractor/#infoitems-encapsulated-in-pages","text":"When a streaming site shows a list of items it usually offers some additional information about that list, like it's title, a thumbnail, or its creator. Such info can be called list header . When a website shows a long list of items it usually does not load the whole list, but only a part of it. In order to get more items you may have to click on a next page button, or scroll down. This is why a list in NewPipe lists are chopped down into smaller lists called InfoItemsPage s. Each page has its own URL, and needs to be extracted separately. Additional metainformation about the list such as its title a thumbnail or its creator, and extracting multiple pages can be handled by a ListExtractor , and it's ListExtractor.InfoItemsPage . For extracting list header information it behaves like a regular extractor. For handling InfoItemsPages it adds methods such as: getInitialPage() which will return the first page of InfoItems. getNextPageUrl() If a second Page of InfoItems is available this will return the URL pointing to them. getPage() returns a ListExtractor.InfoItemsPage by its URL which was retrieved by the getNextPageUrl() method of the previous page. The reason why the first page is handled special is because many Websites such as YouTube will load the first page of items like a regular webpage, but all the others as an AJAX request.","title":"InfoItems encapsulated in pages"},{"location":"02_Concept_of_LinkHandler/","text":"Concept of LinkHandler LinkHandler represent Links to resources like videos, search requests, channels, etc. The idea behind them is that a video can have multiple links pointing to it, but it has one unique ID that represents it, like this example: oHg5SJYRHA0 can be represented as: https://www.youtube.com/watch?v=oHg5SJYRHA0 (default URL for YouTube) https://youtu.be/oHg5SJYRHA0 https://m.youtube.com/watch?v=oHg5SJYRHA0 Importand notes about LinkHandler: A simple LinkHandler will contain the default URL, the ID and the original URL. LinkHandler s are ReadOnly LinkHandler s are also used to determine which part of the extractor can handle a certain link. In order to get one you must either call fromUrl() or fromId() of the the corresponding LinkHandlerFactory . Every type of Type of Resource has its own LinkHandlerFactory . Eg. YoutubeStreamLinkHandler, YoutubeChannelLinkHandler, etc. Usage So the typical usage for getting a LinkHandler would look like this. LinkHandlerFactory myLinkHandlerFactory = new MyStreamLinkHandlerFactory(); LinkHandler myVideo = myLinkHandlerFactory.fromUrl(\"https://my.service.com/the_video\"); Implementation In order to Use LinkHandler for your service you must override the appropriate LinkHandlerFactory. eg: class MyStreamLinkHandlerFactory extends LinkHandlerFactory { @Override public String getId(String url) throws ParsingException { // Return the ID based on the URL. } @Override public String getUrl(String id) throws ParsingException { // Return the URL based on the ID given. } @Override public boolean onAcceptUrl(String url) throws ParsingException { // Return true if this LinkHanlderFactory can handle this type of link } } ListLinkHandler and SearchQueryHandler List based resources like channels and playlists can be sorted, and filtered. Therefore these type of resources don't just use a LinkHandler, but a class called ListLinkHandler which inherits from LinkHandler and adds the fields ContentFilter which is used to filter by resource type like stream or playlist, and SortFilter which is used to sort by name, date or view count. ListLinkHandler are also created by overriding the ListLinkHandlerFactory additionally to the abstract methods this factory inherits from the LinkHandlerFactory you can override getAvailableContentFilter() and getAvailableSortFilter() . Through these you can tell the front end which kind of filter your service supports. SearchQueryHandler You cannot point to a search request with an ID like you point to a playlist or a channel, simply because one and the same search request might have a different outcome depending on the country or the time you send the request. This is why the idea of an \"ID\" is replaced by a \"SearchString\" in the SearchQueryHandler These work like regular ListLinkHandler, except that you don't have to implement the methods onAcceptUrl() and getId() when overriding SearchQueryHandlerFactory .","title":"Concept of LinkHandler"},{"location":"02_Concept_of_LinkHandler/#concept-of-linkhandler","text":"LinkHandler represent Links to resources like videos, search requests, channels, etc. The idea behind them is that a video can have multiple links pointing to it, but it has one unique ID that represents it, like this example: oHg5SJYRHA0 can be represented as: https://www.youtube.com/watch?v=oHg5SJYRHA0 (default URL for YouTube) https://youtu.be/oHg5SJYRHA0 https://m.youtube.com/watch?v=oHg5SJYRHA0","title":"Concept of LinkHandler"},{"location":"02_Concept_of_LinkHandler/#importand-notes-about-linkhandler","text":"A simple LinkHandler will contain the default URL, the ID and the original URL. LinkHandler s are ReadOnly LinkHandler s are also used to determine which part of the extractor can handle a certain link. In order to get one you must either call fromUrl() or fromId() of the the corresponding LinkHandlerFactory . Every type of Type of Resource has its own LinkHandlerFactory . Eg. YoutubeStreamLinkHandler, YoutubeChannelLinkHandler, etc.","title":"Importand notes about LinkHandler:"},{"location":"02_Concept_of_LinkHandler/#usage","text":"So the typical usage for getting a LinkHandler would look like this. LinkHandlerFactory myLinkHandlerFactory = new MyStreamLinkHandlerFactory(); LinkHandler myVideo = myLinkHandlerFactory.fromUrl(\"https://my.service.com/the_video\");","title":"Usage"},{"location":"02_Concept_of_LinkHandler/#implementation","text":"In order to Use LinkHandler for your service you must override the appropriate LinkHandlerFactory. eg: class MyStreamLinkHandlerFactory extends LinkHandlerFactory { @Override public String getId(String url) throws ParsingException { // Return the ID based on the URL. } @Override public String getUrl(String id) throws ParsingException { // Return the URL based on the ID given. } @Override public boolean onAcceptUrl(String url) throws ParsingException { // Return true if this LinkHanlderFactory can handle this type of link } }","title":"Implementation"},{"location":"02_Concept_of_LinkHandler/#listlinkhandler-and-searchqueryhandler","text":"List based resources like channels and playlists can be sorted, and filtered. Therefore these type of resources don't just use a LinkHandler, but a class called ListLinkHandler which inherits from LinkHandler and adds the fields ContentFilter which is used to filter by resource type like stream or playlist, and SortFilter which is used to sort by name, date or view count. ListLinkHandler are also created by overriding the ListLinkHandlerFactory additionally to the abstract methods this factory inherits from the LinkHandlerFactory you can override getAvailableContentFilter() and getAvailableSortFilter() . Through these you can tell the front end which kind of filter your service supports.","title":"ListLinkHandler and SearchQueryHandler"},{"location":"02_Concept_of_LinkHandler/#searchqueryhandler","text":"You cannot point to a search request with an ID like you point to a playlist or a channel, simply because one and the same search request might have a different outcome depending on the country or the time you send the request. This is why the idea of an \"ID\" is replaced by a \"SearchString\" in the SearchQueryHandler These work like regular ListLinkHandler, except that you don't have to implement the methods onAcceptUrl() and getId() when overriding SearchQueryHandlerFactory .","title":"SearchQueryHandler"},{"location":"03_Implement_a_service/","text":"Implement a service Services or better service connectors are the parts of NewPipe which communicate with an actual service like YouTube. This Page will describe how you can implement and add your own to the extractor. Please make sure you read and understand the Concept of Extractors and the Concept of LinkHandler before doing this. Required and optional parts Your service does not have to implement everything. Some parts are optional. This is because not all services support every feature other services support. For example, it might be that a certain service does not support channels. If so, you can leave out the implementation of channels, and make the corresponding factory method of the your StreamingService implementation return null . The frontend will handle the lack of having channels then. However if you start to implement one of the optional parts of the list below, you have to implement all parts/classes of it. NewPipe will crash if you only implement the extractor for the list item of a channel, but not the channel extractor itself. The parts of a service: Head of Service Stream Search Playlist (optional) Channel (optional) Kiosk (optional) Allowed Libraries The NewPipe Extractor already comes along with a lot of usable tools and external libraries that should make extracting easy. For some specific (tiny) tasks regex is allowed. Here you can take a look at the Parser , which will give you a little help with that. Use Regex with care!!! Avoid it as often as possible. It's better to ask us to introduce a new library than start using regex to often. Html/XML Parsing: jsoup JSON Parsing: nanojson JavaScript Parsing/Execution: Mozilla Rhino Link detection in strings: AutoLink If you need to introduce new libraries please tell us before you do it. Head of Service First of all if you want to create a new service you should create a new package below org.schabi.newpipe.services , with the name of your service as package name. Parts required to be implemented: StreamingService ServiceInfo StreamingService is a factory class that will return objects of all important parts of your service. Every extractor, handler, and info type you add, and which should be part of your implementation, must be instantiated using an instance of this class. You can see it as a factory for all objects of your implementation. ServiceInfo will return some meta information about your service. Such as the name, the capabilities, and your name as well as your email address for further notice and maintenance issues. Remember, after extending this class you need to return an instance of it by through your implementation of StreamingService.getServiceInfo() . When these two classes are extended by you, you need to add your StreamingService to the ServiceList of NewPipe. This way your service will become an official part of the NewPipe Extractor. Every service has an ID, which will be set when this list gets created. You need to set this ID by entering it in the constructor. So when adding your service just give it the ID of the previously last service in the list incremented by one. Stream Streams are considered single entities of video or audio. They come along with metainformation like a title, a description, next/related videos, a thumbnail and comments. For getting the URL to the actual stream data as well as this metainformation StreamExtractor is used. The LinkHandlerFactory will represent a link to such a stream. StreamInfoItemExtractor will extract one item in a list of items representing such Streams, like a search result or a playlist. Since every Streaming service (obviously) provides streams this is required to implement. Otherwise your service was pretty useless :) Parts required to be implemented: StreamExtractor StreamInfoItemExtractor LinkHandlerFactory Search The SearchExtractor is also required to be implemented. It will take a search query represented as SearchQueryHandler and return a list of search results. Since many services support a suggestion popup while you type you will also want to implement a SuggestionExtractor . This will make it possible for the frontend to as well display a suggestion while typing. Parts required to be implemented: SearchExtractor SearchQueryHandlerFactory SuggestionExtractor (optional) Playlist Playlists are lists of streams provided by the service (you may not have to take care about locally saved playlists. This will be handled by the frontend). A playlist may only contains StreamInfoItems , but no other InfoItem types. Parts required to be implemented: PlaylistExtractor PlayListInfoItemExtractor ListLinkHandlerFactory Channel A Channel is mostly a Playlist , the only difference is that it does not represent a simple list of streams, but a user, a channel, or any entity that could be represented as a user. This is why the metadata supported by the channel extractor differs form the one of a playlist. Parts required to be implemented: ChannelExtractor ChannelInfoItemExtractor ListLinkHandlerFactory Kiosk A kiosk is a list of InfoItems which will be displayed on the main page of NewPipe. A kiosk is mostly similar to the content displayed on the main page of a video platform. A kiosk could be something like \"Top 20\", \"Charts\", \"News\", \"Creators selection\" etc. Kiosk are controversial, many people may not like them. If you don't like them as well please don't refuse to add them thought. Your service would look pretty empty if you select it and no video is being displayed. Also you should not override the preference of the user, since users of NewPipe can decide by the settings weather they want to see the kiosk page or not. Multiple Kiosks Most services will implement more than one Kiosk, so a service might have a \"Top 20\" for different categories like \"Country Music\", \"Techno\", etc. This is why the extractor will let you implement multiple KioskExtractors . Since different kiosk pages might also differ with their HTML structure every page you want to support has to be implemented as its own KioskExtractor . However if the pages are similar you can use the same Implementation, but set the page type when you instantiate your KioskExtractor through the KioskList.KioskExtractorFactory . Every Kiosk you implement needs to be added to your KioskList which you return with your StreamingService implementation. It is also important to set the default kiosk. This will be the kiosk that will be shown by the first start of your service. An example implementation of the getKioskList() could look like this: @Override public KioskList getKioskList() throws ExtractionException { KioskList list = new KioskList(getServiceId()); list.addKioskEntry(new KioskList.KioskExtractorFactory() { @Override public KioskExtractor createNewKiosk(StreamingService streamingService, String url, String id, Localization local) throws ExtractionException { return new YoutubeTrendingExtractor(YoutubeService.this, new YoutubeTrendingLinkHandlerFactory().fromUrl(url), id, local); } }, new YoutubeTrendingLinkHandlerFactory(), \"Trending\"); list.setDefaultKiosk(\"Trending\"); return list; } Parts required to be implemented: KioskList.KioskExtractorFactory KioskExtractor ListLinkHandlerFactory","title":"Implement a service"},{"location":"03_Implement_a_service/#implement-a-service","text":"Services or better service connectors are the parts of NewPipe which communicate with an actual service like YouTube. This Page will describe how you can implement and add your own to the extractor. Please make sure you read and understand the Concept of Extractors and the Concept of LinkHandler before doing this.","title":"Implement a service"},{"location":"03_Implement_a_service/#required-and-optional-parts","text":"Your service does not have to implement everything. Some parts are optional. This is because not all services support every feature other services support. For example, it might be that a certain service does not support channels. If so, you can leave out the implementation of channels, and make the corresponding factory method of the your StreamingService implementation return null . The frontend will handle the lack of having channels then. However if you start to implement one of the optional parts of the list below, you have to implement all parts/classes of it. NewPipe will crash if you only implement the extractor for the list item of a channel, but not the channel extractor itself. The parts of a service: Head of Service Stream Search Playlist (optional) Channel (optional) Kiosk (optional)","title":"Required and optional parts"},{"location":"03_Implement_a_service/#allowed-libraries","text":"The NewPipe Extractor already comes along with a lot of usable tools and external libraries that should make extracting easy. For some specific (tiny) tasks regex is allowed. Here you can take a look at the Parser , which will give you a little help with that. Use Regex with care!!! Avoid it as often as possible. It's better to ask us to introduce a new library than start using regex to often. Html/XML Parsing: jsoup JSON Parsing: nanojson JavaScript Parsing/Execution: Mozilla Rhino Link detection in strings: AutoLink If you need to introduce new libraries please tell us before you do it.","title":"Allowed Libraries"},{"location":"03_Implement_a_service/#head-of-service","text":"First of all if you want to create a new service you should create a new package below org.schabi.newpipe.services , with the name of your service as package name. Parts required to be implemented: StreamingService ServiceInfo StreamingService is a factory class that will return objects of all important parts of your service. Every extractor, handler, and info type you add, and which should be part of your implementation, must be instantiated using an instance of this class. You can see it as a factory for all objects of your implementation. ServiceInfo will return some meta information about your service. Such as the name, the capabilities, and your name as well as your email address for further notice and maintenance issues. Remember, after extending this class you need to return an instance of it by through your implementation of StreamingService.getServiceInfo() . When these two classes are extended by you, you need to add your StreamingService to the ServiceList of NewPipe. This way your service will become an official part of the NewPipe Extractor. Every service has an ID, which will be set when this list gets created. You need to set this ID by entering it in the constructor. So when adding your service just give it the ID of the previously last service in the list incremented by one.","title":"Head of Service"},{"location":"03_Implement_a_service/#stream","text":"Streams are considered single entities of video or audio. They come along with metainformation like a title, a description, next/related videos, a thumbnail and comments. For getting the URL to the actual stream data as well as this metainformation StreamExtractor is used. The LinkHandlerFactory will represent a link to such a stream. StreamInfoItemExtractor will extract one item in a list of items representing such Streams, like a search result or a playlist. Since every Streaming service (obviously) provides streams this is required to implement. Otherwise your service was pretty useless :) Parts required to be implemented: StreamExtractor StreamInfoItemExtractor LinkHandlerFactory","title":"Stream"},{"location":"03_Implement_a_service/#search","text":"The SearchExtractor is also required to be implemented. It will take a search query represented as SearchQueryHandler and return a list of search results. Since many services support a suggestion popup while you type you will also want to implement a SuggestionExtractor . This will make it possible for the frontend to as well display a suggestion while typing. Parts required to be implemented: SearchExtractor SearchQueryHandlerFactory SuggestionExtractor (optional)","title":"Search"},{"location":"03_Implement_a_service/#playlist","text":"Playlists are lists of streams provided by the service (you may not have to take care about locally saved playlists. This will be handled by the frontend). A playlist may only contains StreamInfoItems , but no other InfoItem types. Parts required to be implemented: PlaylistExtractor PlayListInfoItemExtractor ListLinkHandlerFactory","title":"Playlist"},{"location":"03_Implement_a_service/#channel","text":"A Channel is mostly a Playlist , the only difference is that it does not represent a simple list of streams, but a user, a channel, or any entity that could be represented as a user. This is why the metadata supported by the channel extractor differs form the one of a playlist. Parts required to be implemented: ChannelExtractor ChannelInfoItemExtractor ListLinkHandlerFactory","title":"Channel"},{"location":"03_Implement_a_service/#kiosk","text":"A kiosk is a list of InfoItems which will be displayed on the main page of NewPipe. A kiosk is mostly similar to the content displayed on the main page of a video platform. A kiosk could be something like \"Top 20\", \"Charts\", \"News\", \"Creators selection\" etc. Kiosk are controversial, many people may not like them. If you don't like them as well please don't refuse to add them thought. Your service would look pretty empty if you select it and no video is being displayed. Also you should not override the preference of the user, since users of NewPipe can decide by the settings weather they want to see the kiosk page or not.","title":"Kiosk"},{"location":"03_Implement_a_service/#multiple-kiosks","text":"Most services will implement more than one Kiosk, so a service might have a \"Top 20\" for different categories like \"Country Music\", \"Techno\", etc. This is why the extractor will let you implement multiple KioskExtractors . Since different kiosk pages might also differ with their HTML structure every page you want to support has to be implemented as its own KioskExtractor . However if the pages are similar you can use the same Implementation, but set the page type when you instantiate your KioskExtractor through the KioskList.KioskExtractorFactory . Every Kiosk you implement needs to be added to your KioskList which you return with your StreamingService implementation. It is also important to set the default kiosk. This will be the kiosk that will be shown by the first start of your service. An example implementation of the getKioskList() could look like this: @Override public KioskList getKioskList() throws ExtractionException { KioskList list = new KioskList(getServiceId()); list.addKioskEntry(new KioskList.KioskExtractorFactory() { @Override public KioskExtractor createNewKiosk(StreamingService streamingService, String url, String id, Localization local) throws ExtractionException { return new YoutubeTrendingExtractor(YoutubeService.this, new YoutubeTrendingLinkHandlerFactory().fromUrl(url), id, local); } }, new YoutubeTrendingLinkHandlerFactory(), \"Trending\"); list.setDefaultKiosk(\"Trending\"); return list; } Parts required to be implemented: KioskList.KioskExtractorFactory KioskExtractor ListLinkHandlerFactory","title":"Multiple Kiosks"},{"location":"04_Run_changes_in_App/","text":"Run the changes in the App You should develop and test your changes with the JUnit environment that is provided by the NewPipe Extractor and IDEA. If you want to try it then with the actual fronted you need to follow these steps. Setup Android Studio First of all you want to setup a working Android Studio environment. For this please download Studio from developer.android.com , and follow the instructions about how to set it up. Get the NewPipe code and run it. In order to get it you must simply clone or download from the current dev branch github.com/TeamNewPipe/NewPipe.git . You can then build and run it following these instructions . Please also make sure you are comfortable with adb since you might experience some trouble running your compiled app on a real device, especially under linux where you sometimes have to adjust the udev rules in order to make your device be accessible . Run your changes on the Extractor In order to use the extractor in our app we use jitpack . This is a build service that can build maven *.jar packages for android and java based on a github or gitlab repositories. To the extractor through jitpack, you need to push them to your online repository of your copy that you host either on github or gitlab . It's important to host it on one of both. Now copy your repository url in Http format, go to jitpack , and past it there. From here you can grab the latest commit via GET IT button. I recomend not to use SNAPSHOT, since I am not sure when snapshot is build. An \"implementation\" string will be generated for you. Copy this string and replace the implementation 'com.github.TeamNewPipe:NewPipeExtractor:<commit>' line in the file /app/build.gradle with it. Your browser does not support the video tag. If everything synced well then you should only see a screen with OK signs. Now you can go on an compile and run NewPipe with the new extractor. Troubleshooting If something went wrong on jitpack site, you can check their build log, by selecting the commit you tried to build and click on that little paper symbol next to the GET IT button. If it is red it already shows that the build failed.","title":"Run the changes in the App"},{"location":"04_Run_changes_in_App/#run-the-changes-in-the-app","text":"You should develop and test your changes with the JUnit environment that is provided by the NewPipe Extractor and IDEA. If you want to try it then with the actual fronted you need to follow these steps.","title":"Run the changes in the App"},{"location":"04_Run_changes_in_App/#setup-android-studio","text":"First of all you want to setup a working Android Studio environment. For this please download Studio from developer.android.com , and follow the instructions about how to set it up.","title":"Setup Android Studio"},{"location":"04_Run_changes_in_App/#get-the-newpipe-code-and-run-it","text":"In order to get it you must simply clone or download from the current dev branch github.com/TeamNewPipe/NewPipe.git . You can then build and run it following these instructions . Please also make sure you are comfortable with adb since you might experience some trouble running your compiled app on a real device, especially under linux where you sometimes have to adjust the udev rules in order to make your device be accessible .","title":"Get the NewPipe code and run it."},{"location":"04_Run_changes_in_App/#run-your-changes-on-the-extractor","text":"In order to use the extractor in our app we use jitpack . This is a build service that can build maven *.jar packages for android and java based on a github or gitlab repositories. To the extractor through jitpack, you need to push them to your online repository of your copy that you host either on github or gitlab . It's important to host it on one of both. Now copy your repository url in Http format, go to jitpack , and past it there. From here you can grab the latest commit via GET IT button. I recomend not to use SNAPSHOT, since I am not sure when snapshot is build. An \"implementation\" string will be generated for you. Copy this string and replace the implementation 'com.github.TeamNewPipe:NewPipeExtractor:<commit>' line in the file /app/build.gradle with it. Your browser does not support the video tag. If everything synced well then you should only see a screen with OK signs. Now you can go on an compile and run NewPipe with the new extractor.","title":"Run your changes on the Extractor"},{"location":"04_Run_changes_in_App/#troubleshooting","text":"If something went wrong on jitpack site, you can check their build log, by selecting the commit you tried to build and click on that little paper symbol next to the GET IT button. If it is red it already shows that the build failed.","title":"Troubleshooting"},{"location":"05_documentation/","text":"Documentation The Documentation you are currently reading is written using mkdocs . It is a tool that will generate a static website based on files writting in markdown . Markdown has the advantage that it is simple to read and write, and that there are several tools that can translate a markdown file into languages like html or latex. Installation Mkdos is written in python and is distributed through the python internal package manager pip , thus you need to get python and pip running on your operating system first. Windows Download the latest Python3 . When running the setup program make sure to check Add Python 3.x to PATH . Install python Open powershell or cmd, and type: pip3 install mkdocs . MacOS MacOS already comes along with python, however pip is still missing. The easyest, and most nondistructive way is to install the MacOS package manager homebrew first. The advantage of homebrew are that it will only modify your home directory, but not the root dir. So your OS will not be touched by this. Install homebrew Install Python from homebrew, which will also install pip. Run this command: brew install python . Install mkdocs: pip3 install mkdocs Linux/*BSD Also Linux/*BSD comes pre installed with python. Most distributions also deliver pip by default. If its not installed you may need to figure out how to install pip3 through the package manager of your system. Install pip3 with these commands according to distributions: Ubuntu/Mint : apt install python3-pip Fedora/CentOS : sudo dnf install python3-pip Arch/Manjaro : sudo pacman -S python-pip openSuse : sudo zypper install python-pip *BSD : You are already advanced enough to know how you can force the bits on your disk to become pip by meditating upon it. Run pip3 install mkdocs to install mkdocs only for the current user, or run sudo pip3 install mkdocs to install mkdocs systemwide. Last one has the higher chance to work properly. Update Sometimes mkdocs changes the way how to serve, or the syntax will differ. This is why you should make sure to always run the latest version of mkdocs. To ensure this simply run pip3 install --upgrade mkdocs or sudo pip3 install --upgrade mkdocs if you installed pip system wide on a linux/bsd system. Using mkdocs In order to extend this documentation you have to clone it from its git repository . When you cloned it, you will find a mkdocs.yml file, and a docs directory inside. The yaml file is the config file while in the directory docs the documentation files are stored. here is a guide about how to use mkdocs. Write and Deploy If you are writing a documentation page, and want a live preview of it you can enter the root directory of this documentation project, and then run mkdocs serve this will start the mkdocs internal webserver on port 8000 . So all you have to do is type localhost:8000 into the addressbar of your browser, and here you go. If you modify a file, and save it, mkdocs will reload the page and show you the new content. If you want to deploy the page, so it will be up to date at the github pages simply type mkdocs gh-deploy . However please be aware that this will not push your changes to the master branch of the repository. So you still have to commit and push your changes to the actual git repository of this documentation. Please be aware that only priviliged maintainers can do this.","title":"Documentation"},{"location":"05_documentation/#documentation","text":"The Documentation you are currently reading is written using mkdocs . It is a tool that will generate a static website based on files writting in markdown . Markdown has the advantage that it is simple to read and write, and that there are several tools that can translate a markdown file into languages like html or latex.","title":"Documentation"},{"location":"05_documentation/#installation","text":"Mkdos is written in python and is distributed through the python internal package manager pip , thus you need to get python and pip running on your operating system first.","title":"Installation"},{"location":"05_documentation/#windows","text":"Download the latest Python3 . When running the setup program make sure to check Add Python 3.x to PATH . Install python Open powershell or cmd, and type: pip3 install mkdocs .","title":"Windows"},{"location":"05_documentation/#macos","text":"MacOS already comes along with python, however pip is still missing. The easyest, and most nondistructive way is to install the MacOS package manager homebrew first. The advantage of homebrew are that it will only modify your home directory, but not the root dir. So your OS will not be touched by this. Install homebrew Install Python from homebrew, which will also install pip. Run this command: brew install python . Install mkdocs: pip3 install mkdocs","title":"MacOS"},{"location":"05_documentation/#linuxbsd","text":"Also Linux/*BSD comes pre installed with python. Most distributions also deliver pip by default. If its not installed you may need to figure out how to install pip3 through the package manager of your system. Install pip3 with these commands according to distributions: Ubuntu/Mint : apt install python3-pip Fedora/CentOS : sudo dnf install python3-pip Arch/Manjaro : sudo pacman -S python-pip openSuse : sudo zypper install python-pip *BSD : You are already advanced enough to know how you can force the bits on your disk to become pip by meditating upon it. Run pip3 install mkdocs to install mkdocs only for the current user, or run sudo pip3 install mkdocs to install mkdocs systemwide. Last one has the higher chance to work properly.","title":"Linux/*BSD"},{"location":"05_documentation/#update","text":"Sometimes mkdocs changes the way how to serve, or the syntax will differ. This is why you should make sure to always run the latest version of mkdocs. To ensure this simply run pip3 install --upgrade mkdocs or sudo pip3 install --upgrade mkdocs if you installed pip system wide on a linux/bsd system.","title":"Update"},{"location":"05_documentation/#using-mkdocs","text":"In order to extend this documentation you have to clone it from its git repository . When you cloned it, you will find a mkdocs.yml file, and a docs directory inside. The yaml file is the config file while in the directory docs the documentation files are stored. here is a guide about how to use mkdocs.","title":"Using mkdocs"},{"location":"05_documentation/#write-and-deploy","text":"If you are writing a documentation page, and want a live preview of it you can enter the root directory of this documentation project, and then run mkdocs serve this will start the mkdocs internal webserver on port 8000 . So all you have to do is type localhost:8000 into the addressbar of your browser, and here you go. If you modify a file, and save it, mkdocs will reload the page and show you the new content. If you want to deploy the page, so it will be up to date at the github pages simply type mkdocs gh-deploy . However please be aware that this will not push your changes to the master branch of the repository. So you still have to commit and push your changes to the actual git repository of this documentation. Please be aware that only priviliged maintainers can do this.","title":"Write and Deploy"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"Welcome to the NewPipe Documentation. This site is/should be a beginner friendly tutorial and documentation for people who want to use, or write services for the NewPipe Extractor . It is an addition to our auto generated jdoc documentation . Please be aware that it is also in an early state, so help and feedback is always welcome :D Introduction The NewPipeExtractor is a Java framework for scraping video platform websites in a way that they can be accessed like a normal API. The extractor is the core of the popular YouTube and streaming App NewPipe for android, however it's system independent and also available for other platforms. The beauty behind this framework is it takes care of the extracting process, error handling etc., so you can take care about what is important: Scraping the website. It focuses on making it possible for the creator of a scraper for a streaming service to create the best outcome with the least amount of written code.","title":"Welcome to the NewPipe Documentation."},{"location":"#welcome-to-the-newpipe-documentation","text":"This site is/should be a beginner friendly tutorial and documentation for people who want to use, or write services for the NewPipe Extractor . It is an addition to our auto generated jdoc documentation . Please be aware that it is also in an early state, so help and feedback is always welcome :D","title":"Welcome to the NewPipe Documentation."},{"location":"#introduction","text":"The NewPipeExtractor is a Java framework for scraping video platform websites in a way that they can be accessed like a normal API. The extractor is the core of the popular YouTube and streaming App NewPipe for android, however it's system independent and also available for other platforms. The beauty behind this framework is it takes care of the extracting process, error handling etc., so you can take care about what is important: Scraping the website. It focuses on making it possible for the creator of a scraper for a streaming service to create the best outcome with the least amount of written code.","title":"Introduction"},{"location":"00_Prepare_everything/","text":"Prepare everything Welcome to the NewPipeExtractor documentation. This tutorial will guide you through the process of creating your own Extractor service with which NewPipe will gain support for a dedicated streaming service like YouTube, Vimeo or SoundCloud. The whole documentation consists of this page, which explains the general concept of the NewPipeExtractor, as well as our Jdoc setup. IMPORTANT!!! this is likely to be the worst documentation you have ever read, so do not hesitate to report if you find any spelling errors, incomplete parts or you simply don't understand something. We are an open community and are open for everyone to help :) Setup your dev environment First and foremost you need to meet certain conditions in order to write your own service. What you need to know Basic understanding of git Good Java knowledge Good understanding of web technology Basic understanding of unit testing and JUnit Flawless understanding of how to contribute to the NewPipe project What you need to have A dev environment/ide that supports: git java 8 gradle unit testing I highly recommend IDEA Community since it has everything we need. A Github account A lot of patience and excitement ;D After making sure all these conditions are provided fork the NewPipeExtractor , using the fork button . This way you have your own working repository. Now clone this repository into your local folder in which you want to work in. Next import the cloned project into your IDE and run it. If all the checks are green you did everything right, and you are good to go to move on to the next chapter. Running test in Android Studio Go to run > edit configurations > add new configuration and select \"Gradle\". As Gradle Project, select NewPipeExtractor. As task add \"test\". Now save and you should be able to run. Inclusion criteria for services After creating you own service you will need to submit it to our NewPipeExtractor repository. However in order to include your changes you need to follow these rules: Stick to our Code contribution guidelines Do not send services that present content we don't allow on NewPipe. You need to be willing to keep on maintaining your service after submission. Be patient and do the requested changes when one of our maintainers rejects your code. Allowed Content Basically anything except NOT allowed content . Any kind of porn/NSFW that is allowed according to the US Porn act . Advertisement (may be handled specially though) NOT allowed Content NSFL (Not Safe For Life) Porn that is not allowed according to US Porn act . Any form of violence Child pornography Media that harms others Media that violates human rights Copyright infringement/pirated media","title":"Prepare everything"},{"location":"00_Prepare_everything/#prepare-everything","text":"Welcome to the NewPipeExtractor documentation. This tutorial will guide you through the process of creating your own Extractor service with which NewPipe will gain support for a dedicated streaming service like YouTube, Vimeo or SoundCloud. The whole documentation consists of this page, which explains the general concept of the NewPipeExtractor, as well as our Jdoc setup. IMPORTANT!!! this is likely to be the worst documentation you have ever read, so do not hesitate to report if you find any spelling errors, incomplete parts or you simply don't understand something. We are an open community and are open for everyone to help :)","title":"Prepare everything"},{"location":"00_Prepare_everything/#setup-your-dev-environment","text":"First and foremost you need to meet certain conditions in order to write your own service.","title":"Setup your dev environment"},{"location":"00_Prepare_everything/#what-you-need-to-know","text":"Basic understanding of git Good Java knowledge Good understanding of web technology Basic understanding of unit testing and JUnit Flawless understanding of how to contribute to the NewPipe project","title":"What you need to know"},{"location":"00_Prepare_everything/#what-you-need-to-have","text":"A dev environment/ide that supports: git java 8 gradle unit testing I highly recommend IDEA Community since it has everything we need. A Github account A lot of patience and excitement ;D After making sure all these conditions are provided fork the NewPipeExtractor , using the fork button . This way you have your own working repository. Now clone this repository into your local folder in which you want to work in. Next import the cloned project into your IDE and run it. If all the checks are green you did everything right, and you are good to go to move on to the next chapter.","title":"What you need to have"},{"location":"00_Prepare_everything/#running-test-in-android-studio","text":"Go to run > edit configurations > add new configuration and select \"Gradle\". As Gradle Project, select NewPipeExtractor. As task add \"test\". Now save and you should be able to run.","title":"Running test in Android Studio"},{"location":"00_Prepare_everything/#inclusion-criteria-for-services","text":"After creating you own service you will need to submit it to our NewPipeExtractor repository. However in order to include your changes you need to follow these rules: Stick to our Code contribution guidelines Do not send services that present content we don't allow on NewPipe. You need to be willing to keep on maintaining your service after submission. Be patient and do the requested changes when one of our maintainers rejects your code.","title":"Inclusion criteria for services"},{"location":"00_Prepare_everything/#allowed-content","text":"Basically anything except NOT allowed content . Any kind of porn/NSFW that is allowed according to the US Porn act . Advertisement (may be handled specially though)","title":"Allowed Content"},{"location":"00_Prepare_everything/#not-allowed-content","text":"NSFL (Not Safe For Life) Porn that is not allowed according to US Porn act . Any form of violence Child pornography Media that harms others Media that violates human rights Copyright infringement/pirated media","title":"NOT allowed Content"},{"location":"01_Concept_of_the_extractor/","text":"Concept of the Extractor Collector/Extractor pattern Before we can start coding our own service we need to understand the basic concept of the extractor. There is a pattern you will find all over the code. It is called the extractor/collector pattern. The idea behind it is that the extractor would produce single pieces of data, and the collector would collect it to form usable data for the front end. The collector also controls the parsing process, and takes care of error handling. So if the extractor fails at any point, the collector will decide whether or not it should continue parsing. This requires the extractor to be made out of many small methods. One method for every data field the collector wants to have. The collectors are provided by NewPipe. You need to take care of the extractors. Usage in the front end So typical call for retrieving data from a website would look like this: Info info; try { // Create a new Extractor with a given context provided as parameter. Extractor extractor = new Extractor(some_meta_info); // Retrieves the data form extractor and builds info package. info = Info.getInfo(extractor); } catch(Exception e) { // handle errors when collector decided to break up extraction } Typical implementation of a single data extractor The typical implementation of a single data extractor on the other hand would look like this: class MyExtractor extends FutureExtractor { public MyExtractor(RequiredInfo requiredInfo, ForExtraction forExtraction) { super(requiredInfo, forExtraction); ... } @Override public void fetch() { // Actually fetch the page data here } @Override public String someDataFiled() throws ExtractionException { //The exception needs to be thrown if someting failed // get piece of information and return it } ... // More datafields } Collector/Extractor pattern for lists Sometimes information can be represented as a list. In NewPipe a list is represented by a InfoItemsCollector . A InfoItemCollector will collect and assemble a list of InfoItem . For each item that should be extracted a new Extractor must be created, and given to the InfoItemCollector via commit() . If you are implementing a list for your service you need to extend InfoItem containing the extracted information, and implement an InfoItemExtractor that will return the data of one InfoItem. A common Implementation would look like this: private MyInfoItemCollector collectInfoItemsFromElement(Element e) { MyInfoItemCollector collector = new MyInfoItemCollector(getServiceId()); for(final Element li : element.children()) { collector.commit(new InfoItemExtractor() { @Override public String getName() throws ParsingException { ... } @Override public String getUrl() throws ParsingException { ... } ... } return collector; } InfoItems encapsulated in pages When a streaming site shows a list of items it usually offers some additional information about that list, like it's title, a thumbnail, or its creator. Such info can be called list header . When a website shows a long list of items it usually does not load the whole list, but only a part of it. In order to get more items you may have to click on a next page button, or scroll down. This is why a list in NewPipe lists are chopped down into smaller lists called InfoItemsPage s. Each page has its own URL, and needs to be extracted separately. Additional metainformation about the list such as its title a thumbnail or its creator, and extracting multiple pages can be handled by a ListExtractor , and it's ListExtractor.InfoItemsPage . For extracting list header information it behaves like a regular extractor. For handling InfoItemsPages it adds methods such as: getInitialPage() which will return the first page of InfoItems. getNextPageUrl() If a second Page of InfoItems is available this will return the URL pointing to them. getPage() returns a ListExtractor.InfoItemsPage by its URL which was retrieved by the getNextPageUrl() method of the previous page. The reason why the first page is handled special is because many Websites such as YouTube will load the first page of items like a regular webpage, but all the others as an AJAX request.","title":"Concept of the Extractor"},{"location":"01_Concept_of_the_extractor/#concept-of-the-extractor","text":"","title":"Concept of the Extractor"},{"location":"01_Concept_of_the_extractor/#collectorextractor-pattern","text":"Before we can start coding our own service we need to understand the basic concept of the extractor. There is a pattern you will find all over the code. It is called the extractor/collector pattern. The idea behind it is that the extractor would produce single pieces of data, and the collector would collect it to form usable data for the front end. The collector also controls the parsing process, and takes care of error handling. So if the extractor fails at any point, the collector will decide whether or not it should continue parsing. This requires the extractor to be made out of many small methods. One method for every data field the collector wants to have. The collectors are provided by NewPipe. You need to take care of the extractors.","title":"Collector/Extractor pattern"},{"location":"01_Concept_of_the_extractor/#usage-in-the-front-end","text":"So typical call for retrieving data from a website would look like this: Info info; try { // Create a new Extractor with a given context provided as parameter. Extractor extractor = new Extractor(some_meta_info); // Retrieves the data form extractor and builds info package. info = Info.getInfo(extractor); } catch(Exception e) { // handle errors when collector decided to break up extraction }","title":"Usage in the front end"},{"location":"01_Concept_of_the_extractor/#typical-implementation-of-a-single-data-extractor","text":"The typical implementation of a single data extractor on the other hand would look like this: class MyExtractor extends FutureExtractor { public MyExtractor(RequiredInfo requiredInfo, ForExtraction forExtraction) { super(requiredInfo, forExtraction); ... } @Override public void fetch() { // Actually fetch the page data here } @Override public String someDataFiled() throws ExtractionException { //The exception needs to be thrown if someting failed // get piece of information and return it } ... // More datafields }","title":"Typical implementation of a single data extractor"},{"location":"01_Concept_of_the_extractor/#collectorextractor-pattern-for-lists","text":"Sometimes information can be represented as a list. In NewPipe a list is represented by a InfoItemsCollector . A InfoItemCollector will collect and assemble a list of InfoItem . For each item that should be extracted a new Extractor must be created, and given to the InfoItemCollector via commit() . If you are implementing a list for your service you need to extend InfoItem containing the extracted information, and implement an InfoItemExtractor that will return the data of one InfoItem. A common Implementation would look like this: private MyInfoItemCollector collectInfoItemsFromElement(Element e) { MyInfoItemCollector collector = new MyInfoItemCollector(getServiceId()); for(final Element li : element.children()) { collector.commit(new InfoItemExtractor() { @Override public String getName() throws ParsingException { ... } @Override public String getUrl() throws ParsingException { ... } ... } return collector; }","title":"Collector/Extractor pattern for lists"},{"location":"01_Concept_of_the_extractor/#infoitems-encapsulated-in-pages","text":"When a streaming site shows a list of items it usually offers some additional information about that list, like it's title, a thumbnail, or its creator. Such info can be called list header . When a website shows a long list of items it usually does not load the whole list, but only a part of it. In order to get more items you may have to click on a next page button, or scroll down. This is why a list in NewPipe lists are chopped down into smaller lists called InfoItemsPage s. Each page has its own URL, and needs to be extracted separately. Additional metainformation about the list such as its title a thumbnail or its creator, and extracting multiple pages can be handled by a ListExtractor , and it's ListExtractor.InfoItemsPage . For extracting list header information it behaves like a regular extractor. For handling InfoItemsPages it adds methods such as: getInitialPage() which will return the first page of InfoItems. getNextPageUrl() If a second Page of InfoItems is available this will return the URL pointing to them. getPage() returns a ListExtractor.InfoItemsPage by its URL which was retrieved by the getNextPageUrl() method of the previous page. The reason why the first page is handled special is because many Websites such as YouTube will load the first page of items like a regular webpage, but all the others as an AJAX request.","title":"InfoItems encapsulated in pages"},{"location":"02_Concept_of_LinkHandler/","text":"Concept of LinkHandler LinkHandler represent Links to resources like videos, search requests, channels, etc. The idea behind them is that a video can have multiple links pointing to it, but it has one unique ID that represents it, like this example: oHg5SJYRHA0 can be represented as: https://www.youtube.com/watch?v=oHg5SJYRHA0 (default URL for YouTube) https://youtu.be/oHg5SJYRHA0 https://m.youtube.com/watch?v=oHg5SJYRHA0 Importand notes about LinkHandler: A simple LinkHandler will contain the default URL, the ID and the original URL. LinkHandler s are ReadOnly LinkHandler s are also used to determine which part of the extractor can handle a certain link. In order to get one you must either call fromUrl() or fromId() of the the corresponding LinkHandlerFactory . Every type of Type of Resource has its own LinkHandlerFactory . Eg. YoutubeStreamLinkHandler, YoutubeChannelLinkHandler, etc. Usage So the typical usage for getting a LinkHandler would look like this. LinkHandlerFactory myLinkHandlerFactory = new MyStreamLinkHandlerFactory(); LinkHandler myVideo = myLinkHandlerFactory.fromUrl(\"https://my.service.com/the_video\"); Implementation In order to Use LinkHandler for your service you must override the appropriate LinkHandlerFactory. eg: class MyStreamLinkHandlerFactory extends LinkHandlerFactory { @Override public String getId(String url) throws ParsingException { // Return the ID based on the URL. } @Override public String getUrl(String id) throws ParsingException { // Return the URL based on the ID given. } @Override public boolean onAcceptUrl(String url) throws ParsingException { // Return true if this LinkHanlderFactory can handle this type of link } } ListLinkHandler and SearchQueryHandler List based resources like channels and playlists can be sorted, and filtered. Therefore these type of resources don't just use a LinkHandler, but a class called ListLinkHandler which inherits from LinkHandler and adds the fields ContentFilter which is used to filter by resource type like stream or playlist, and SortFilter which is used to sort by name, date or view count. ListLinkHandler are also created by overriding the ListLinkHandlerFactory additionally to the abstract methods this factory inherits from the LinkHandlerFactory you can override getAvailableContentFilter() and getAvailableSortFilter() . Through these you can tell the front end which kind of filter your service supports. SearchQueryHandler You cannot point to a search request with an ID like you point to a playlist or a channel, simply because one and the same search request might have a different outcome depending on the country or the time you send the request. This is why the idea of an \"ID\" is replaced by a \"SearchString\" in the SearchQueryHandler These work like regular ListLinkHandler, except that you don't have to implement the methods onAcceptUrl() and getId() when overriding SearchQueryHandlerFactory .","title":"Concept of LinkHandler"},{"location":"02_Concept_of_LinkHandler/#concept-of-linkhandler","text":"LinkHandler represent Links to resources like videos, search requests, channels, etc. The idea behind them is that a video can have multiple links pointing to it, but it has one unique ID that represents it, like this example: oHg5SJYRHA0 can be represented as: https://www.youtube.com/watch?v=oHg5SJYRHA0 (default URL for YouTube) https://youtu.be/oHg5SJYRHA0 https://m.youtube.com/watch?v=oHg5SJYRHA0","title":"Concept of LinkHandler"},{"location":"02_Concept_of_LinkHandler/#importand-notes-about-linkhandler","text":"A simple LinkHandler will contain the default URL, the ID and the original URL. LinkHandler s are ReadOnly LinkHandler s are also used to determine which part of the extractor can handle a certain link. In order to get one you must either call fromUrl() or fromId() of the the corresponding LinkHandlerFactory . Every type of Type of Resource has its own LinkHandlerFactory . Eg. YoutubeStreamLinkHandler, YoutubeChannelLinkHandler, etc.","title":"Importand notes about LinkHandler:"},{"location":"02_Concept_of_LinkHandler/#usage","text":"So the typical usage for getting a LinkHandler would look like this. LinkHandlerFactory myLinkHandlerFactory = new MyStreamLinkHandlerFactory(); LinkHandler myVideo = myLinkHandlerFactory.fromUrl(\"https://my.service.com/the_video\");","title":"Usage"},{"location":"02_Concept_of_LinkHandler/#implementation","text":"In order to Use LinkHandler for your service you must override the appropriate LinkHandlerFactory. eg: class MyStreamLinkHandlerFactory extends LinkHandlerFactory { @Override public String getId(String url) throws ParsingException { // Return the ID based on the URL. } @Override public String getUrl(String id) throws ParsingException { // Return the URL based on the ID given. } @Override public boolean onAcceptUrl(String url) throws ParsingException { // Return true if this LinkHanlderFactory can handle this type of link } }","title":"Implementation"},{"location":"02_Concept_of_LinkHandler/#listlinkhandler-and-searchqueryhandler","text":"List based resources like channels and playlists can be sorted, and filtered. Therefore these type of resources don't just use a LinkHandler, but a class called ListLinkHandler which inherits from LinkHandler and adds the fields ContentFilter which is used to filter by resource type like stream or playlist, and SortFilter which is used to sort by name, date or view count. ListLinkHandler are also created by overriding the ListLinkHandlerFactory additionally to the abstract methods this factory inherits from the LinkHandlerFactory you can override getAvailableContentFilter() and getAvailableSortFilter() . Through these you can tell the front end which kind of filter your service supports.","title":"ListLinkHandler and SearchQueryHandler"},{"location":"02_Concept_of_LinkHandler/#searchqueryhandler","text":"You cannot point to a search request with an ID like you point to a playlist or a channel, simply because one and the same search request might have a different outcome depending on the country or the time you send the request. This is why the idea of an \"ID\" is replaced by a \"SearchString\" in the SearchQueryHandler These work like regular ListLinkHandler, except that you don't have to implement the methods onAcceptUrl() and getId() when overriding SearchQueryHandlerFactory .","title":"SearchQueryHandler"},{"location":"03_Implement_a_service/","text":"Implement a service Services or better service connectors are the parts of NewPipe which communicate with an actual service like YouTube. This Page will describe how you can implement and add your own to the extractor. Please make sure you read and understand the Concept of Extractors and the Concept of LinkHandler before doing this. Required and optional parts Your service does not have to implement everything. Some parts are optional. This is because not all services support every feature other services support. For example, it might be that a certain service does not support channels. If so, you can leave out the implementation of channels, and make the corresponding factory method of the your StreamingService implementation return null . The frontend will handle the lack of having channels then. However if you start to implement one of the optional parts of the list below, you have to implement all parts/classes of it. NewPipe will crash if you only implement the extractor for the list item of a channel, but not the channel extractor itself. The parts of a service: Head of Service Stream Search Playlist (optional) Channel (optional) Kiosk (optional) Allowed Libraries The NewPipe Extractor already comes along with a lot of usable tools and external libraries that should make extracting easy. For some specific (tiny) tasks regex is allowed. Here you can take a look at the Parser , which will give you a little help with that. Use Regex with care!!! Avoid it as often as possible. It's better to ask us to introduce a new library than start using regex to often. Html/XML Parsing: jsoup JSON Parsing: nanojson JavaScript Parsing/Execution: Mozilla Rhino Link detection in strings: AutoLink If you need to introduce new libraries please tell us before you do it. Head of Service First of all if you want to create a new service you should create a new package below org.schabi.newpipe.services , with the name of your service as package name. Parts required to be implemented: StreamingService ServiceInfo StreamingService is a factory class that will return objects of all important parts of your service. Every extractor, handler, and info type you add, and which should be part of your implementation, must be instantiated using an instance of this class. You can see it as a factory for all objects of your implementation. ServiceInfo will return some meta information about your service. Such as the name, the capabilities, and your name as well as your email address for further notice and maintenance issues. Remember, after extending this class you need to return an instance of it by through your implementation of StreamingService.getServiceInfo() . When these two classes are extended by you, you need to add your StreamingService to the ServiceList of NewPipe. This way your service will become an official part of the NewPipe Extractor. Every service has an ID, which will be set when this list gets created. You need to set this ID by entering it in the constructor. So when adding your service just give it the ID of the previously last service in the list incremented by one. Stream Streams are considered single entities of video or audio. They come along with metainformation like a title, a description, next/related videos, a thumbnail and comments. For getting the URL to the actual stream data as well as this metainformation StreamExtractor is used. The LinkHandlerFactory will represent a link to such a stream. StreamInfoItemExtractor will extract one item in a list of items representing such Streams, like a search result or a playlist. Since every Streaming service (obviously) provides streams this is required to implement. Otherwise your service was pretty useless :) Parts required to be implemented: StreamExtractor StreamInfoItemExtractor LinkHandlerFactory Search The SearchExtractor is also required to be implemented. It will take a search query represented as SearchQueryHandler and return a list of search results. Since many services support a suggestion popup while you type you will also want to implement a SuggestionExtractor . This will make it possible for the frontend to as well display a suggestion while typing. Parts required to be implemented: SearchExtractor SearchQueryHandlerFactory SuggestionExtractor (optional) Playlist Playlists are lists of streams provided by the service (you may not have to take care about locally saved playlists. This will be handled by the frontend). A playlist may only contains StreamInfoItems , but no other InfoItem types. Parts required to be implemented: PlaylistExtractor PlayListInfoItemExtractor ListLinkHandlerFactory Channel A Channel is mostly a Playlist , the only difference is that it does not represent a simple list of streams, but a user, a channel, or any entity that could be represented as a user. This is why the metadata supported by the channel extractor differs form the one of a playlist. Parts required to be implemented: ChannelExtractor ChannelInfoItemExtractor ListLinkHandlerFactory Kiosk A kiosk is a list of InfoItems which will be displayed on the main page of NewPipe. A kiosk is mostly similar to the content displayed on the main page of a video platform. A kiosk could be something like \"Top 20\", \"Charts\", \"News\", \"Creators selection\" etc. Kiosk are controversial, many people may not like them. If you don't like them as well please don't refuse to add them thought. Your service would look pretty empty if you select it and no video is being displayed. Also you should not override the preference of the user, since users of NewPipe can decide by the settings weather they want to see the kiosk page or not. Multiple Kiosks Most services will implement more than one Kiosk, so a service might have a \"Top 20\" for different categories like \"Country Music\", \"Techno\", etc. This is why the extractor will let you implement multiple KioskExtractors . Since different kiosk pages might also differ with their HTML structure every page you want to support has to be implemented as its own KioskExtractor . However if the pages are similar you can use the same Implementation, but set the page type when you instantiate your KioskExtractor through the KioskList.KioskExtractorFactory . Every Kiosk you implement needs to be added to your KioskList which you return with your StreamingService implementation. It is also important to set the default kiosk. This will be the kiosk that will be shown by the first start of your service. An example implementation of the getKioskList() could look like this: @Override public KioskList getKioskList() throws ExtractionException { KioskList list = new KioskList(getServiceId()); list.addKioskEntry(new KioskList.KioskExtractorFactory() { @Override public KioskExtractor createNewKiosk(StreamingService streamingService, String url, String id, Localization local) throws ExtractionException { return new YoutubeTrendingExtractor(YoutubeService.this, new YoutubeTrendingLinkHandlerFactory().fromUrl(url), id, local); } }, new YoutubeTrendingLinkHandlerFactory(), \"Trending\"); list.setDefaultKiosk(\"Trending\"); return list; } Parts required to be implemented: KioskList.KioskExtractorFactory KioskExtractor ListLinkHandlerFactory","title":"Implement a service"},{"location":"03_Implement_a_service/#implement-a-service","text":"Services or better service connectors are the parts of NewPipe which communicate with an actual service like YouTube. This Page will describe how you can implement and add your own to the extractor. Please make sure you read and understand the Concept of Extractors and the Concept of LinkHandler before doing this.","title":"Implement a service"},{"location":"03_Implement_a_service/#required-and-optional-parts","text":"Your service does not have to implement everything. Some parts are optional. This is because not all services support every feature other services support. For example, it might be that a certain service does not support channels. If so, you can leave out the implementation of channels, and make the corresponding factory method of the your StreamingService implementation return null . The frontend will handle the lack of having channels then. However if you start to implement one of the optional parts of the list below, you have to implement all parts/classes of it. NewPipe will crash if you only implement the extractor for the list item of a channel, but not the channel extractor itself. The parts of a service: Head of Service Stream Search Playlist (optional) Channel (optional) Kiosk (optional)","title":"Required and optional parts"},{"location":"03_Implement_a_service/#allowed-libraries","text":"The NewPipe Extractor already comes along with a lot of usable tools and external libraries that should make extracting easy. For some specific (tiny) tasks regex is allowed. Here you can take a look at the Parser , which will give you a little help with that. Use Regex with care!!! Avoid it as often as possible. It's better to ask us to introduce a new library than start using regex to often. Html/XML Parsing: jsoup JSON Parsing: nanojson JavaScript Parsing/Execution: Mozilla Rhino Link detection in strings: AutoLink If you need to introduce new libraries please tell us before you do it.","title":"Allowed Libraries"},{"location":"03_Implement_a_service/#head-of-service","text":"First of all if you want to create a new service you should create a new package below org.schabi.newpipe.services , with the name of your service as package name. Parts required to be implemented: StreamingService ServiceInfo StreamingService is a factory class that will return objects of all important parts of your service. Every extractor, handler, and info type you add, and which should be part of your implementation, must be instantiated using an instance of this class. You can see it as a factory for all objects of your implementation. ServiceInfo will return some meta information about your service. Such as the name, the capabilities, and your name as well as your email address for further notice and maintenance issues. Remember, after extending this class you need to return an instance of it by through your implementation of StreamingService.getServiceInfo() . When these two classes are extended by you, you need to add your StreamingService to the ServiceList of NewPipe. This way your service will become an official part of the NewPipe Extractor. Every service has an ID, which will be set when this list gets created. You need to set this ID by entering it in the constructor. So when adding your service just give it the ID of the previously last service in the list incremented by one.","title":"Head of Service"},{"location":"03_Implement_a_service/#stream","text":"Streams are considered single entities of video or audio. They come along with metainformation like a title, a description, next/related videos, a thumbnail and comments. For getting the URL to the actual stream data as well as this metainformation StreamExtractor is used. The LinkHandlerFactory will represent a link to such a stream. StreamInfoItemExtractor will extract one item in a list of items representing such Streams, like a search result or a playlist. Since every Streaming service (obviously) provides streams this is required to implement. Otherwise your service was pretty useless :) Parts required to be implemented: StreamExtractor StreamInfoItemExtractor LinkHandlerFactory","title":"Stream"},{"location":"03_Implement_a_service/#search","text":"The SearchExtractor is also required to be implemented. It will take a search query represented as SearchQueryHandler and return a list of search results. Since many services support a suggestion popup while you type you will also want to implement a SuggestionExtractor . This will make it possible for the frontend to as well display a suggestion while typing. Parts required to be implemented: SearchExtractor SearchQueryHandlerFactory SuggestionExtractor (optional)","title":"Search"},{"location":"03_Implement_a_service/#playlist","text":"Playlists are lists of streams provided by the service (you may not have to take care about locally saved playlists. This will be handled by the frontend). A playlist may only contains StreamInfoItems , but no other InfoItem types. Parts required to be implemented: PlaylistExtractor PlayListInfoItemExtractor ListLinkHandlerFactory","title":"Playlist"},{"location":"03_Implement_a_service/#channel","text":"A Channel is mostly a Playlist , the only difference is that it does not represent a simple list of streams, but a user, a channel, or any entity that could be represented as a user. This is why the metadata supported by the channel extractor differs form the one of a playlist. Parts required to be implemented: ChannelExtractor ChannelInfoItemExtractor ListLinkHandlerFactory","title":"Channel"},{"location":"03_Implement_a_service/#kiosk","text":"A kiosk is a list of InfoItems which will be displayed on the main page of NewPipe. A kiosk is mostly similar to the content displayed on the main page of a video platform. A kiosk could be something like \"Top 20\", \"Charts\", \"News\", \"Creators selection\" etc. Kiosk are controversial, many people may not like them. If you don't like them as well please don't refuse to add them thought. Your service would look pretty empty if you select it and no video is being displayed. Also you should not override the preference of the user, since users of NewPipe can decide by the settings weather they want to see the kiosk page or not.","title":"Kiosk"},{"location":"03_Implement_a_service/#multiple-kiosks","text":"Most services will implement more than one Kiosk, so a service might have a \"Top 20\" for different categories like \"Country Music\", \"Techno\", etc. This is why the extractor will let you implement multiple KioskExtractors . Since different kiosk pages might also differ with their HTML structure every page you want to support has to be implemented as its own KioskExtractor . However if the pages are similar you can use the same Implementation, but set the page type when you instantiate your KioskExtractor through the KioskList.KioskExtractorFactory . Every Kiosk you implement needs to be added to your KioskList which you return with your StreamingService implementation. It is also important to set the default kiosk. This will be the kiosk that will be shown by the first start of your service. An example implementation of the getKioskList() could look like this: @Override public KioskList getKioskList() throws ExtractionException { KioskList list = new KioskList(getServiceId()); list.addKioskEntry(new KioskList.KioskExtractorFactory() { @Override public KioskExtractor createNewKiosk(StreamingService streamingService, String url, String id, Localization local) throws ExtractionException { return new YoutubeTrendingExtractor(YoutubeService.this, new YoutubeTrendingLinkHandlerFactory().fromUrl(url), id, local); } }, new YoutubeTrendingLinkHandlerFactory(), \"Trending\"); list.setDefaultKiosk(\"Trending\"); return list; } Parts required to be implemented: KioskList.KioskExtractorFactory KioskExtractor ListLinkHandlerFactory","title":"Multiple Kiosks"},{"location":"04_Run_changes_in_App/","text":"Run the changes in the App You should develop and test your changes with the JUnit environment that is provided by the NewPipe Extractor and IDEA. If you want to try it then with the actual fronted you need to follow these steps. Setup Android Studio First of all you want to setup a working Android Studio environment. For this please download Studio from developer.android.com , and follow the instructions about how to set it up. Get the NewPipe code and run it. In order to get it you must simply clone or download from the current dev branch github.com/TeamNewPipe/NewPipe.git . You can then build and run it following these instructions . Please also make sure you are comfortable with adb since you might experience some trouble running your compiled app on a real device, especially under linux where you sometimes have to adjust the udev rules in order to make your device be accessible . Run your changes on the Extractor In order to use the extractor in our app we use jitpack . This is a build service that can build maven *.jar packages for android and java based on a github or gitlab repositories. To the extractor through jitpack, you need to push them to your online repository of your copy that you host either on github or gitlab . It's important to host it on one of both. Now copy your repository url in Http format, go to jitpack , and past it there. From here you can grab the latest commit via GET IT button. I recomend not to use SNAPSHOT, since I am not sure when snapshot is build. An \"implementation\" string will be generated for you. Copy this string and replace the implementation 'com.github.TeamNewPipe:NewPipeExtractor:<commit>' line in the file /app/build.gradle with it. Your browser does not support the video tag. If everything synced well then you should only see a screen with OK signs. Now you can go on an compile and run NewPipe with the new extractor. Troubleshooting If something went wrong on jitpack site, you can check their build log, by selecting the commit you tried to build and click on that little paper symbol next to the GET IT button. If it is red it already shows that the build failed.","title":"Run the changes in the App"},{"location":"04_Run_changes_in_App/#run-the-changes-in-the-app","text":"You should develop and test your changes with the JUnit environment that is provided by the NewPipe Extractor and IDEA. If you want to try it then with the actual fronted you need to follow these steps.","title":"Run the changes in the App"},{"location":"04_Run_changes_in_App/#setup-android-studio","text":"First of all you want to setup a working Android Studio environment. For this please download Studio from developer.android.com , and follow the instructions about how to set it up.","title":"Setup Android Studio"},{"location":"04_Run_changes_in_App/#get-the-newpipe-code-and-run-it","text":"In order to get it you must simply clone or download from the current dev branch github.com/TeamNewPipe/NewPipe.git . You can then build and run it following these instructions . Please also make sure you are comfortable with adb since you might experience some trouble running your compiled app on a real device, especially under linux where you sometimes have to adjust the udev rules in order to make your device be accessible .","title":"Get the NewPipe code and run it."},{"location":"04_Run_changes_in_App/#run-your-changes-on-the-extractor","text":"In order to use the extractor in our app we use jitpack . This is a build service that can build maven *.jar packages for android and java based on a github or gitlab repositories. To the extractor through jitpack, you need to push them to your online repository of your copy that you host either on github or gitlab . It's important to host it on one of both. Now copy your repository url in Http format, go to jitpack , and past it there. From here you can grab the latest commit via GET IT button. I recomend not to use SNAPSHOT, since I am not sure when snapshot is build. An \"implementation\" string will be generated for you. Copy this string and replace the implementation 'com.github.TeamNewPipe:NewPipeExtractor:<commit>' line in the file /app/build.gradle with it. Your browser does not support the video tag. If everything synced well then you should only see a screen with OK signs. Now you can go on an compile and run NewPipe with the new extractor.","title":"Run your changes on the Extractor"},{"location":"04_Run_changes_in_App/#troubleshooting","text":"If something went wrong on jitpack site, you can check their build log, by selecting the commit you tried to build and click on that little paper symbol next to the GET IT button. If it is red it already shows that the build failed.","title":"Troubleshooting"},{"location":"05_documentation/","text":"Documentation The Documentation you are currently reading is written using mkdocs . It is a tool that will generate a static website based on files writting in markdown . Markdown has the advantage that it is simple to read and write, and that there are several tools that can translate a markdown file into languages like html or latex. Installation Mkdos is written in python and is distributed through the python internal package manager pip , thus you need to get python and pip running on your operating system first. Windows Download the latest Python3 . When running the setup program make sure to check Add Python 3.x to PATH . Install python Open powershell or cmd, and type: pip3 install mkdocs . MacOS MacOS already comes along with python, however pip is still missing. The easyest, and most nondistructive way is to install the MacOS package manager homebrew first. The advantage of homebrew are that it will only modify your home directory, but not the root dir. So your OS will not be touched by this. Install homebrew Install Python from homebrew, which will also install pip. Run this command: brew install python . Install mkdocs: pip3 install mkdocs Linux/*BSD Also Linux/*BSD comes pre installed with python. Most distributions also deliver pip by default. If its not installed you may need to figure out how to install pip3 through the package manager of your system. Install pip3 with these commands according to distributions: Ubuntu/Mint : apt install python3-pip Fedora/CentOS : sudo dnf install python3-pip Arch/Manjaro : sudo pacman -S python-pip openSuse : sudo zypper install python-pip *BSD : You are already advanced enough to know how you can force the bits on your disk to become pip by meditating upon it. Run pip3 install mkdocs to install mkdocs only for the current user, or run sudo pip3 install mkdocs to install mkdocs systemwide. Last one has the higher chance to work properly. Android/ChromeOS This might sound funny, but according to the growing amount of ChromeBooks and Android tablets with keyboard this might actually be useful. Install the Tremux App from f-droid . Launch Termux and type apt update Install python and git with the command: apt install git python Now install mkdocs with pip install mkdocs . From here on everything will be the same as on Desktop. If you want to edit the files you can (besides vim or emacs which are available through Termux) use your favourite text editor on android. This is possible by opening the files with the Termux integration of the build in android file manager: Update Sometimes mkdocs changes the way how to serve, or the syntax will differ. This is why you should make sure to always run the latest version of mkdocs. To ensure this simply run pip3 install --upgrade mkdocs or sudo pip3 install --upgrade mkdocs if you installed pip system wide on a linux/bsd system. Using mkdocs In order to extend this documentation you have to clone it from its git repository . When you cloned it, you will find a mkdocs.yml file, and a docs directory inside. The yaml file is the config file while in the directory docs the documentation files are stored. here is a guide about how to use mkdocs. Write and Deploy If you are writing a documentation page, and want a live preview of it you can enter the root directory of this documentation project, and then run mkdocs serve this will start the mkdocs internal webserver on port 8000 . So all you have to do is type localhost:8000 into the addressbar of your browser, and here you go. If you modify a file, and save it, mkdocs will reload the page and show you the new content. If you want to deploy the page, so it will be up to date at the github pages simply type mkdocs gh-deploy . However please be aware that this will not push your changes to the master branch of the repository. So you still have to commit and push your changes to the actual git repository of this documentation. Please be aware that only priviliged maintainers can do this.","title":"Documentation"},{"location":"05_documentation/#documentation","text":"The Documentation you are currently reading is written using mkdocs . It is a tool that will generate a static website based on files writting in markdown . Markdown has the advantage that it is simple to read and write, and that there are several tools that can translate a markdown file into languages like html or latex.","title":"Documentation"},{"location":"05_documentation/#installation","text":"Mkdos is written in python and is distributed through the python internal package manager pip , thus you need to get python and pip running on your operating system first.","title":"Installation"},{"location":"05_documentation/#windows","text":"Download the latest Python3 . When running the setup program make sure to check Add Python 3.x to PATH . Install python Open powershell or cmd, and type: pip3 install mkdocs .","title":"Windows"},{"location":"05_documentation/#macos","text":"MacOS already comes along with python, however pip is still missing. The easyest, and most nondistructive way is to install the MacOS package manager homebrew first. The advantage of homebrew are that it will only modify your home directory, but not the root dir. So your OS will not be touched by this. Install homebrew Install Python from homebrew, which will also install pip. Run this command: brew install python . Install mkdocs: pip3 install mkdocs","title":"MacOS"},{"location":"05_documentation/#linuxbsd","text":"Also Linux/*BSD comes pre installed with python. Most distributions also deliver pip by default. If its not installed you may need to figure out how to install pip3 through the package manager of your system. Install pip3 with these commands according to distributions: Ubuntu/Mint : apt install python3-pip Fedora/CentOS : sudo dnf install python3-pip Arch/Manjaro : sudo pacman -S python-pip openSuse : sudo zypper install python-pip *BSD : You are already advanced enough to know how you can force the bits on your disk to become pip by meditating upon it. Run pip3 install mkdocs to install mkdocs only for the current user, or run sudo pip3 install mkdocs to install mkdocs systemwide. Last one has the higher chance to work properly.","title":"Linux/*BSD"},{"location":"05_documentation/#androidchromeos","text":"This might sound funny, but according to the growing amount of ChromeBooks and Android tablets with keyboard this might actually be useful. Install the Tremux App from f-droid . Launch Termux and type apt update Install python and git with the command: apt install git python Now install mkdocs with pip install mkdocs . From here on everything will be the same as on Desktop. If you want to edit the files you can (besides vim or emacs which are available through Termux) use your favourite text editor on android. This is possible by opening the files with the Termux integration of the build in android file manager:","title":"Android/ChromeOS"},{"location":"05_documentation/#update","text":"Sometimes mkdocs changes the way how to serve, or the syntax will differ. This is why you should make sure to always run the latest version of mkdocs. To ensure this simply run pip3 install --upgrade mkdocs or sudo pip3 install --upgrade mkdocs if you installed pip system wide on a linux/bsd system.","title":"Update"},{"location":"05_documentation/#using-mkdocs","text":"In order to extend this documentation you have to clone it from its git repository . When you cloned it, you will find a mkdocs.yml file, and a docs directory inside. The yaml file is the config file while in the directory docs the documentation files are stored. here is a guide about how to use mkdocs.","title":"Using mkdocs"},{"location":"05_documentation/#write-and-deploy","text":"If you are writing a documentation page, and want a live preview of it you can enter the root directory of this documentation project, and then run mkdocs serve this will start the mkdocs internal webserver on port 8000 . So all you have to do is type localhost:8000 into the addressbar of your browser, and here you go. If you modify a file, and save it, mkdocs will reload the page and show you the new content. If you want to deploy the page, so it will be up to date at the github pages simply type mkdocs gh-deploy . However please be aware that this will not push your changes to the master branch of the repository. So you still have to commit and push your changes to the actual git repository of this documentation. Please be aware that only priviliged maintainers can do this.","title":"Write and Deploy"}]}
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index 8fd98fecff5f0a2fc5bb7b281b0394c3086ce79b..5e849a0b38458b259fde062b608674701ad3a1f6 100644
GIT binary patch
delta 14
VcmX@kc$|?<zMF$1F>)f?K>#2)1Y-aI

delta 14
VcmX@kc$|?<zMF$XpJO81K>!{41K<Dv