IPTV StreamHub

Note

A simple IPTV restream and synchronization (watch2gether) application with web frontend. Share your iptv playlist and watch it together with your friends.

Actively in devlopment and open your ideas!
Test it out (Only for testing, used channels are free and not reliable)

💡Use Cases

• Connect with multiple Devices to 1 IPTV Stream, if your provider limits current streaming devices.
• Proxy all Requests through one IP.
  • Helps with CORS issues.
• Synchronize IPTV streaming with multiple devices: Synchronized playback and channel selection for perfect Watch2Gether.
• Share your iptv access without revealing your actual stream-url (privacy-mode) and watch together with your friends.

✨ Features

Restream / Proxy - Proxy your iptv streams through the backend.
Synchronization - The selection and playback of the stream is perfectly synchronized for all viewers.
Channels - Add multiple iptv streams and playlists, you can switch between.
Live chat - chat with other viewers with a randomized profile.

🚀 Run

Run with Docker (Preferred)

Clone the repo

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

Make sure to have docker up & running. Start with docker compose

docker compose up -d

Open http://localhost

Important

If a channel/playlist won't work, please try with restream through backend option enabled. This fixes most of the problems! It leads to longer initial loading times. If you don't need synchronization, turn it off in the ⚙️ or set the delay in the config.

Run components seperately

If you only need the restream functionality and want to use another iptv player (e.g. VLC), you may only run the backend.
If you only need the synchronization functionality, you may only run the frontend.

Be aware, that this'll require additional configuration/adaption and won't be officially supported. It is recommended to run the whole project as once.

🖼️ Preview

⚙️ Settings

Channel Mode

Direct

Directly uses the source stream. Won't work with most of the streams, because of CORS, IP/Device restrictions. Is also incompatible with custom headers and privacy mode.

Proxy (Preffered)

The stream requests are proxied through the backend. Allows to set custom headers and bypass CORS. This mode is preffered. Only switch to restream mode, if proxy mode won't work for your stream or if you have synchronization issues.

Restream

The backend service caches the source stream (with ffmpeg) and restreams it. Can help with hard device restrictions of your provider or synchroization problems (when your iptv channels have no programDateTime). But it can lead to longer initial loading times and performance issues after time.

FAQ & Common Mistakes

Which streaming mode should I choose for the channel?

Generally: You should try with direct mode first, switch to proxy mode if it doesn't work and switch to restream mode if this also doesn't work.

Proxy mode is most likely the mode, you will use! You will need restream mode especially when your iptv playlist has no programDateTime set and you want to have playback synchronization.

Error: Bind for 0.0.0.0:80 failed: port is already allocated

To fix this, change the port mapping in the docker-compose to X:80 e.g. 8080:80. Make also sure that port X is open in the firewall configuration if you want to expose the application.

Contribute & Contact

Feel free to open discussions and issues for any type of requests. Don't hesitate to contact me, if you have any problems with the setup.

If you like the project and want to support future development, please leave a ⭐.