wofi

Show the list of apps

$ wofi [[-S|--show]] drun

$ wofi [[-S|--show]] run

$ printf "[Choice1\nChoice2\nChoice3]" | wofi [[-d|--dmenu]]

wofi [options]

--allow-images
    Allow rendering images specified via pango markup or xresources

--cache-file
    Specify a path to use for caching the menu entries. Useful for dynamic menus.

--class
    Set the window class name to use. Defaults to 'wofi'.

--conf-file
    Specify a path to a custom config file.

--dmenu
    Run in dmenu mode, reading input from stdin and writing the selected entry to stdout.

--display
    Connect to specified X display.

--gtk-dark
    Force wofi to use gtk's dark theme

--height
    Set the window height in pixels. Overrides config.

--hide-scroll
    Hides the scrollbar.

--inner-border
    Set the inner border width in pixels. Overrides config.

--lines
    Set the number of lines to display. Overrides config.

--matching
    Set the matching mode. Fuzzy (default), Contains, or Regex.

--modi
    Set the modes to use. Each mode is separated by a comma. Defaults to 'run'.

--normal-window
    Sets the _NET_WM_WINDOW_TYPE to NORMAL.

--output
    Use output primary or output with specified name to display wofi on. Overrides config.

--password
    Mask input, useful for password prompts. Only relevant in dmenu mode.

--prompt
    Set the prompt text. Only relevant in dmenu mode.

--require-input
    Do not launch wofi if it does not receive input on stdin. Only relevant in dmenu mode.

--scroll-amount
    Set the scroll amount in pixels. Overrides config.

--show
    Show the specified mode without using modi switching. Ignores --modi.

--show-match
    Show only matches in the specified mode. Ignores --modi. Requires --search.

--search
    Pre-populate the search query.

--sort
    Sort wofi menu items. Ascending or descending.

--style
    Specify a path to a custom CSS file.

--version
    Print the version and exit.

--width
    Set the window width in pixels. Overrides config.

--x
    Set the x position in pixels. Overrides config.

--y
    Set the y position in pixels. Overrides config.

wofi is a versatile launcher and menu program designed as a replacement for dmenu, drawing inspiration from rofi. It provides a highly customizable and configurable interface for launching applications, running commands, and selecting from lists.

wofi excels in its simplicity and extensibility. Users can tailor its appearance and behavior through CSS styling and configuration files. This allows for a personalized experience, adapting the launcher to individual workflows and aesthetic preferences. The input is fuzzy matched against available entries. Selection can happen with arrows and enter or with mouse. Wofi aims to be easy to use, beautiful, and very customizable.

The program's modular design allows users to select the type of view to use, such as grid or list. Wofi is commonly used to launch applications, switch between windows, or act as a general-purpose selector. Wofi can also output the selected option.

Wofi's config file is located in ~/.config/wofi/config. You can specify custom colors, fonts, and keybindings there. Wofi uses a CSS file for styling, which defaults to ~/.config/wofi/style.css.

dmenu(1), rofi(1)