Skip to content

Repository files navigation

Quick Settings (Decky, Windows) - v2.3.0

A Decky plugin that exposes Windows quick settings inside Steam Big Picture. It works on Windows PCs without requiring Xbox Game Bar.

Features

Audio - device volume, microphone volume, output and input selectors.

Display - brightness dimmer, resolution, refresh rate and native HDR control.

Performance - Windows power mode: Best power efficiency, Balanced, Better performance and Best performance. This uses the native Windows power overlay and does not require administrator rights.

TDP (supported AMD systems) - power-limit control through the dynamically loaded RyzenAdj library.

Lossless Scaling - enabling Scaling starts Lossless Scaling minimized, applies the selected settings to the current game and keeps the app hidden. Disabling Scaling closes the managed Lossless Scaling process.

Each Steam game gains a Quick Settings menu entry with a complete Lossless Scaling profile and an option to apply it automatically when the game starts. Profiles include scaling, frame generation, capture, synchronization, cursor, crop, GPU and display settings.

AMD Radeon - RSR, AFMF, Anti-Lag, Radeon Boost, Enhanced Sync, Radeon Chill, Image Sharpening and supported display color controls. Writes use driver read-back and retry before the UI reports success.

The QAM Radeon controls are global. A game can optionally enable its own AMD profile from the same per-game Quick Settings page. With no game profile enabled, the global QAM settings are used. When a profile is enabled, Quick Settings captures the global state, applies and verifies the game's overrides, then restores and verifies the global state when the game closes.

Diagnostics - exports a bounded diagnostic report with plugin, agent, display, audio, AMD, Lossless Scaling, process, game-runtime and per-game profile information, including requested values, driver read-back and transition times.

Unsupported controls are hidden automatically.

Architecture

  • main.py - Decky Python backend and managed Lossless Scaling coordinator.
  • bin/QuickSettingsAgent.exe - local-only volume and brightness agent on 127.0.0.1:47993.
  • bin/libryzenadj.dll - RyzenAdj, loaded dynamically for supported AMD TDP.
  • amd/adlx_helper.exe - short-lived ADLX helper for Radeon settings.
  • src/ - TypeScript and React frontend, built to dist/index.js.

Helpers are launched without visible console windows. Quick Settings does not ship or use GoTweaks services, controller drivers, RTSS, VIIPER or ring-0 drivers.

Build

pnpm install
pnpm run build
.\package-win.ps1

The package script creates:

  • Quick-Settings_Installer-2.3.0.zip
  • quick-settings-project-2.3.0.zip

Licensing

Quick Settings is MIT licensed. It reuses MIT-licensed ADLX integration logic and techniques from GoTweaks, while excluding its GPL controller-emulation components and packaged binaries. The Lossless Scaling reference project is BSD-3-Clause. See LEGAL.md, NOTICE and THIRD-PARTY-NOTICES.md.

About

Handy system toggles from the quick access menu

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages