Features Gaming Quality

Gaming Quality Index

The Gaming Quality Index rates your connection's suitability for online gaming on a 0-100 scale with an A-F letter grade. It appears as a colored badge in the dashboard hero card.

How It Works

The index combines DOCSIS signal health with Speedtest Tracker latency data into a single score. Each component is weighted by its impact on gaming performance:

Component	Weight	Score Logic
Latency (ping)	25%	<20ms = 100, 20-50 = 80, 50-80 = 60, 80-120 = 30, >120 = 0
Jitter	20%	<5ms = 100, 5-15 = 80, 15-30 = 60, 30-50 = 30, >50 = 0
Packet Loss	15%	0% = 100, <0.5% = 80, <1% = 60, <2% = 30, >2% = 0
DOCSIS Health	25%	good = 100, tolerated = 75, marginal = 50, critical = 0
SNR Headroom	15%	>6dB above threshold = 100, 3-6 = 70, 1-3 = 40, <1 = 0

Grades

Grade	Score	Meaning
A	90-100	Excellent for all online games
B	75-89	Good for most games
C	50-74	Playable but may have occasional issues
D	25-49	Frequent lag and connection problems
F	0-24	Not suitable for online gaming

Without Speedtest Tracker

If Speedtest Tracker is not configured, the index only uses the DOCSIS components (health + SNR headroom, 40% of the full weight). The tooltip shows "DOCSIS only" to indicate that latency, jitter, and packet loss data is missing.

For the full score, set up Speedtest Tracker.

Enabling the Gaming Quality Index

The Gaming Quality Index is enabled by default. To disable it:

1. Go to Settings > Appearance
2. Set Gaming Quality Index to "Disabled"
3. Save

Or via environment variable:

GAMING_QUALITY_ENABLED=false

Dashboard Badge

When enabled, a colored badge appears in the hero card next to the channel count:

• Green (A/B): Good gaming conditions
• Orange (C): Fair gaming conditions
• Red (D/F): Poor gaming conditions

Hover over the badge to see the numeric score (e.g., "85/100").

Home Assistant

Two MQTT sensors are published automatically:

Sensor	Description
sensor.docsight_gaming_quality_score	Numeric score (0-100, unit: %)
sensor.docsight_gaming_quality_grade	Letter grade (A/B/C/D/F)

These sensors are available regardless of the web UI toggle setting.

Example Automation

automation:
  - alias: "Gaming Quality Alert"
    trigger:
      - platform: numeric_state
        entity_id: sensor.docsight_gaming_quality_score
        below: 50
    action:
      - service: notify.mobile_app
        data:
          title: "Gaming Quality: Poor"
          message: "Score dropped to {{ states('sensor.docsight_gaming_quality_score') }}/100 ({{ states('sensor.docsight_gaming_quality_grade') }})"