Skip to content

Querying

Open Wox, type what you want, then act on the selected result. The launcher does not require you to remember every plugin keyword, but keywords are useful when you want a specific plugin to handle the query.

Query Types

TypeExampleNotes
Global searchchromeLets global plugins compete for results, such as apps, calculator, converter, and web search.
Keyword queryf invoiceSends the query to a plugin with a trigger keyword.
Command querywpm installRuns a command inside a plugin.
Selection querySelect text, then trigger Wox selection actionsUsed by plugins that can work with selected text or files.

Keywords and Commands

A keyword is the first word in the query. If it matches a plugin trigger, Wox sends the rest of the query to that plugin.

text
wpm install browser
PartMeaning
wpmPlugin Manager trigger
installPlugin Manager command
browserSearch term passed to the command

Common built-in keywords:

KeywordPlugin
fFile search
cbClipboard history
emojiEmoji search
chatAI chat
wpm, store, pmPlugin Manager
calculatorCalculator / converter explicit mode

Fallback Results

Some plugins listen to normal text without a keyword. That is why typing Chrome, 100 + 20, 1km to m, or a web search can produce useful results immediately.

Use a keyword when fallback results are noisy or when you know exactly which plugin should answer.

Shortcuts

ShortcutDescription
Windows: Alt + SpaceToggle Wox visibility
macOS: Command + SpaceToggle Wox visibility
Linux: Ctrl + SpaceToggle Wox visibility
EscHide Wox or go back from a nested view
Up / DownMove through results
EnterRun the selected result's primary action
Alt + J / Command + JOpen the Action Panel
TabComplete the suggested query when available

Hotkey Settings

Open Settings -> General to change the main Wox hotkey. You can also create query hotkeys that open Wox with a predefined query, position, width, or hidden toolbar/query box.

Released under the GPL-3.0 License.