1 # MyMenu
2 
3 > A drop-in replacement for dmenu, 'cause I was bored
4 
5 ![MyMenu works!](screen.png)
6 
7 ![MyMenu alternate layout](screen-alt.png)
8 
9 ---
10 
11 ## What?
12 
13 This is a drop-in replacement for `dmenu(1)`.
14 
15 ## Why?
16 
17 This was the perfect excuse to learn how to make window with Xlib.
18 
19 ## How?
20 
21 Check out the [manpage](mymenu.1) for further documentation. Check out
22 also the [template](Xexample) for the resources.
23 
24 ---
25 
26 ## Dependencies
27 
28  - Xlib
29  - Xinerama (optional)
30    For multi-monitor support
31  - pkg-config (optional)
32    used in the makefile to generate `LIBS` and `CFLAGS` correctly
33 
34 ## Build
35 
36 As simple as `make`. If you want to disable Xinerama support just
37 delete `-DUSE_XINERAMA` from the `CFLAGS` and `xinerama` from the
38 `pkg-config` call from the Makefile.
39 
40 ---
41 
42 ## TODO
43 
44  - Command line flags
45  
46    At the moment the X Resource Database is the only way to interact
47    with the graphic appearance of MyMenu.
48 
49  - Optional TrueType support
50  
51  - Opacity support
52 
53 ## Scripts
54 
55 I'm using this script to launch MyMenu
56 
57 ``` shell
58 #!/bin/sh
59 
60 cat <<EOF | /bin/sh -c "$(mymenu "$@")"
61 ZZZ
62 sct 4500
63 lock
64 connect ethernet
65 connect home
66 connect phone
67 zzz
68 ...
69 EOF
70 ```
71 
72 Of course you can as well use the `dmenu_path` and `dmenu_run` scripts
73 that (usually) comes with `dmenu`.