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 / udev rules 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.