A modern, lightweight and database-free PHP WebTV client for XUI.ONE and Xtream-compatible IPTV panels.
XUI WebTV Client lets users sign in with their own IPTV subscription credentials and watch Live TV, Movies and Series directly from a clean, TV-friendly web interface.
🚀 No database. No admin API. No stream proxy. Just upload, configure your panel URL and start using it.
- ⚡ Plain PHP — no framework, no composer setup, no database
- 🔐 User login with standard IPTV
usernameandpassword - 📡 Live TV categories, channels, logos and HLS playback
- 🎬 Movies with posters, ratings, years and IMDb-style metadata
- 📚 Series with categories, posters, seasons, season artwork and episodes
- 🧾 Account details in the top bar: expiry date, remaining time, max connections, active connections and status
- 🖥️ TV-friendly UI with large buttons, large typography and keyboard-friendly controls
- ⭐ Favorites stored locally in the browser
- ⏯️ Continue watching progress for movies and episodes
- 🔎 Search for channels, movies and series
- 🧠 Smart browser playback warnings for unsupported video/audio formats
- 🖼️ Default fallback images for missing channel logos, posters and covers
- 🧹 File cache with a one-click Refresh List button
- 🔗 Clean URLs without
.phpextensions - 📁 Auto path detection for root, subdomain or subdirectory usage
- 🌐 HTTP mode support for IPTV streams that do not work over SSL
This project is a standard WebTV viewer application.
Users log in with their own IPTV line credentials:
Username
Password
The application uses the standard Xtream/XUI player API, for example:
/player_api.php?username=USER&password=PASS
It is not an XUI.ONE admin panel project and does not use admin API keys.
- Live categories
- Channel lists
- Channel logos
- HLS playback with HLS.js
- Native Safari HLS fallback
- Fullscreen button
- Large TV-friendly channel rows
- Movie categories
- Poster grid
- Movie details
- IMDb-style metadata
- Rating, year, duration, genre, cast and director display when available
- Browser playback compatibility checks
- Continue watching support
- Series categories
- Poster grid
- Series details
- Seasons and season artwork
- Episode lists
- Episode playback
- Continue watching support
- PHP 7.4+
- Apache with
mod_rewriteenabled, or an equivalent Nginx rule - PHP cURL extension recommended
- An XUI.ONE / Xtream-compatible player API
- A valid IPTV user account for login testing
No MySQL database is required.
- Upload all project files to your hosting account.
- Edit
config.php. - Set your XUI.ONE / Xtream panel URL.
- Open the WebTV URL in your browser.
- Log in with a valid IPTV username and password.
Example config.php values:
'xui_base_url' => 'http://panel.example.com:8080',
'stream_base_url' => '',
'prefer_server_info_stream_url' => true,
'force_http' => true,
'force_http_client_fallback' => true,
'force_stream_http' => true,
'live_stream_extension' => 'm3u8',
'live_fallback_extension' => 'ts',
'player_start_timeout_ms' => 30000,Do not add /player_api.php to xui_base_url.
Correct:
'xui_base_url' => 'http://panel.example.com:8080',Wrong:
'xui_base_url' => 'http://panel.example.com:8080/player_api.php',Many IPTV panels and stream servers still serve live channels, movies or episodes over plain HTTP.
When a WebTV page is opened with HTTPS and the media file is HTTP, modern browsers may block playback because of mixed-content rules. In that case, the interface may load correctly but the video will not start.
For HTTP-only IPTV streams, the recommended setup is:
http://webtv.example.com
Not:
https://webtv.example.com
This project includes automatic HTTPS-to-HTTP redirection, but hosting panels, Cloudflare, HSTS or browser cache can still force HTTPS before the application can handle the request.
Use a dedicated subdomain:
webtv.example.com
Point the subdomain document root directly to the project folder.
Recommended final URLs:
http://webtv.example.com
http://webtv.example.com/live
http://webtv.example.com/movies
http://webtv.example.com/series
This is cleaner and safer than installing the project under a path like:
http://example.com/webtv
Subdomain installation also makes it easier to keep HTTP enabled only for WebTV while keeping your main website fully HTTPS.
For HTTP-only IPTV streams, the safest Cloudflare setup is:
DNS record: DNS only
Proxy status: Off / grey cloud
Recommended Cloudflare settings for the WebTV subdomain:
- ❌ Do not force HTTPS
- ❌ Do not enable Always Use HTTPS
- ❌ Do not enable HSTS for the WebTV subdomain
- ❌ Do not use automatic HTTPS rewrite rules for WebTV media paths
- ✅ Keep the WebTV subdomain reachable over HTTP
If the subdomain is proxied through Cloudflare and Cloudflare forces HTTPS, the WebTV page may open but streams may fail.
Expected behavior:
https://webtv.example.com -> http://webtv.example.com
http://webtv.example.com -> stays on HTTP
If HTTP immediately turns back into HTTPS, the redirect is happening outside the application. Check Cloudflare rules, HSTS, hosting redirects or browser cache.
- Create a subdomain, for example:
webtv.example.com
-
Set the document root to the project folder.
-
Upload all files.
-
Edit
config.phpand set your panel URL. -
Make sure these folders are writable by PHP:
storage/cache
storage/logs
- Open the subdomain over HTTP:
http://webtv.example.com
If the browser shows:
ERR_TOO_MANY_REDIRECTS
Plesk is probably forcing HTTP back to HTTPS.
In Plesk, open the WebTV subdomain and disable:
Permanent SEO-safe 301 redirect from HTTP to HTTPS
You may keep SSL/TLS support enabled if you still want a certificate available, but HTTPS forcing must be disabled for the WebTV subdomain.
Also check SSL It! settings and disable HSTS for this subdomain.
- Create a subdomain:
webtv.example.com
-
Upload the project files into the subdomain document root.
-
Edit
config.php. -
Make sure Apache rewrite rules are enabled.
-
Make sure these folders are writable:
storage/cache
storage/logs
- In cPanel, check Domains and disable Force HTTPS Redirect for the WebTV subdomain if your IPTV streams require HTTP.
Open:
http://webtv.example.com
Web browsers do not support every IPTV media container or codec.
Best browser compatibility:
- ✅ HLS /
.m3u8 - ✅ MP4 with browser-compatible video/audio codecs
- ✅ WebM on supported browsers
May fail or play without audio depending on codec:
⚠️ MKV⚠️ AVI⚠️ TS VOD files⚠️ MP4 files with unsupported audio codecs⚠️ Some HEVC/H.265 streams
When a movie or episode format is not compatible with the browser, the application shows a clear warning instead of pretending the content is playable.
Recommended message shown to users:
This content format is not supported by your web browser. Please use an IPTV application to watch this content.
Live TV URLs are generated in this format:
/live/USERNAME/PASSWORD/STREAM_ID.m3u8
Movie URLs:
/movie/USERNAME/PASSWORD/STREAM_ID.EXT
Series episode URLs:
/series/USERNAME/PASSWORD/EPISODE_ID.EXT
If stream_base_url is empty, the system can use the server_info values returned by the player API.
If your panel API URL and stream server URL are different, set stream_base_url manually:
'xui_base_url' => 'http://panel.example.com:8080',
'stream_base_url' => 'http://stream.example.com:8080',For stubborn HTTPS cache or HSTS problems, using the stream server IP and port may help:
'stream_base_url' => 'http://123.123.123.123:8080',Check:
- PHP version is 7.4 or newer
mod_rewriteis enabled.htaccessis allowed by hostingstorage/cacheis writablestorage/logsis writable- Hosting error logs for exact PHP/Apache errors
Usually caused by two opposite redirects:
WebTV app: HTTPS -> HTTP
Hosting/CDN: HTTP -> HTTPS
Disable forced HTTPS for the WebTV subdomain in Plesk, cPanel, Nginx, Cloudflare or any CDN rule.
This usually means the browser upgraded HTTP to HTTPS before the request was sent, often because of cached HTTPS/HSTS behavior.
Try:
- Clean browser profile
- Incognito/private window
- Different browser
- Clearing HSTS/cache for the subdomain
- Using a new WebTV subdomain
- Setting
stream_base_urlto HTTP IP:PORT
Check:
- Stream URL is HTTP if your streams do not support SSL
- WebTV page is also HTTP
- Cloudflare is not forcing HTTPS
- Browser supports the media format
- IPTV user account is active
- Max connections are not exceeded
- Stream works in an IPTV player with the same credentials
xui-webtv-client/
├── assets/
│ ├── css/
│ ├── img/
│ ├── js/
│ └── vendor/
├── docs/
│ └── screenshots/
├── storage/
│ ├── cache/
│ └── logs/
├── .htaccess
├── config.php
├── index.php
├── LICENSE
└── README.md
- IPTV credentials are used only for the logged-in user's playback session.
- The project does not require admin API credentials.
- The project does not create, edit, delete or manage IPTV users.
- Streams are not proxied through your web server.
- If users can see their own stream URL in the browser network tab, they are only seeing their own IPTV credentials and playback URL.
- Keep
config.phpprotected from direct access. - Keep
storageprotected from public access.
This project is only a WebTV client interface for compatible IPTV APIs. It does not include, host, sell, provide or redistribute any media content.
You are responsible for using it only with services and content that you are legally allowed to access.
xui
xui-one
xtream-codes
iptv
webtv
php
hls
m3u8
vod
live-tv
series
movies
iptv-player
web-player
MIT License.
If this project helps you, consider giving the repository a star on GitHub.