Date:

Fri Oct 18 20:47:53 2019 UTC

Message:

improved command example that grep | sed can be reduced to a single sed

1# MyMenu
2
3> A menu for Xorg, 'cause I was bored
4
5![MyMenu works!](screen.png)
6
7![MyMenu alternate layout](screen-alt.png)
8
9---
10
11## What?
12
13This is a simple menu for Xorg, like `dmenu(1)`.
14
15## Why?
16
17This was the perfect excuse to learn how to use Xlib.
18
19## How?
20
21Check out the [manpage](mymenu.1.md) for further documentation. Check
22out also the [template](Xexample) for the resources.
23
24---
25
26## Features
27
28- two layout: `horizontal` (a là dmenu) and `vertical` (a là rofi);
29- highly customizable (width, height, position on the screen, colors, borders, ...);
30- transparency support
31- support for both Xft and bitmap font
32
33## Dependencies
34
35 - Xlib
36 - Xinerama *(optional)* for multi-monitor support
37 - Xft *(optional)* for TrueType font support
38 - pkg-config *(optional)* to generate `LIBS` and `CFLAGS`
39 - mandoc *(optional)* to generate the
40   [markdown version of the manpage](mymenu.1.md)
41
42## Build
43
44As simple as `make` (or `make gnu` if you're using GNU libc). Keep in
45mind that, by default, both Xft and Xinerama are enabled. So, you may
46want to run:
47
48  - `make no_xft` to build without xft support;
49  - `make no_xinerama` to build without xinerama support;
50  - `make no_xft_xinerama` to build without xinerama *and* no xft support.
51
52Or you can update the first lines of the `Makefile` customizing
53`OPTIONAL` and `CDEFS` to your needs.
54
55#### ignore case completion / don't have `strcasestr(3)`
56
57If you want to build without the ignore case completion or on your
58platform `strcasestr(3)` isn't available, you have to update the
59`Makefile` and remove `-DUSE_STRCASESTR`. A simple
60``` shell
61sed -i.orig 's/-DUSE_STRCASESTR//g' Makefile
62```
63should be enough.
64
65
66## FAQ
67
68 - Does not run / Hangs
69
70   At the startup mymenu will read `stdin` for a list of item, only
71   then it'll display a window. Are you sure that you're passing
72   something on standard input?
73
74 - Will feature $X be added?
75
76   No. Or maybe yes. In fact, it depends. Open an issue and let's
77   discuss. If it's something that's trivial to achieve in combo with
78   other tool maybe is not the case to add it here.
79
80 - Is feature $Y present? What $Z do? How to achieve $W?
81
82   Everything is documented in the [man page](mymenu.1.md). To read
83   it, simply execute `man -l mymenu.1` or `mandoc mymenu.1 | less`
84   (depending on your system the `-l` option may not be present).
85
86---
87
88## Scripts
89
90I'm using this script to launch MyMenu with custom item
91
92``` shell
93#!/bin/sh
94
95cat <<EOF | /bin/sh -c "$(mymenu "$@")"
96sct 4500
97lock
98connect ethernet
99connect home
100connect phone
101ZZZ
102zzz
103...
104EOF
105```
106
107You can generate a list of executables from `$PATH` like this:
108
109``` shell
110#!/bin/sh
111
112path=`echo $PATH | sed 's/:/ /g'`
113
114{
115    for i in $path; do
116        ls -F $i | sed -n 's/\*$//p'
117    done
118} | sort -f | /bin/sh -c "$(mymenu "$@")"
119```
120
121You can, for example, select a song to play from the current queue (in mpd), with
122
123```shell
124fmt="%position% %artist% - %title%"
125if song=$(mpc playlist -f "$fmt" | mymenu -p "Song: " -A -d " "); then
126    mpc play $(echo $song | sed "s/ .*$//")
127fi
128```
129
130Of course you can as well use the `dmenu_path` and `dmenu_run` scripts
131that (usually) comes with `dmenu`.