|
1 | | -# ThreadPilot |
| 1 | +# ThreadPilot ✈️ <sup><kbd>v1.0.0</kbd></sup> |
2 | 2 |
|
3 | | -ThreadPilot is a Windows process and power plan manager built with WPF and .NET 8. |
4 | | -It is focused on deterministic performance workflows for power users, gamers, and admins. |
| 3 | +[]() |
| 4 | +[](https://www.microsoft.com/windows) |
| 5 | +[](https://dotnet.microsoft.com/) |
| 6 | +[](https://docs.microsoft.com/en-us/dotnet/desktop/wpf/) |
| 7 | +[](LICENSE) |
| 8 | +[](../../releases) |
| 9 | +[](https://docs.microsoft.com/en-us/windows/win32/) |
5 | 10 |
|
6 | | -## Highlights |
| 11 | +**ThreadPilot** is a Windows application for advanced **process management**, **CPU affinity control**, and **power plan automation**. |
| 12 | +Built with WPF and .NET 8, it is focused on deterministic performance workflows for power users, gamers, and system admins who want precise control over system resources. |
7 | 13 |
|
8 | | -- Process management with CPU affinity and priority controls. |
9 | | -- Rule-based automation for process-triggered power plan behavior. |
10 | | -- Global power plan management with explicit separation from per-process actions. |
11 | | -- System tweaks panel for advanced Windows performance settings. |
12 | | -- Performance Intelligence dashboard with hotspots, rule impact, and timeline events. |
13 | | -- Light/Dark theming with runtime switching. |
| 14 | +[](https://postimg.cc/cr0hkLd9) |
14 | 15 |
|
15 | | -## Requirements |
| 16 | +## ✨ Features & Highlights |
16 | 17 |
|
17 | | -- Windows 10/11 (x64) |
18 | | -- .NET 8 SDK for building from source |
19 | | -- Administrator privileges for full functionality |
| 18 | +- **Advanced Process Management:** Real-time monitoring with CPU affinity and priority controls. |
| 19 | +- **Enterprise-Grade Rules & Automation:** Rule-based automation for process-triggered power plan behavior, featuring graceful failure handling for Anti-Cheat protected games (Vanguard, EAC, BattlEye). |
| 20 | +- **Performance Intelligence Dashboard:** Interactive dashboard with process hotspots, rule impact analysis, and timeline events. |
| 21 | +- **Global vs. Per-Process Control:** Explicit visual separation of global power plan management from per-process actions. |
| 22 | +- **System Tweaks:** Advanced Windows performance settings panel. |
| 23 | +- **Dynamic Theming:** Light/Dark theming with seamless runtime switching. |
| 24 | +- **Profile-based Configuration:** Persistent settings, customizable notification levels, and low-overhead minimized tray mode. |
20 | 25 |
|
21 | | -## Build |
| 26 | +<img width="1474" height="920" alt="Screenshot 2025-12-21 044753" src="https://github.com/user-attachments/assets/77fc944e-d2a1-4cc7-9915-e01b0776106c" /> |
22 | 27 |
|
23 | | -```bash |
24 | | -dotnet build "ThreadPilot_1.sln" --configuration Release |
25 | | -``` |
| 28 | +## ⚙️ Requirements |
| 29 | + |
| 30 | +- **OS:** Windows 10 / 11 (x64) |
| 31 | +- **Privileges:** Administrator privileges required for full WMI functionality and process control. |
| 32 | +- **SDK:** .NET 8.0 SDK (only required for building from source). |
26 | 33 |
|
27 | | -## Run |
| 34 | +--- |
28 | 35 |
|
| 36 | +## 📦 Installation |
| 37 | + |
| 38 | +### Portable / Setup (Recommended) |
| 39 | +1. Download the latest `ThreadPilot_v1.0.0` release from [GitHub Releases](../../releases) |
| 40 | +2. Extract the archive |
| 41 | +3. Run `ThreadPilot.exe` **as Administrator** |
| 42 | + |
| 43 | +### Build from source |
29 | 44 | ```bash |
| 45 | +git clone [https://github.com/PrimeBuild-pc/ThreadPilot.git](https://github.com/PrimeBuild-pc/ThreadPilot.git) |
| 46 | +cd ThreadPilot |
| 47 | +dotnet build "ThreadPilot_1.sln" --configuration Release |
30 | 48 | dotnet run --project "ThreadPilot.csproj" --configuration Release |
31 | | -``` |
| 49 | +```` |
32 | 50 |
|
33 | | -Useful arguments: |
| 51 | +*Useful startup arguments: `--start-minimized`, `--autostart`, `--test`* |
34 | 52 |
|
35 | | -- `--start-minimized` |
36 | | -- `--autostart` |
37 | | -- `--test` (console test mode) |
| 53 | +----- |
38 | 54 |
|
39 | | -## Test Mode |
| 55 | +## 🧪 Test Mode |
40 | 56 |
|
41 | | -Console test mode runs via the app entrypoint and uses `TestRunner.cs`. |
| 57 | +Console test mode runs via the app entrypoint and uses the integrated `TestRunner.cs`. |
| 58 | +*(Note: `dotnet test` will only execute tests in dedicated test projects; this repository currently uses an integrated runtime test runner).* |
42 | 59 |
|
43 | 60 | ```bash |
44 | 61 | dotnet run --project "ThreadPilot.csproj" --configuration Release -- --test |
45 | 62 | ``` |
46 | 63 |
|
47 | | -Notes: |
| 64 | +*Note: In environments where elevation is required to start the app process, test mode requires an elevated terminal.* |
| 65 | + |
| 66 | +----- |
| 67 | + |
| 68 | +## 🛠️ Architecture & Tech Stack |
| 69 | + |
| 70 | + * **.NET 8.0** & **WPF** |
| 71 | + * **MVVM** pattern using `CommunityToolkit.Mvvm` |
| 72 | + * **Dependency Injection** (`Services/ServiceConfiguration.cs`) |
| 73 | + * **Rules & Automation Engine** (`Services/ProcessPowerPlanAssociationService.cs` & `ViewModels/ProcessPowerPlanAssociationViewModel.cs`) |
| 74 | + * **Performance Dashboard** (`Views/PerformanceView.xaml` & `ViewModels/PerformanceViewModel.cs`) |
| 75 | + |
| 76 | +----- |
| 77 | + |
| 78 | +## 📄 License |
48 | 79 |
|
49 | | -- In environments where elevation is required to start the app process, test mode may need an elevated terminal. |
50 | | -- `dotnet test` will only execute tests in dedicated test projects; this repository currently uses an integrated runtime test runner. |
| 80 | +This project is licensed under the **GNU General Public License v3.0**. |
| 81 | +See [LICENSE](https://www.google.com/search?q=LICENSE) for details. |
51 | 82 |
|
52 | | -## Architecture Notes |
| 83 | +----- |
53 | 84 |
|
54 | | -- MVVM with CommunityToolkit.Mvvm. |
55 | | -- DI configuration in `Services/ServiceConfiguration.cs`. |
56 | | -- Rules and automation in `Services/ProcessPowerPlanAssociationService.cs` and `ViewModels/ProcessPowerPlanAssociationViewModel.cs`. |
57 | | -- Performance dashboard in `Views/PerformanceView.xaml` and `ViewModels/PerformanceViewModel.cs`. |
| 85 | +## 📞 Support |
58 | 86 |
|
59 | | -## License |
| 87 | +**Made for Windows power users☕** [](https://paypal.me/PrimeBuildOfficial?country.x=IT&locale.x=it_IT) |
60 | 88 |
|
61 | | -GPLv3. See `LICENSE`. |
| 89 | + * **Issues**: [https://github.com/PrimeBuild-pc/ThreadPilot/issues](https://github.com/PrimeBuild-pc/ThreadPilot/issues) |
| 90 | + * **Discussions**: [https://github.com/PrimeBuild-pc/ThreadPilot/discussions](https://github.com/PrimeBuild-pc/ThreadPilot/discussions) |
0 commit comments