Overview

With this application you can create lists with TV streams from around the web.

Features

• Channels with electronic program guide.
• Extract streams using XML, JSON, M3U, REGEX or HTML parsers.
• Test streams.
• Export and Import database.
• Create custom channels and EPG parsers.
• Stream references (automatically assign channels to streams).

Requirements

• Fast internet connection (Ethernet the best, WiFi or LTE recommended, 4G may work).
• Good and stable data signal.
• 100 MB or more free internal memory space.

How to use

Step 1 (Extract/grab streams):
First you need to extract the streams. You can do this by creating a new list. Start by selecting Extract Streams from the menu.
You need to know the file from where you want to grab your streams. This can be a remote file (eg. like a web page) or a local file.
For xml files you need to know the tag where the stream is and optionally the tag for the name of the stream.
(Advanced only) For regular expression you can get more details from android Pattern object.

After you have the streams extracted and saved you can go to step 2 or 3.

Step 2 (Assign Channel):
You can assign a channel by either touching the logo icon or from Edit Channel page. (make sure that you first updated the database otherwise no channels will be available to assign).

Step 3 (Test stream):
You can test the stream by either touching the stream name and select test or from Edit Channel page. This will show additional details about your stream.

F.A.Q.

TO DO

Notes

• At this time you will find no streams at all included in this app. In the case that some streams will eventually be added, they will be only from free public TV stations and for demonstrative purpose.

Custom Channels

This application allows you to create your own custom channels

To create a custom channel you need to create a xml file and import it into TVStreams. Bellow is an example of the content of a xml file with one custom channel:

customchannel.xml

<?xml version="1.0" encoding="UTF-8"?>
<TVStreams>
    <Channels>
        <channel id="1">
            <name><![CDATA[Al Jazeera]]></name>
            <category>News</category>
            <file_name>al_jazeera</file_name>
            <epg_module_name>america.aljazeera.com</epg_module_name>
            <epg_module_key>none</epg_module_key>
            <epg_language>En</epg_language>
            <language>En</language>
            <country><![CDATA[United States]]></country>
            <web><![CDATA[english.aljazeera.net]]></web>
            <enabled>true</enabled>
        </channel>
    </Channels>
</TVStreams>

Logo Image

For the app to properly load the custom channel logo, the following conditions must be met.

• The logo must be placed on the external storage under folder TVStreams/images/logos/.
• The logo must be in png format type and with transparency.
• The dimensions of the logo must be 161px x 109px.
• The name of the file must match the file_name tag of the channel in xml.

Custom EPG parser

This application allows you to create your own custom EPG parsers

The EPG module files must be placed on the external storage under the folder TVStreams/epg/.

america.aljazeera.com.xml

<?xml version="1.0" encoding="UTF-8"?>
<EPG_MODULE url="http://america.aljazeera.com/bin/ajam/broadcast-schedule.json">
    <EVENT eventsgroup="true"><![CDATA[\{"wireEntry"(.*?)\{"entry":]]>
        <TITLE mode="regex"><![CDATA[","title":"(.*?)",]]></TITLE>
        <TIME mode="regex" timemode="timestamp"><![CDATA["publishedDate":(.*?),"]]></TIME>
        <SUBTITLE mode="regex" trim="true"><![CDATA["description":\{"value":"(.*?)",]]></SUBTITLE>
    </EVENT>
</EPG_MODULE>

EPG_MODULE

EPG_MODULE is the main group and is mandatory.

EPG_MODULE attributes

Groups

You can define your own groups using only uppercase leteres and numbers (eg:DAY or GROUP_1). Do not use TIME, TITLE or SUBTILE as custom groups because these are predefined elements.

Groups specific attributes

Elements

There are 2 types: predefined and custom.

• Predefined elements are: TIME, TITLE and SUBTITLE. These must be placed into a group with the attribute "eventsgroup".
• Custom elements must be lowercase to diference them from groups and predefined elements.

Common attributes TIME specific attributes

Complex Example

<?xml version="1.0" encoding="UTF-8"?>
<EPG_MODULE url="http://www.devaward.com/tvstreams/example-epg.php?channel=$MODULE_KEY$">
    <DAY><![CDATA[(?s)<span>\n(.*?)<td style=\"vertical-align:top;text-align:center\">]]>
        <time_1 mode="regex" trim="true"><![CDATA[class="begin_time">(.*?)<]]></time_1>
        <date mode="regex" replace="ţ|$|ț"><![CDATA[(?s).*? (.*?)\n   </span><br/>]]></date>
        <EVENT eventsgroup="true"><![CDATA[(?s)<table><tr><td>(.*?)</td></tr><]]>
            <time_2 mode="regex" replaceepmty="time_1"><![CDATA[(?s)class="time_text">(.*?)<]]></time_2>
            <TITLE mode="regex"><![CDATA[btxt">(.*?)</]]></TITLE>
            <TIME mode="comp" trim="true" timemode="format" timeformat="(d MMMM) H:mm" referencesystemyear="true" timezone="Europe/Madrid" locale="es,ES"><![CDATA[$date$ $time_2$]]></TIME>
            <sub_1 mode="regex" trim="true" removechars="()"><![CDATA[class="sub_text">(.*?)</]]></sub_1>
            <sub_2 mode="regex" trim="true" removechars="()"><![CDATA[class="extra_text">(.*?)</]]></sub_2>
            <sub_3 mode="regex" trim="true"><![CDATA[class="desc_text">(.*?)</]]></sub_3>
            <sub_4 mode="comp" trim="true"><![CDATA[$sub_1$ $sub_2$]]></sub_4>
            <SUBTITLE mode="comp" removestring="()" replace="<br/>|$| "><![CDATA[$sub_3$ ($sub_4$)]]></SUBTITLE>
        </EVENT>
    </DAY>
</EPG_MODULE>

Report a bug

Send all bug reports to e-mail . Please make sure to describe it in detail.
Thank you for your help!