TIPCAT — Tray Icon Power Condition Action Trigger

The ultimate FOSS Windows power plan automation engine · Engine Version dev

Author: MarekM(AKMSoft) Contact: MaxKfK: u/Glad-Journalist-4807 Generated: 2026-11-17 20:39

A lightweight, versatile FOSS (Free and Open Source Software) Windows power plan switcher — and the only one that actually takes care of your eyes by preserving your exact screen brightness across power plan transitions. It switches plans automatically based on running applications, Windows Performance Counters, and AC/Battery state, while letting you design custom user tray icons for every rule.

1. Overview 2. Golden Rule 3. Rule Syntax 4. Fallback Rules 5. Examples 6. Config File 7. Sample Config 8. Getting Started

1. Overview

TIPCAT is a Free and Open Source (FOSS) utility available as a standalone executable (.exe) and as open PowerShell source (.ps1). It evaluates a list of user-defined rules every few seconds (default: 5 seconds) and switches the system power plan (Power saver, Balanced, High Performance, Ultimate Performance, or any custom plan) to the one assigned to the first matching rule.

Process & Path TriggersSwitch plans when a specific executable (firefox.exe) or an entire directory (C:\Games\) is running.
Windows Performance CountersReact to real-time metrics such as CPU load, disk activity, GPU, or available memory and scale performance dynamically.
Complex Boolean LogicCombine paths and counters in a single rule using AND, OR, and parentheses.
AC / Battery AwarenessDefine separate rule sets depending on whether the machine is plugged in or running on battery.
Eye-Friendly Brightness Carry-OverCurrent screen brightness is preserved when switching plans, so laptops never suddenly dim or blind you.
Custom User Tray IconsDefine custom per-rule foreground/background colors, letter badges (e.g., PS, B, UP), or custom user icon files.
Smart DocIndividual, per-machine performance counters HTML documentation with filtering based on a custom multilingual dictionary.
One-Time InitBuilt-in tray tool to override Modern Standby limitations, restore hidden Windows power plans, and auto-populate your config file.

2. The Golden Rule

First match wins Rules are evaluated sequentially from top to bottom. The first matching rule triggers the corresponding power plan switch and immediately halts further evaluation for that cycle.

Because evaluation stops at the first match, rule order matters:

  1. Put your most specific and highest-priority rules at the top.
  2. Put general / default fallback rules at the very bottom.

3. Rule Syntax

Rules live in the configuration file (TIPCAT_*.cfg) as 6-column CSV lines:

MODE, CONDITION, POWER_PLAN, FG_COLOR, BG_COLOR, LETTER
ColumnDescription
MODEAC (plugged in) or BAT (on battery).
CONDITIONPath/process check, performance counter comparison, or a combination of both (see below).
POWER_PLANAlias of the target power plan, as defined in the PowerPlan= entries.
FG_COLOROptional. Tray icon foreground (text) color.
BG_COLOROptional. Tray icon background color.
LETTEROptional. Letter(s) or custom icon identifier displayed on the tray icon. Leave the three optional fields blank if you do not want a custom badge for a rule.

Type 1: Path & Process Conditions

True when the given executable name or folder path is currently running/active. A folder path also matches every executable in its subfolders.

AC,C:\Games\XCOM,Test lower clocks
AC,C:\Games\,High Performance
BAT,notepad.exe,Power saver

Type 2: Performance Counter Conditions

True when a Windows Performance Counter compared against a numeric threshold holds. Any valid Windows Performance Counter available on the system can be used.

AC,\Processor(_Total)\% Processor Time > 32,Ultimate Performance

Operators & Logic

ElementMeaning
<   >   =Comparison operators (internally translated to -lt, -gt, -eq).
AND   ORLogical operators (translated to -and, -or). Mix any number of paths and counters in one rule.
(   )Parentheses for grouping complex boolean expressions.

4. Default & Fallback Rules

To make sure Windows always returns to a predictable baseline when none of your specific triggers are active, place fallback rules at the bottom of the configuration file:

BAT,C:\,Power saver,Red,LightSkyBlue,PS
AC,C:\,Power saver,DarkBlue,LightSkyBlue,PS
Why this works Windows always has system or user processes running from the C:\ drive, so a rule matching C:\ is always true when evaluation reaches it. You can also use Balanced as the AC fallback, e.g., AC,C:\,Balanced,White,SkyBlue,B.
Non-standard system drive If your system drive uses a different letter, replace C:\ with your active system drive, such as D:\.

5. Configuration Examples (Basic to Advanced)

Example 1: Entire Folder Trigger (Basic)

Switches to High Performance whenever any executable inside C:\Games\ (including subfolders) runs on AC power. Shows a Firebrick G on a Gold tray icon.

AC,C:\Games\,High Performance,Firebrick,Gold,G

Example 2: Specific Subfolder Override (Priority Ordering)

Placed above the general C:\Games\ rule, this overrides the plan for XCOM only, with a DarkBlue XC badge on Yellow.

AC,C:\Games\XCOM,Test lower clocks,DarkBlue,Yellow,XC

Example 3: Single Performance Counter with Custom Badge

Switches to Ultimate Performance when total CPU usage exceeds 32% on AC power, showing a LightGreen UP on OrangeRed.

AC,\Processor(_Total)\% Processor Time > 32,Ultimate Performance,LightGreen,OrangeRed,UP

Example 4: Combining Two Conditions (OR Logic)

On battery, switches to Power saver if either notepad.exe or SumatraPDF.exe is running.

BAT,notepad.exe OR SumatraPDF.exe,Power saver,Red,LightSkyBlue,PS

Example 5: Folder Path + Performance Counter (AND Logic)

Ultimate Performance only when Firefox is running and CPU usage exceeds 50%, which avoids high power draw while merely reading static pages. The rule right below keeps Firefox on Balanced during normal browsing.

AC,C:\Program Files\Mozilla Firefox\ AND (\Processor(_Total)\% Processor Time > 50),Ultimate Performance,LightGreen,OrangeRed,UP
AC,C:\Program Files\Mozilla Firefox\,Balanced,RoyalBlue,SpringGreen,B

Example 6: Multi-Metric Rule with Parentheses (Advanced)

Ultimate Performance on AC when OpenShot is running or the system is under heavy combined load (CPU > 25% AND Disk Time > 50%), while more than 2048 MB of RAM is still free.

AC,(C:\Program Files\OpenShot OR (\Processor(_Total)\% Processor Time > 25 AND \PhysicalDisk(_Total)\% Disk Time > 50)) AND \Memory\Available MBytes > 2048,Ultimate Performance,Gold,OrangeRed,O

6. Configuration File Architecture (.cfg)

The configuration file controls general engine behavior, power plan definitions, and automation rules.

# TIPCAT CONFIGURATION vdev
ProcessCheckInterval=7
KeyCheckInterval=100
PoolKeyboard=0
LogLevel=0
AutoInheritBrightness=1
DisplaySubGroup=7516b95f-f776-4464-8c53-06167f40cc99

# Power Plans: Alias=GUID, Color, Letter
PowerPlan=High Performance,ff8df10d-5c3f-4e46-9c79-1d457b194356,White,H
PowerPlan=Test lower clocks,63a04321-21f8-445c-9deb-b62efb0e19d7,White,T
PowerPlan=Power saver,501b7e45-8bd6-4c7c-89e0-e203023bed61,White,P
PowerPlan=Balanced,381b4222-f694-41f0-9685-ff5bb260df2e,White,B
PowerPlan=Ultimate Performance,38b3f036-5bcc-48e2-be08-2f219c8d7ec5,White,U

# Rules: MODE, CONDITION, PLAN, FG_COLOR, BG_COLOR, LETTER
AC,C:\Games\XCOM,Test lower clocks,DarkBlue,Yellow,XC
AC,C:\Games\,High Performance,Firebrick,Gold,G
...
SectionPurpose
Global settingsProcessCheckInterval (polling frequency in seconds), KeyCheckInterval (keyboard monitoring frequency), LogLevel, AutoInheritBrightness, and GUID mappings such as DisplaySubGroup.
Power plansMaps friendly aliases (e.g., High Performance) to Windows Power Plan GUIDs, plus a default accent color and letter badge.
RulesThe execution matrix: power source (AC / BAT), condition, target plan, and optional tray icon styling. Evaluated top to bottom (see the Golden Rule).

7. Complete Sample Configuration

Specific app overrides at the top, stepped CPU scaling in the middle, fallback rules at the bottom:

# 1. Specific application & folder rules (highest priority)
AC,C:\Games\XCOM,Test lower clocks,DarkBlue,Yellow,XC
AC,C:\Games\,High Performance,Firebrick,Gold,G
AC,C:\Program Files\OpenShot,Ultimate Performance,Gold,OrangeRed,O
AC,C:\Program Files\Mozilla Firefox\ AND (\Processor(_Total)\% Processor Time > 50),Ultimate Performance
AC,C:\Program Files\Mozilla Firefox\,Balanced,RoyalBlue,SpringGreen,B

# 2. Stepped CPU load scaling (AC)
AC,\Processor(_Total)\% Processor Time > 32,Ultimate Performance,LightGreen,OrangeRed,UP
AC,\Processor(_Total)\% Processor Time > 20,High Performance,Firebrick,DarkOrange,Hi
AC,\Processor(_Total)\% Processor Time > 16,High Performance,Firebrick,Gold,Hi
AC,\Processor(_Total)\% Processor Time > 8,Balanced,White,SkyBlue,B

# 3. Stepped CPU load scaling (Battery)
BAT,\Processor(_Total)\% Processor Time > 24,High Performance,DarkRed,HotPink,H
BAT,\Processor(_Total)\% Processor Time > 12,Balanced,Crimson,DarkSalmon,B

# 4. Default / Fallback rules (always keep at the bottom)
BAT,C:\,Power saver,Red,LightSkyBlue,PS
AC,C:\,Power saver,DarkBlue,LightSkyBlue,PS

8. Getting Started

  1. Download the standalone executable (TIPCAT_*.exe) from the Releases section, or TIPCAT_*.ps1 and TIPCAT_*.cfg to run directly in PowerShell.
  2. Run One-time init (Optional): Right-click the tray icon → Tools → One-time init (right below Show colors) to override Modern Standby restrictions, restore hidden Windows power plans, and save them into your config.
  3. Edit TIPCAT_*.cfg to match your Windows power plan names, application paths, and thresholds.
  4. Launch the .exe, or run the .ps1 in PowerShell (your execution policy must allow local scripts, e.g., Set-ExecutionPolicy -Scope CurrentUser RemoteSigned).
  5. Explore this reference: right-click the tray icon to generate the manual, which scans all Windows Performance Counters on your PC.

Links & Mirrors

Developed by AKMSoft.