FAQ

Startup and Logs

Wox does not start. Where should I look first?

Open the log directory:

Platform	Logs
Windows	%USERPROFILE%\.wox\log
macOS	~/.wox/log
Linux	~/.wox/log

Start with the newest core log. If the UI opens but a plugin fails, check the plugin-specific log directory under the same Wox data folder.

How do I reset Wox?

Quit Wox, then remove the Wox data directory:

Platform	Data directory
Windows	%USERPROFILE%\.wox
macOS	~/.wox
Linux	~/.wox

This removes settings, installed plugins, plugin data, cache, and logs.

Search

Why is an app, file, or bookmark missing?

• App search may need a few seconds after installing a new app.
• File search only returns paths inside configured roots and readable by Wox.
• Browser bookmarks are read from supported browser profiles; browser sync can delay updates.
• Open the related plugin settings and confirm the plugin is enabled.

Why are results noisy?

Use an explicit keyword when you want one plugin. For example, f report searches files and cb report searches clipboard history. Global queries intentionally let multiple plugins answer.

Plugins

Plugin installation failed. What should I check?

1. Confirm network access to the plugin store and release host.
2. Check whether the plugin requires Node.js or Python.
3. Open the Wox log directory and inspect the newest core and plugin-host logs.
4. Try wpm again after restarting Wox if a runtime host was just installed.

How do I update plugins?

Run wpm, select the plugin, and use the update action when one is available. You can also manage installed plugins from Plugin Manager settings.

File Search

Does Wox require Everything?

No. Wox has its own File plugin and indexes the roots you configure in plugin settings. Install Everything only if you also want to use Everything outside Wox.

Why does file search ask for permissions on macOS?

macOS may block access to Desktop, Documents, Downloads, removable drives, or other protected locations. Grant Wox file access in System Settings -> Privacy & Security if search status or logs report permission errors.

Customization

How do I change the theme?

Run theme in Wox or open Settings -> Theme.

How do I change the hotkey?

Open Settings -> General and edit the hotkey field.