Usage Guide

Starting the daemon

NOTE

If you installed waycast using the home manager module, the daemon should already be running as a systemd process. Otherwise, you have to make sure the daemon is running yourself.

The waycast daemon runs in the background and scans:

  • Application entries
  • Project directories (if configured)
  • Files (if configured)

and updates the sqlite database so they can be quickly retrieved when searching as opposed to doing a system scan every time you open your launcher.

It is also the process that launches the UI when you run waycast show.

Launching Waycast

waycast show will show the launcher UI. This is what you would set a keybind to.

You can make sure the daemon is running with waycast status.

Utility Commands

waycast status: Checks if the daemon is running.

waycast config: Shows the resolved configuration both runtime and from waycast.toml

waycast cache clear: Clears the icon cache.

waycast version: Shows app version.