Quick Start Guide - LeGeRyChEeSe/Sunshine-AIO GitHub Wiki

Quick Start Guide

Get Sunshine-AIO running in just 5 minutes! This guide covers the essential steps for a basic streaming setup.

⚡ Prerequisites

  • Windows 10/11 (64-bit)
  • Administrator privileges required
  • Stable internet connection
  • Moonlight client on your streaming device

Note: Python and Git will be automatically installed if not present

🚀 Installation Steps

1. One-Line Installation (Recommended)

# Run as Administrator - This does everything automatically
irm https://sunshine-aio.com/script.ps1 | iex

What the script does automatically:

  • ✅ Checks and installs Python 3.8+ if needed
  • ✅ Checks and installs Git if needed
  • ✅ Downloads the latest Sunshine-AIO from GitHub
  • ✅ Creates Python virtual environment
  • ✅ Installs all required packages
  • ✅ Sets up project structure and shortcuts
  • ✅ Guides you through component selection

2. After Installation

The PowerShell script will:

  • Create a "Sunshine-AIO" shortcut in the installation folder
  • Guide you through component selection
  • Set up everything automatically

Note: There are no manual download options - use the PowerShell command only.

3. Component Selection

When prompted, select these components for a quick setup:

  • ✅ Sunshine (Required)
  • ✅ Virtual Display Driver (Recommended)
  • ⏚ī¸ Sunshine Virtual Monitor (Skip for now)
  • ⏚ī¸ Playnite (Skip for now)
  • ⏚ī¸ Playnite Watcher (Skip for now)

4. Configure Sunshine

  1. Open Sunshine Web UI: https://localhost:47990
  2. Set a username and password
  3. Add your first application: 
    Name: Desktop
Command: cmd /C
Working Directory: C:\

5. Connect with Moonlight

  1. Install Moonlight on your client device
  2. Scan for PC or enter your host IP manually
  3. Pair using the PIN displayed in Sunshine
  4. Launch the Desktop application

✅ Verify Installation

Check if services are running:

# Check Sunshine service
Get-Service -Name "SunshineService"

# Check if virtual display is available
Get-PnpDevice -Class "Display" | Where-Object {$_.FriendlyName -like "*Virtual*"}

Test streaming:

  1. Launch Desktop from Moonlight
  2. You should see your PC screen
  3. Mouse and keyboard should work normally

🔧 Next Steps

Now that basic streaming works:

  1. Add games and apps to your Sunshine library
  2. Install Playnite for unified game management
  3. Configure Steam for gaming-optimized streaming
  4. Optimize performance for your setup

⚠ī¸ Quick Fixes

Can't connect with Moonlight

  • Check firewall - Allow Sunshine through Windows Firewall
  • Same network - Ensure both devices use same WiFi/LAN
  • Manual IP - Try entering host PC IP address directly

No virtual display after installation

  • Reboot PC - Some systems require restart after driver install
  • Check Device Manager - Look for "IDD HDR" under Display adapters
  • Run as Admin - Virtual Display Driver needs admin privileges

Poor streaming quality

  • Lower bitrate in Sunshine Web UI (try 15 Mbps)
  • Match resolution to your client device screen
  • Use wired connection instead of WiFi when possible

🆘 Still Having Issues?

Need more detailed setup? See the complete Installation Guide