Setup Guide
- Quick Setup
- First Time Use
- Adding Favourites
- Pause and Resume
- Using the Options Screen
- Starlight Client Setup Instructions
- Additional Requirements for HDR Streaming
- Keyboard/Mouse/Gamepad Input Options
- Adding Programs not Automatically Added
- Using Starlight to stream your entire desktop
- Using AAudio and AC3 Surround Sound
- Frequently Asked Questions
- Troubleshooting
Host Gaming PC Requirements
For Sunshine:
- Any modern GPU from AMD, NVIDIA and Intel
- Windows 10 or 11 (Windows 7 and 8 are not supported)
- macOS 12 and newer (experimental)
- Linux (Debian 11, Ubuntu 22.04, Fedora 38 and newer)
There are additional host PC requirements for streaming HDR content.
Quick Setup Instructions
Using Sunshine
- On your gaming PC, install the latest version of Sunshine from the setup page. Your PC may need a reboot after installation to finish setup and for controller emulation to work.
- Start Sunshine and wait for the configuration page to open in your web browser. Your browser will show a "this page is not secure" error that you can safely ignore. You can access this interface manually by using the "Open Sunshine" option of the tray menu or by opening the Sunshine web interface directly in your web browser.
- The first time Sunshine starts, it will ask you to create an account to secure access to the configuration interface. This is important, as anyone with access to this interface can add new clients to access your computer remotely.
- Start Starlight and make sure your client is connected to the same network as your PC. In most cases, your gaming PC should show up automatically in the PC view after a few seconds. You can also add a computer manually by entering its IP address if it doesn't show up automatically.
- Click the entry in the PC list to start pairing. Sunshine should send a pairing notification on your host PC, redirecting you to the Pin page. There, enter the PIN displayed in Starlight and submit the pairing dialog. If you get an error after submitting the PIN form, try the troubleshooting steps here.
- Try streaming a game or app to make sure everything is working. If you encounter issues, try the troubleshooting steps here.
- You can manually add other games and apps by following Sunshine's guide to adding apps.
- Start Starlight and make sure your client is connected to the same network as your PC. In most cases, your gaming PC will show up automatically in the PC list after a few seconds. Click the entry in the PC list to start pairing.
- On your PC, enter the PIN displayed in Starlight and accept the pairing dialog. If you don't see a pairing dialog, try the troubleshooting steps here.
- Try streaming a game or app to make sure everything is working. If you encounter issues, try the troubleshooting steps here.
- If you don't see the game you want to stream in Starlight , you can add it manually. You can also stream your desktop and launch anything you want.
Firewall Setup
If you are not able to stream when connected to the same network as your gaming PC, you may need to add firewall rules to stream successfully. First, try disabling the firewall software on your gaming PC (usually Windows Firewall or a firewall integrated into your anti-virus software) to confirm it's a firewall-related problem.
Windows Firewall
- Open a Command Prompt or PowerShell window as administrator
- Run the following 2 commands:
netsh advfirewall firewall add rule name="GameStream UDP" dir=in protocol=udp localport=5353,47998-48010 action=allow
netsh advfirewall firewall add rule name="GameStream TCP" dir=in protocol=tcp localport=47984,47989,48010 action=allow
- Ensure your PC now appears online in Starlight
Other Firewall Software
For other firewall products, you should follow their instructions to create exceptions for the following ports:
- TCP 47984, 47989, 48010
- UDP 5353, 47998, 47999, 48000, 48002, 48010
Starlight Client Setup Instructions
Client Requirements
- Android/Google TV device running Android 9 or newer. Newer and "flagship" devices with higher processor speeds are more likely to be able to handle Starlight well by using the hardware video system on the device to produce smooth streaming without video stuttering or freezing.
- PC: Windows 10+. Your PC should be new enough that it supports hardware-accelerated H.264 video decoding, otherwise it will have to use CPU decoding. Most modern PCs should work fine, though older PCs may not be able to stream at 60 FPS without lag.
Internet and Network Requirements
To have a good experience, you need a mid to high-end wireless router with a good wireless connection to your client device (5 GHz WIFI 5 (802.11ac) or WIFI 6 (802.11ax) strongly recommended) and a good connection from your PC server to your router (Ethernet/wired connections highly recommended).
Setup First Time Use
- Pair your PC with Starlight, see here .
- Select your PC, you will be presented with a progress screen, this is downloading required data from IGDB, when complete you will see the app list.
- If you want the full details UI, go to Starlight settings and enable the Leanback UI.
Adding Favourite's
When viewing the Leanback UI you can add games or apps to favourites:
- Long press the selected item, on the context menu select Add to Favourites.
- To remove repeat above and uncheck Add to Favourites.
Once added to favourites a new icon will appear on the main menu where you can view your favourites and start streaming.
On Android TV devices this will also add a channel to your Home Screen, from there you can launch the game without opening Starlight.
On Google TV devices this Home Screen option is currently unavailable.
Pause and Resume Games
On Android TV devices when streaming, you can on back press PAUSE or QUIT the streaming session. When you pause the session Android TV will add the session to the play next row so you can easily resume the session, quitting the session will remove the session from the row, if you accidentally press the Home key on your remote Android TV will add the session to the play next.
On Google TV devices the watch next option is currently unavailable.
Using the Options Screen
When viewing the options screen you will see various options.
- Settings: Will open the main settings.
- HDR: With this you can toggle on or off, only available if HDR requirements met .
- Cache: Here you can see the size of the cache, selecting this will give you the option to clear the cache.
- Clear Favourites: Selecting this will clear all favourites from the app and Android TV Home Screen.
- Support: This will open the support website.
- Database: Selecting this gives you the option to delete all game data and reload the database.
- Exit: Exit the app.
Additional Requirements for HDR Streaming
If the HDR requirements are not met, the HDR option in Starlight will not appear at all.
Known issues with GameStream HDR:
- Running some games and applications may cause flashing colour artifacts when HDR streaming is enabled
- The video stream may not start until you move or click the mouse when HDR streaming is enabled
- You may see video scaling artifacts if the stream resolution doesn't match the host display resolution when HDR streaming is enabled
- If HDR is already enabled on your host PC when streaming starts, you may need to toggle HDR off and back on for the stream to enter HDR mode properly
Host PC requirements for HDR streaming
For a host using Sunshine:
- A Windows host with NVIDIA, AMD, or Intel GPUs that support encoding HEVC Main 10
- An HDR-capable display or EDID emulator dongle connected to your host PC
- Some newer games may require an HDR display or HDR10-compatible EDID emulator dongle connected to your host PC for HDR options to be available
- The stream resolution in Starlight should be set to match the host PC's display resolution to prevent video scaling artifacts
Android client requirements for HDR streaming
- Android 9.0 or later
- HEVC Main10 hardware decoder
- HDR10-compatible display
Windows client requirements for HDR streaming
- Windows 10 1703 (Creators Update) or later
- HDR10-compatible display
- Client GPU must support both HEVC Main10 decoding and HDR10 output
- For Intel GPUs, this is 7th-generation (Kaby Lake) iGPUs and later
- For NVIDIA GPUs, this is 1000-series (Pascal) GPUs and later
- For AMD GPUs, this is RX 400-series (Polaris) GPUs and later
- HDR toggle in Windows must be enabled for streaming in windowed mode
Keyboard/Mouse/Gamepad Input Options
PC client
PC clients support keyboard, mouse, and touchscreen input and up to 4 game controllers (with mappings for most common gamepads included).
- Ctrl+Alt+Shift+Q - Quit the streaming session (leaving the game running on the host PC)
- Ctrl+Alt+Shift+Z - Toggle mouse and keyboard capture
- Ctrl+Alt+Shift+X - Toggle between full-screen and windowed mode
- Ctrl+Alt+Shift+S - Open performance stats overlay (not supported on Steam Link or Raspberry Pi)
- Ctrl+Alt+Shift+M - Toggle mouse mode (pointer capture or direct control)
- Ctrl+Alt+Shift+V - Type clipboard text on the host
- Ctrl+Alt+Shift+D - Minimize the stream window
- Ctrl+Alt+Shift+C - Toggle local cursor display in remote desktop mouse mode (remote cursor will always show up due to GameStream limitations)
- Ctrl+Alt+Shift+L - Toggle locking the mouse pointer to the video area (requires "Optimize mouse for remote desktop instead of games" checkbox enabled)
Android client
Starlight supports gamepads that use the standard Android button mapping. It also supports some popular non-Android controllers like the Xbox 360, Xbox One, PS3, Steam and PS4 controllers. However, we recommend testing these with your specific Android device first, because some controllers have latency or disconnection issues (particularly with PlayStation controllers over Bluetooth).
For gamepads that are missing Select or Mode buttons, the following special button combos are available to emulate them:
- Start+Select (for gamepads with a Select button) or R1+Start (for gamepads without a Select button) = Mode
- L1+Start = Select
If you don't have a mouse connected to your Android device, you can emulate one using a game controller. Press and hold the Start button to toggle mouse emulation. When mouse emulation is on, you can use either analogue stick to move the cursor. The A button left clicks and the B button right clicks.
Adding Programs not Automatically Added
You can stream almost any game or app by adding the EXE file manually to Sunshine.
With Sunshine, you can add new apps via the configuration interface, under the "Applications" page.
The next time the client opens and displays the App List, the newly added programs and games should be displayed and ready to stream.
On Starlight Android, pressing the home key will switch out of the streaming session. Choose the Quit Session option from the App List to fully quit the streaming session.
Using Starlight to Stream your Desktop
Follow the steps above for adding a custom program, but for the path use: C:\windows\system32\mstsc.exe
You can rename the remote desktop entry using the Edit button. When you click this entry, you will see your full desktop where you can run whatever you want.
Even though the mstsc.exe executable is typically used for Microsoft Remote Desktop, this is only an indicator to GeForce/Quadro Experience that you want to stream your desktop. It does not actually launch mstsc.exe or use RDP to stream.
Using AAudio and AC3 Surround Sound
If Audio Output Mode in settings is set to PCM, AAudio can be selected for super low-latency. When Audio Output Format is set to Dolby Digital, AAudio will be unavailable and Dolby output will be used. Both of these options support the use of Bluetooth headphones and will automatically switch when connected or disconnected.