Add live stream connection health tracking and UI TCP timeout warnings - #147
Open
sappelhoff wants to merge 3 commits into
Open
Add live stream connection health tracking and UI TCP timeout warnings#147sappelhoff wants to merge 3 commits into
sappelhoff wants to merge 3 commits into
Conversation
sappelhoff
force-pushed
the
feat/stream-connection-diagnostics
branch
from
August 27, 2026 08:24
eec86a3 to
3b16f21
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
When stream discovery succeeds over UDP broadcast but establishing the TCP data connection fails or times out (e.g. due to Windows Firewall, multi-NIC/VPN routing like WireGuard, or unreachable remote ports),
in->open_stream()caughtlsl::timeout_errorand silently proceeded to record. The user received no visual feedback in the GUI, resulting in empty ~40 KB files containing only XML stream headers and zero sample chunks.Solution
StreamTelemetrytracker inrecordingto monitor per-stream TCP connection status and sample counts.connection_failed = truewhenin->open_stream()encounters a timeout error during stream subscription.MainWindow::statusUpdate(), surface an immediate warning banner in the status bar if any stream's TCP connection failed (or is offline/missing), alerting the experimenter in real-time.UI Preview
Recording to sub-001.xdf (00:02:15; 1420kb)Recording to sub-001.xdf (00:02:15; 40kb) | WARNING: Cannot connect to BioSemi (TCP timeout)Verification