Setup & troubleshooting
Start here on your first launch, or jump to the issue you are seeing.
Your first session
- Sign in to the dashboard, download your Ruby loader, and run it once.
- Finish browser pairing and keep Ruby open while it prepares your PC. Approve the driver installer if prompted.
- Open Fortnite, select Windowed Fullscreen in Video settings, and apply. Close OBS if opened.
- When the dashboard says it is ready, click Inject, then return to Fortnite.
Returning user? Launch the same loader, open Fortnite, and inject. Your settings and cached engine are saved.
Fortnite is in Fullscreen, or the overlay is missing
- In Fortnite, open Settings → Video → Window Mode. Select Windowed Fullscreen and apply the change. Fullscreen and Windowed Fullscreen are different options.
- Return to the game and keep it visible. If capture failed, return to the dashboard and choose Retry Inject, then switch back to Fortnite.
- If capture is running but the overlay is still missing, check that the overlay is enabled in your dashboard settings.
It does not work on the first launch
- Check the setup message first. Downloads and the first engine build can take several minutes. Keep Ruby open while progress is changing; later launches reuse the saved files.
- Approve the Windows driver installer prompt if it appears. Check the taskbar if you cannot see it. If installation asks for a restart, restart Windows before trying again.
- Once setup is ready, open Fortnite, use Windowed Fullscreen, close OBS if opened, and click Inject. A capture failure offers Retry Inject without restarting Ruby.
- If the app remains unresponsive, use Close desktop app, wait for it to exit, and run the Ruby loader again. If the website cannot reach it, end ruby_vision_app.exe in Windows Task Manager, then launch the loader once and inject again.
Gateway timeout or desktop app not connected
- Not connected means the website cannot currently confirm the desktop connection. It does not prove the desktop process has closed.
- If Ruby is already open, leave it running for about a minute while it reconnects. Check your internet connection, especially after sleep or changing networks. If the website says its live status connection was lost, it reconnects automatically too.
- If the problem continues, reload the dashboard and check that the browser and desktop pairing use the same account. Finish any pending sign-in or pairing prompt.
- If a version mismatch is shown, close Ruby and run the loader to update. Download the current loader from the dashboard if prompted. Reinstalling repeatedly will not fix a server outage; report persistent failures with the exact message and time.
Inject fails or no captured frames arrive
- Wait until Fortnite reaches its lobby. Use Windowed Fullscreen, apply, and keep the game visible.
- Close OBS before injecting; its capture hook conflicts with Ruby's. You do not need to install or launch OBS to use Ruby.
- Read the error beneath Retry Inject and follow that specific instruction. Only run Ruby as administrator if the error says the game is running with higher privileges.
- Retry Inject after fixing the cause. If repeated retries fail, close Ruby, restart Fortnite, and try again with the game visible.
Capture works but aim does not move
- Confirm aim is enabled and check your activation key and current weapon settings in the dashboard.
- If the driver installation was canceled or failed, close Ruby and relaunch the loader to retry. Approve the installer prompt and restart Windows if requested.
- If it still fails, share the startup error with support. Avoid deleting the engine cache or resetting your linked device as a first step; neither repairs a missing controller driver.
Still stuck?
Contact support with the exact error, when it happened, your GPU, and whether this is your first launch. For crashes or fatal startup errors, paste %LOCALAPPDATA%\RubyVision\logs into File Explorer and look for last-crash.log. Only share it privately with support after checking its contents.