Repository navigation
1.4.7
New to Rebel IPTV? Visit rebeliptv.com for a step-by-step guide to installing and setting up your instance.
What's New
New
- See how a stream is holding up. Turn on Settings → Playback → Stream stats to show a panel under the player on a channel's or game's page while you watch: how much of the stream is buffered (on your server and in your player), how fast its source is delivering, how far it has fallen behind, and how many are watching.
- Poster art for games in your guide. Every game now comes with a movie-poster-style image as well as its wide banner. Jellyfin shows the poster as the game's artwork, and Jellyfin 12 also uses the banner as the background of the game's page.
- Stop a stream from the dashboard. Every row under Now Watching now has a stop button. It ends that stream at once for everyone watching it — handy for a browser tab or TV left playing in the background. The dashboard's player won't quietly reconnect to it, and you can choose the channel again straight away.
- Multiview is easier to fill and nicer to watch. Choosing what to put on a screen now opens a browser: search by name, number, show or team; tabs for games on now, channels and your recent picks; category and country filters; and every channel shows what it is airing with how long is left. Feeds already on another screen are marked, and a screen's channel can be changed without removing it first. Double-click a picture to make it large, with the others beside it (under it on a phone); click a small one to swap it in, and double-click the large one, or press Esc, to go back to the grid. Clicking a picture still moves the sound to it; mute from its speaker button.
- A channel that takes a moment to start now says so. Instead of a blank screen while your server fetches the channel, you see a "Connecting to your channel" card, in the dashboard and in Jellyfin, Plex and your other apps, and the channel takes over as soon as it is ready. Channels that start straight away go straight to the picture.
- The waiting cards have a new look. The reconnecting, stream limit, no game scheduled and game coming up cards now carry the Rebel IPTV design.
Playback
- Channels play smoothly from the start. A channel could show its first picture and then freeze for several seconds while the rest of its buffer sat unused on your server. On some channels the buffer was thrown away as the channel started, so playback ran with none at all and every hiccup showed up as a stall. Every channel now keeps its full buffer, and it reaches your player in time.
- Channels and games now buffer the same way. A channel used to buffer 5 seconds and a game 30, on top of your setting, so games took far longer to open than channels. Every live stream now buffers 15 seconds by default, enough to ride out a slow source's hiccups. To buffer more, turn on Add extra buffer under Settings → Playback → Stream buffering and set Extra seconds to buffer: the extra seconds are added to the 15, so 15 means every stream holds 30 seconds, and the total shows as you change it. A stream whose source can send ahead still starts as quickly as before; one whose source only sends in real time takes about as long as its buffer to start.
- Fewer long freezes when a channel's source falls behind. When a source fell behind and then skipped ahead, players froze at the jump, and the skip hid the slowdown from the check that moves a channel to a working source, so a struggling channel could stay frozen for minutes. Your server now plays straight across a skip and notices a failing source within seconds. A channel also no longer jumps back to replay the last few seconds you just watched.
- Some channels no longer glitch, or freeze in the web player on a Mac. On some channels your server damaged a frame about once a second. Most apps showed that as a brief glitch, but on a Mac the web player froze at the first damaged frame until it reconnected, which could happen every minute or so. Every frame now arrives intact.
- Channels offered in several qualities play the best one. Such a channel played whichever quality its source listed first, which on some channels was the lowest (384×216). It now plays the best available, up to 1080p.
- Games open in your apps at the same time as on the dashboard. Tuning a game's channel before it opens (an hour before the start for most leagues) now shows the "coming up" card, like your favourite-team channels, instead of a player spinning on a stream that isn't live yet. The channel opens on its own when the time comes.
- Channels from the Rebel relay get the reliability fixes described in 1.4.6. They were left out of that release by mistake. A relay channel no longer gives up and shows the reconnecting card while the relay is still switching to a working source, the picture no longer breaks up when the relay switches source behind a channel, and a channel whose access quietly expired now recovers on its own instead of needing a restart.
- The dashboard's player no longer goes silent when a channel's sound changes. Some sources come back from a reconnect with their sound in a different format, and the player kept the picture but played no sound until you tuned away and back. It now restarts at the moment the sound changes and carries straight on from what your server has already buffered, so the sound returns after a blink instead of a wait. This covers channels from the Rebel relay too, where it happened most.
- The dashboard's player no longer stalls and reconnects every minute on some channels. On channels whose stream reconnects to its source every minute or so, each reconnect handed the player a few seconds of picture it could not decode, so the web player (on a Mac especially) froze and reconnected every time. Each one now picks up cleanly from the next complete picture.
- A channel no longer freezes for half a minute when its source switches mid-stream. Some sources move a stream to a different encoder without warning, and your server sent the next half minute or so of the channel stamped as a single instant, so the picture froze, the sound could go silent, and your player had to reconnect. Your server now picks the switch up where it happens and carries straight on.
Channels
- Channels play from working sources only, and show offline as soon as none works. A source already known to be down is no longer tried while another of the channel's sources works, and one that won't start when you tune in is marked down on the spot. A channel left with no working source goes offline straight away instead of at the next check. When a check finds it working again, it comes back online and plays straight away, instead of showing online but not playing until the next refresh.
- A provider turning away one connection no longer marks a channel offline. If a provider turned away, or hung up on, the first connection your server tried, the channel was marked offline — or skipped for five minutes when you pressed play — even though the provider would have served it on the next try. Your server now tries again before giving up, and stops trying first with a connection that keeps getting turned away.
- Online status stays current on large channel lists. When one of the many servers behind a channel list asked to be checked less often, every channel on that list was checked less often, so their online status could be hours out of date. Now only the channels on that server are checked less often.
- ABC, CBS, NBC and FOX now go offline with your local station. These four play your home market's station, but they stayed online, and in your playlist, while it was off the air, so choosing one only brought up the off-the-air card. They now go offline when your station does and come back with it.
- A channel no longer hangs on a source that has gone silent. When one of a channel's sources stopped answering altogether, your server waited nearly half a minute on it before trying the next, so the channel took up to a minute to open. It now moves on after a few seconds.
- A channel no longer plays a different channel. When a source's listing for one channel actually led to another channel's broadcast, your server played the wrong channel under the right name. It now spots two channels leading to the same broadcast and skips that source for both until the listing is corrected; each channel keeps playing from its other sources.
- Many channels have their backup sources back. One of the channel lists your server reads started sending its channels a page at a time, and your server was reading only the first page, so dozens of channels lost a backup source. Your server now reads every page.
- Channels from your own playlist no longer point at a logo that doesn't exist. A channel you added from your own playlist without a logo was given a logo address that could never load, so apps such as Jellyfin kept retrying it and the dashboard showed a broken image. Such a channel now has no logo in your playlist and guide, so your apps show their own placeholder and the dashboard shows its usual one.
Your setup
- Refreshes use far less memory. While refreshing its channels, your server held each provider's whole channel list in memory, and some lists run to hundreds of MB. A refresh could briefly need several GB, enough to slow a small machine down or get the server stopped for running out of memory. It now reads each list as it downloads, and a refresh needs a few hundred MB at most.
- Update now and Restart Server work when your server shares a VPN container's network. If your server runs inside another container's network (for example
network_mode: service:gluetun), both buttons and automatic updates acted on that container instead. They updated or restarted the VPN container, which cut your server off from the network and left it on its old version. They now act on your server.
Update
Already running Rebel IPTV? Update to this version — your data (the iptv-data volume) is kept. From the dashboard, click Update now on the Dashboard or in Settings → Server (on the :latest image with the Docker socket mounted). Or from the command line:
docker pull rebeliptv/iptv:1.4.7
docker compose up -dSetting up a new instance? The step-by-step guide at https://www.rebeliptv.com builds a Docker configuration for your system — ports, timezone, in-app updates, and more — so you copy a setup that fits your box instead of a generic one.
Image: rebeliptv/iptv:1.4.7 (also published as rebeliptv/iptv:latest).
Endpoints
| URL | Description |
|---|---|
http://<server>:8080/playlist?key=YOUR_KEY |
M3U playlist |
http://<server>:8080/epg?key=YOUR_KEY |
EPG guide (XML) |
http://<server>:8080/epg.gz?key=YOUR_KEY |
EPG guide (gzip) |
http://<server>:8080 |
Web dashboard |
Note: The
?key=parameter is only required if an API key has been generated in the web dashboard under Settings.