kelvin-van-vuuren / dmenu

My fork of dmenu, a fast and lightweight dynamic menu.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Custom build of dmenu, an efficient dynamic menu for X.

About Features Install Usage

dmenu

About

dmenu is a fast and lightweight dynamic menu for X. It reads arbitrary text from stdin, and creates a menu with one item for each line. The user can then select an item and the line is printed to stdout. The software is written by suckless and adheres to the suckless philosophy. As a result, the base distribution of this software comes with a very minimal set of features. This fork extends the functionality and appearance of the program through the use of patches and other changes to the codebase.

Features

  • Center: center dmenu in screen with -c flag.
  • Border: set dmenu border width with -bw flag.
  • Alpha: change dmenu background opacity.
  • Mouse support: basic mouse support (scroll, left click to select, right click to close).
  • Numbers: display number of matched and total items in the top right corner of dmenu.
  • Case insensitive: case insensitive item matching (-s to enable case sensitivity).
  • Fuzzy matching: allows user to type non-consecutive portions of the string to be matched (-f flag).
  • Fuzzy highlighting: highlight fuzzy-matched text.
  • Xresources: configure dmenu via Xresources. See my dotfiles for an example of how this can be used.

Install

Clone this repo and install with rm -rf config.h && sudo make clean install. Configuration is done via config.def.h so any changes will require the program to be recompiled and installed to take effect.

Usage

See the man page for details. Or take a look at some of my other forks of related suckless software, such as dwm, which contains a keybind to a useful dmenu command.

About

My fork of dmenu, a fast and lightweight dynamic menu.

License:MIT License


Languages

Language:C 86.6%Language:Roff 8.6%Language:Makefile 4.2%Language:Shell 0.5%