Complete rules you can validate and apply without opening the GUI. The JSON format, field semantics and quota rules are documented in RULE_AUTHORING.md; this file is a recipe book. Replace paths and process names with values from your own machine.
Every example validates with:
cmd /c "Synector.exe --rules-validate rule.json"
cmd /c "Synector.exe --rules-apply rule.json"Use --rules-sync instead of --rules-apply when the file should become the complete rule set.
--dry-run previews the result.
Starts a helper tool with the game and closes it when the game exits. single_instance: true
makes the rule fire only for the first matching instance and defers cleanup until every tracked
instance has exited.
{
"id": "rule_game_companion",
"name": "Start the companion with the game",
"description": "Runs a helper HUD while the game is open and closes it with the game.",
"trigger": {
"$trigger_type": "process",
"process_name": "game.exe",
"match_mode": "exact",
"single_instance": true
},
"actions": [
{
"$action_type": "start_process",
"file_path": "C:\\Tools\\CompanionHud.exe",
"arguments": "--attach game.exe",
"working_directory": "C:\\Tools",
"close_on_exit": true
}
]
}Trims the working set of one process. A cooldown prevents repeated trimming while the hotkey is held.
{
"id": "rule_trim_browser_memory",
"name": "Trim browser working set",
"trigger": {
"$trigger_type": "hotkey",
"key_combination": "CTRL+ALT+R"
},
"actions": [
{
"$action_type": "process_tuning",
"target_process": "chrome.exe",
"trim_memory": true
}
],
"cooldown_seconds": 5
}Anything on the machine can call
http://127.0.0.1:48123/api/v1/trigger/backup. The quota allows five runs per
clock hour and then skips requests until the hour rolls over; the rule stays enabled.
{
"id": "rule_webhook_backup",
"name": "Backup on webhook",
"trigger": {
"$trigger_type": "webhook",
"endpoint_path": "backup"
},
"actions": [
{
"$action_type": "notification",
"title": "Backup",
"message": "Webhook received, starting the backup."
},
{
"$action_type": "execute_script",
"interpreter": "power_shell",
"script": "Write-Output 'backup placeholder'"
}
],
"max_executions": 5,
"quota_period": "hour"
}Replace the placeholder script with your own command. Script bodies are never written to the log.
Watches an inbox folder and packs it into a ZIP. The cooldown coalesces bursts of file events into one archive operation.
{
"id": "rule_archive_logs",
"name": "Archive new logs",
"trigger": {
"$trigger_type": "file_watcher",
"folder_path": "C:\\Logs\\Inbox",
"filter_extension": "log",
"on_created": true
},
"actions": [
{
"$action_type": "archive",
"operation": "pack",
"format": "zip",
"source_path": "C:\\Logs\\Inbox",
"destination_path": "C:\\Logs\\Archive\\logs.zip",
"overwrite": true
}
],
"cooldown_seconds": 30
}Two rules in one file. --rules-apply accepts an array, a single object, or {"rules": [...]}.
[
{
"id": "rule_power_high_morning",
"name": "High performance on weekday mornings",
"trigger": {
"$trigger_type": "schedule",
"schedule_type": "daily",
"daily_time": "09:00:00",
"days_of_week": [1, 2, 3, 4, 5]
},
"actions": [
{
"$action_type": "power_plan",
"plan": "high_performance"
}
]
},
{
"id": "rule_power_balanced_evening",
"name": "Balanced power in the evening",
"trigger": {
"$trigger_type": "schedule",
"schedule_type": "daily",
"daily_time": "19:00:00",
"days_of_week": [1, 2, 3, 4, 5]
},
"actions": [
{
"$action_type": "power_plan",
"plan": "balanced"
}
]
}
]days_of_week uses 1 = Monday through 7 = Sunday.
One hotkey either restores an existing window or starts the application. Conditions use the
$condition_type tag; the same condition type is valid in a top-level conditions list.
{
"id": "rule_focus_or_start_notepad",
"name": "Focus or start Notepad",
"trigger": {
"$trigger_type": "hotkey",
"key_combination": "CTRL+ALT+N"
},
"actions": [
{
"$action_type": "if_else",
"conditions": [
{
"$condition_type": "process_running",
"process_name": "notepad.exe",
"must_be_running": true
}
],
"then_actions": [
{
"$action_type": "window",
"target_process": "notepad.exe",
"window_action": "restore"
}
],
"else_actions": [
{
"$action_type": "start_process",
"file_path": "C:\\Windows\\System32\\notepad.exe"
}
]
}
]
}Sleep, resume, display state and device changes are pushed by Windows through a hidden notification window, so these rules fire without polling.
[
{
"id": "rule_mute_on_sleep",
"name": "Mute playback before sleep",
"trigger": {
"$trigger_type": "system",
"event_type": "system_sleep"
},
"actions": [
{
"$action_type": "audio_control",
"target": "playback",
"action_type": "mute"
}
]
},
{
"id": "rule_unmute_on_resume",
"name": "Unmute playback after resume",
"trigger": {
"$trigger_type": "system",
"event_type": "system_resume"
},
"actions": [
{
"$action_type": "audio_control",
"target": "playback",
"action_type": "unmute"
}
]
}
]The wait step blocks only this execution. timeout_policy: "abort" stops the remaining pipeline if
the process does not appear within 60 seconds; use "continue" to run the following steps anyway.
{
"id": "rule_launch_game_priority",
"name": "Launch the game with high priority",
"trigger": {
"$trigger_type": "hotkey",
"key_combination": "CTRL+ALT+G"
},
"actions": [
{
"$action_type": "start_process",
"file_path": "D:\\Games\\Example\\game.exe",
"working_directory": "D:\\Games\\Example"
},
{
"$action_type": "wait",
"mode": "until_condition",
"condition": {
"type": "process_started",
"process_name": "game.exe"
},
"timeout_sec": 60,
"timeout_policy": "abort"
},
{
"$action_type": "process_tuning",
"target_process": "game.exe",
"priority": "high"
}
]
}- A toggle hotkey uses
hold_mode: trueto repeat the pipeline while held, orrepeat_while_held: truewithout hold mode to loop until pressed again. - On-exit actions belong to
on_exit_actions; they run after the pipeline, including when a bound companion is cleaned up. - Runtime counters (
execution_count,last_executed_at, the custom quota anchor) are owned byruntime.json; values in a rule file are ignored when an existing rule is updated. - Share codes (
SYN1:) bundle the presets and overlays a rule references; imported rules are created disabled unless--enable-importedis passed.