
Client Configuration
📋 Prerequisites​
Before configuring any integration:
- Create and configure your playlist in m3u-editor
- Note your playlist UUID from Playlists → Edit → Step 1 (Links)
- Ensure m3u-editor is accessible from your client/media server (same network or via DNS)
- Replace
YOUR_M3U_EDITOR_IPwith your actual IP or hostname (e.g.,192.168.1.50,m3u.example.com)
➰ Output Methods​
m3u-editor provides multiple ways to consume your playlists. Choose based on what your client supports.
Xtream API​
Standard IPTV provider protocol. Clients authenticate with username/password and receive structured data (channels, VOD, series).
Use when: Client supports Xtream API (TiviMate, IPTV Smarters, OTT Navigator, etc.)
Server URL: http://YOUR_M3U_EDITOR_IP:36400
HDHomeRun​
Emulates a physical HDHomeRun tuner. Provides channel discovery and live TV integration at the OS/media-server level.
Use when: Media server has native HDHomeRun support (Jellyfin, Emby, Plex)
Discovery URL: http://YOUR_M3U_EDITOR_IP:36400/{playlist-uuid}/discover.json
Direct M3U Playlist​
Raw M3U file for generic players. Works everywhere but minimal metadata/structure.
Use when: Client only supports M3U or you need maximum compatibility
Playlist URL: http://YOUR_M3U_EDITOR_IP:36400/{playlist-uuid}/playlist.m3u
With Proxy: http://YOUR_M3U_EDITOR_IP:36400/{playlist-uuid}/playlist.m3u?proxy=true
EPG (Electronic Program Guide)​
XMLTV format guide data for live TV listings. Works with HDHomeRun and some Xtream clients.
EPG URL: http://YOUR_M3U_EDITOR_IP:36400/{playlist-uuid}/epg.xml
🔎 Finding Your Playlist Details​
Information in this section will be helpful for the steps outlined in** Client Configurations**
In m3u-editor:
- Go to Playlists
- Click Edit on your playlist
- In Step 1 (Links), you'll see:
- Playlist UUID (used in URLs)
- Username/Password (for Xtream API)
- Direct URLs for M3U, EPG, HDHomeRun, etc.
Copy these values as needed for your client configuration.
🔧 Client Configuration​
TiviMate​
Popular Android IPTV client supporting both Xtream API and M3U.
Xtream API Setup​
- Open TiviMate
- Select Add Playlist
- Choose Xtream Codes
- Enter:
- Server URL:
http://YOUR_M3U_EDITOR_IP:36400 - Username: Your playlist username
- Password: Your playlist password
- Server URL:
- Click Next and complete setup
M3U Setup​
- Open TiviMate
- Select Add Playlist
- Choose M3U Playlist
- Enter playlist URL:
http://YOUR_M3U_EDITOR_IP:36400/{playlist-uuid}/playlist.m3u - (Optional) Add EPG URL:
http://YOUR_M3U_EDITOR_IP:36400/{playlist-uuid}/epg.xml - Click Save