# HZ-Television

{% embed url="<https://www.youtube.com/watch?v=j9Z1rJPSZkA>" %}

## Overview

**HZ-Television** transforms every TV prop on your FiveM server into a functional Smart TV. Your players can watch YouTube, Twitch, Kick and much more, directly in-game, with a multi-screen system that allows displaying different content simultaneously.

### Key Features

* **Multi-TV Support** — Multiple screens with different content simultaneously
* **Power ON/OFF** — TVs are off by default, players control them
* **Inventory Placement** — Place portable TVs anywhere
* **Billboard Support** — Large outdoor screens work the same way
* **Live Configurator** — Admin tool to calibrate positions with `/tvcfg`
* **Distance Audio** — Realistic volume that decreases with distance
* **Pre-recorded Channels** — Configure default channels
* **Database Persistence** — Optional saving of placed TVs

### Supported Platforms

* YouTube (videos & livestreams)
* Twitch
* Kick
* Vimeo
* Dailymotion
* Direct video URLs (MP4, WebM, M3U8/HLS)
* Images (PNG, JPG, GIF)
* Web browser mode

### Multi-Framework

HZ-Television **automatically detects** your server's resources and adapts!

| System            | Supported Options                                                                                                              |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Framework**     | QBCore, ESX, Standalone                                                                                                        |
| **Target**        | ox\_target, qb-target, TextUI mode                                                                                             |
| **Menu**          | ox\_lib, qb-menu + qb-input                                                                                                    |
| **Notifications** | ox\_lib, QBCore, ESX, native                                                                                                   |
| **Inventory**     | ox\_inventory, qb-inventory, qs-inventory, ps-inventory, codem-inventory, origen\_inventory, core\_inventory, tgiann-inventory |

### Performance

| Metric        | Value   |
| ------------- | ------- |
| Client (idle) | 0.01 ms |
| Client (peak) | 0.03 ms |
| Server        | 0.00 ms |

### Requirements

* FiveM Server (recommended build: latest)
* [generic\_texture\_renderer\_gfx](https://github.com/pongo1231/fivem-gfx-thing) **(required)**
* A menu system: ox\_lib (recommended) OR qb-menu + qb-input
* [oxmysql](https://github.com/overextended/oxmysql) (optional, for persistence)

***

{% hint style="info" %}
**Need help?** Join our [Discord](https://discord.gg/D2jMNswvBM) and open a ticket in the #support channel.
{% endhint %}

## Quick Navigation

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Installation</strong></td><td>Step-by-step guide to install HZ-Television on your server</td><td><a href="hz-television/installation">installation</a></td></tr><tr><td><strong>Configuration</strong></td><td>Customize TV models, permissions and channels</td><td><a href="hz-television/configuration">configuration</a></td></tr><tr><td><strong>Exports &#x26; Events</strong></td><td>Integrate the TV system into your own scripts</td><td><a href="hz-television/exports">exports</a></td></tr><tr><td><strong>FAQ</strong></td><td>Answers to frequently asked questions</td><td><a href="hz-television/faq">faq</a></td></tr></tbody></table>