Use Screen Awareness
Let her watch a film or game with you, keep you on task, or answer a question about your screen, without saving any frame.
Follow the bold button names and numbered steps. Technical names are included only when you need to recognize a model or file inside the app.
Screen awareness lets her look at your screen: watch a film or play a game together, keep you on task, or answer a question about what you are looking at. It is off by default. The setting says it plainly: Frames are never saved. They are looked at once, in memory, then thrown away. Only her reaction is kept.
She needs a model that can see images. If none is available she says so: I need a vision model to see your screen. Set one up in Settings. Chapter 27 covers vision-capable models.
Turn it on
Goal
Allow screen awareness and give the app the system permission it needs.
Steps
- Open Settings → Screen.
- Turn on Screen awareness.
- On macOS, allow Screen Recording. If the tab says Screen Recording is not allowed, select Open System Settings, switch Local Waifu on under Privacy & Security → Screen & System Audio Recording, and relaunch the app. macOS only applies the change after a relaunch. Select I’ve enabled it, check again afterwards.
- Nothing is captured until you start one of the modes below.
Expected result
The tab shows Screen Recording is allowed (macOS) and the modes are ready.
If something goes wrong
- If permission is lost while she is watching, she stops and says Screen Recording permission was lost, so I stopped watching.
- If she cannot capture the screen, she stops and says so rather than retrying silently.
- On Windows there is no separate permission step. Protected video, such as some streaming apps, appears black to her, so she may not react to it.
Start a mode
Start a mode from Settings → Screen under Start, or from the Screen button in the message box (the monitor icon). While the master switch is off, that button only leads to the setting.
| Mode | What she does |
|---|---|
| Watch together | She comments now and then on what you watch. By default she looks every 20 seconds. You can set Look every N s while watching from 10 to 120 seconds |
| Game buddy | Quicker, shorter reactions while you play |
| Focus guard | You tell her what you are working on and for how long. She glances at your screen and nudges you if you drift. By default she checks every 150 seconds, adjustable from 60 to 600 |
| Ask about my screen | A one-off question. She captures the screen and answers about it |
For Focus guard, a dialog asks What are you working on?, then For a duration (minutes) or Until a time, then Start focus.
While a mode runs, a banner shows what is happening, for example Watching your screen, Game buddy is watching your screen, or Focus guard until a time. The banner has Pause, Resume, and Stop.
Choose what she captures
- “Ask her” captures: The whole screen or The active window.
- Allow a cloud vision model: off by default. When it is on and no local vision model is available, your screen frames go to the cloud provider you chose. Leave it off to keep everything on your computer.
- Never capture these apps: a list of app or window names. If one of them is on screen, nothing is captured at all, and the app says Not captured: a protected app is on screen. Password managers are always protected and cannot be removed from the list.
Shortcuts
The Shortcuts block in the tab shows the two keyboard shortcuts for your platform: one to capture and ask her, and one to pause or resume watching. They are global, so they work from any app.
Quiet Mode and screen awareness
When Quiet Mode is on because of a meeting or a fullscreen app, watching pauses and the banner says Watching paused, Quiet Mode (meeting or fullscreen). Chapter 18 explains Quiet Mode.