~kris/suckless

dmenu

ref: ae389797788cc66d3b93c92fe8639d68d47b8b39 dmenu/README.md -rw-r--r-- 2.1 KiB
ae389797 — Kris Yotam Initial commit: dmenu with center patch 7 months ago

#Kris's build of dmenu

My build of dmenu, the dynamic menu for X.

Based on BreadOnPenguins' dmenu with center and xresources patches.


#Features

  • Center patch: dmenu appears centered on screen (-c flag)
  • Vertical listing: Show options in a vertical list (-l flag)
  • Xresources: Read colors from ~/.Xresources (pywal compatible)
  • Alpha: Transparency support
  • Emoji: Can view color characters like emoji
  • Password mode: -P flag hides user input
  • Reject non-matching: -r flag rejects input that doesn't match an option
  • Mouse clickable: dmenu options are mouse clickable

#Patches

Patch Description
center Center dmenu on screen
xresources Read colors and settings from ~/.Xresources
alpha Transparency support
password Hide input for password entry
mouse support Click to select options

#Usage

# Run dmenu centered
dmenu_run -c

# Vertical list centered
echo -e "option1\noption2\noption3" | dmenu -c -l 3

# Password mode
echo -e "option1\noption2" | dmenu -P

# Reject non-matching input
echo -e "yes\nno" | dmenu -r

# With prompt
dmenu -c -l 5 -p "Select:" < options.txt

#Installation

git clone https://github.com/krisyotam/dmenu
cd dmenu
sudo make install

#Credits


#Other Suckless Repos

  • dwm - dynamic window manager
  • st - simple terminal
  • dwmblocks - modular status bar

#Contact