🎮 StreamTweak

StreamTweak is a host-side companion for Moonlight game streaming. It automates the technical setup that makes streaming reliable — NIC throttling, spatial audio, HDR, game library sync — so you can focus on playing.

✅ Compatibility

Works with Moonlight, Sunshine, Apollo, Vibeshine, and Vibepollo on Windows 10 21H2 and later.

⚠️ Installer warning: Windows SmartScreen may flag the installer because it lacks a commercial code-signing certificate. Choose Keep / Keep anyway. Full source code is available in this repository.

🔗 StreamLight — The Companion Client

StreamLight is the official FoggyBytes Moonlight fork with native StreamTweak integration:

• NIC control from the client — send the speed-change command before connecting, with a built-in countdown and auto-revert
• Host metrics in overlay (StreamLight 1.2.0+) — live GPU %, encoder %, GPU temp, VRAM, CPU %, and network TX in the performance overlay
• Store badges on game covers (StreamLight 2.0.0+) — per-game store badge (Steam, Epic, GOG, Ubisoft Connect, Xbox, Battle.net, EA App) pulled from StreamTweak via the APPSTORES command
• Session quality report (StreamLight 2.0.0+) — client-side metrics (FPS, drops, RTT, decode latency, bitrate) streamed to StreamTweak for grading and sparkline display

⚠️ StreamLight is Windows-only and requires StreamTweak on the host. Store badges and host metrics require StreamLight 2.0.0 or later.

🔥 Features

🌐 Network

• Auto Streaming Mode — monitors Sunshine/Apollo/Vibeshine/Vibepollo logs and throttles the host NIC to 1 Gbps on client connect; restores original speed on disconnect
• Manual streaming control — one-click throttle/restore without waiting for log events
• UAC-free — a LocalSystem Windows Service handles all speed changes via Named Pipe; no prompts ever
• Tailscale detection — if Tailscale is running, the Network tab shows the host's Tailscale IP with a copy button. Useful for remote streaming: instead of the local LAN address, connect StreamLight to the Tailscale IP to reach your PC from outside your home network — no port forwarding needed

🖥️ Display

• HDR toggle — enable or disable HDR per monitor from StreamTweak, without opening Windows Settings
• Auto HDR toggle — enable or disable Windows Auto HDR system-wide; change broadcast instantly to all running apps

🎧 Audio

• Auto spatial audio — activates Dolby Atmos for Headphones or Windows Sonic 30 seconds after session start, on the output device of your choice
• Output device selector — any audio render device; Steam Streaming Speakers pre-selected when present
• Live availability indicators — green/red dot per format per device before activation

🗂️ Streaming App Manager

• Auto kill & relaunch — define apps to terminate at session start and relaunch at session end (e.g. Hue Sync)
• Per-app AutoManage toggle — exclude individual apps from automation without removing them from the list

🎮 Game Library Sync

• Multi-store discovery — Steam, Epic Games, GOG, Ubisoft Connect, Xbox/Game Pass, EA App, Battle.net
• Native cover art — fetched from each store's CDN and cached as PNG
• Safe sync — manually created Sunshine entries are never touched; uninstalled games removed on next sync
• Manual game management — Add any exe not auto-detected; remove individual entries with the Remove button

🛒 Store

• Instant Gaming integrated — browse and buy games directly inside StreamTweak via an embedded browser. Purchases through the embedded Store contribute a small affiliate commission to FoggyBytes at no extra cost to you, helping fund StreamTweak's development
• Open in browser — hand off the current page to your default browser with one click; affiliate parameter preserved across the handoff

📋 Session History & Telemetry

• Full session log — every session recorded with duration, RTT avg, frame drops %, games
• Quality report — click any session row to open a telemetry overlay: CLIENT stats, HOST stats, four sparkline charts (RTT, drops, bitrate, decode latency), and a quality grade (Excellent / Good / Poor)
• Home dashboard — real-time status tiles for all nine managed settings at a glance (3×3 grid)

✨ What's New in 6.2.7 — "The Stability Update"

• Bug fix: session logs — games missing on host shutdown — games played during a session that ended via host PC shutdown or power loss were not recorded in the session log. Two separate fixes: (1) WriteCheckpoint() had an early-return guard that skipped the entire method (including the games snapshot) when fewer than 2 telemetry samples had been collected — this affected all sessions started without StreamLight and any session cut short before the first 30-second checkpoint; (2) OnSystemSessionEnding() was not collecting the detected game list before calling SessionLogger.EndSession() — fixed to match the existing pattern in HandleAutoStreamStop
• Bug fix: phantom session at startup — StreamTweak could incorrectly detect an active streaming session when none was running; the root cause was HasActiveMoonlightSession() matching Sunshine's HTTPS web UI connections (ports 47989/47990), which any LAN machine can open without streaming. Fixed by filtering strictly to port 48010 (RTSP), the only port active during a real streaming session
• Bug fix: phantom session from stale log — CheckForExistingSession() Phase 2 (head-of-file scan) could raise a retrospective StreamStarted event from an old log entry when no session was active. Fixed by requiring a positive TCP check before raising the event
• Bug fix: Stop Streaming Mode race condition — HandleAutoStreamStop was async void, causing ToggleStreamingAsync in NetworkViewModel to receive Task.CompletedTask immediately and proceed before any async work ran. Changed to async Task
• Bug fix: sessions.json atomic write — SessionLogger.Save() now writes to .tmp first and renames atomically, preventing a truncated file on crash

6.2.6 — "The Steam Update"

• Improvement: game metadata now sourced exclusively from Steam — developer and release date are fetched from the Steam Store API for all games regardless of source store (Epic, GOG, Ubisoft, Xbox, Battle.net, EA App, manual). For games without a known AppId, a name search against the Steam Store Search endpoint resolves it automatically. RAWG.io and PCGamingWiki have been removed entirely — no API key required
• Bug fix: Logs — Xbox game covers not detected — cover art for Xbox library games was not detected at all in the session list or the session detail overlay. Cover lookup now correctly resolves Xbox titles alongside all other stores

6.2.5 — "The Covers Update"

• Bug fix: Logs — game covers for uninstalled games — cover art no longer disappears from the session table row or the session detail overlay when a game has been uninstalled or removed from the library. Logs now use the same snapshot-first lookup already used by Home — cover paths snapshotted at session-end time are checked first; the live game library is only a fallback for older sessions
• Bug fix: app exit crash — fixed an ObjectDisposedException that could occur in the single-instance activation watcher thread when the app closed while the thread was blocked on WaitOne()

6.2.4 — "The Detail Update"

• Home — last session card — "Duration" label added to the left of the duration value for clarity
• Home tile Logs — "All session duration" label and cumulative time now displayed inline on the same row instead of stacked vertically
• Game Library — sync toggle tooltip now reflects the actual detected streaming server (Apollo, Vibeshine, Vibepollo…) instead of the hardcoded "Sunshine"

6.2.3 — "The Glow Update"

• Home tiles — hover effects — all 9 tiles are now Buttons; hovering over any tile reveals a subtle background glow and a navigation arrow (↗) that fade in at the top-right corner via a shared ST_TileButton ControlTemplate
• Home tiles — three new — APPS shows the count of managed apps in amber; STORE shows the Instant Gaming logo with "powered by"; LOGS shows the total session count (color-coded by average quality grade) and cumulative streaming time; the grid is now 3×3
• Green accent everywhere — toggle switches, Apply Settings button, and Add button no longer use the system accent color; all interactive states now use the app-wide green (#22c55e); the sidebar selection indicator matches
• Settings — GPL v3 and Donate — moved from the Home footer to the Settings About card as standard buttons; the Donate button now shows the PayPal icon; the Home footer is gone
• Minimum window size — enforcement upgraded to Win32 WM_GETMINMAXINFO subclassing — the OS now prevents the window from being dragged below 1280×720 at all (previously it snapped back reactively)

6.2.2 — "The Tile Update"

• Home tiles — contextual subtitles — each tile now shows a secondary line below its main value: the active network adapter name (NIC Speed), the display FriendlyName (HDR), and the audio output device (Auto Spatial Audio)
• Home tiles — icons — each tile title now displays the corresponding sidebar icon to its left, making the tile layout visually consistent with the NavigationView
• Button hover — Primary, Green, and Danger buttons now maintain their own accent color on hover instead of turning grey; hover and pressed states are explicitly styled per button type
• Bug fix: Auto Spatial Audio tile — showed "Default device" at startup instead of the configured output device; fixed by surfacing the device name through AppStateService at boot time, before the Audio page ViewModel is instantiated

6.2.1 — "The Polish Update"

• Bug fix: Store tab (WebView2) — the embedded browser failed to load when launched from the installer-built exe; the WebView2 runtime was attempting to write its user data folder inside Program Files (read-only). Fixed by supplying a custom environment pointing to %LocalAppData%\StreamTweak\WebView2; a dismissible error bar is shown if initialization still fails
• Bug fix: Debug Mode toggle — the toggle in Settings now correctly shows its active state after navigating away and back; previously it always reset to Off on re-navigation, requiring a double toggle to stop the session
• Home tile badges — Auto Streaming, HDR, and Auto HDR badges now use a tinted background + colored border matching the green/red button style; NIC Speed, Spatial Audio, and Game Library use the same treatment in amber
• Home last session card — quality grade badge moved to the left column (below RTT avg and frame drops) and restyled to match the tile badge format (tinted bg, colored border, no dot); a "Games played" label now appears above the cover thumbnails
• Session log — quality grade pill unified with the tile badge style (tinted bg, colored border, colored text, no dot); grade colors aligned to the app palette

6.2.0 — "The Store Update"

• Store tab — a new Store entry in the sidebar opens Instant Gaming directly inside StreamTweak via an embedded browser, with a minimal toolbar (back, forward, home, open-in-system-browser) and the FoggyBytes affiliate link preserved on every navigation
• Open in browser — hand off the current Instant Gaming page to the system default browser with one click; the affiliate parameter is preserved across the handoff
• External links — non-instant-gaming URLs clicked inside the Store open in the system browser, keeping the embedded view focused on shopping
• Info banner — a one-time dismissible banner explains that Facebook / Google / Apple sign-in does not work in embedded browsers (a server-side restriction enforced by those providers since 2021) and directs users to the open-in-browser button; the FB / Google / Apple buttons are also hidden from the IG login modal to remove dead options
• Cover art improvement — Steam Store Search added as a final fallback for GOG titles whose covers cannot be resolved via the GOG Galaxy database, the GOG Catalog API, or any of the other GOG-specific sources
• Bug fix: games on abrupt host shutdown — sessions interrupted by power loss or OS kill no longer lose the list of detected games; the games list is now persisted in the 30-second telemetry checkpoint and recovered at next startup

6.1.0 — "The Live Session Update"

• Live session panel — while a stream is active, the Home card replaces the Last Session summary with a real-time view: duration timer, RTT and Bitrate sparkline charts (30-second scrolling window), and drop percentage updated every second
• Debug Mode — a toggle in Settings › Maintenance simulates an active streaming session for testing the UI without touching the NIC, spatial audio, or managed apps
• General UI redesign — developed with Claude Design; covers the full interface from transparency and color consistency to spacing, component styling, and DM Sans font integration in the sidebar
• Bug fix: Bridge game detection — sessions initiated by StreamLight (Bridge mode) now correctly run the game process monitor and show detected games in the session log
• Bug fix: interrupted sessions — sessions ended without a clean client-side stop now correctly display telemetry data in the log

⚠️ Requires StreamLight 2.3.1 or later for 1-second chart updates. Earlier versions update every 10 seconds.

6.0.3 — "The Game Info Update"

• Developer & release date — each game in the library now shows its developer and release date; Steam games are fetched via the official Steam Store API, non-Steam games via PCGamingWiki

6.0.2 — "The Layout Update"

• Stream Host inline — the Stream Host label and icon now appear directly in the Streaming Session card; the separate card below the tile grid has been removed
• Uniform tile height — the top row tiles (NIC Speed, Auto Streaming, HDR) now match the height of the bottom row

6.0.1 — "The Snapshot Update"

• Last session auto-refresh — the Home page Last session card updates automatically when a streaming session ends, without requiring a tab switch
• Game covers survive uninstall — covers in the Last session card remain visible even after a game is removed from the library or uninstalled; cover paths are snapshotted at session-end time

6.0.0 — "The WinUI3 Update"

• WinUI3 rewrite — the entire UI has been rebuilt in WinUI3 (Windows App SDK 1.8), bringing native Windows 11 visuals and a Mica backdrop that reflects your desktop wallpaper
• Sidebar navigation — NavigationView replaces the old horizontal tab bar; all sections (Home, Network, Display, Audio, Apps, Game Library, Logs, Glossary, Settings) are accessible from the left pane
• Minimize to tray — the minimize button hides the window to the tray; no taskbar clutter
• DPI-aware window — window size is remembered and scales correctly on any display

For full version history see changelog.txt.

🏗️ Architecture

StreamTweak consists of three components:

• StreamTweakUI.exe — WinUI3 tray app (unprivileged), built on Windows App SDK 1.8
• StreamTweak.Core — shared business logic library (NIC control, audio, HDR, game library, telemetry, TCP bridge)
• StreamTweakService.exe — Windows Service (LocalSystem), handles all NIC speed changes via Named Pipe; no UAC ever appears in the tray app

StreamLight communicates with StreamTweak over a plain TCP bridge on port 47998 (LAN). Commands: PREPARE, RESTORE, STATUS, STATS, APPSTORES.

📝 Installation

1. Go to the Releases page of this repository.
2. Download the latest StreamTweak_6.2.7_Installer.exe and run it.

🙏 Support the Project

🤝 Acknowledgements

• Moonlight — the open-source streaming client that inspired this project
• Sunshine — the streaming host that started it all
• Apollo — community-driven Sunshine fork
• Vibeshine and Vibepollo — fully supported since v2.5.2

License