mirror/bemenu
1
0
Fork 0
mirror of https://github.com/Cloudef/bemenu synced 2024-11-23 01:12:01 +01:00
Code Issues
Dynamic menu library and client program inspired by dmenu
330 Commits 2 Branches 30 Tags 1.5 MiB
C 88.5%
CSS 7%
Makefile 2.6%
HTML 0.8%
Nix 0.7%
Other 0.4%
ee700c11ea
Go to file
Jari Vetoniemi ee700c11ea make: _DEFAULT_SOURCE is required
2020-02-07 18:32:22 +02:00
.github Add donation option 2020-01-29 18:43:17 +09:00
client ignore_ret warns on clang *sigh* 2020-02-07 16:23:52 +02:00
doxygen Nuke CMake from existance 2020-02-07 16:03:08 +02:00
lib menu: left/right now moves always cursor 2020-02-07 18:28:48 +02:00
man Nuke CMake from existance 2020-02-07 16:03:08 +02:00
.editorconfig Add .editorconfig 2018-04-08 11:05:52 -04:00
.gitignore .gitignore: Ignore everything 2020-02-07 16:04:01 +02:00
GNUmakefile make: _DEFAULT_SOURCE is required 2020-02-07 18:32:22 +02:00
LICENSE-CLIENT
LICENSE-LIB Add license for library and binding[s] 2014-03-18 20:15:05 +01:00
README.md Fix missing dependencies from renderers 2020-02-07 17:27:40 +02:00

README.md

bemenu

Dynamic menu library and client program inspired by dmenu

Building

# Build everything
make

# To build only certain features, pass the targets which you are interested into
#
# You can also use the following meta-targets for common features:
# - clients (bemenu, bemenu-run)
# - x11
# - wayland
# - curses
#
# For example this would build the bemenu and bemenu-run binaries and the x11 renderer:
make clients x11

# To install the built features, simply run:
make install

# NOTE: You may get errors during install when not building all the features.
#       These errors are free to ignore if `Install OK!` is printed.

# By default that will install to /usr/local, but you can change this with PREFIX
make install PREFIX=/usr

# Other usual variables are available for modifying such as DESTDIR, bindir, libdir and mandir
# Note that if you want a custom libdir, you should pass that during build as well, since it
# will be used compile-time to figure out where to load renderers from!

# HTML API documentation (requires doxygen installed):
make doxygen

OSX

# Make sure you have GNU coreutils, GNU Make and pkg-config installed
brew install coreutils make pkg-config

# You may need to setup your pkg-config to point to brew version of the libraries
# For example to build curses renderer, you'd do:
PKG_CONFIG_PATH="/usr/local/opt/ncurses/lib/pkgconfig" gmake curses

# Other than that, follow the normal build steps, but use gmake instead of make
# For installs, you need to have GNU coreutils in the path:
PATH="/usr/local/opt/coreutils/libexec/gnubin:$PATH" gmake install

Dependencies

All dependencies are searched with pkg-config

Renderer Dependencies
curses ncurses
x11 x11, xinerama, cairo, pango, pangocairo
Wayland wayland-client, wayland-protocols, cairo, pango, pangocairo, xbkcommon

Environment variables

Variable Description Value
BEMENU_BACKEND Forces a renderer by name x11, wayland, curses
BEMENU_RENDERER Forces a renderer by loading a .so file Path to the .so file
BEMENU_RENDERERS Override renderer load directory Path to a directory

About Wayland support

Wayland is only supported by compositors that implement the wlr-layer-shell protocol. Typically wlroots-based compositors.

License