> ## Documentation Index
> Fetch the complete documentation index at: https://docs.streamly.watch/llms.txt
> Use this file to discover all available pages before exploring further.

# Live TV Plugin

> Live TV platform feature — icon, enablement flags, catalog tab, /live storefront, OpenAir prerequisite.

**Live TV** (`features.live_tv`) is a Streamly **plugin** in the **video** category.

Turns on the live channel catalog, admin management, and viewer `/live`. Playlist packs like [OpenAir](/addons/openair) require this plugin first.

## At a glance

| | |
| - | - |
| **Plugin ID** | `features.live_tv` |
| **Version** | 1.2.0 |
| **Capability** | `catalog.live_tv` |
| **Manage** | `/admin/catalog?tab=live-tv` |
| **Viewer** | `/live` |

## Capabilities

* `catalog.live_tv`

## When to use it

* Linear / live channel catalogs
* Free public packs via OpenAir
* Premium live tiers

## How it works

### How Live TV turns on

| Step | Action | Result |
| - | - | - |
| **1** | Enable **Live TV** in `/admin/plugins` | Unlocks live catalog + `/live` |
| **2** | Manage channels in `/admin/catalog?tab=live-tv` | Import, edit, premium flags |
| **3** | Optional: install [OpenAir](/addons/openair) | Free public channel pack |
| **4** | Open `/live` as a viewer | Storefront live experience |

APIs include `/api/v1/live/channels`, `…/import`, `…/dedupe`, `…/categories`, `…/public`, `…/openair/*`.

## Activation keys

Configure in `/admin/plugins` → **Live TV** → Configure. Secret fields stay server-side — never commit them or expose as `NEXT_PUBLIC_*` unless the key is intentionally public (e.g. Stripe publishable key).

| Key | Label | Default intent |
| - | - | - |
| `showInNav` | Show in storefront nav | Surface Live in theme nav |
| `signedInOnly` | Signed-in only | Gate `/live` |
| `heroAutoplay` | Hero autoplay | Autoplay on `/live` |
| `preferCountryLanguage` | Prefer viewer country language | Locale bias |
| `importPremiumDefault` | Import as premium by default | Imported channels premium |
| `skipDuplicateOnImport` | Skip duplicate channels on import | Dedupe imports |

All are optional booleans.

## Setup guide

<Steps>
  <Step title="Enable plugin">`/admin/plugins` → Live TV → flags → save.</Step>
  <Step title="Manage channels">`/admin/catalog?tab=live-tv`.</Step>
  <Step title="Optional OpenAir">Install [OpenAir](/addons/openair) and refresh.</Step>
  <Step title="Viewer check">Open `/live`.</Step>
</Steps>

## Admin & Settings paths

| Path | Purpose |
| - | - |
| `/admin/plugins` | Feature flags |
| `/admin/catalog?tab=live-tv` | Channels |
| `/admin/streaming-providers` | OpenAir pack |
| `/live` | Viewer experience |

## Official vendor documentation

* [Plugins Overview](/plugins/overview)
* [OpenAir Addon](/addons/openair)

## Related

* [OpenAir Addon](/addons/openair)
* [Live TV (Admin)](/admin-dashboard/live-tv)
* [Viewer Live TV](/viewer/live-tv)
* [Plugins Overview](/plugins/overview)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.