HZ-Television
{% embed url="https://www.youtube.com/watch?v=8FtW4lCHC2E" %}
Overview
HZ-Television turns every interactive screen on your FiveM server into a fully functional Smart TV — including wall-mounted TVs, curved cinema screens, vanilla GTA V huge billboards, and the dashboard of any vehicle via the CarPlay feature. Unlimited simultaneous screens, 14 video platforms, persistent account with favorites & history, real-time multi-player sync, and a free-cursor raycast interaction mode.Key Features
- Unlimited Multi-TV — no more 5-screen cap (removed in v2.3 with the DrawSpritePoly rendering engine). Every nearby TV can play its own content
- 9 original 3D props streamed with the resource — 3 wall TVs + 3 stand TVs + 3 curved cinema screens. No external packs required
- CarPlay (v3.2) — mount a Smart TV on any vehicle dashboard via the
hz_carplayitem + in-vehicle keyboard gizmo. 12 texture-isolated variants so every car gets its own independent content - Cabin audio occlusion (v3.3) — Web Audio pipeline inside the DUI simulates RAGE's native vehicle sound filtering (lowpass + bass shelf + per-door state)
- Cylindrical cursor raycast (v3.3) — true ray ↔ cylinder math for pixel-perfect clicks on curved cinema screens. Live preview overlay during
/tvcfg - SmartTV on billboards & cinema (v3.3) — every screen type runs the same Smart TV UI; render-target auto-detection fixes vanilla GTA V huge billboards
- Road-placement guard (v3.4) — opt-in red-outline preview blocks placing props on roads. CarPlay in-vehicle placement is exempt
- Abandon protection (v3.4) —
MaxPerPlayer+AutoCleanupDays+/tvcleanadmin command stop long-running servers from filling up with TVs owned by inactive players - Routing bucket aware — TVs and billboards are fully isolated per instance (jails, apartments, jobs, events)
- Real-time video sync — all players near the same TV see the same frame (5 s heartbeat, 1.5 s drift tolerance, 0.1 s precision, instant seek/play/pause)
- Account system + personal playlist — login from any TV, save favorites / history / per-user settings, build a looping queue with per-item duration
- LB Phone companion app (
lb-hztelevision) — remote any nearby TV from your phone, streamer-mode mute, local-media browser - Live
/tvcfgcalibrator — localized in en/fr/es/de (v3.3), reach distance 25 m for huge billboards
Supported Platforms (14)
- YouTube (videos + livestreams) · Twitch (native SDK) · Kick · Bilibili · Rumble · Odysee · Streamable · Facebook Video · Youku
- Direct video — MP4, WebM, OGG, MOV · M3U8 / HLS streams · Images (PNG / JPG / GIF)
- Browser mode (any URL) · automatic fallback: unknown URL → native video → browser iframe
Multi-Framework — Auto Detection
All framework / target / menu / notification / inventory detection is centralized in HZ-Bridge. Configure once there, every Hz-Script inherits.
| System | Supported Options |
|---|---|
| Framework | QBCore, QBox, 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 |
| Database | oxmysql (optional — required for account, playlist, TV persistence, abandon-cleanup) |
Performance
| Metric | Value |
|---|---|
| Client idle | \~0.01 ms |
| Client — 6 TVs on screen | \~0.03 ms (cached DrawSpritePoly) |
| Server | \~0.00 ms |
| Simultaneous TVs | Unlimited (no engine cap since v2.3) |
| Simultaneous CarPlays / client | 12 nearest rendered (unlimited placed) |
Requirements
- FiveM server (latest artifacts recommended)
- HZ-Bridge — latest version required — handles all framework / inventory / target / menu / notification detection. Older versions are missing exports HZ-Television v3.4 depends on, so always update HZ-Bridge when you update HZ-Television
- HZ-PropsCarplay — downloaded as a separate Keymaster asset alongside HZ-Television, ships the 12 CarPlay prop variants (split in v3.4 so CarPlay asset updates no longer touch the logic resource)
ox_lib(recommended) orqb-menu+qb-inputoxmysqlormysql-async— required for persistence, accounts, playlist,AutoCleanupDays. HZ-Television auto-detects which one is running (v3.4.1+) and works with bothox_targetorqb-target— optional (TextUI fallback available)lb-phone— optional (required for the phone remote applb-hztelevision)
Always update HZ-Bridge to the latest version alongside HZ-Television. HZ-Bridge is a free shared dependency and every Hz-Script release is tested against the latest Bridge build. Mismatched versions will surface as "export not found" or missing detection at boot.
Need help? Join our Discord and open a ticket in #support.