Deep Link

Deep links let another app or script open Wox with a prepared query. This is useful for terminal aliases, browser shortcuts, automation tools, and app-specific launch buttons.

Format

text

wox://query?q=<url-encoded-query>
wox://install?path=<url-encoded-file>
wox://confetti

The q value is the exact query text Wox should place into the launcher. URL-encode spaces and symbols.

wox://install?path= opens the local plugin installer for a .wox package. Double-clicking a .wox file uses this same path after Wox registers the file association.

Examples

Play confetti on the display under the mouse without opening the launcher or taking focus. The animation ends after about six seconds; calling it again restarts it:

wox://confettiRun in Wox

Open Plugin Manager with an install query:

wox://query?q=wpm%20install%20Run in Wox

Open file search:

wox://query?q=f%20invoiceRun in Wox

Run a calculation:

wox://query?q=100%20%2B%2020Run in Wox

Start an AI chat:

wox://query?q=chat%20summarize%20thisRun in Wox

Create a note:

wox://query?q=note%20new%20Run in Wox

Open a downloaded plugin package in the installer:

wox://install?path=/Users/demo/Downloads/wox.plugin.example.woxRun in Wox

From Scripts

macOS:

bash

open "wox://query?q=f%20invoice"

Windows PowerShell:

powershell

Start-Process "wox://query?q=f%20invoice"

Linux:

bash

xdg-open "wox://query?q=f%20invoice"

Encoding Notes

Encode spaces as %20.
Encode + as %2B when it is part of a calculation.
Keep secrets out of deep links; URLs can be recorded by shells, browsers, or automation logs.