Troubleshooting
Common issues and solutions for Spacerun.
Connection Problems
"Unable to connect to server"
- Check your internet connection and try loading a regular webpage.
- Restart your router or switch to a different network.
- If using a VPN, disable it and try again — VPNs can add latency or block UDP traffic.
High latency or frequent disconnects
- Switch from Wi-Fi to a wired Ethernet connection.
- Move closer to your Wi-Fi router or use the 5 GHz band.
- Close other applications or devices consuming bandwidth (video calls, downloads).
- Check your ISP for outages.
Video & Performance
Stuttering or frame drops
- Lower the stream resolution in Settings → Stream Quality.
- Ensure your device supports hardware video decoding (H.264 or HEVC).
- Close background apps that consume CPU or GPU resources.
- On mobile, disable battery saver mode — it throttles performance.
Blurry or pixelated video
- Increase the bitrate in Settings → Stream Quality.
- Ensure you have at least 15 Mbps download speed (35 Mbps recommended for 1080p+).
- Avoid networks with heavy congestion.
Black screen after launching a game
- Wait a few seconds — the first frame may take a moment to render.
- Try restarting the session from the game library.
- Update your GPU drivers to the latest version.
Audio
No audio during gameplay
- Check that your device volume is not muted.
- Verify the correct audio output is selected in your system settings.
- Restart the Spacerun app.
Audio delay or echo
- This is usually caused by high network latency. Try a wired connection.
- Disable Bluetooth audio and use wired headphones for lower latency.
Input & Controllers
Controller not detected
- Ensure the controller is connected via Bluetooth or USB before launching the app.
- Try re-pairing the controller in your device's Bluetooth settings.
- On Linux, ensure
gamepad/udevrules are configured correctly.
Input lag
- Use a wired controller connection instead of Bluetooth.
- Reduce stream latency by switching to a closer server region (if available).
- Close other apps that might be intercepting input events.
Mouse or keyboard not responding in-game
- Click inside the game window to ensure it has input focus.
- On macOS, grant Accessibility and Input Monitoring permissions to Spacerun in System Settings.
Account & Login
Cannot sign in
- Double-check your email and password.
- Use the Forgot Password flow to reset your credentials.
- Clear the app cache or reinstall if the issue persists.
Session expired
- Sign in again. Sessions expire after extended inactivity for security.
App Installation
Windows: "Windows protected your PC" warning
This is a SmartScreen warning for new or unsigned applications. Click More info → Run anyway to proceed. The Spacerun installer is safe.
macOS: "App is damaged" or "cannot be opened"
Run the following command in Terminal to remove the quarantine flag:
xattr -cr /Applications/Spacerun.app
Linux: AppImage does not launch
Make the file executable first:
chmod +x Spacerun.AppImage
./Spacerun.AppImage
Still stuck? Contact support and include your device model, OS version, and a description of the issue.