Use localwaifu Links
Control Local Waifu from a shortcut, the Run dialog, Siri, or a script with localwaifu:// links.
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.
A localwaifu:// link lets another program talk to Local Waifu. You can send her a message, start or end a call, start screen watching, start focus guard, or run the morning brief, from a desktop shortcut, a launcher, a script, or on macOS the Shortcuts app and Siri.
Links only run while Local Waifu is unlocked. The settings for them are in Settings → Advanced, in the block called Shortcuts and Siri on macOS and Shortcuts and links on Windows.
Turn links on or off
- Allow Shortcuts links (Allow localwaifu:// links on Windows): on by default. Turn it off to ignore every link. A link that arrives while this is off is rejected with a message pointing here.
- Skip the confirmation for these actions: off by default. While it is off, a link that sends a message, switches character, starts a call, starts screen watching, or starts focus guard asks you first: A Shortcut wants to… with Allow and Deny. Turn the skip on only if you trust every shortcut on this computer. On Windows any program can open a link, so be strict.
The links
Copy any of these with Copy link in the block:
| Link | What it does |
|---|---|
localwaifu://send?text=Good%20morning | Send her a message. Add &character=Name to pick who |
localwaifu://call/start | Start a voice call |
localwaifu://call/stop | End the call |
localwaifu://watch/start | Start watching your screen |
localwaifu://watch/stop | Stop watching your screen |
localwaifu://focus/start?minutes=25 | Start focus guard (minutes are optional, 1 to 240) |
localwaifu://focus/stop | Stop focus guard |
localwaifu://brief/run | Run the morning brief now |
A link marked coming soon in the block is not active in your build. If a link names a character that does not exist, the app says No character named that name.
To send your own words, URL-encode them: a space becomes %20. A link is limited to 4096 bytes after encoding, which is roughly 650 characters of non-English text, so keep messages short.
Use a link on macOS
Goal
Make a Siri phrase or a Shortcuts action that talks to her.
Steps
- Open the Shortcuts app and choose New Shortcut.
- Add the Open URLs action and paste one of the links.
- Name the shortcut. That name is what you say to Siri.
- To send dictated text, add Ask for Input, then URL Encode, and use
localwaifu://send?text=followed by the encoded text.
Links only work once Local Waifu is installed in the /Applications folder.
Use a link on Windows
Steps
- Desktop shortcut: right-click the desktop, choose New → Shortcut, and paste a link as the location. Opening the shortcut runs the action.
- Run dialog: press
Win+R, paste a link, and press Enter. - Anything that can open a URL also works: a launcher such as PowerToys Run, a Stream Deck website action, an AutoHotkey command, or
start "" "localwaifu://call/start"in a terminal.
Windows learns the links when Local Waifu is installed with its installer. A copy that was only unpacked does not register them. If you are busy in another app, Windows may only flash Local Waifu on the taskbar instead of bringing it to the front. Open it to answer Allow or Deny.