---
name: "tofi-run"
section: "1"
platform: "linux"
package: "tofi"
version: "0.9.1-2+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/tofi"
---

# tofi-run(1)

Tiny dynamic menu for Wayland, inspired by rofi(1) and dmenu(1).

Part of [tofi(1)](/tofi/1.md).

## NAME

tofi - Tiny dynamic menu for Wayland, inspired by [**rofi**(1)](/rofi/1.md) and [**dmenu**(1)](/dmenu/1.md).

## SYNOPSIS

**tofi** \[options...\]

**tofi-run** \[options...\]

**tofi-drun** \[options...\]

## DESCRIPTION

**tofi** is a tiny dynamic menu for Wayland compositors supporting the layer-shell protocol. It reads newline-separated items from stdin, and displays a graphical selection menu. When a selection is made, it is printed to stdout.

When invoked via the name **tofi-run**, **tofi** will not accept items on stdin, instead presenting a list of executables in the user's $PATH.

When invoked via the name **tofi-drun**, **tofi** will not accept items on stdin, and will generate a list of applications from desktop files as described in the Desktop Entry Specification.

## OPTIONS

- **-h, --help**

  Print help and exit.

- **-c, --config** \<path\>

  Specify path to custom config file.

All config file options described in [**tofi**(5)](/tofi/5.md) are also accepted, in the form **--key=value**.

## KEYS

\<Up\> \| \<Left\> \| \<Ctrl\>-k \| \<Ctrl\>-p

Move the selection back one entry.

\<Down\> \| \<Right\> \| \<Ctrl\>-j \| \<Ctrl\>-n \| \<Tab\>

Move the selection forward one entry.

\<Page Up\>

Move the selection back one page.

\<Page Down\>

Move the selection forward one page.

\<Ctrl\>-u

Delete line.

\<Ctrl\>-w \| \<Ctrl\>-\<Backspace\>

Delete word.

\<Enter\>

Confirm the current selection and quit.

\<Escape\>

Quit without making a selection.

## FILES

*/etc/xdg/tofi/config*

Example configuration file.

*$XDG\_CONFIG\_HOME/tofi/config*

The default configuration file location.

*$XDG\_CACHE\_HOME/tofi-compgen*

Cached list of executables under $PATH, regenerated as necessary.

*$XDG\_CACHE\_HOME/tofi-drun*

Cached list of desktop applications, regenerated as necessary.

*$XDG\_STATE\_HOME/tofi-history*

Numeric count of commands selected in **tofi-run**, to enable sorting results by run count.

*$XDG\_STATE\_HOME/tofi-drun-history*

Numeric count of commands selected in **tofi-drun**, to enable sorting results by run count.

## AUTHORS

Philip Jones \<philj56@gmail.com\>

## SEE ALSO

[**tofi**(5)](/tofi/5.md), [**dmenu**(1)](/dmenu/1.md) [**rofi**(1)](/rofi/1.md)