https://github.com/mirbyte/windows-cpu-limit-tray
Windows tray utility for quickly capping the active power plan's plugged-in CPU maximum processor state.
https://github.com/mirbyte/windows-cpu-limit-tray
cpu cpu-limit cpu-state power-management powercfg pyside6 python system-tray windows windows-11 windows-tweaks
Last synced: 18 days ago
JSON representation
Windows tray utility for quickly capping the active power plan's plugged-in CPU maximum processor state.
- Host: GitHub
- URL: https://github.com/mirbyte/windows-cpu-limit-tray
- Owner: mirbyte
- License: mit
- Created: 2026-07-05T22:29:01.000Z (19 days ago)
- Default Branch: main
- Last Pushed: 2026-07-05T23:03:59.000Z (19 days ago)
- Last Synced: 2026-07-06T00:12:40.786Z (19 days ago)
- Topics: cpu, cpu-limit, cpu-state, power-management, powercfg, pyside6, python, system-tray, windows, windows-11, windows-tweaks
- Language: Python
- Homepage:
- Size: 24.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Windows CPU Limit Tray
A small Windows tray utility for quickly changing the active power plan's **CPU maximum processor state** while plugged in.
Useful when a desktop or laptop CPU does not lower clocks properly at idle or light use. Instead of relying on the minimum processor state, this app lets you quickly cap the CPU's maximum allowed state from the tray, then restore it to 100% when needed.
## Status
Beta / initial public release.
This app changes a real Windows power setting. Test it on your own machine before relying on it.
## Features
* Change the **AC / plugged-in** CPU maximum processor state
* Preset buttons from 5% to 100%
* Optional small overlay when the CPU limit is below 100%
* System tray menu
* Warning before quitting while below 100%
* **Restore 100% and Quit** option
## What it does not do
* Does not change battery/DC CPU settings
* Does not automatically request administrator permissions (shouldn't require admin)
* Does not directly control BIOS, firmware, undervolting, TDP, or thermal limits
## Requirements
* Windows 11 (Windows 10 should work too)
* Python 3.10 or newer recommended
* PySide6
## Install
```bash
pip install -r requirements.txt
```
## Run
```bash
python windows_cpu_limit_tray.pyw
```
Or double-click `windows_cpu_limit_tray.pyw` if Python is associated with `.pyw` files.
## Restore CPU to 100%
Use the **100%** button in the app, or right-click the tray icon and choose **Restore 100% and Quit**.
Manual restore command:
```bash
powercfg -setacvalueindex SCHEME_CURRENT SUB_PROCESSOR PROCTHROTTLEMAX 100
powercfg -setactive SCHEME_CURRENT
```
If Windows blocks the change, try closing the app and running it as Administrator. Some managed devices may block power setting changes by policy.
## Logs
The app writes `windows_cpu_limit_tray.log` next to the script when possible, or in the system temporary directory as a fallback.
---
