{"id":25263868,"url":"https://github.com/protostarship/systemguardian","last_synced_at":"2026-05-16T01:35:11.053Z","repository":{"id":276781977,"uuid":"930280584","full_name":"Protostarship/SystemGuardian","owner":"Protostarship","description":"SystemGuardian is a powerful Windows service designed for real-time system monitoring, failure prevention, and automated recovery. It safeguards critical system components, detects driver failures, registry modifications, and service disruptions, and takes automatic corrective actions to prevent crashes and instability.","archived":false,"fork":false,"pushed_at":"2025-02-11T12:29:57.000Z","size":36,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-06T01:15:36.103Z","etag":null,"topics":["csharp","guard","guardian","system-guardian","windows","windows-10","windows-11","windows-insider-program","windows-insiders","windows-server-2016","windows-service","windows-services"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Protostarship.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-10T11:31:02.000Z","updated_at":"2025-02-11T12:30:00.000Z","dependencies_parsed_at":"2025-02-10T12:32:27.009Z","dependency_job_id":"9f255834-d175-46d5-8cac-3f5a5c552f59","html_url":"https://github.com/Protostarship/SystemGuardian","commit_stats":null,"previous_names":["protostarship/systemguardian"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Protostarship%2FSystemGuardian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Protostarship%2FSystemGuardian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Protostarship%2FSystemGuardian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Protostarship%2FSystemGuardian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Protostarship","download_url":"https://codeload.github.com/Protostarship/SystemGuardian/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247419864,"owners_count":20936014,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csharp","guard","guardian","system-guardian","windows","windows-10","windows-11","windows-insider-program","windows-insiders","windows-server-2016","windows-service","windows-services"],"created_at":"2025-02-12T07:26:10.506Z","updated_at":"2026-05-16T01:35:10.879Z","avatar_url":"https://github.com/Protostarship.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SystemGuardian - Comprehensive Documentation\n\n## 📌 Overview\n**SystemGuardian** is a high-performance Windows service designed for **real-time system monitoring, failure prevention, and automated recovery**. It ensures system stability by tracking **drivers, services, registry changes, and system integrity**, preventing potential failures, crashes, and unauthorized modifications.\n\n## 📥 Installation \u0026 Setup\n### 1️⃣ Prerequisites\n- Windows **10/11**, Windows **Insider Preview** or **Windows Server 2016+**\n- Administrator privileges\n\n### 2️⃣ Install SystemGuardian\nTo install the SystemGuardian service, open a command prompt with **Administrator privileges** and run:\n```powershell\nsc create SystemGuardian binPath= \"C:\\\\Path\\\\To\\\\SystemGuardian.exe\" start= auto\n```\nThis registers the service in Windows and configures it to start automatically on system boot.\n\n### 3️⃣ Start the Service\nTo manually start the service, run:\n```powershell\nsc start SystemGuardian\n```\n\n### 4️⃣ Stop or Restart the Service\nIf you need to stop or restart the service, use:\n```powershell\nsc stop SystemGuardian\nsc start SystemGuardian\n```\n\n### 5️⃣ Uninstall SystemGuardian\nTo remove the service completely from the system, execute:\n```powershell\nsc delete SystemGuardian\n```\n\n## ⚙️ How It Works\n### 🛡️ **Core Features**\n#### ✅ **Real-time System Monitoring** - Watches **drivers, registry keys, and services** for changes.\n#### ✅ **Automated Recovery**  - Restores **services, drivers, and registry keys** from backups.\n#### ✅ **Integrity Protection** - Uses **SHA-256 file hashing** to detect modifications.\n#### ✅ **Driver Verification** - Blocks **unsigned/unverified drivers**.\n#### ✅ **Crash Prevention** - Detects system crashes and **creates restore points automatically**.\n#### ✅ **Event Logging \u0026 Alerts** - Logs system failures and can **notify administrators**.\n\n### 🔄 **Recovery Process**\n1. **Detect** an issue (e.g., service failure, driver corruption).\n2. **Backup** registry and critical components.\n3. **Attempt Auto-Recovery**:\n   - **Restart failed services**.\n   - **Restore corrupted drivers from backups**.\n   - **Rollback registry keys if altered**.\n4. **Notify the user** if intervention is required.\n\n## 🔧 Configuration Management\n### 🔹 Configuration File Location\nSystemGuardian uses a configuration file to define which system components should be monitored. The default configuration file is located at:\n```plaintext\nC:\\ProgramData\\SystemGuardian\\config.json\n```\n\n### 🔹 What if the Configuration File is Missing?\n- If the configuration file **does not exist**, the service will automatically generate a default configuration with standard monitoring settings.\n- Users can manually create a configuration file in the same directory to customize monitoring.\n\n### 🔹 Example Configuration File\n```json\n{\n    \"MonitorDrivers\": true,\n    \"MonitorServices\": true,\n    \"MonitorRegistry\": true,\n    \"CriticalPaths\": [\n        \"C:\\\\Windows\\\\System32\\\\drivers\",\n        \"C:\\\\Windows\\\\System32\"\n    ]\n}\n```\n\n### 🔹 Modifying Configuration Settings\nTo modify the configuration:\n1. Open `C:\\ProgramData\\SystemGuardian\\config.json` with a text editor.\n2. Adjust monitoring preferences as needed.\n3. Restart the service for changes to take effect:\n   ```powershell\n   sc stop SystemGuardian\n   sc start SystemGuardian\n   ```\n\n### 🔹 Enable Debug Logging\nTo enable **verbose logging** for troubleshooting:\n```powershell\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Services\\SystemGuardian\" -Name \"DebugLogging\" -Value 1 -PropertyType DWord -Force\n```\n\n---\n\n## 📜 Service Management\n### 🔹 Checking Service Status\nTo check if the service is running:\n```powershell\nsc query SystemGuardian\n```\n\n### 🔹 Viewing Logs\n- Logs are saved in: `C:\\ProgramData\\SystemGuardian\\Logs\\`\n- Use Notepad or PowerShell to view logs:\n  ```powershell\n  Get-Content C:\\ProgramData\\SystemGuardian\\Logs\\latest.log -Tail 50 -Wait\n  ```\n\n### 🔹 Manually Recovering a Component\nIf a monitored component fails and SystemGuardian does not auto-recover it, you can manually recover it by running:\n```powershell\nSystemGuardian.exe /recover \"ComponentName\"\n```\n\n### 🔹 Restoring Registry from Backup\n```powershell\nreg import C:\\ProgramData\\SystemGuardian\\registry_backup.reg\n```\n\n---\n\n## 🔍 Considerations \u0026 Best Practices\n1️⃣ **Always Run as Administrator** - SystemGuardian requires administrative privileges to monitor and recover system components.\n\n2️⃣ **Regularly Check Logs** - Monitor logs in `C:\\ProgramData\\SystemGuardian\\Logs\\` to detect unusual activity.\n\n3️⃣ **Backups are Critical** - Ensure that **registry and system file backups** are created regularly.\n\n4️⃣ **Avoid Modifying System Files Manually** - If you need to restore a system file, use the SystemGuardian recovery process.\n\n5️⃣ **Verify Driver \u0026 Service Integrity** - Before installing third-party drivers, use SystemGuardian's integrity verification features to ensure they are safe.\n\n---\n\n## ❓ FAQ \u0026 Troubleshooting\n### ❓ How do I check service status?\n```powershell\nsc query SystemGuardian\n```\n\n### ❓ Where are logs stored?\n- Logs are saved in: `C:\\ProgramData\\SystemGuardian\\Logs\\`\n\n### ❓ How do I manually recover a component?\n- Open a command prompt as **Administrator**.\n- Run:\n```powershell\nSystemGuardian.exe /recover \"ComponentName\"\n```\n\n### ❓ What happens if a driver is blocked?\n- SystemGuardian will **isolate the driver**, preventing it from running.\n- The user will be notified and can **choose to restore or permanently block** it.\n\n---\n\n## 📞 Support\nFor assistance, open an issue on our **GitHub repository** or contact support at: `relay.arbiter303@gmail.com`.\n\n---\n\n**© 2025 SystemGuardian | All Rights Reserved**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprotostarship%2Fsystemguardian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprotostarship%2Fsystemguardian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprotostarship%2Fsystemguardian/lists"}