ThreadPilot ✈️

ThreadPilot is a free and open-source Windows process and power plan manager focused on deterministic performance workflows.

The project targets users who need Process Lasso style capabilities in a modern WPF desktop application with enterprise-grade reliability, security hardening, and automation support.

Coverage badge tracks business/application code and excludes generated build artifacts.

✨ Key Features

• Process management with live refresh, filtering, and high-volume process handling.
• CPU affinity and priority controls with topology-aware logic.
• I/O and scheduling related tuning utilities.
• Rule-driven power plan switching based on process start/stop events.
• Conditional profiles, system tray controls, and runtime monitoring.
• Windows 11 first-class support.

Screenshots

⚙️ Requirements

• Windows 11 (Build 22000+).
• .NET 8 SDK for source builds.
• Administrator privileges are required to launch ThreadPilot.

📦 Download

One-Click Terminal Install

# winget
winget install PrimeBuild.ThreadPilot

# chocolatey
choco install threadpilot

# PowerShell bootstrap (Admin)
iwr https://raw.githubusercontent.com/PrimeBuild-pc/ThreadPilot/main/build/install-threadpilot.ps1 -UseBasicParsing | iex

Manual download files and checksum verification

Latest artifacts are published on each tagged release in GitHub Releases.

Package	File name	Recommended use
Installer (Recommended)	ThreadPilot_v<version>_Setup.exe	Standard Windows installer (Inno Setup) for most users
Portable	ThreadPilot_v<version>_singlefile_win-x64.zip	No-install deployment for power users

Quick links:

• Release page: https://github.com/PrimeBuild-pc/ThreadPilot/releases/latest

Verification examples:

Get-FileHash .\ThreadPilot_v<version>_Setup.exe -Algorithm SHA256
Get-FileHash .\ThreadPilot_v<version>_singlefile_win-x64.zip -Algorithm SHA256

Compare hashes with SHA256SUMS.txt from the same release.

Expanded PowerShell installer script (auditable)

# 1) Verify administrator permissions
if (-not ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
  Write-Warning "Please run this command in a PowerShell window opened as Administrator."
  exit 1
}

Write-Host "Starting ThreadPilot installation..." -ForegroundColor Cyan

# 2) Resolve latest installer asset from GitHub Releases
$release = Invoke-RestMethod -Uri "https://api.github.com/repos/PrimeBuild-pc/ThreadPilot/releases/latest"
$asset = $release.assets | Where-Object { $_.name -match '^ThreadPilot_v.*_Setup\.exe$' } | Select-Object -First 1
if (-not $asset) {
  throw "Unable to locate the latest ThreadPilot installer asset."
}

$url = $asset.browser_download_url
$destPath = "$env:ProgramFiles\ThreadPilot"
$exePath = Join-Path $destPath $asset.name

# 3) Ensure destination folder exists
if (-not (Test-Path $destPath)) { New-Item -ItemType Directory -Force -Path $destPath | Out-Null }

# 4) Download installer
Write-Host "Downloading installer..."
Invoke-WebRequest -Uri $url -OutFile $exePath -UseBasicParsing

# 5) Optional: add install folder to machine PATH
$currentPath = [Environment]::GetEnvironmentVariable("Path", "Machine")
if ($currentPath -notmatch [regex]::Escape($destPath)) {
  [Environment]::SetEnvironmentVariable("Path", $currentPath + ";" + $destPath, "Machine")
  Write-Host "Added install folder to machine PATH."
}

# 6) Run installer silently
Start-Process -FilePath $exePath -ArgumentList "/VERYSILENT /SUPPRESSMSGBOXES /NORESTART /SP-" -Wait

Write-Host "Installation completed successfully." -ForegroundColor Green

Notes:

• This installation flow is machine-wide (Program Files) and requires administrator rights.
• The PATH update is optional but included in the script for command-line convenience.

Channel availability and install notes

• Winget visibility depends on microsoft/winget-pkgs publication and client source refresh.
• Chocolatey visibility depends on moderation and verification approval state.
• The release workflow can auto-submit winget and Chocolatey publication jobs when repository secrets are configured.
• ThreadPilot uses an administrator-required manifest (requireAdministrator) and requests elevation at startup.
• If UAC elevation is declined at startup, the application exits and does not continue in limited mode.
• In Power Plans > Custom Power Plans, use Add .pow File to add new custom plans directly from the app.
• The first opening of Performance shows a blocking onboarding modal with blurred background for clarity.

Build from Source

git clone https://github.com/PrimeBuild-pc/ThreadPilot.git
cd ThreadPilot
dotnet restore ThreadPilot_1.sln
dotnet build ThreadPilot_1.sln --configuration Release
dotnet run --project ThreadPilot.csproj --configuration Release

Useful startup arguments:

• --start-minimized
• --autostart
• --test
• --smoke-test

Usage Examples

Run integrated runtime tests:

dotnet run --project ThreadPilot.csproj --configuration Release -- --test

Publish a self-contained build:

dotnet publish ThreadPilot.csproj --configuration Release --runtime win-x64 --self-contained true

Build release artifacts via script:

./build/build-release.ps1

Quality and Security

• CI validates build, formatting, analyzers, vulnerability checks, and secret scanning.
• Security disclosures are handled through private GitHub advisories. See docs/SECURITY.md.
• Change history is tracked in docs/CHANGELOG.md.

Comparison with Process Lasso

Capability	ThreadPilot	Process Lasso
Open source	Yes (AGPL v3)	No
Rule-based power plan switching	Yes	Yes
CPU affinity and priority controls	Yes	Yes
Modern Windows 11 Fluent UI	Yes	Partial
Scriptable CI release artifacts	Yes	Not applicable
Package manager distribution	winget + Chocolatey	Varies by edition

Repository Docs

• docs/README.md
• docs/RELEASE_SIGNING.md
• docs/reference/ARCHITECTURE_GUIDE.md
• docs/reference/API_REFERENCE.md
• docs/reference/DEVELOPER_GUIDE.md
• docs/reference/PROJECT_STRUCTURE.md
• docs/reference/UI_STYLE_GUIDE.md
• docs/release/PACKAGING.md

Contributing

See docs/CONTRIBUTING.md and docs/CODE_OF_CONDUCT.md before opening pull requests.

🛠️ Roadmap

• Expand dedicated unit and integration coverage for core services.
• Continue async reliability refactoring for long-running monitoring paths.
• Improve accessibility and localization readiness in all major views.
• Formalize release signing and distribution hardening.

📄 License

Licensed under GNU Affero General Public License v3.0. See LICENSE.

📞 Support

Made with love for Windows power users☕ PayPal.me

• Issues: https://github.com/PrimeBuild-pc/ThreadPilot/issues
• Discussions: https://github.com/PrimeBuild-pc/ThreadPilot/discussions