This release is a pre-release and may not be stable for production use.
About
PowerRules allows you to define rules that automatically control the power state of your computer based on configurable conditions.
Rules are evaluated from top to bottom. The first matching rule executes its configured action.
Getting Started
Install with pip:
pip install powerrules
Create a policy file:
# yaml-language-server: $schema=https://raw.githubusercontent.com/LeoTN/PowerRules/main/assets/schema/powerrules_policy.schema.json
rules:
- name: "Shutdown after nightly weekend backup"
conditions:
and:
- process:
name: "backup.exe"
running: false
- window:
title: "Backup Completed"
exists: true
- datetime:
between:
start: "23"
end: "1:30"
- datetime:
weekday: ["Saturday", "Sunday"]
action:
type: shutdown
Validate the policy:
pwru policy validate
Show configured rules:
pwru policy show
Evaluate the policy once:
pwru policy run --once
Run continuously:
pwru policy run
Use a different policy file with --policy or -p:
pwru policy run --policy my-policy.yaml
Features
| Feature | Description |
|---|---|
| Rule-based power management | Define ordered rules with conditions and power actions |
| Process conditions | Match rules based on whether a process is running |
| Time conditions | Match time ranges and weekdays |
| Window conditions | Match window titles |
| Logical conditions | Combine conditions using and, or, and not |
| Matching behavior | How a value (process name, window title, etc.) should be matched. By default, an exact, case-sensitive match is used. |
| Power actions | Shutdown, sleep, hibernate, and reboot |
| Continuous evaluation | Evaluate policies repeatedly |
| First-match execution | Only the first matching rule executes once per match |
Supported Platforms
| Platform | Status |
|---|---|
| Windows 10/11 | ✅ |
| Linux | ✅ |
| macOS* | ✅ |
* Hibernation is not supported on macOS.
Credits & License
- Pydantic → configuration validation
- PyYAML → YAML policy parsing
- Typer → command-line interface
- psutil → process information
- PyWinCtl → window information
- Inkscape → program used to design the logo
This repository is licensed under the MIT License.
1 maintainer
Release files for powerrules 0.2.0b0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| powerrules-0.2.0b0.tar.gz | 14.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| powerrules-0.2.0b0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 36.9 kB
Release files / powerrules-0.2.0b0.tar.gz
| Download URL | powerrules-0.2.0b0.tar.gz |
|---|---|
| Size | 14.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
673956923fa0e9e7f5f56da38ed850e048f95825c8b892b5c21baaa2ff4e4c70
|
|
BLAKE2b-256 checksum How to use checksums |
2275ae0dfb8685401dbe5cd95a2297f2ac6913a44ee4bc1cc9efacafc5828d61
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.12.3 Linux/6.17.0-1022-azure
|
Release files / powerrules-0.2.0b0-py3-none-any.whl
| Download URL | powerrules-0.2.0b0-py3-none-any.whl |
|---|---|
| Size | 22.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
998aac7f04e211c5a4ff03456d443e50aef0f2671c812ecef546846169699d3d
|
|
BLAKE2b-256 checksum How to use checksums |
e2f3a6c8b9ed0abc44acfecebfd11a5d19255965cd390bbcdba4e80e11fdfc64
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.12.3 Linux/6.17.0-1022-azure
|
