Documentation & Guide
Learn how to import IPTV playlists, connect media servers, and get the most out of D Media Player.
Content Disclaimer: D Media Player does not provide, host, or endorse any content. The app contains ZERO built-in proprietary content. Any sample stream links provided in the app are for demonstration purposes only. These point to publicly available, free-to-air broadcasts operated by third parties. You must provide your own media sources or local files to use the app.
1. How to Connect a Media Server
D Media Player can connect to your personal media server to browse and stream your library. You can set up a server connection in four different ways from the Home Screen:
1. Connect via URL
The fastest method. Provide a URL that returns a valid server configuration. The app will fetch, validate, and save the connection instantly.
2. Paste Server Config
Paste the server configuration directly into the app. Ideal for quick copy-pasting from your clipboard.
3. Import Config File
Import a JSON configuration file from your device's file system for easy setup.
4. Configure Manually
A step-by-step UI wizard where you can manually enter endpoints, headers, and set up your parsing logic using the built-in AI Mapper.
2. IPTV Playlists
D Media Player supports importing standard M3U/M3U8 playlists for IPTV channel browsing and playback.
- Import from URL: Paste any M3U playlist URL and the app will parse it into browsable channels with group filtering.
- Import from File: Import
.m3uor.m3u8files directly from your device. - Paste Text: Copy-paste the raw M3U playlist text content into the app.
Channels are displayed with logos, group categories, and search functionality for easy navigation.
3. M3U8 / HLS Direct Streams
Save individual M3U8 or HLS streaming URLs for quick access. Simply paste any direct stream URL and play it instantly with the native Apple media player.
4. Media Server Endpoints
To fully utilize the media server client, your server needs to supply these endpoints:
- Catalog Endpoint: The URL that returns a list (array) of video items. This is what you see on the Home screen grids and lists. It supports pagination.
- Detail Endpoint: The URL that returns the full details of a specific item (e.g., description, cast, ratings) based on its ID.
- Video Endpoint: The URL that returns the actual streamable video link (e.g.,
.m3u8or.mp4) based on the item's ID.
If your Catalog Endpoint already includes the direct Video URL, you can leave the Detail and Video endpoints blank.
3. Data Mapping & Parsing
Since every JSON API is structured differently, D Media Player uses Node Paths (Key Paths) to
extract the correct information. You can use dot-notation (like data.results) to point the app to
the right fields.
Key Mapping Fields:
itemsPath: Where the array of items is located in the Catalog JSON (e.g.,data.movies).idPath: The unique identifier for an item (used to fetch details/video).namePath: The title of the movie/video.coverUrlPath: The URL of the thumbnail or poster image.videoUrlPath: The location of the actual playback URL in the Video Endpoint response.
Pro Tip: Use AI Auto-Mapper
If you don't want to figure out the node paths manually, just paste a sample JSON response into the Manual Configuration wizard and click "Auto Map". Our on-device AI will automatically detect the lists, titles, images, and video URLs for you.
5. Example Server Configuration
This is the structure the app expects when you use "Connect via URL" or "Paste Server Config":
{
"name": "My Custom API Server",
"catalogURL": "https://<Your APIs>/v1/api/danh-sach/phim-moi",
"catalogMethod": "GET",
"catalogRootPath": "data.results",
"catalogConnectorPath": "id",
"catalogTitlePath": "title",
"catalogPosterPath": "poster_url",
"catalogSynopsisPath": "overview",
"detailURLTemplate": "https://<Your APIs>/phim/{slug}",
"detailMethod": "GET",
"detailDirectStreamPath": "stream_url"
}Note: The {slug} placeholder in the endpoints will be automatically replaced by the
catalogConnectorPath of the selected item.