Documentation›3D avatar, desktop, groups, and daily life
26 Her world

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.

Local Waifu 1.8.0 macOS Windows
plain English first

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

  1. Open Settings → Screen.
  2. Turn on Screen awareness.
  3. 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.
  4. 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.

ModeWhat she does
Watch togetherShe 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 buddyQuicker, shorter reactions while you play
Focus guardYou 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 screenA 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.