steam-deck-tools/README.md
2026-02-22 23:08:07 -05:00

6.1 KiB

ROG Ally X Performance Overlay (Fork)

This repository is a personal fork of Steam Deck Tools, customized for my ROG Ally X setup and workflow.

Scope

This fork is focused on PerformanceOverlay and companion tooling around it (including a Game Bar widget).

Included projects:

  • PerformanceOverlay
  • CommonHelpers
  • ExternalHelpers
  • XboxGameBarWidget

The other original applications are intentionally not part of active development in this fork.

Build

dotnet restore PerformanceOverlay/PerformanceOverlay.csproj
dotnet build PerformanceOverlay/PerformanceOverlay.csproj --configuration Release

This fork now targets .NET 8 for desktop projects.

CI

GitHub Actions builds and publishes:

  • PerformanceOverlay-<version>.zip
  • SteamDeckToolsGameBarWidget-<version>.zip (includes MSIX package + install script)

Xbox Game Bar widget (Windows 11)

The widget appears in Xbox Game Bar (Win+G) as Performance Overlay Control and lets you:

  • Switch directly to FPS, FPSWithBattery, Battery, Minimal, Detail, Full
  • Cycle, Show, Hide, or Toggle the overlay

The widget sends URI commands to PerformanceOverlay via:

  • steamdecktools-performanceoverlay://mode/<name>
  • steamdecktools-performanceoverlay://cycle
  • steamdecktools-performanceoverlay://show
  • steamdecktools-performanceoverlay://hide
  • steamdecktools-performanceoverlay://toggle

Run PerformanceOverlay once after extracting it so it can register the URI protocol in HKCU.

Install widget package (PowerShell)

After downloading the SteamDeckToolsGameBarWidget-<version>.zip artifact:

powershell -ExecutionPolicy Bypass -File scripts/install_gamebar_widget.ps1 -PackagePath "C:\path\to\SteamDeckToolsGameBarWidget-<version>.zip"

Use -ForceReinstall to remove an existing widget package before reinstalling.

If Windows blocks unsigned package installation, enable Developer Mode: Settings > Privacy & security > For developers > Developer Mode.

Install latest GitHub build artifact (PowerShell)

To update an existing install directory with files from the latest successful PerformanceOverlay GitHub Actions build artifact:

powershell -ExecutionPolicy Bypass -File scripts/install_from_github_build.ps1 -DestinationDir "C:\SteamDeckTools"

Useful options:

  • -Repository owner/repo (default: nicklavoie/steam-deck-tools)
  • -Ref <branch> (default: main)
  • -ArtifactNamePattern "PerformanceOverlay-*.zip"
  • -CleanDestination (remove destination contents before copying)
  • -GitHubToken <token> (or set GITHUB_TOKEN) for higher API rate limits

Credits

Based on the original Steam Deck Tools project by Kamil Trzciński.

License

This fork remains under the original project license: Creative Commons Attribution-NonCommercial-ShareAlike (CC-BY-NC-SA).


(Windows) Steam Deck Tools

GitHub release (latest SemVer) GitHub release (latest SemVer including pre-releases) GitHub all releases

This repository contains my own personal set of tools to help running Windows on Steam Deck.

This software is provided on best-effort basis and can break your SteamDeck.

Help this project

Consider donating if you are happy with this project:

Buy Me a Coffee at ko-fi.com Donate with PayPal

Install

See all instructions here: https://steam-deck-tools.ayufan.dev/.

Applications

This project provides the following applications:

Additional informations

Join Us

Join Us for help or chat. We are at Official WindowsOnDeck Discord server.

Anti-Cheat and Antivirus software

READ IF PLAYING ONLINE GAMES AND/OR GAMES THAT HAVE ANTI-CHEAT ENABLED.

Author

Kamil Trzciński, 2022-2024

Steam Deck Tools is not affiliated with Valve, Steam, or any of their partners.

License

Creative Commons Attribution-NonCommercial-ShareAlike (CC-BY-NC-SA).

Free for personal use. Contact me in other cases (ayufan@ayufan.eu).