SMOLNET PORTAL home about changes
iadd a real README (not from the man pages) - iomenu - interactive terminal-based selection menu	Err	bitreich.org	70
hgit clone git://bitreich.org/iomenu git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/iomenu	URL:git://bitreich.org/iomenu git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/iomenu	bitreich.org	70
1Log	/scm/iomenu/log.gph	bitreich.org	70
1Files	/scm/iomenu/files.gph	bitreich.org	70
1Refs	/scm/iomenu/refs.gph	bitreich.org	70
1Tags	/scm/iomenu/tag	bitreich.org	70
1README	/scm/iomenu/file/README.gph	bitreich.org	70
1LICENSE	/scm/iomenu/file/LICENSE.gph	bitreich.org	70
i---	Err	bitreich.org	70
1commit 3905e591078c229e7db64662c9f933bc1c7a504d	/scm/iomenu/commit/3905e591078c229e7db64662c9f933bc1c7a504d.gph	bitreich.org	70
1parent dc5363e17ca9699906f7789d6175dc09aa6418ec	/scm/iomenu/commit/dc5363e17ca9699906f7789d6175dc09aa6418ec.gph	bitreich.org	70
hAuthor: Josuah Demangeon <mail@josuah.net>	URL:mailto:mail@josuah.net	bitreich.org	70
iDate:   Tue, 12 Jun 2018 23:04:38 +0200	Err	bitreich.org	70
i	Err	bitreich.org	70
iadd a real README (not from the man pages)	Err	bitreich.org	70
i	Err	bitreich.org	70
iDiffstat:	Err	bitreich.org	70
i  M README                              |      94 +++++--------------------------	Err	bitreich.org	70
i	Err	bitreich.org	70
i1 file changed, 14 insertions(+), 80 deletions(-)	Err	bitreich.org	70
i---	Err	bitreich.org	70
1diff --git a/README b/README	/scm/iomenu/file/README.gph	bitreich.org	70
i@@ -1,86 +1,20 @@	Err	bitreich.org	70
i-IOMENU(1)                   General Commands Manual                  IOMENU(1)	Err	bitreich.org	70
i+iomenu	Err	bitreich.org	70
i+================================================================================	Err	bitreich.org	70
i 	Err	bitreich.org	70
i-NAME	Err	bitreich.org	70
i-     iomenu – interactive selection menu	Err	bitreich.org	70
i+*iomenu* is an interactive menu inspired from dmenu [1]: it reads lines from	Err	bitreich.org	70
i+stdin display them to the screen [1], and filter them as the user type.  When	Err	bitreich.org	70
i+`Enter` is pressed, the selected line is printed to stdout.	Err	bitreich.org	70
i 	Err	bitreich.org	70
i-SYNOPSIS	Err	bitreich.org	70
i-     iomenu [-#] [-l lines] [-p prompt]	Err	bitreich.org	70
i+This permits to build interactive menu with shell pipes.  As an example, a poor	Err	bitreich.org	70
i+man's music player could be done this way:	Err	bitreich.org	70
i 	Err	bitreich.org	70
i-DESCRIPTION	Err	bitreich.org	70
i-     iomenu is an interactive filtering and selection tool for the terminal.	Err	bitreich.org	70
i+        $ find ~/music -name '*.flac' | iomenu | xargs mplayer	Err	bitreich.org	70
i 	Err	bitreich.org	70
i-     It reads lines from standard input, and prompt for a selection.  The	Err	bitreich.org	70
i-     selected line is printed to standard output.	Err	bitreich.org	70
i+It will print all the FLAC files in `~/music` to iomenu which shows a fulscreen	Err	bitreich.org	70
i+menu, and the selected file will be printed to xargs mplayer.	Err	bitreich.org	70
i 	Err	bitreich.org	70
i-     -l lines          If lines is 0 or if -l is not set, the items are	Err	bitreich.org	70
i-                       displayed in an horizontal list.  Otherwise, in a	Err	bitreich.org	70
i-                       vertical list of at most lines lines.	Err	bitreich.org	70
i+iomenu does not use ncurses but ansi escape sequences [2] instead so it does	Err	bitreich.org	70
i+not have dependencies beyond a C compiler.	Err	bitreich.org	70
i 	Err	bitreich.org	70
i-     -p prompt         Set the prompt to display at the beginning of the input	Err	bitreich.org	70
i-                       to prompt.	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-     -#                If a line starts with #, iomenu will interprete it as a	Err	bitreich.org	70
i-                       header, which always matches, and can not be printed.	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-KEY BINDINGS	Err	bitreich.org	70
i-     An active selection is highlighted, and can be controlled with	Err	bitreich.org	70
i-     keybindings.  As printable keys are entered, the lines are filtered to	Err	bitreich.org	70
i-     match each word from the input.	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-     Up, Down, Ctrl + p, Ctrl + n	Err	bitreich.org	70
i-                      Move selection to the previous/next item.	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-     PageUp, PageDown, Alt + v, Ctrl + v	Err	bitreich.org	70
i-                      Move one page up or down.	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-     Ctrl + m, Ctrl + j, Enter	Err	bitreich.org	70
i-                      Print the selection to the standard output, and exit 0.	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-     Ctrl + h, Bakcspace	Err	bitreich.org	70
i-                      Remove last character from current input.	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-     Ctrl + w         Remove last word from current input.	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-     Ctrl + u         Remove the whole input string.	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-     Ctrl + i, Tab    Fill the input with current selection.	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-EXIT STATUS	Err	bitreich.org	70
i-     The iomenu utility exits 0 on success, and >0 if an error occurs.	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-EXAMPLES	Err	bitreich.org	70
i-     Open a bookmark from a list in a text file:	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-       iomenu < bookmarks-urls.txt | xargs firefox	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-     Go to a subdirectory:	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-       cd "$(find . -type d | iomenu)"	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-     Edit a file located in HOME:	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-       EDITOR "$(find "$HOME" -type f | iomenu -l 255)"	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-     Play an audio file:	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-       mplayer "$(find ~/Music | iomenu)"	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-     Select a background job to attach to:	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-       fg "%$(jobs | iomenu | cut -c 2)"	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-     Filter "ps" output and print a process ID	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-       { printf '# '; ps ax; } | iomenu -l 255 -s | sed -r 's/ *([0-9]*).*/1/'	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-SEE ALSO	Err	bitreich.org	70
i-     dmenu(1), slmenu(1), vis-menu(1)	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-BUGS	Err	bitreich.org	70
i-     iomenu currently only support ASCII characters.	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-AUTORS	Err	bitreich.org	70
i-     iomenu was written from scratch by Josuah Demangeon <mail@josuah.net>	Err	bitreich.org	70
i-     with the help of dmenu(1) and vis-menu(1) as models.	Err	bitreich.org	70
i-	Err	bitreich.org	70
i-Void Linux                      August 21, 2017                     Void Linux	Err	bitreich.org	70
i+[1]: https://tools.suckless.org/dmenu	Err	bitreich.org	70
i+[2]: https://en.wikipedia.org/wiki/ANSI_escape_code	Err	bitreich.org	70
.
Response: text/plain
Original URLgopher://bitreich.org/0/scm/iomenu/commit/3905e591078c229...
Content-Typetext/plain; charset=utf-8