DMENU(1)

💖 NAME 💖

dmenu-wl — it's a dynamic menu, bestie. that's the whole vibe ✨

🌸 SYNOPSIS 🌸

dmenu-wl [-b] [-i] [-l lines] [-m monitor] [-p prompt] [-fn font] [-nb
color] [-nf color] [-sb color] [-sf color] [-v]

dmenu-wl_run ...

dmenu-wl_path

🦋 DESCRIPTION 🦋

okay so dmenu-wl is a dynamic menu for Wayland — and the lore is that it was originally designed for X and dwm(1). it handles huge numbers of user-defined menu items efficiently, like no cap, it just eats them up 👑

here's the tea: dmenu-wl reads a list of newline-separated items from standard input and creates a menu (or, if you're using -e, it displays a notification instead). then when the user selects an item or types any text and presses Return, their choice gets printed to standard output and dmenu-wl terminates. periodt 💅

dmenu-wl_run is a dmenu-wl script used by dwm which lists programs in the user's PATH and executes the selected item. very "run my little program bestie" energy.

dmenu-wl_path is a program used by dmenu-wl_run to find and cache a list of executables. it's giving support-system main character 🫶

✨ OPTIONS ✨

• -e — dmenu displays text from stdin with no user interaction.
• -ec — same as -e but the text is aligned centrally.
• -er — same as -e but the text is aligned to the right.
• -et secs — when using -e, close the message after the given number of seconds. set a timer bestie ⏰
• -b — dmenu appears at the bottom of the screen.
• -h height — dmenu is drawn at least the given number of pixels high.
• -i — dmenu matches menu items case insensitively. lowercase girlies stay winning 🌈
• -l lines — dmenu lists items vertically, within the given number of lines.
• -m monitor — dmenu appears on the given monitor (0-based index or monitor name).
• -p prompt — defines the prompt to be displayed to the left of the input field.
• -po prompt — same as -p but don't wait for stdin — useful for a prompt with no selection options.
• -r — Return as soon as a single match is found. i.e. don't wait for the user to press return. instant gratification, we love her 😭
• -fn font — defines the font or font set used.
• -nb color — defines the normal background color. #RRGGBB and #RRGGBBAA are supported.
• -nf color — defines the normal foreground color.
• -sb color — defines the selected background color.
• -sf color — defines the selected foreground color.
• -v — prints version information to standard output, then exits.

🎀 USAGE 🎀

dmenu-wl is completely controlled by the keyboard. besides standard Unix line editing and item selection (Up/Down/Left/Right, PageUp/PageDown, Home/End), the following keys are recognized:

• Tab (Control-i) — Copy the selected item to the input field.
• Return (Control-j) — Confirm selection. Prints the selected item to standard output and exits, returning success.
• Shift-Return (Control-Shift-j) — Confirm input. Prints the input text to standard output and exits, returning success.
• Escape (Control-c) — Exit without selecting an item, returning failure.
• Control-y — Paste the current selection into the input field.

👑 SEE ALSO 👑

• dwm(1)

okay that's the whole page bestie, you ate 💅✨ this was dmenu-wl-VERSION, living in the DMENU(1) manual page, dated whenever this page was dated — go forth and menu dynamically 🦋🌸💖