Skip to content

README.md

Latest commit

 

History

History
100 lines (69 loc) · 3.94 KB

README.md

File metadata and controls

100 lines (69 loc) · 3.94 KB


💾 About The Project

AppMonitor (The "Keep It Alive" Utility)

AppMonitor is a lightweight, background PowerShell utility designed to keep your essential applications running. It sits quietly in your system tray, monitoring a list of specified processes. If an application crashes or closes unexpectedly, App Monitor waits for a grace period and then automatically relaunches it.

Built by: Zachary Whiteman & Google Gemini AI.

(back to top)

🔰 Getting Started

This script runs in the background and is managed via the system tray.

🕰️ Prerequisites

To run this script, you will need:

  • Windows Operating System.
  • PowerShell 5.1 or newer.
  • .NET Framework: Required for the System Tray icon and menus.
  • Icons (Optional): For the best visual experience, ensure the included .ICO files (ICON.ICO, ICON2.ICO, ICON3.ICO) are in the same directory.

💽 Installation & Execution

  1. Download: Download the AppMonitor.ps1 script file.
  2. Configuration: Open the script in a text editor and edit the $MonitoredApps array at the top to include the paths to the applications you want to keep alive.
  3. Unblock: Right-click the file, go to Properties, and click Unblock.
  4. Run: Execute the script. It handles its own backgrounding loop. 
    .\AppMonitor.ps1

(back to top)

🚀 Usage

Once running, the script lives in your system tray (near the clock).

  • Tray Icon Status:
    • 🟢 Green: Idle. All monitored apps are running or within their grace period.
    • 🔴 Red: Active. The script is currently launching an application.
    • 🟡 Yellow/Alert: Error or Paused. An app failed to launch, a file is missing, or monitoring is globally paused.
  • Context Menu (Right-Click):
    • Force Check Now: Manually triggers a scan of all processes immediately.
    • Manage Apps: Toggle monitoring on or off for individual applications.
    • Pause All Monitoring: Globally pauses the script.
    • Exit: Closes the monitor.

(back to top)

✨ Key Features

  • Self-Healing: Automatically detects closed applications and restarts them.
  • Visual Feedback: The tray icon changes color to reflect the current status.
  • Startup Self-Test: Runs a quick color-cycling animation on the tray icon at launch.
  • Granular Control: Toggle monitoring for specific apps without stopping the entire script.

(back to top)

🛠️ Technology Stack

  • Scripting Language: PowerShell
  • GUI Framework: .NET Windows Forms (WinForms) for the System Tray integration.
  • Core Logic: Uses Get-Process and Start-Process.

(back to top)

📐 Architecture & Security Notes

  • User Context: The script runs in the context of the user who started it.
  • Configuration: Hardcoded $MonitoredApps array within the script.

(back to top)

🪪 License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

☎️ Contact

Zach Whiteman - elitesoftwarecolimited@gmail.com

HuggingFace - https://huggingface.co/EliteSoftware

HuggingFace (Personal) - https://huggingface.co/TheShadyRainbow

LinkTree - https://linktr.ee/zachrainbow

Patreon - https://www.patreon.com/c/EliteSoftwareCo

(back to top)