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 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 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 .