Creating M3U Playlists for xPola Player

ADAMA BONGADO — Sun, 05 Jan 2025 10:25:09 +0000

This tutorial walks you through creating an M3U playlist that's compatible with the xPola Player, an advanced media player capable of playing multiple formats. The steps below will help you structure and customize your M3U playlist to include features like logos, user-agent headers, and multi-server support.

Steps to Create an M3U Playlist
Step 1: Start by opening a text editor, such as Notepad++ or any other code editor, and create a new file. Save it with a relevant name, such as playlist.m3u.

Step 2: At the very beginning of your playlist file, add the following line to indicate that the file is an M3U playlist:
Step 2: At the very beginning of your playlist file, add the following line to indicate that the file is an M3U playlist:

#EXTM3U

Step 3: Add each media entry following this structure. You can include details like group titles, channel logos, and video names. Below is an example:

#EXTINF:-1 group-title="Group Name" tvg-logo="https://example.com/images/logo.jpeg", Video Name 1
https://example.com/file/video.m3u8

To configure the playlist with specific headers like user-agent, referrer, or player type, use the appropriate commands as shown below.
Adding User-Agent
To include a specific user-agent header for the stream, use:

#EXTVLCOPT:http-user-agent=your-agent-here

For example:

#EXTINF:-1 group-title="Group Name" tvg-logo="https://example.com/images/logo.jpeg", Video Name 1
#EXTVLCOPT:http-user-agent=your-agent-here
https://example.com/file/video.m3u8

Adding Referrer
To specify a referrer, add:

#EXTVLCOPT:http-referrer=https://domaine.com/

Example:

#EXTINF:-1 group-title="Group Name" tvg-logo="https://example.com/images/logo.jpeg", Video Name 1
#EXTVLCOPT:http-referrer=https://domaine.com/
https://example.com/file/video.m3u8

Setting the HTTP Origin
To set the HTTP origin for a video link, use the following line:

#EXTVLCOPT:http-origin=https://domaine.com

Example:

#EXTINF:-1 group-title="Group Name" tvg-logo="https://example.com/images/logo.jpeg", Video Name 1
#EXTVLCOPT:http-origin=https://domaine.com
https://example.com/file/video.m3u8

This option is used to specify the HTTP origin header when accessing the video link. It's essential for certain streams or servers that require an origin value to ensure the request is valid, usually to check the origin of the request for security or access control purposes.

Setting the X-Requested-With Header
To set the X-Requested-With header for a video link, use the following line:

#EXTVLCOPT:http-requested=com.android.browser

Example:

#EXTINF:-1 group-title="Group Name" tvg-logo="https://example.com/images/logo.jpeg", Video Name 1
#EXTVLCOPT:http-requested=com.android.browser
https://example.com/file/video.m3u8

This option is used to specify the X-Requested-With HTTP header when accessing the video link. This header is often required by servers to identify the client making the request, commonly for security, access control, or compatibility purposes.

Setting Custom Cookies for a Video Stream
This option allows you to pass custom cookies to the video stream URL. Cookies can be used for authentication, session handling, or other purposes required by the server to grant access to the media content.

#EXTVLCOPT:http-cookie=name=value;name2=value2

Example:

#EXTINF:-1 group-title="Group Name" tvg-logo="https://example.com/images/logo.jpeg", Video Name 1
#EXTVLCOPT:http-cookie=name=value;name2=value2
https://example.com/file/example.m3u8

How it works: You define one or more cookies using the format name=value. You can set multiple cookies by separating them with semicolons. When the media player sends the request to access the video, it will include these cookies in the request headers, just as a browser would. This is useful when the server requires specific cookie values to grant access to the video stream.

For example, if the server requires session authentication or other information stored in cookies, you can set these values to ensure the player can access and play the content properly.

Setting the Player Type to Web Player
To configure the player type as "webplayer", use the following line:

#EXTVLCOPT:http-player-type=webplayer

#EXTVLCOPT:http-player-type=browser

#EXTVLCOPT:http-player-type=browser

#EXTVLCOPT:http-player-type=external

#EXTVLCOPT:http-player-type=m3u

Example:

#EXTINF:-1 group-title="Group Name" tvg-logo="https://example.com/images/logo.jpeg", Video Name 1
#EXTVLCOPT:http-player-type=webplayer
https://example.com/file/video.html

#EXTINF:-1 group-title="Group Name" tvg-logo="https://example.com/images/logo.jpeg", Video Name 1
#EXTVLCOPT:http-player-type=m3u
https://example.com/file/playlist.m3u

This option tells the player to open the link in a web player format. It's useful when the content is designed to be played directly in a browser or web-based media player rather than a standalone app or media player.

Advanced Configurations
To handle multi-server streams or advanced player configurations, you can add multiple server links in the following format:

#EXTINF:-1 group-title="Group Name" tvg-logo="https://example.com/images/logo.jpeg", Video Name 1
servers=["https://server1.com/playlist.m3u8|referer=https://example.com/", 
         "https://server2.com/playlist.m3u8|user-agent=CustomAgent"]

You can also specify DRM license configurations for ClearKey, Widevine, or PlayReady:

#EXTINF:-1 group-title="Group Name" tvg-logo="https://example.com/images/logo.jpeg", Video Name 1
#EXTVLCOPT:http-drm-scheme=clearkey
#EXTVLCOPT:http-drm-license=xxxxxxxxxxxxxxxxx:yyyyyyyyyyyyyyyyyy
https://example.com/file/stream.mpd

#EXTINF:-1 group-title="Group Name" tvg-logo="https://example.com/images/logo.jpeg", Video Name 1
#KODIPROP:inputstream.adaptive.license_type=clearkey
#KODIPROP:inputstream.adaptive.license_key=xxxxxxxxxxxxxxxxx:yyyyyyyyyyyyyyyyyy
https://example.com/file/stream.mpd

#EXTINF:-1 group-title="Group Name" tvg-logo="https://example.com/images/logo.jpeg", Video Name 1
https://example.com/file/stream.mpd?|drmScheme=clearkey&drmLicense=xxxxxxxxxxxxxxxxx:yyyyyyyyyyyyyyyyyy

Automatically Fetching a Video Stream from a Webpage
This option is particularly useful when you have a webpage with an embedded video player or video link, and you want the media player to find and play the video stream without showing the webpage itself.

#EXTVLCOPT:http-find=any_key_word_in_the_link;m3u8

Example:

#EXTINF:-1 group-title="Group Name" tvg-logo="https://example.com/images/logo.jpeg", Video Name 1
#EXTVLCOPT:http-find=any_key_word_in_the_link;m3u8
https://example.com/file/example.html

How it works: You provide the link to a webpage that contains the video player or video URL, and specify a keyword (like "m3u8") that is part of the actual video link. The player will open the webpage in the background, search for the video link that matches the keyword, extract it, and play the video directly in the player without displaying the webpage.

This is useful for avoiding unnecessary webpage content and directly streaming the video by automatically finding the correct video link from the page.

PHP and HTML Integration

If you want to open videos in the xPola Player app directly from a web page, you can use the following PHP or HTML code snippets. These examples show how to encode a video URL and pass it to the xPola Player via an intent in Android:

<?php
$videoUrl = "https://example.com/file/playlist.m3u8";
?>
<button onClick="location.href='intent://<?php echo base64_encode($videoUrl); ?>#Intent;scheme=xmtv;package=com.xpola.player;end'">Play</button>

Similar HTML-based buttons can be created to trigger playback directly in xPola Player:

<!DOCTYPE html>
<html>
<head>
    <title>Play Video</title>
</head>
<body>
    <button onclick="playVideo()">Play Video</button>
    <script>
        function playVideo() {
            let videoUrl = "https://example.com/file/playlist.m3u8|referer=https://example.com/";
            location.href = 'intent://' + btoa(videoUrl) + '#Intent;scheme=xmtv;package=com.xpola.player;end';
        }
    </script>
</body>
</html>

xPola Player: The Advanced Media Player for Android

ADAMA BONGADO — Sun, 05 Jan 2025 10:10:21 +0000

xPola Player is a versatile video link player designed specifically for Android devices. Its user-friendly interface and elegant design make it accessible to users of all levels. With its support for a wide range of video formats such as M3U, TS, M3U8, MOV, and audio formats like MP3, xPola Player is a reliable and powerful media player.
Wide Format Support
One of the key strengths of xPola Player is its compatibility with various media formats. Whether you’re streaming live channels or playing your favorite audio tracks, xPola Player ensures a seamless playback experience.

Customizable User-Agent
When adding new video links, users can customize the user-agent header for their streams, providing greater flexibility for accessing content. Alternatively, the default user-agent of the app can be used for simplicity.

Personalized M3U Playlists
xPola Player allows users to create and manage personalized M3U playlists. By including options like user-agent, referrer, and cookies, users can tailor their playlists to meet their needs. This feature ensures compatibility with advanced streaming requirements and multi-server configurations.

Playing Links with ClearKey Protection
xPola Player supports playing video links protected with ClearKey technology. This capability allows users to access content that requires specific keys for playback, offering a smooth and secure viewing experience. This makes it a suitable choice for legally accessing DRM-protected content like premium channels and movies.

No Preloaded Content
xPola Player is strictly a media player and does not come with any preloaded videos or links. Users must provide their own links, ensuring compliance with copyright regulations and maintaining a fair-use policy.

Advanced Features for Enhanced Playback
The app includes advanced features such as:

Custom HTTP Headers: Specify user-agent, referrer, cookies, and more to enhance compatibility.
Playlist Flexibility: Easily organize and manage playlists with additional metadata like logos and group titles.
Multi-Server Support: Add multiple streaming servers for redundancy and better performance.
Integration with External Players: Use external apps or browsers for specialized playback needs.
Streamlining Video Playback from Web Pages
xPola Player simplifies video streaming by extracting video links directly from web pages using specified keywords. This eliminates unnecessary webpage content, allowing users to focus on the content they want to watch.

Conclusion
xPola Player stands out as a comprehensive and advanced media player for Android. Its ability to handle a wide array of formats, customization options, and support for modern playback technologies like ClearKey makes it an excellent choice for all your media needs. Whether you’re an everyday user or a streaming enthusiast, xPola Player is here to deliver a seamless experience.
You can download xPola Player directly from the Google Play Store.

DEV Community: ADAMA BONGADO

Creating M3U Playlists for xPola Player

xPola Player: The Advanced Media Player for Android