autoPriority

Monitors process memory usage on Windows and automatically adjusts CPU priority: promotes memory-heavy processes to HIGH and demotes everything else to NORMAL. Optionally enters Game Mode when a process exceeds a higher threshold, boosting it to HIGH and setting all other processes to IDLE.

Windows only.

How it works

Normal mode

Every scan interval the program iterates over all running processes:

RSS vs -mem	Current priority	Action
≥ threshold	anything except HIGH	→ HIGH (logged as PROMOTE)
≥ threshold	already HIGH	skip
< threshold	ABOVE_NORMAL, HIGH, or REALTIME	→ NORMAL (logged as DEMOTE)
< threshold	NORMAL, BELOW_NORMAL, or IDLE	skip

Game mode (-game-mem)

When any process reaches or exceeds the -game-mem threshold:

1. That process → HIGH (logged as GAME)
2. All other processes → IDLE
3. Log: GAME MODE ON

When all such processes close:

1. All processes that were demoted during game mode are restored to their original priority (logged as RESTORE)
2. GAME MODE OFF logged
3. Normal mode resumes — priorities recalculated by -mem rules

If SetPriorityClass or OpenProcess fails for a process (e.g., anti-cheat protection, system processes), the process is added to an in-memory exclusion list and never touched again (logged as BLOCK). When the process exits, it is automatically removed from the list.

On shutdown, all processes are restored: game-mode demoted processes to their saved original priority, promoted and game processes to NORMAL.

Build

Requires Go 1.26+.

# Standard build (with console window)
go build -o autopriority.exe .

# Background build (no console, minimal size)
go build -ldflags="-H windowsgui -s -w" -o autopriority.exe .

Usage

autopriority [flags]

Flag	Default	Description
-mem	512M	Memory threshold (e.g. 512M, 1G, 2048M)
-game-mem	4G	Game threshold (e.g. 3G, 4G). Must be > -mem. 0 = disabled
-interval	1 minute	Scan interval (min 10s)
-dry-run	false	Log only, don't change priority

Examples:

# Run with 1 GB threshold, scanning every 30 seconds
autopriority -mem=1G -interval=30s

# Run with defaults (512M threshold, 4G game threshold)
autopriority

# Game mode: normal threshold 512M, game threshold 4G
autopriority -mem=512M -game-mem=4G

# Dry run — log decisions without changing anything
autopriority -dry-run

Log

Log is always written to %TEMP%\autopriority.log. A new log file is created on each run (previous log is deleted).

Log entries:

Prefix	Meaning
PROMOTE	Priority raised to HIGH (normal mode)
DEMOTE	Priority lowered to NORMAL (normal mode)
GAME	Process set to HIGH or IDLE (game mode)
GAME MODE ON	Game mode activated
GAME MODE OFF	Game mode deactivated — processes restored
BLOCK	OpenProcess or SetPriorityClass failed; process added to exclusion list
RESTORE	Process restored to original/saved priority (game mode exit or shutdown)
SKIP RESTORE	PID reused by a different process; restore skipped
[DRY-RUN]	Would change priority (dry-run mode)

Auto-start

Open Win+R, type shell:startup, and press Enter. Then place a shortcut to autopriority.exe in the folder that opens.

Dependencies

None. Uses only Windows API (kernel32, psapi) via raw syscall.