forked from RepoMirrors/bemenu
83 lines
3.0 KiB
Markdown
83 lines
3.0 KiB
Markdown
bemenu
|
|
======
|
|
|
|
Dynamic menu library and client program inspired by dmenu
|
|
|
|
## Building
|
|
|
|
```sh
|
|
# 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
|
|
|
|
```sh
|
|
# 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](https://github.com/swaywm/wlr-protocols/tree/master/unstable) protocol.
|
|
Typically [wlroots](https://github.com/swaywm/wlroots)-based compositors.
|
|
|
|
## License
|
|
|
|
* [GNU GPLv3 (or any later version)](LICENSE-CLIENT) for client program[s] and
|
|
other sources except library and bindings
|
|
* [GNU LGPLv3 (or any later version)](LICENSE-LIB) for library and bindings
|