HydraIssues

hydraheadipad: reduce WireGuard stream bitrate from 25 Mbps to 20 Mbps for 3-stream event headroom
open improvement Priority: high Project: hydraheadipad Reporter: 21 May 2026 20:04

Description

## Context

With 3 simultaneous streams at 25 Mbps each, both the cloud-seven uplink (100 Mbps up) and the venue downlink (100 Mbps) run at 75% utilisation. Any burst or background traffic on either end will degrade all three streams simultaneously.

Dropping to 20 Mbps per stream brings both sides to 60%, adding enough headroom that streams can burst without affecting each other. Quality difference between 20 and 25 Mbps at 1080p60 H.264 is imperceptible for the Mercator Talks experience.

## Fix

In `hydraheadipad/Sources/HydraHeadiPad/Models/HeadConfig.swift` around line 50-55, change the WireGuard bitrate constant:

```swift
// Before
if host.hasPrefix("10.10.") { return 25000 }
// After
if host.hasPrefix("10.10.") { return 20000 }
```

Longer term: make this configurable from the cluster (body config or experience config) so it can be tuned per-venue without a build.

## Event context

Nerdland event 2026-05-22, dedicated 100/100 Mbps line at venue, bodies at cloud-seven (100 Mbps up SF Fiber Ultra). 3 concurrent streams expected.