Repository navigation
1.5.0
New to Rebel IPTV? Visit rebeliptv.com for a step-by-step guide to installing and setting up your instance.
What's New
A new look for the whole dashboard, with a setup wizard and new pages for your channels, the guide, sports, games, fight cards and race weekends; your channels numbered 1, 2, 3, country by country if you like, and led by your home market's own networks wherever you live; league channels, so Plex keeps your games; and a guide that carries on when its listings stop updating.
Rescan the tuner in your app after you update. Your channel numbers change: they now count only the channels that are on (see Your lineup).
The dashboard
- A new look. The dashboard now has the colours of rebeliptv.com, in dark and light: deep navy with a blue accent, or a cool light grey by day. Buttons are rounder, corners are softer, and the menu bar lets the page show through as you scroll, with a blue line under the page you're on.
- A setup wizard that gets you watching in minutes. Setting up a new server now takes five short steps. Choose where your channels come from, your local stations, countries and live sports on one page. Add a sign-in for the dashboard and a key for your playlist, now or later. Then pick your app (Jellyfin, Plex, Emby, Channels DVR or another) and follow its numbered steps, with a Copy button beside every address you paste in; if you added a key, the addresses already include it. Or take the recommended settings on the first page and skip the channel choices.
- A new Channels page. Every channel is a tile with its logo and the show on now, with a progress bar and the time left, or what's on next; or switch to a list. Search, filter by country, market, status or category, and the rows always fill the width of your screen: showing more adds whole rows, and the end of the list says so. Play takes you to the channel's page and starts it playing there.
- A new Guide. The Guide opens on what's on now and next, with buttons for today, tomorrow and the days after, and chips to show one category. Click a show that's coming up to see its description, its times and what follows on that channel; a show that's on now still opens its channel. Each show's episode title is shown, and on a phone the details slide up from the bottom.
- A new channel page. A channel's page puts the player first, with the channel's schedule a day at a time under it, what's on now and next beside it, and a few more channels like it, different each time you open it: for a local station, others from its own city. Add to Multiview opens the channel there, and Copy stream link copies the address your player app opens it at.
- Easier on a phone. On a phone, the dashboard's pages sit in a tab bar along the bottom of the screen, as in a phone app, with More for the rest.
- Multiview's Recent tab keeps the past week. A channel or game you haven't put on a Multiview screen for seven days now drops off the Recent tab, so it lists what you watch now. A channel you open there with Add to Multiview on its page is listed too.
- The dashboard on a Sports-only server. With Sports only on (Settings → Sports), the dashboard is now your home page too, with the Sports page beside it in the menu. It shows what's playing, the games live and coming up and how your server is doing, counting games where it counted channels. Before, Sports only put the Sports page in its place.
- A game under Most watched opens its own page. It opened a channel page that doesn't exist. It now opens the game's page, with the game's logo, and offers Play only while the game is on.
Your lineup
- Your channels are numbered 1, 2, 3, counting only the ones that are on. Your apps get your channels numbered straight through from 1 in your lineup's order, with no gaps: a channel you turn off has no number, and the channels after it move up, while one that's only offline keeps its number. Typing a number on the lineup page moves the channel there, a channel that's off keeps its place in the list, and with On picked you can drag just the channels that are on. Your channel numbers change when you update, so rescan the tuner in your app afterwards.
- A new lineup page. Settings → Channels → Manage lineup now runs country by country, in your country order, each country headed by the numbers its channels run through, under a bar of all your numbers where a click on a country shows it alone. Click a channel's number to type a new one, or drag the channel within its country. Filter by the channels that are on, turned off, offline or renumbered, by country, market or category, and a channel that shares its number with another says so. With Group channels by country off, it's one list.
- Moving a channel renumbers only the channels it passes. Dragging a channel on the lineup page renumbered every channel after it, and marked them all renumbered. Now only the channels between where it was and where it went change number, and typing a channel's own number gives it back its own.
- Your channels by country, numbered in your order. Turn on Group channels by country under Settings → Channels → Numbering, and your apps get your channels country by country, in the order of your countries under Countries (drag them into the order you want). Your home market's networks come first, from 1, and then each country's channels follow on, numbered straight through below 4000, and the Countries list shows each country's numbers. Your playlist groups the channels under their country too. Turning it on renumbers your channels, so rescan the tuner in your app afterwards.
- A home market outside the US leads with its own networks. Choose a home market in another country, such as Sydney, and that country's main networks lead your lineup with the first channel numbers, playing that city's stations, as ABC, CBS, NBC and FOX play your city's stations in the US, whatever order your countries are in. The home market's country also comes first in the country lists until you order them yourself, and the help under Home market names your country's networks.
- Only your home market's networks show. The main networks of the other countries in your lineup are for their own home markets, so they're left out: with Sydney as your home market, ABC, CBS, FOX and NBC from the US, and CBC and CTV from Canada, leave your playlist, guide and dashboard, while the rest of those countries' channels stay.
- Your home market's networks stay at the top, and go on and off with their station. On the lineup page (Settings → Channels → Manage lineup), your home market's networks are pinned: they always lead your lineup, so they can't be dragged or renumbered, and nothing can be dragged above them. Each says which local station it plays and has no switch of its own: turn the station off, and its network goes off with it everywhere. A network you'd turned off is back after you update, and a station you'd turned off takes its network with it.
- No home market, if you'd rather number your own stations. Choose None under Settings → Channels → Local stations → Home market, or in the setup wizard, and no main network leads your lineup or plays a city's station: ABC, CBS, FOX and NBC, and every other country's main networks, leave your playlist, guide and dashboard, so your own channels start at 1. Your local stations stay, as channels you turn on and number yourself. Rescan the tuner in your app afterwards.
- Auto picks a home market outside the US. With your home market on Auto, a server whose time zone is in Australia now gets an Australian city, where it got New York before. A server in the US gets the same city as before.
- Markets listed by country. Every list of markets, under Home market, in the setup wizard and in the Channels and lineup pages' filters, groups its cities under their country, in the order of your countries.
- Find a country's shows in the Guide. When your lineup has more than one country, the Guide has the same country buttons as the Channels page: All, or one country's channels. The category chips follow the country you pick.
Sports
- League channels, so Plex keeps your games. Plex remembers the channels it found when you set it up, and a channel per game changes every day, so Plex lost track of your games from one day to the next. Turn on League channels under Settings → Sports and each league you follow gets its own set of channels, such as NHL 1 to NHL 16, in place of a channel per game. Each day's games go onto them at the start of the day, in kickoff order, with their listings and artwork, and keep their channel all day; a game plays once its stream is found. The channels themselves never change, so Plex pairs them once. A channel shows the game it's carrying as its logo, and its own logo with its league and number when it has none, and the leagues list shows each league's channel numbers. Rescan the tuner in your app after turning it on. Jellyfin changes a channel's logo when it refreshes its guide, once a day unless you set Refresh Guide under Scheduled Tasks to run every hour.
- Put your leagues in your own order. Drag the leagues under Settings → Sports into the order you want. The Sports settings and the favourite-teams page list them that way, and with league channels on, the first league's channels get the lowest numbers. A league added later goes at the end, so it never moves yours. After moving a league with league channels on, rescan the tuner in your app.
- A new Sports page. Games that are on come first, then today's, tomorrow's and the days after. Each card shows both teams with their records, the score and the clock while a game is on, and a Watch button once it can be played. Filter by status or league, or pick My teams to see only your favourite teams' games. Games and event sports, such as fight cards and races, share the one page, in start order, so nothing is a tab away.
- A new game page. A game's page opens on a scoreboard in the two teams' colours, with the score by period, the venue, the weather and where to watch. Under the player, everything about the game is in tabs: the summary, the box score, team stats, standings and game info. Beside the player you'll find what's happening right now, the game's stars and the key team stats, or the preview before it starts.
- A new fight card page. A fight card's page now opens on the fight that's on: both fighters with their flags, records and belts, and the round with the time left in it. Between fights it shows the next one up, and before the card the main event. Beside the player is the night's running order, from the early prelims to the main event, with who won, how and in which round, and where the card is now. Pick any fight to see its tale of the tape under the player (age, height, reach and stance), the fighters' career numbers going in, and the fight's own stats once it starts: knockdowns, strikes, takedowns and control time. Hide results keeps every winner, finish and stat out of sight until you ask for it, and your browser remembers the choice.
- A new race weekend page. An F1 weekend's page now opens on where the weekend is: the race under way with its lap and who leads, how it finished, or the next session and when it starts, with the leader, the winner or the pole sitter beside it and their car number in their team's colour. Beside the player is the timing: during a race the running order with each car's pit stops; after it the classification with the points each driver scored; before it the starting grid from qualifying. Under the player, tabs hold the weekend's sessions, the race and the sprint, qualifying with each part's times and where each cut fell, the practices, both championships with what the weekend brought, the season with the title fight round by round and the calendar with every winner, and the circuit.
- A game keeps its channel number all day. A game's channel number was its place among the games your server had found a stream for, so the numbers followed the order streams turned up in rather than the schedule: a game with no stream yet took no number, the next game took it, and every number after it moved when that stream turned up or another game dropped out, so your app could show one game's guide on another game's number. Each day's games are now numbered in kickoff order, all of them, the first time the day is published, and keep their numbers all day. A game added later takes the next free number.
- A game opens on time after your server restarts. Your server finds a game's feeds during its hourly refresh, and a restart waited for the next one, so a server restarted in the hour before a game could open it with nothing to play, sometimes until after kickoff. When a game is about to open without a feed, your server now looks for its feeds as soon as it starts.
- A game keeps playing after the final whistle. On some servers, a game's player on its page stopped the moment the game ended, cutting off the postgame. It now plays on until the game's postgame is over, as its channel in your apps already did.
- A game's page turns live when the game starts. Before a game, its page refreshed only every five minutes, so it could show the pregame for up to five minutes after kickoff. From five minutes before the start until the game is under way, it now checks every few seconds.
- Team colours on a game's page are each team's own. The bars and dots that tell the two teams apart could draw a team in plain grey when both teams' colours were dark, such as the Jets against the Patriots, in light and dark mode alike. Each team now keeps its own colour, brightened just enough to read on the page, and when two teams' colours really do clash, the away team uses its second colour instead of grey.
- Teams that no longer play leave your favourites. A favourite team that no longer plays drops out of your favourite teams and its channel goes. With league channels on, its league also gives up the channel it needed once no game is on it; rescan the tuner in your app afterwards.
- Search your apps for F1 to find a race. A race's channel and its listings in the guide were named only after its sponsor and its country, such as "MSC Cruises United States Grand Prix", so searching Jellyfin for F1 found nothing. They now start with F1: "F1 MSC Cruises United States Grand Prix". A fight card's name already says UFC, so it stays as it is, and a game is still named by its teams.
Channels and playback
- Jellyfin and Plex keep a channel's sound when it moves to another source. A channel's sources don't all send their audio in the same format. When a channel moved from one to another mid-show, Jellyfin and Plex lost the sound and the picture kept stalling until you tuned in again. Your server now converts the new source's audio into the format your app started with, so the sound carries on.
- Channels play again when a source's first connection stops working. A source's channels are reached through several connections. When the first of them stopped working, every channel from that source tried it and failed, and the source's channel list stopped updating, so a server set up since then had none of its channels. Your server now moves on to the source's next connection, both to play a channel and to update the list.
- Plex and your other apps ride out a channel's hiccups on a full buffer. A channel now starts in your apps only once your server has buffered all of it: 15 seconds, plus any Extra buffer under Settings → Streaming. A hiccup shorter than that is played out of the buffer and never reaches the screen. When a channel stops for longer and the buffer runs out, your apps get the Reconnecting card instead of nothing, which Plex used to give up on with a playback error, and the card stays until the buffer is full again, so the hiccups after it are covered too.
- Your guide no longer runs out when its listings stop updating. The guide now reads a second set of listings beside the first. When one stops updating, each channel's schedule carries on from the other as the first runs out, so the guide doesn't go blank, and it fills in channels the first doesn't list. Films on more channels show as movies, with their posters.
- A channel no longer keeps a stream its source stopped listing. When a source renamed or dropped a stream, the channel kept it for as long as the stream answered, sometimes under another channel's name. Your server now takes a stream off a channel once the source's latest list leaves it out, and keeps everything as it was when a list looks incomplete.
- Your apps get your changes straight away. After a refresh or a change in Settings, the next time an app asks for the playlist, the guide or the tuner's channels, it gets the new ones. The server could hand out a guide it had built up to 30 seconds before the change, and the playlist and the tuner didn't tell apps not to keep a copy. Jellyfin still keeps a guide it downloaded for an hour.
- Pictures stay up to date in your apps. Plex and Jellyfin keep a logo or a game's artwork by its link for good, so a league card, team card or game picture that changed, or wasn't up yet the first time your app asked for it, never updated. Every picture's link now changes each time your server refreshes, so your app fetches each picture again.
Your server
- A smaller image with only the server in it. The image no longer carries an operating system, so it's smaller and has nothing else to keep patched. Your time zone works as before, from
TZor a mounted/etc/localtime. A container console, such as the Console button in Unraid or Portainer, now has no shell to open. - A refresh says what it's doing, and how it went. While your server refreshes, the dashboard names each step in plain words (getting the latest channels, the sports schedule, finding more channels, reading your playlists, checking each channel and game, updating the guide), with a count where there is one ("282 of 445") and its place in the list ("Step 5 of 7"). Settings shows the steps as a checklist, with how long each took and about how long the running one has left. Afterwards the dashboard says when the refresh finished, how many channels are online and how long it took, or, if it stopped early, at which step, that what it finished is kept, with Try again. It also says when the next refresh is due.
- Your refresh schedule runs in your time zone. A
CRON_SCHEDULEwith an hour in it, such as0 3 * * *for 3 AM, ran on UTC time while the dashboard worked out the next refresh in yourTZ, so the two could be hours apart. It now runs in your time zone, at the time the dashboard shows; the default, every hour at half past, is unchanged in most time zones. The help beside Refresh now, under Settings → Overview → Refresh data, also says when your server refreshes by itself: every hour at half past, or on your own schedule, starting at a set time of its own up to 20 minutes after that, so that servers don't all refresh at once. - A restart no longer skips a refresh. Your server starts each scheduled refresh at a set time of its own, up to 20 minutes after the schedule, and restarting it in between, as an update does, skipped that refresh, leaving two hours between refreshes. That refresh now still runs, at its time.
- The Channels refresh refreshes all your channels. The Channels button under Settings → Overview → Refresh data got the latest channels from only some of their sources, skipped your own playlists and didn't check the channels it found, so a new stream stayed off for up to 5 minutes after it said it was done. It now does everything a full refresh does for your channels, in the same steps, so what it finds plays as soon as it finishes.
- Sports only refreshes just the games. With Sports only on, a refresh still fetched and checked every channel and its guide, though none of them are published. It now refreshes the games alone, in seconds, and turning Sports only off refreshes your channels straight away.
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 → System (on the :latest image with the Docker socket mounted). Or from the command line:
docker pull rebeliptv/iptv:latest
docker compose up -dOn an image pinned to a version, change its tag in your compose file to :1.5.0 and run docker compose up -d.
Setting 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.5.0 (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 → Security.