Blame


1 be5b89f6 2018-05-18 omar.polo # MyMenu
2 be5b89f6 2018-05-18 omar.polo
3 eccc9e7a 2018-05-20 omar.polo > A replacement for dmenu, 'cause I was bored
4 be5b89f6 2018-05-18 omar.polo
5 be5b89f6 2018-05-18 omar.polo ![MyMenu works!](screen.png)
6 be5b89f6 2018-05-18 omar.polo
7 36a15a9f 2018-05-19 omar.polo ![MyMenu alternate layout](screen-alt.png)
8 36a15a9f 2018-05-19 omar.polo
9 be5b89f6 2018-05-18 omar.polo ---
10 be5b89f6 2018-05-18 omar.polo
11 be5b89f6 2018-05-18 omar.polo ## What?
12 be5b89f6 2018-05-18 omar.polo
13 eccc9e7a 2018-05-20 omar.polo This is a replacement for `dmenu(1)`.
14 be5b89f6 2018-05-18 omar.polo
15 be5b89f6 2018-05-18 omar.polo ## Why?
16 be5b89f6 2018-05-18 omar.polo
17 be5b89f6 2018-05-18 omar.polo This was the perfect excuse to learn how to make window with Xlib.
18 be5b89f6 2018-05-18 omar.polo
19 be5b89f6 2018-05-18 omar.polo ## How?
20 be5b89f6 2018-05-18 omar.polo
21 b3f35c85 2018-05-18 omar.polo Check out the [manpage](mymenu.1) for further documentation. Check out
22 b3f35c85 2018-05-18 omar.polo also the [template](Xexample) for the resources.
23 be5b89f6 2018-05-18 omar.polo
24 be5b89f6 2018-05-18 omar.polo ---
25 be5b89f6 2018-05-18 omar.polo
26 be5b89f6 2018-05-18 omar.polo ## Dependencies
27 be5b89f6 2018-05-18 omar.polo
28 be5b89f6 2018-05-18 omar.polo - Xlib
29 be5b89f6 2018-05-18 omar.polo - Xinerama (optional)
30 be5b89f6 2018-05-18 omar.polo For multi-monitor support
31 c9a3bfaa 2018-05-21 omar.polo - Xft (optional)
32 c9a3bfaa 2018-05-21 omar.polo For TrueType (r) font support
33 be5b89f6 2018-05-18 omar.polo - pkg-config (optional)
34 be5b89f6 2018-05-18 omar.polo used in the makefile to generate `LIBS` and `CFLAGS` correctly
35 be5b89f6 2018-05-18 omar.polo
36 be5b89f6 2018-05-18 omar.polo ## Build
37 be5b89f6 2018-05-18 omar.polo
38 75faf30e 2018-05-22 omar.polo As simple as `make` (or `make gnu` if you're using GNU libc). Keep in
39 75faf30e 2018-05-22 omar.polo mind that, by default, both Xft and Xinerama are enabled. So, you may
40 75faf30e 2018-05-22 omar.polo want to run:
41 be5b89f6 2018-05-18 omar.polo
42 75faf30e 2018-05-22 omar.polo - `make no_xft` to build without xft support;
43 75faf30e 2018-05-22 omar.polo - `make no_xinerama` to build without xinerama support;
44 75faf30e 2018-05-22 omar.polo - `make no_xft_xinerama` to build without xinerama *and* no xft support.
45 75faf30e 2018-05-22 omar.polo
46 75faf30e 2018-05-22 omar.polo #### ignore case completion / don't have `strcasestr(3)`
47 75faf30e 2018-05-22 omar.polo
48 75faf30e 2018-05-22 omar.polo If you want to build without the ignore case completion or on your
49 75faf30e 2018-05-22 omar.polo platform `strcasestr(3)` isn't available, you have to update the
50 75faf30e 2018-05-22 omar.polo `Makefile` and remove `-DUSE_STRCASESTR`. A simple
51 75faf30e 2018-05-22 omar.polo ``` shell
52 75faf30e 2018-05-22 omar.polo sed -i.orig 's/-DUSE_STRCASESTR//g' Makefile
53 75faf30e 2018-05-22 omar.polo ```
54 75faf30e 2018-05-22 omar.polo should be enough.
55 75faf30e 2018-05-22 omar.polo
56 75faf30e 2018-05-22 omar.polo
57 9c241438 2018-05-20 omar.polo ## FAQ
58 9c241438 2018-05-20 omar.polo
59 9c241438 2018-05-20 omar.polo - Does not run / Hangs
60 9c241438 2018-05-20 omar.polo
61 9c241438 2018-05-20 omar.polo At the startup mymenu will read `stdin` for a list of item, only
62 9c241438 2018-05-20 omar.polo then it'll display a window. Are you sure that you're passing
63 9c241438 2018-05-20 omar.polo something on standard input?
64 9c241438 2018-05-20 omar.polo
65 9c241438 2018-05-20 omar.polo - Will feature $X be added?
66 9c241438 2018-05-20 omar.polo
67 9c241438 2018-05-20 omar.polo No. Or maybe Yes. In fact, it depends. Open an issue and let's
68 9c241438 2018-05-20 omar.polo discuss. If it's something that's trivial to achieve in combo with
69 9c241438 2018-05-20 omar.polo other tool maybe is not the case to add it here.
70 9c241438 2018-05-20 omar.polo
71 9c241438 2018-05-20 omar.polo - Is feature $Y present? What $Z do? How to achieve $W?
72 9c241438 2018-05-20 omar.polo
73 9c241438 2018-05-20 omar.polo Everything is documented in the man page. To read it, simply execute
74 9c241438 2018-05-20 omar.polo `man -l mymenu.1` or `mandoc mymenu.1 | less` (depending on your
75 9c241438 2018-05-20 omar.polo system the `-l` option may not be present).
76 9c241438 2018-05-20 omar.polo
77 be5b89f6 2018-05-18 omar.polo ---
78 be5b89f6 2018-05-18 omar.polo
79 be5b89f6 2018-05-18 omar.polo ## TODO
80 be5b89f6 2018-05-18 omar.polo
81 75faf30e 2018-05-22 omar.polo - Improve UTF8 support
82 75faf30e 2018-05-22 omar.polo
83 75faf30e 2018-05-22 omar.polo The whole UTF8 support is still kinda naïve and should definitely
84 75faf30e 2018-05-22 omar.polo be improved.
85 75faf30e 2018-05-22 omar.polo
86 75faf30e 2018-05-22 omar.polo - Opacity support
87 75faf30e 2018-05-22 omar.polo
88 be5b89f6 2018-05-18 omar.polo - Command line flags
89 9c241438 2018-05-20 omar.polo
90 be5b89f6 2018-05-18 omar.polo At the moment the X Resource Database is the only way to interact
91 be5b89f6 2018-05-18 omar.polo with the graphic appearance of MyMenu.
92 be5b89f6 2018-05-18 omar.polo
93 b836b1ec 2018-05-18 omar.polo ## Scripts
94 b836b1ec 2018-05-18 omar.polo
95 8880d5e3 2018-05-19 omar.polo I'm using this script to launch MyMenu with custom item
96 b836b1ec 2018-05-18 omar.polo
97 b836b1ec 2018-05-18 omar.polo ``` shell
98 b836b1ec 2018-05-18 omar.polo #!/bin/sh
99 b836b1ec 2018-05-18 omar.polo
100 b836b1ec 2018-05-18 omar.polo cat <<EOF | /bin/sh -c "$(mymenu "$@")"
101 b836b1ec 2018-05-18 omar.polo sct 4500
102 b836b1ec 2018-05-18 omar.polo lock
103 b836b1ec 2018-05-18 omar.polo connect ethernet
104 b836b1ec 2018-05-18 omar.polo connect home
105 b836b1ec 2018-05-18 omar.polo connect phone
106 8880d5e3 2018-05-19 omar.polo ZZZ
107 b836b1ec 2018-05-18 omar.polo zzz
108 b836b1ec 2018-05-18 omar.polo ...
109 b836b1ec 2018-05-18 omar.polo EOF
110 b836b1ec 2018-05-18 omar.polo ```
111 b836b1ec 2018-05-18 omar.polo
112 8880d5e3 2018-05-19 omar.polo You can generate a menu from the `.desktop` file with something like
113 8880d5e3 2018-05-19 omar.polo this:
114 8880d5e3 2018-05-19 omar.polo
115 8880d5e3 2018-05-19 omar.polo ``` shell
116 8880d5e3 2018-05-19 omar.polo #!/bin/sh
117 8880d5e3 2018-05-19 omar.polo
118 8880d5e3 2018-05-19 omar.polo getname() {
119 8880d5e3 2018-05-19 omar.polo cat $1 | grep '^Name=' | sed 's/^.*=//'
120 8880d5e3 2018-05-19 omar.polo }
121 8880d5e3 2018-05-19 omar.polo
122 8880d5e3 2018-05-19 omar.polo getexec() {
123 8880d5e3 2018-05-19 omar.polo cat $1 | grep '^Exec=' | sed 's/^.*=//'
124 8880d5e3 2018-05-19 omar.polo }
125 8880d5e3 2018-05-19 omar.polo
126 8880d5e3 2018-05-19 omar.polo desktop_files=`ls /usr/local/share/applications/*.desktop`
127 8880d5e3 2018-05-19 omar.polo
128 8880d5e3 2018-05-19 omar.polo {
129 8880d5e3 2018-05-19 omar.polo for i in $desktop_files; do
130 8880d5e3 2018-05-19 omar.polo getname $i
131 8880d5e3 2018-05-19 omar.polo done
132 8880d5e3 2018-05-19 omar.polo } | mymenu "$@" | {
133 8880d5e3 2018-05-19 omar.polo read prgname
134 8880d5e3 2018-05-19 omar.polo for i in $desktop_files; do
135 8880d5e3 2018-05-19 omar.polo name=`getname $i`
136 8880d5e3 2018-05-19 omar.polo if [ "x$prgname" = "x$name" ]; then
137 8880d5e3 2018-05-19 omar.polo exec `getexec $i`
138 8880d5e3 2018-05-19 omar.polo fi
139 8880d5e3 2018-05-19 omar.polo done
140 8880d5e3 2018-05-19 omar.polo }
141 8880d5e3 2018-05-19 omar.polo ```
142 8880d5e3 2018-05-19 omar.polo
143 8880d5e3 2018-05-19 omar.polo or generate a list of executables from `$PATH` like this:
144 8880d5e3 2018-05-19 omar.polo
145 8880d5e3 2018-05-19 omar.polo ``` shell
146 8880d5e3 2018-05-19 omar.polo #!/bin/sh
147 8880d5e3 2018-05-19 omar.polo
148 8880d5e3 2018-05-19 omar.polo path=`echo $PATH | sed 's/:/ /g'`
149 8880d5e3 2018-05-19 omar.polo
150 8880d5e3 2018-05-19 omar.polo {
151 8880d5e3 2018-05-19 omar.polo for i in $path; do
152 8880d5e3 2018-05-19 omar.polo ls -F $i | grep '.*\*$' | sed 's/\*//'
153 8880d5e3 2018-05-19 omar.polo done
154 75faf30e 2018-05-22 omar.polo } | sort -f | /bin/sh -c "$(mymenu "$@")"
155 8880d5e3 2018-05-19 omar.polo ```
156 8880d5e3 2018-05-19 omar.polo
157 b836b1ec 2018-05-18 omar.polo Of course you can as well use the `dmenu_path` and `dmenu_run` scripts
158 b836b1ec 2018-05-18 omar.polo that (usually) comes with `dmenu`.