wmenu
=====
WARNING: AI-GENERATED CODEBASE
------------------------------
This codebase is AI-generated and requires a human touch: review, testing,
and maintenance. It is stable enough for everyday use, but has not received
an independent human audit.
About
-----
wmenu is a small Win32 picker for newline-separated input. Pipe text into
it, search the lines, and print the selected line to standard output. Input
can keep arriving while the window is open; the list and search cover all
loaded lines without drawing every row at once.
This is a hard fork inspired by LinArcX's original wmenu. This implementation
was written separately; the project name and idea come from LinArcX, not the
code in this fork. See Credits below.
Build
-----
On Windows, install Visual Studio Build Tools with the C compiler and GNU
make. Open a Developer Command Prompt in this directory, then run:
make
make test
For the larger synthetic-input test, run `make stress`. The build is defined
in Makefile; no Visual Studio project or batch launcher is needed. See
HACKING for development notes.
Use
---
dir /b | .\wmenu.exe
where.exe *.exe | .\wmenu.exe -p run:
dir /b | .\wmenu.exe -c -w 800 -l 12
Options
-------
-p text prompt text
-e utf8|ansi|oem input/output encoding (default: utf8)
-x px -y px -w px position and width
-c center the window
-l lines visible rows; -l-1 fills the screen (default: 5)
-m multi-select (Ctrl+Enter adds; Enter finishes)
-i ASCII case-insensitive matching
-V vi mode; Ctrl+Alt+V toggles it
-d native Windows edit shortcuts
-b close when focus is lost
-fn name -fs pt -fw weight
font face, size, and weight
-v version
-h help
Keys
----
Enter print selection and exit
Esc exit (vi insert mode: return to normal mode)
Up/Down move selection
Ctrl+N/P next/previous row
Ctrl+D/U page down/up
Ctrl+O/I back/forward through visited searches and rows
Ctrl+A/E start/end of input
Ctrl+K delete to end of input
Ctrl+W cut selection
Ctrl+Backspace delete previous word
Ctrl+Alt+V toggle vi mode
Clearing the query returns to the first row. Location history keeps the
latest 128 searches and row positions.
Credits
-------
LinArcX created the original wmenu and inspired this hard fork:
https://github.com/LinArcX/wmenu
The picker follows the dmenu interface from suckless:
https://tools.suckless.org/dmenu/
arg.h is the suckless argument-parsing header by 20h. Its original header
is left intact; the MIT/X Consortium terms are included in LICENSE.
License
-------
This fork's code is BSD 3-Clause licensed; see LICENSE. The third-party arg.h
is MIT/X Consortium licensed; its notice is included in LICENSE. Older
upstream releases and histories have their own copyright and licensing terms.
