This IPTV player, built with Python and PyQt5, supports M3U_plus playlists and Xtream Codes API, allowing users to manage and play IPTV channels, movies, and series.
Feel free to report issues when encountering any problems: Issues
For sharing ideas and general questions: Discussions
Download the latest version here: Latest releases
- Supports Windows, Linux and Mac OS
- M3U_plus Support: Load and play live TV, movies, and series.
- Xtream Codes API: Log in with Xtream credentials and dynamically load content.
- Categorized Playlists: Organized into Live TV, Movies, and Series tabs for easy navigation.
- Favorites: Add items to favorite and find them in the 'Favorites' category.
- EPG Option: Access and download Electronic Program Guide for live TV channels.
- Movies and series information: Additional movies and series information e.g. movie/series cover, description, cast, trailer, TMDB, etc.
- Series navigation: Access series categories and specific episodes with efficient 'Go Back' functionality in series playlist.
- Search bar history: By using the up and down keys you can access the previously searched texts in the search bars.
- Sorting playlists: Each list can be sorted A-Z, Z-A or sorting can be disabled. The default sorting can be configured in the settings tab.
- Info tab: Information about IPTV account status.
- Adjustable column widths: Adjust the column widths in each tab to your liking by dragging the edges.
- Error Handling: Graceful handling of loading issues.
- External Player Support: Play channels/movies/series using VLC or SMPlayer.
- Recommended Player: For optimal performance, use VLC media player. Download it at: https://www.videolan.org/vlc/
- Recommended Player: For optimal performance, use SMPlayer. Download it at: https://www.smplayer.info
- M3U file support: Select M3U file or URL to M3U file to load data from.
- Home tab: Home tab with previously watched and popular movies and series.
- TMDB support: Much more information about movies and series with the TMDB API.
- Improve startup loading time: Improve loading time at startup by optionally loading the IPTV data from cache.
- Dark theme
My Live TV doesn't work, but my movies and series do work. How can I fix this?
Some IPTV providers require a different URL format than the default, therefore you need to change this URL format. Go to the account manager inside the IPTV player. And in the live tv format line replace the URL format with one of the following URL formats:
{server}/{username}/{password}/{stream_id}
{server}/{username}/{password}/{stream_id}.ts
{server}/{username}/{password}/{stream_id}.m3u8
{server}/{username}/{password}/live/{stream_id}
{server}/{username}/{password}/live/{stream_id}.ts
{server}/{username}/{password}/live/{stream_id}.m3u8
{server}/live/{username}/{password}/{stream_id}
{server}/live/{username}/{password}/{stream_id}.ts
{server}/live/{username}/{password}/{stream_id}.m3u8
If none of these work, more attention is needed and you should create an Issues.
Live TV showing EPG data
Movies with information
Series navigation
Search in categories and entries
Save your IPTV account and optionally auto-select at startup
- Run the latest Python 3 installer.
- During installation, make sure to:
- Use administrator privileges when installing Python
- Add
python.exeto the system PATH - Select any other appropriate options as prompted
python -m pip install --upgrade pip
python -m pip install --upgrade setuptools
python -m pip install --upgrade pyinstaller
python -m pip install --upgrade requests lxml python-dateutil PyQt5pyinstaller --version
# Example of expected output: 6.14.0- Run the build_iptv_player.bat file to start the process.
- To compile Python yourself, download the source code
- Tested with Python 3.13.4
Note: The following dependencies must be installed:
dnf install python3-dev python-dev
If you are building Python by yourself, rebuild with--enable-shared(or,--enable-frameworkon macOS).\
python3 -m pip install --upgrade pip
python3 -m pip install --upgrade setuptools
python3 -m pip install --upgrade pyinstaller
python3 -m pip install --upgrade requests lxml python-dateutil PyQt5Note: If you are not logged in as root (which is recommended), you need to ensure that pyInstaller is included in your PATH environment variable:
export PATH=$PATH:$HOME/.local/binpyinstaller --version
# Example of expected output: 6.14.0- Make the SH script executable with the command:
chmod +x build_iptv_player.sh - Run the ./build_iptv_player.sh file to start the process.