iomenu.1 - iomenu - interactive terminal-based selection menu
(HTM) git clone git://bitreich.org/iomenu git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/iomenu
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) Tags
(DIR) README
(DIR) LICENSE
---
iomenu.1 (1901B)
---
1 .Dd aug 21, 2017
2 .Dt IOMENU 1
3 .Os
4 .
5 .
6 .Sh NAME
7 .
8 .Nm iomenu
9 .Nd interactive selection menu
10 .
11 .
12 .Sh SYNOPSIS
13 .
14 .Nm
15 .Op Fl #
16 .
17 .
18 .Sh DESCRIPTION
19 .
20 .Nm
21 is an interactive filtering and selection tool for the terminal.
22 .
23 .Pp
24 It reads lines from standard input, and prompt for a selection.
25 The selected line is printed to standard output.
26 .
27 .Bl -tag -width 6n
28 .
29 .It Fl #
30 If a line starts with
31 .Li # ,
32 .Nm
33 will interprete it as a header, which always matches, and can not be
34 printed.
35 .
36 .
37 .Sh KEY BINDINGS
38 .
39 An active selection is highlighted, and can be controlled with keybindings.
40 As printable keys are entered, the lines are filtered to match each
41 word from the input.
42 .
43 .Bl -tag -width 6n
44 .
45 .It Ic Up Ns , Ic Down Ns , Ic Ctrl + p Ns , Ic Ctrl + n
46 Move selection to the previous/next item.
47 .
48 .It Ic Alt + p Ns , Ic Alt + n
49 Move selection to the previous/next header.
50 .
51 .It Ic PageUp Ns , Ic PageDown Ns , Ic Alt + v Ns , Ic Ctrl + v
52 Move one page up or down.
53 .
54 .It Ic Ctrl + m Ns , Ic Ctrl + j Ns , Ic Enter
55 Print the selection to the standard output, and exit 0.
56 .
57 .It Ic Ctrl + h Ns , Ic Bakcspace
58 Remove last character from current input.
59 .
60 .It Ic Ctrl + w
61 Remove last word from current input.
62 .
63 .It Ic Ctrl + u
64 Remove the whole input string.
65 .
66 .It Ic Ctrl + i Ns , Ic Tab
67 Fill the input with current selection.
68 .
69 .El
70 .
71 .
72 .Sh EXIT STATUS
73 .
74 .Ex -std
75 .
76 .
77 .Sh EXAMPLES
78 .
79 Go to a subdirectory:
80 .Dl cd "$(find . -type d | iomenu)"
81 .
82 .Pp
83 Edit a file located in
84 .Ev HOME :
85 .Dl $EDITOR "$(find "$HOME" -type f | iomenu)"
86 .
87 .Pp
88 Play an audio file:
89 .Dl mplayer "$(find ~/Music | iomenu)"
90 .
91 .Pp
92 Select a background job to attach to:
93 .Dl fg "%$(jobs | iomenu | cut -c 2)"
94 .
95 .Pp
96 Filter "ps" output and print a process ID:
97 .Dl { printf '#'; ps ax; } | iomenu -# | sed -r 's/ *([0-9]*).*/\1/'
98 .
99 .
100 .Sh SEE ALSO
101 .
102 .Xr dmenu 1 ,
103 .Xr slmenu 1 ,
104 .Xr vis-menu 1
105 .
106 .
107 .Sh AUTORS
108 .
109 .An Josuah Demangeon Aq Mt mail@josuah.net