IPTV-Restream: A Robust IPTV Restreaming Solution

IPTV-Restream is designed as a web application to restream and synchronize IPTV streams effectively, leveraging HLS and ffmpeg technologies. This innovative platform allows users to share IPTV playlists and experience synchronized viewing alongside friends, enhancing the IPTV streaming experience.

Use Cases

• Multi-Playlist Support: Stream multiple IPTV playlists simultaneously with an easy-to-use web player.
• Device Connection: Connect multiple devices to a single IPTV stream, overcoming limitations set by streaming providers.
• Request Proxying: All requests can be routed through a singular IP address, addressing CORS issues effectively.
• Synchronized Streaming: Achieve perfectly synchronized playback and channel selection across devices for a seamless watch-together experience.
• Privacy Mode: Share IPTV access without disclosing the actual stream URL, ensuring privacy while viewing together.

Key Features

• Restream / Proxy Functionality: Effortlessly proxy IPTV streams through the backend, allowing for enhanced reliability and customization.
• Synchronization Mechanism: Enables synchronized playback and channel selections, ensuring an immersive viewing experience for all participants.
• Channel Management: Add and switch between multiple IPTV streams and playlists effortlessly.
• Live Chat Functionality: Engage with other viewers in real-time through a randomized profile chat feature.

How to Run

The preferred method to run IPTV-Restream is using Docker:

git clone https://github.com/antebrl/IPTV-Restream.git  

Ensure Docker is running and execute:

docker compose up -d  

Access the application at http://localhost.

Consult the advanced deployment documentation for further customization options, including automated SSL handling with NGINX Proxy Manager.

Compatible Playlists

For optimal performance and quality, several free IPTV playlists have been tested:

• Free TV Channels: A comprehensive collection of free TV channels sorted by country.
• Streamed SU Sports playlist: Provides access to live sporting events.
• Daddylive playlist: A variety of channels, including sports broadcasts.

Please note to set the necessary headers for playlists (Origin, Referer, User-Agent) to ensure smooth operation.

Streaming Modes

Options Available

1. Direct Mode: Utilizes the source stream directly, although it may present issues due to CORS or device restrictions.
2. Proxy Mode: The recommended choice, where all stream requests are proxied through the backend, allowing for custom headers and CORS bypassing.
3. Restream Mode: Caches the source stream with ffmpeg, providing a solution for device restrictions and synchronization challenges, though it may increase initial loading times.

For best results, it's advisable to start with Direct Mode and sequentially try Proxy and Restream modes if issues arise.

Contributions and Community

Community engagement is encouraged. Contributions, discussions, or requests for features are welcomed. For immediate assistance or troubleshooting, utilize the project's issue tracking feature.

If the application proves beneficial, consider supporting future development by starring the project.