Your First Connection¶
This guide walks through connecting to your team's relay server for the first time.
Before You Start¶
You need:
- Latency Lab installed on your iOS device (App Store)
- A relay token from your team's administrator
Step 1: Open the App¶
Launch Latency Lab. You'll see the token entry screen.
Step 2: Enter Your Token¶
Paste or type your relay token. Tokens look like a long string of characters (32 characters), prefixed with a port number:
The port prefix tells the app which relay server to connect to. Your administrator will provide the complete token.
Step 3: Connect¶
Tap Connect. The app will:
- Parse the port and token
- Establish a WebSocket connection to the relay server
- Authenticate with your token
- Receive your team's branding (colors, name, logos)
- Theme itself to match your team
If the connection fails, check:
- Token is entered correctly (no extra spaces)
- You have an internet connection
- The relay server is running (ask your administrator)
Step 4: Explore the Interface¶
After connecting, you'll see three tabs accessible by swiping the score header:
Relay Tab¶
The main view. If you're a scout, this is where you'll report events using gestures. If you're a viewer, you'll see the live game visualization.
Feed Tab¶
A scrollable feed of all game events with timestamps. Tap any event for details.
Commands Tab¶
Access slash commands to query scores, stats, standings, and more.
Connection Status¶
The status bar shows your connection state:
- Connected (green) — Active WebSocket connection
- Reconnecting — Connection lost, attempting to reconnect (exponential backoff: 3s → 60s)
- Disconnected (red) — Connection failed after 20 attempts. Tap to retry.
Token Expiry¶
Tokens are valid for 24 hours. When your token expires, you'll need a new one from your administrator. The app will show a token expiry message.
Multi-Team Support¶
You can switch between teams by entering a different team's token. See Team Selector for details.