লাইভ টিভি
AIO প্লেয়ারে ফ্রি লাইভ চ্যানেল, সঙ্গে আপনার নিজের প্লেয়ার বিজ্ঞাপন: HLS, DASH, MP4 ও ইউটিউব লাইভ, ক্যাটাগরি, প্রিয় চ্যানেল, টিভি রিমোটে চলাচল, M3U ইমপোর্ট-এক্সপোর্ট, স্ট্রিম টেস্ট, হেলথ চেক ও ঐচ্ছিক রিলে।
The Live TV plugin gives your members a TV section: live channels they watch for free in the AIO Player, with your own player advertisements from the Ads plugin instead of the stream's. It plays HLS (.m3u8), DASH (.mpd), MP4 files and YouTube live videos, works on phones, computers and smart-TV browsers, and is driven by a TV remote as easily as by a mouse.
Your responsibility. You must have the right to show every channel you add. Add only streams you own or whose owner allows others to show them. The three Demo channels are open test streams that Mux, Apple and Akamai publish for player testing, the importer takes any public M3U playlist you choose, and Add the popular free channels adds only free, official sources (see below).
What members get
- The Live TV page at
/live-tv(also in the side menu): a grid of channel cards with the logo, the name, the category and country, a red Live tag (or Offline when the last check failed) and how many people are watching right now. Above it a search box and category chips; for signed-in members a Your favourites row and a Recently watched row. - A channel at
/live-tv/<name>: the AIO Player with a Live badge, the channel bar (logo, name, category, country, language, N watching), previous / next channel buttons, Favourite, Full screen and All channels, and the list of every channel beside the player (below it on a phone). - When a stream does not play the player says This channel is not playing right now, marks it in the list and offers the next channel with a 10-second countdown (Stay here stops it). The failure moves the channel to the front of the next health check.
- Viewers watching now come from a heartbeat every 30 seconds; a viewer who leaves drops off after about a minute.
- Search: channels are a section of the site search and appear in the search suggestions.
TV remotes and keyboards
Every card, chip and button is focusable, and a small D-pad manager moves the focus with the arrow keys to the nearest card in that direction. OK / Enter plays the channel, Back / Escape closes the player and goes back to the grid. On the player page ↑ / ↓ (and the remote's Channel up / down or Page up / down) switch to the previous / next channel; inside the channel list the arrows move the focus instead.
Smart-TV browsers (Samsung Tizen, LG webOS, Android TV, Fire TV, Hisense VIDAA and others), and any address with ?tv=1, get the TV mode: big cards, the player over the whole screen, OK opens the channel list as a side panel, Back closes it. Browsers only allow real full screen after a key press or a touch, so the first key press switches it on.
Smart TV app
The plugin adds a Live TV row (up to 20 channels, opening in TV mode) to the Home of the Smart TV app of the Mobile Apps plugin through the tv_sections filter. The TV's Live TV tab shows one row per category (News, Religion, Education ...), and the TV's Search finds channels too.
Advertising
Live TV shows only your own ads - those of the Ads plugin's player slots - never the ads inside a stream. With the Ads plugin off there are no ads at all.
- Pre-roll: the player pre-roll ad plays before the channel starts.
- Mid-roll: a live channel has no length, so a clock runs instead: after every N minutes of watching (10 by default) the player mid-roll ad plays - the pre-roll ad stands in when there is no mid-roll ad - and the channel then jumps back to the live edge.
- The overlay and pause ads of the Ads plugin work as on videos.
Adding channels
Admin → Plugin pages → Live TV → Add a channel: the name, the stream address (HLS, DASH, an MP4 address, a YouTube video address or 11-letter id, or a YouTube channel - its UC... id or youtube.com/channel/UC.../live - which plays whatever that channel has live now through youtube.com/embed/live_stream?channel=UC... in the AIO Player's YouTube mode), the stream type (found from the address by default), the category, country, language, a short description, the address name, the order, Shown to the members and Play through the relay. The logo is an uploaded picture or a picture address. Save and test the stream saves and tests in one go.
The channels list has the tabs All, OK, CORS-blocked, Dead, Hidden, Turned off and Not checked yet, a search over names, addresses, countries and languages, a category filter, and per channel Test stream, Edit, Turn off / on and Delete. Tick several channels to test, turn on, turn off or delete them together.
Test stream
The test asks the stream from your server, as a browser on your site would, and reports:
| Result | Meaning |
|---|---|
| OK | The stream answers and allows your site to play it. |
| CORS-blocked | The stream plays for the server, but it does not allow other sites (no Access-Control-Allow-Origin header), so browsers refuse it. The relay can show it. |
| Dead | No answer, an error code, or the answer is not a playlist / manifest. |
YouTube channels are not asked; the test only checks that the id looks right.
Popular free channels
Admin → Plugin pages → Live TV → Add the popular free channels adds a set of well-known channels that are free and official: either the broadcaster's own public stream, or the broadcaster's own YouTube channel played live by its channel id. Never restreams or third-party playlists. Each one comes with its category, country, language and a plain initials badge as its logo (no broadcaster logos are copied). A channel is switched on only when its stream answers the test (a YouTube channel must be live at that moment); the others stay off until a later run finds them live. Pressing the button again adds nothing twice - it only tests the ones that are still off. On a new install, and on the update to Live TV 1.1.0, the list is added once by itself.
| Channel | Category | Country | Source |
|---|---|---|---|
| Al Jazeera English | News | Qatar | YouTube channel, linked from aljazeera.com/live |
| DW News | News | Germany | DW's own HLS stream from dw.com/en/live-tv |
| France 24 English | News | France | YouTube channel, its About page links france24.com |
| Sky News | News | United Kingdom | YouTube channel, linked from news.sky.com/watch-live |
| Euronews English | News | Europe | YouTube channel, linked from euronews.com/live |
| TRT World | News | Turkey | YouTube channel, linked from trtworld.com |
| CGTN | News | China | YouTube channel, linked from cgtn.com |
| NHK WORLD-JAPAN | News | Japan | YouTube channel, its About page links nhk.or.jp/nhkworld |
| NASA | Education | United States | YouTube channel, linked from nasa.gov |
| Somoy TV | News | Bangladesh | YouTube channel, its About page links somoynews.tv |
| Jamuna TV | News | Bangladesh | YouTube channel, linked from jamuna.tv |
| Independent TV | News | Bangladesh | YouTube channel, linked from itvbd.com |
| Ekattor TV | News | Bangladesh | YouTube channel, linked from ekattor.tv |
| DBC News | News | Bangladesh | YouTube channel, linked from dbcnews.tv |
| ATN News | News | Bangladesh | YouTube channel, its About page links atnnewstv.com |
| News24 | News | Bangladesh | YouTube channel, linked from news24bd.tv |
| Desh TV News | News | Bangladesh | YouTube channel, its About page links desh.tv |
| Saudi Quran TV (Makkah) | Religion | Saudi Arabia | The @SaudiQuranTv YouTube channel |
| Saudi Sunnah TV (Madinah) | Religion | Saudi Arabia | The @SaudiSunnahTv YouTube channel |
YouTube decides what an embedded live stream shows; some broadcasters block embedding in some countries. Check the terms in your country before you promote a channel, and turn off any you do not want.
Importing an M3U playlist
Admin → Plugin pages → Import M3U takes a playlist pasted into the box or fetched from an address. From each #EXTINF line it reads the name after the comma, tvg-logo, group-title, tvg-country and tvg-language (tvg-name when there is no name); #EXTGRP lines set the group of the channels after them. A group-title finds or makes a category of that name. Addresses already in the list are skipped, so importing the same playlist twice is safe; up to 5,000 channels at a time. Show the new channels right away off brings them in turned off so you can test them first.
Export M3U (on the same page and on the channels list) downloads every channel as one playlist with logo, group, country and language - a backup, or a list for another site.
Health check
The cron job Check Live TV streams runs every 30 minutes and tests a batch of channels (20 by default), the ones checked longest ago first. A dead channel shows Offline; after the number of failed checks in a row you set (5 by default) it is hidden from the members, and it comes back by itself when a later check finds it working. Run the health check now on the channels list runs a batch by hand. See Scheduled jobs for the cron line.
The relay (proxy mode)
Some streams refuse to play on other sites. With the relay switched on, those channels - the ones marked Play through the relay and the ones the test finds CORS-blocked - play through your own server at /live-tv/relay/<id>/...: the playlist is fetched by the server, every address in it (variants, segments, keys, audio tracks) is rewritten to a signed relay address, and the video pieces are passed on to the viewer.
Bandwidth warning. Every viewer's video then passes through your hosting twice (in and out). That can use a great deal of bandwidth and CPU, and many shared hosts do not allow it. The relay is off by default; use it for the few channels that need it and keep the caps low.
Caps: the largest piece relayed (8 MB by default) and the longest time for one piece (20 seconds). Relay addresses are signed, so the relay fetches only what a channel's own playlist points to. Tests, imports and the relay refuse addresses on the server's own network unless you allow them.
Settings
Admin → Plugin pages → Live TV settings.
| Setting | What it does |
|---|---|
| Who may watch | Everyone, visitors too or Signed-in members only (visitors then see the grid with a Sign in note). |
| Full screen on smart TVs | The TV mode for smart-TV browsers; ?tv=1 always asks for it. |
| Channels on a page | 60 by default. |
| Pre-roll / Mid-roll / Mid-roll every (minutes) | The player ads, see Advertising. |
| Relay switched on, largest piece, longest time | See The relay. |
| Channels tested on each run | The batch of the health check. |
| Hide a channel after this many failed checks | 0 never hides. |
| Allow stream addresses on the server's own network | For a stream server inside your own network only. |
Admin → Plugin pages → TV categories adds, renames, orders and deletes categories (a deleted category's channels stay, without a category). The plugin starts with Demo, News, Sports, Entertainment, Kids, Music, Education and Religion; only categories with channels appear as chips.
Packages
The plugin adds the feature Watch Live TV (live_tv.watch) to the package features. A Wallet package without it shows the member an upgrade card instead of the player; admins always watch.
Clean-up
Deleting a member removes their favourites and their recently watched list. Deleting a channel removes its uploaded logo, the favourites, the history and the viewer counts.