spmenu is an X11 menu application based on dmenu which takes standard input, parses it, and lets the user choose an option and sends the selected option to standard output.
In addition to this, it also serves as a run launcher through the
included shell script spmenu_run
, which handles both $PATH
listing and .desktop entries.
It is designed to integrate well with my dwm fork, speedwm.
..and more! Note that spmenu is still compatible with dmenu. Just pass the original arguments.
imlib2=false
in
buildconf
.toggle.mk
and commenting out a few
lines.xinerama=false
in
buildconf
.toggle.mk
and commenting out a few
lines.CC="gcc"
to the make
command.CC="gcc"
to the
buildconf
. command if you want)imlib2=false
and
openssl=false
in buildconf
.toggle.mk
and commenting out a few
lines.pango=false
and
pangoxft=false
in buildconf
.toggle.mk
and commenting out a few
lines.libconfig=false
in
buildconf
.toggle.mk
and commenting out a few
lines.emerge dev-vcs/git # Install dev-vcs/git using your favorite package manager
git clone https://git.speedie.site/spmenu
cd spmenu/
./build.sh # Run as root.
Report any issues with the build.sh script. There’s also a Makefile which you can use but it may require editing host.mk and toggle.mk manually.
NOTE: Adds Xquartz as a dependency. I highly recommend you use Homebrew to install all the dependencies.
Follow ‘Installation (GNU/Linux, *BSD)’ for the most part. macOS requires some minor changes though, such as disabling pango, pangoxft, imlib2, and openssl. It is not possible to compile spmenu with these as of now, unless you’re a developer.
PREFIX must also be set to /usr/local instead of the default /usr if you’re using macOS Catalina or newer, because Apple made /usr read-only.
See this wiki article for more information.
If you are on Gentoo GNU/Linux, you can add my overlay which
includes x11-misc/spmenu
as well as other useful
packages.
If you are on Arch GNU/Linux, you can add my repository
which includes spmenu
as well as other useful packages.
There’s also a PKGBUILD. To use it, simply
make install_arch
in the directory the PKGBUILD is
located.
If you wish to package spmenu for your GNU/Linux distribution, feel free to add it to this list.
Pull requests would be greatly appreciated for any of these issues!
This build of spmenu should work with all spmenu/dmenu scripts. Here are a few I’ve written/use. If your scripts are useful enough, and written with spmenu in mind, feel free to pull request and put your scripts here!
See the included man
page.
spmenu is licensed under the MIT license. See the included LICENSE file for more information!