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.

✨ 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

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

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

Verification example:

Get-FileHash .\ThreadPilot_v1.1.2_Portable.zip -Algorithm SHA256

Install flow summary:

1. Download the package matching your deployment model.
2. Installer package (recommended): run ThreadPilot_vX.Y.Z_Setup.exe and complete the wizard.
3. Portable package: extract ZIP and launch ThreadPilot.exe.

Notes:

• 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.

Installation

Quick Install (PowerShell, Admin)

Fast copy/paste one-liner:

iwr https://raw.githubusercontent.com/PrimeBuild-pc/ThreadPilot/main/build/install-threadpilot.ps1 -UseBasicParsing | iex

Expanded 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) Define paths
$url = "https://github.com/PrimeBuild-pc/ThreadPilot/releases/latest/download/ThreadPilot_v1.1.2_Setup.exe"
$destPath = "$env:ProgramFiles\ThreadPilot"
$exePath = "$destPath\ThreadPilot_v1.1.2_Setup.exe"

# 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.
• If package manager search does not show the latest package, see the channel notes below.

Install from winget:

winget install PrimeBuild.ThreadPilot

Install from Chocolatey:

choco install threadpilot

Direct installer (latest release):

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

Verify SHA256 before running the installer:

Get-FileHash .\ThreadPilot_v1.1.2_Setup.exe -Algorithm SHA256

Compare the output with SHA256SUMS.txt from the same release.

Channel availability notes:

• Winget visibility depends on microsoft/winget-pkgs publication and client source refresh.
• Chocolatey visibility depends on moderation and verification approval state.

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