win-dmenu

Dynamic menu for Windows - inspired by the suckless dmenu. This project is a form from JerwuQu

Usage

Menu entries are passed to dmenu through stdin. After the user has made a choice, the result is sent out through stdout.

Running (echo hello & echo world & echo !) | dmenu would for example bring up a menu like this:

The user can filter by writing in the textbox:

The menu style and behavior can be customized through command-line arguments. Run dmenu -h for a list of these.

dmenu by itself doesn't do much. The power comes through using scripts that talk to it. suckless has a list of examples of scripts that can be used with dmenu.

Dave Davenport's rofi (an alternative to dmenu) also has such a list.

System requirements

dmenu has been tested and works on unmodified Windows XP (32-bit) and Windows 10 (64-bit). As such, it should work on anything in-between as well.

Build steps

1. Download the Mingw Compiler, installing it and adding to PATH. It is also possile (and recommanded) to use the scoop package manager : scoop install gcc make
2. Make sure gcc.exe and make is in your PATH.
3. Clone this repo (git clone https://gitlab.com/xdavidel/win-dmenu.git)
4. Run make

Build with TCC

The Tiny C Compiler can produce smaller size apps and compiles faster most of the time.

1. Download the Tiny C Compiler and add the WinApi headers.
2. Patch tcc/lib/gdi32.def to also include SetDCPenColor and SetDCBrushColor.
3. Make sure tcc.exe is in your PATH.
4. Clone this repo (git clone https://githlab.com/xdavidel/win-dmenu.git)
5. Run maketcc.bat

Credits

• tcc - by Fabrice Bellard

• stretchy_buffer.h - by Sean Barrett

• wlines - by JerwuQu

Contributing

All issues and PRs related to fixing bugs or other strange behavior are welcome.

License

This project is licensed under the GNU General Public License v3.0. See LICENSE for more details.