NAME

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

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.

       WARNING: In the last version of tofi, when a selection was made in drun mode, the filename
       of the selected desktop file was printed to stdout. In the current version of tofi, this
       has changed to an executable command line, to be passed to swaymsg exec or similar.
       Consequently, the --drun-print-exec does nothing, and may be removed in a future version
       of tofi.

OPTIONS

       -h, --help
           Print help and exit.

       -c, --config <path>
           Specify path to custom config file.

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

KEYS

       <Up> | <Left> | <Ctrl>-k
           Move the selection back one entry.

       <Down> | <Right> | <Ctrl>-j | <Tab>
           Move the selection forward one entry.

       <Ctrl>-u
           Delete line.

       <Ctrl>-w
           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), dmenu(1) rofi(1)

                                            2022-08-21                                    tofi(1)