Test Entries

Username Password Server URL TVG-ID Actions

Health Check Endpoint

Use this endpoint with any HTTP monitoring tool — Uptime Kuma, Grafana, Prometheus, Home Assistant, or a simple cron script — to monitor stream availability. The endpoint skips the live stream test automatically when a proxy stream is already active, so it won't interrupt viewing.

Note: Each check opens a brief connection to your IPTV provider. Set your polling interval to 60 seconds or longer to avoid triggering provider rate limits or flooding the app with unnecessary requests.

Pick a reliable, low-priority channel. Set HEALTH_CHECK_TVG_ID in .env to make it permanent (then no ?tvg_id= needed).

Uptime Kuma / Grafana

Monitor type: HTTP(S) — JSON Query
URL: 
JSON Query: $.status
Expected value: ok
Interval: 60s or longer

"skipped" returns HTTP 200 and won't
trigger an alert while a stream is
active.

Home Assistant

sensor:
  - platform: rest
    name: IPTV Status
    resource: 
    value_template: "{{ value_json.status }}"
    json_attributes:
      - latency_ms
      - active_streams
    scan_interval: 60

Network Quality Test

Run a 5-test suite — latency, bandwidth, packet loss, stream pull, and jitter — against a provider's stream server. Results route through the VPN tunnel when active.

Run Network Test →