Adding VOD (Video on Demand) movies and multi-season TV Series in Xtream-compatible IPTV applications requires a slightly different approach than loading standard Live TV channels.
When VOD or TV Series categories are missing, fail to play, or lack poster art, it is almost always due to M3U format limitations, disabled VOD toggles in the app’s playlist parameters, or video player decoder mismatches.
This guide covers how to properly load and structure VOD Movies and TV Series across top Xtream apps like TiviMate, IPTV Smarters Pro, and XCIPTV.
Step 1: Use Xtream Codes API Instead of M3U Links
The most critical step for correct VOD and TV Series indexing is logging in via Xtream Codes API.
- Why Plain M3U Links Fail: Standard M3U playlist URLs format VOD items as continuous live channel streams. This strips away TV Series season/episode structures, movie metadata, poster graphics, and TMDB plot descriptions.
- Why Xtream Codes API Works: Xtream Codes queries your provider’s server database directly, separating content into three distinct native API queries: Live TV, VOD Movies, and TV Series.
If your provider gave you a single long playlist URL, learn how to find server address in M3U URL to extract your exact Server URL, Username, and Password.
Step 2: Enable VOD & Series in Your IPTV Player Settings
Many modern IPTV apps disable VOD and TV Series by default during initial playlist imports to speed up playlist loading times. You must verify that VOD content parsing is toggled on.
Enabling VOD in TiviMate:
1.Navigate to Playlist Settings:Access playlist options.
Open TiviMate, go to Settings > Playlists, and select your active playlist.
2.Open Xtream Codes Parameters:Check API configuration.
Scroll down and select Xtream Codes parameters.
3.Toggle On VOD Movies & TV Series:Enable VOD features.
Ensure the toggles for Include VOD and Include TV series are turned ON.
4.Apply & Update Playlist:Sync new categories.
Return to the main settings menu and click Update playlist. TiviMate will fetch movie posters, series folders, and metadata.
Enabling VOD in IPTV Smarters Pro:
- Open IPTV Smarters Pro.
- From the main dashboard, tap the Download Movies and Download Series buttons.
- If categories remain empty, click the Settings (Gear Icon) in the top-right corner > Refresh Contents > Select Refresh Movies & TV Series.
Step 3: Configure Video Decoders for VOD Playback
Live TV streams typically use .ts (Transport Stream) files, whereas VOD movies and TV Series are hosted as .mp4 or .mkv files utilizing H.264, HEVC/H.265, or AV1 compression codecs.
If clicking a movie results in a black screen or infinite loading spinner:
- Go to your app’s Settings > Playback (or Player Settings).
- Set the VOD Video Decoder to Hardware (HW) or ExoPlayer.
- If playback still fails, select Use External Player and set VLC Media Player or MX Player as your designated player for VOD content.
Troubleshooting VOD & TV Series Issues
| Issue | Likely Cause | Solution |
| TV Series Episodes Out of Order | App parsing error or provider folder misnaming | Clear app cache. In TiviMate, go to Settings > Appearance > VOD and set sorting to By Season/Episode. |
| Subtitles / Multi-Audio Missing | Native internal player engine limitations | Press OK/Select during video playback, tap the Audio/Subtitle icon, and switch tracks. If unsupported, switch to an external player like VLC. |
| App Crashes When Opening Movies | Low RAM / Excessive playlist cache | Large VOD libraries (50,000+ titles) can overwhelm budget TV sticks. Go to Playlist Settings and hide/disable unused movie categories (e.g., non-English languages). |
Developed by iptvhelpcenter.com
