Documentation›Integrations, data, and support
44 Data and support

Use localwaifu Links

Control Local Waifu from a shortcut, the Run dialog, Siri, or a script with localwaifu:// links.

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.

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.

  • 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.

Copy any of these with Copy link in the block:

LinkWhat it does
localwaifu://send?text=Good%20morningSend her a message. Add &character=Name to pick who
localwaifu://call/startStart a voice call
localwaifu://call/stopEnd the call
localwaifu://watch/startStart watching your screen
localwaifu://watch/stopStop watching your screen
localwaifu://focus/start?minutes=25Start focus guard (minutes are optional, 1 to 240)
localwaifu://focus/stopStop focus guard
localwaifu://brief/runRun 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.

Goal

Make a Siri phrase or a Shortcuts action that talks to her.

Steps

  1. Open the Shortcuts app and choose New Shortcut.
  2. Add the Open URLs action and paste one of the links.
  3. Name the shortcut. That name is what you say to Siri.
  4. 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.

Steps

  1. Desktop shortcut: right-click the desktop, choose New → Shortcut, and paste a link as the location. Opening the shortcut runs the action.
  2. Run dialog: press Win+R, paste a link, and press Enter.
  3. 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.