Awareness Engine

Overview

Most of CCP happens in a session, in its own window, on purpose. The Awareness Engine doesn't. It sits in the background, watches for words you chose, and reacts wherever you are: a browser tab, a chat, a document, a game.

You give it a word. You give it one or more things to do when that word turns up. That's the whole idea. The rest of this page is the detail.

• Two ways of noticing - it can read text off your screen, and it can watch what you type.
• Ready-made packs - four themed sets of words and reactions you can install in one click.
• Mix and match reactions - each word can fire any combination of eight kinds of action.
• Word highlighting - matched words get a coloured box drawn around them on screen.
• Anti-loop protection - several layers of it, so the app can't set itself off in circles.

Signal Sources

Two ways it can notice a word. You can run either, both, or neither.

Screen OCR

OCR just means "reading text out of a picture". Every few seconds the app takes a snapshot of your screens, reads the words in it, and checks them against your list. This is what catches words you're looking at rather than words you're writing: web pages, chat, documents, games.

• Scans every 3 seconds by default, adjustable from 2 to 10.
• Covers all your monitors.
• Each word on screen fires once. It won't nag you about the same word sitting in the same place.
• Small shifts in position (from typing above it, or a slight scroll) don't count as a new word.
• When it thinks it has found something, it quickly re-scans to confirm before firing, so a flicker or a rendering glitch doesn't set anything off.
• CCP's own windows are ignored by default, so she can't read her own speech bubble and react to it.

Keyboard

Keeps a short rolling record of what you've typed and fires the moment you finish a trigger word. No waiting for the next screen scan.

• Remembers the last 200 characters, and no more.
• Clears itself after 3 seconds of not typing (adjustable from 1 to 10 seconds).
• Matches whole words only, so typing "sit" won't fire from "intensity".
• Multi-word triggers match words typed one after another.

Built-in Presets

Four themed packs ship with CCP, eight trigger words each. Install one with a single click from the Awareness tab, then edit anything you don't like.

Action Types

Every trigger word can fire any combination of the eight actions below. If two words match on the same screen scan, their actions are merged so you don't get everything twice.

Word Highlighting

When screen reading catches one of your words, a coloured box appears around it, right where the word is.

• Colour - neon pink by default (#FF69B4), with a set of swatches to choose from.
• Duration - 1.5 seconds by default, anywhere from 0.3 to 5 seconds.
• Mode - box every new match, or only a random handful per scan if you want it subtler.
• Invisible to capture - by default the boxes are hidden from screen recording and streaming software. That's partly for your privacy and partly practical: if they showed up in the next screenshot, the app would read its own highlights and set itself off. There's a toggle if you actually want them on stream.

Preset Editor

Installing Presets

1. Open the Awareness tab.
2. Look through the presets.
3. Hit Install to add that pack's words to your active list.
4. Use the master switch to turn the whole engine on and off.

Managing Presets

• Uninstall - takes that pack's words back out of your active list.
• Clone - makes your own copy to mess with, leaving the original alone.
• Updates - the four built-in packs update themselves when a newer version ships with CCP. Your clones don't, which is rather the point of cloning.

Custom Triggers

Adding your own:

1. On the Awareness tab, click the + New Preset card at the end of the preset row, or open a preset you already installed.
2. In the preset editor, click ＋ Add trigger at the bottom of the trigger list.
3. Type the word, or a pattern if you want to catch several forms at once.
4. Add one or more actions - audio, visual, haptic, and so on.
5. Set how long that word has to wait before it can fire again.
6. Save and switch it on.

Safety Features

A trigger that fires a subliminal, which the screen reader then sees, which fires the trigger again, is a loop that ends with your afternoon gone. Several layers exist to stop exactly that, plus a couple to keep the engine out of places it shouldn't be looking.

Settings Reference