1wofi(1) General Commands Manual wofi(1)
2
6 wofi - A rofi inspired launcher for wlroots compositors
7
10 wofi [options]
11
14 wofi is a rofi inspired menu program for wlroots compositors such as
15 sway. It is intended to be highly customizable and flexible with the
16 help of CSS styling and a dmenu mode that allows for endless script‐
17 ability. Wofi can be run cacheless in dmenu mode automatically by
18 invoking it as dmenu with symlink.
19 Wofi was designed specifically for wlroots and makes use of the
21 wlr-layer-shell protocol. If your compositor does not support this pro‐
22 tocol or if you are in a non-wayland environment then wofi must be run
23 with --normal-window or it will crash. If you wish to run wofi this way
24 you can also place normal_window=true in your config file to avoid
25 specifying the option on the command line.
26
29 -h, --help
30 Prints the help message and then exits.
31 -f, --fork
33 Forks the menu so the terminal running it can be closed.
34 -c, --conf=PATH
36 Specifies the config file to use.
37 -s, --style=PATH
39 Specifies the CSS file to use as the stylesheet.
40 -C, --color=PATH
42 Specifies the colors file to use.
43 -d, --dmenu
45 Runs wofi in dmenu mode.
46 -S, --show=MODE
48 Specifies the mode to run in. A list of modes can be found in
49 wofi(7).
50 -W, --width=WIDTH
52 Specifies the menu width in pixels or percent of screen size,
53 default is 50%. Pixels are used unless the number ends with a %.
54 -H, --height=HEIGHT
56 Specifies the menu height in pixels or percent of screen size,
57 default is 40%. Pixels are used unless the number ends with a %.
58 -p, --prompt=PROMPT
60 Sets the prompt to be display in the search box, default is the
61 name of the mode.
62 -x, --xoffset=OFFSET
64 Sets the x offset from the location in pixels, default is 0.
65 -y, --yoffset=OFFSET
67 Sets the y offset from the location in pixels, default is 0.
68 -n, --normal-window
70 Runs wofi in a normal window instead of using wlr-layer-shell.
71 -I, --allow-images
73 Allows image escape sequences to be processed and rendered.
74 -m, --allow-markup
76 Allows pango markup to be processed and rendered.
77 -k, --cache-file=PATH
79 Specifies the cache file to load/store cache, default is
80 $XDG_CACHE_HOME/wofi-<mode name> where <mode name> is the name
81 of the mode, if $XDG_CACHE_HOME is not specified ~/.cache is
82 used.
83 -t, --term=TERM
85 Specifies the term to use when running a program in a terminal.
86 This overrides the default terminal run order which is kitty,
87 termite, gnome-terminal, weston-terminal in that order.
88 -P, --password [character]
90 Runs wofi in password mode with an optional password character
91 to use. If no character is specified * is used by default.
92 -e, --exec-search
94 Activiating a search with enter will execute the search not the
95 first result.
96 -b, --hide-scroll
98 Hides the scroll bars.
99 -M, --matching=MODE
101 Specifies the matching mode, it can be either contains or fuzzy,
102 default is contains.
103 -i, --insensitive
105 Enables case insensitive search.
106 -q, --parse-search
108 Parses out image escapes and pango preventing them from being
109 used for searching.
110 -v, --version
112 Prints the version and then exits.
113 -l, --location=LOCATION
115 Specifies the location. See wofi(7) for more information,
116 default is center.
117 -a, --no-actions
119 Disables multiple actions for modes that support it.
120 -D, --define=KEY=VALUE
122 Sets a config option
123 -L, --lines=LINES
125 Specifies the height in number of lines instead of pixels.
126 -w, --columns=COLUMNS
128 Specifies the number of columns to display, default is 1.
129 -O, --sort-order=ORDER
131 Specifies the default sort order. There are currently two
132 orders, default and alphabetical. See wofi(7) for details.
133 -G, --gtk-dark
135 Instructs wofi to use the dark variant of the current GTK theme,
136 if available.
137 -Q, --search
139 Specifies something to search for immediately on opening
140 -o, --monitor
142 Sets the monitor to open on
143
146 Wofi has 3 main files used for configuration. All files are completely
147 optional.
148 1. The config file which defaults to $XDG_CONFIG_HOME/wofi/config.
150 2. The CSS file which defaults to $XDG_CONFIG_HOME/wofi/style.css.
152 3. The colors file which defaults to the pywal cache
154 $XDG_CACHE_HOME/wal/colors.
155 All 3 of these paths can be manually specified using the respective
158 command line flag. In the case of the last 2 they can additionally be
159 specified in the config file.
160 In the event $XDG_CONFIG_HOME is not specified it defaults to ~/.config
162 likewise if $XDG_CACHE_HOME is not specified it defaults to ~/.cache.
163 Information about the formats for these files can be found in wofi(5).
165 wofi(1)