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 with custom item
56 
57 ``` shell
58 #!/bin/sh
59 
60 cat <<EOF | /bin/sh -c "$(mymenu "$@")"
61 sct 4500
62 lock
63 connect ethernet
64 connect home
65 connect phone
66 ZZZ
67 zzz
68 ...
69 EOF
70 ```
71 
72 You can generate a menu from the `.desktop` file with something like
73 this:
74 
75 ``` shell
76 #!/bin/sh
77 
78 getname() {
79     cat $1 | grep '^Name=' | sed 's/^.*=//'
80 }
81 
82 getexec() {
83     cat $1 | grep '^Exec=' | sed 's/^.*=//'
84 }
85 
86 desktop_files=`ls /usr/local/share/applications/*.desktop`
87 
88 {
89     for i in $desktop_files; do
90         getname $i
91     done
92 } | mymenu "$@" | {
93     read prgname
94     for i in $desktop_files; do
95         name=`getname $i`
96         if [ "x$prgname" = "x$name" ]; then
97             exec `getexec $i`
98         fi
99     done
100 }
101 ```
102 
103 or generate a list of executables from `$PATH` like this:
104 
105 ``` shell
106 #!/bin/sh
107 
108 path=`echo $PATH | sed 's/:/ /g'`
109 
110 {
111     for i in $path; do
112         ls -F $i | grep '.*\*$' | sed 's/\*//'
113     done
114 } | sort | /bin/sh -c "$(mymenu "$@")"
115 ```
116 
117 Of course you can as well use the `dmenu_path` and `dmenu_run` scripts
118 that (usually) comes with `dmenu`.