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

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.
• 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

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.exe to 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 PyQt5

pyinstaller --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-framework on 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 PyQt5

Note: 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/bin

pyinstaller --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.