xaizek / pipedial (License: GPLv3 only) (since 2019-01-08)
One more tool for selecting something in console.
<root> / docs / pipedial.1 (0e9076ef41ec54a8e5da5f3d29a33b7797c14ea7) (2,158B) (mode 100644) [raw]
.\" Automatically generated by Pandoc 1.17.0.3
.\"
.TH "pipedial" "1" "September 20, 2020" "" ""
.hy
.SH NAME
.PP
\f[I]pipedial\f[] is a terminal element picker.
It displays a list of lines it got from standard input and lets the user
pick which one of them is printed on standard output.
.SH SYNOPSIS
.PP
\f[B]pipedial\f[] < \f[I]list\-of\-inputs\f[]
.PP
\f[I]input\-generator\f[] | \f[B]pipedial\f[] |
\f[I]output\-consumer\f[]
.PP
\f[I]output\-consumer\f[] $(\f[I]input\-generator\f[] |
\f[B]pipedial\f[])
.SH OPTIONS
.SS \f[B]\f[C]\-\-help\f[], \f[C]\-h\f[]\f[]
.PP
Display short usage help.
.SS \f[B]\f[C]\-\-version\f[]\f[]
.PP
Display version information.
.SS \f[B]\f[C]\-\-title\ <title>\f[], \f[C]\-t\ <title>\f[]\f[]
.PP
Customize title.
.SS \f[B]\f[C]\-\-filter\f[], \f[C]\-f\f[]\f[]
.PP
Start in filtering mode.
.SH SHORTCUTS
.PP
\f[B]{Escape}\f[] \-\- abort partially typed shortcut.
.SS Normal Mode
.PP
\f[B]q\f[] \-\- quit the application with no selection.
.PP
\f[B]h\f[] \-\- enter Help mode.
.PP
\f[B]{Enter}\f[] \-\- select current item and quit.
.PP
\f[B]e\f[] \-\- edit current item and accept the result.
.PP
\f[B]/\f[] \-\- start interactive filtering.
Case is respected unless no matches are found.
.PP
\f[B][count]gg\f[] \-\- put cursor on the first or \f[B][count]\f[]\-th
element.
.PP
\f[B][count]G\f[] \-\- put cursor on the last or \f[B][count]\f[]\-th
element.
.PP
\f[B][count]j\f[] \-\- move cursor \f[B][count]\f[] (1 by default)
elements down.
.PP
\f[B][count]k\f[] \-\- move cursor \f[B][count]\f[] (1 by default)
elements up.
.PP
\f[B]Ctrl\-E\f[] \-\- scroll one line down.
.PP
\f[B]Ctrl\-Y\f[] \-\- scroll one line up.
.SS Help Mode
.PP
\f[B]h\f[] \-\- return to Normal mode.
.PP
\f[B]gg\f[] \-\- scroll to the top.
.PP
\f[B]G\f[] \-\- scroll to the bottom.
.PP
\f[B]j\f[]/\f[B]Ctrl\-E\f[] \-\- scroll one line down.
.PP
\f[B]k\f[]/\f[B]Ctrl\-Y\f[] \-\- scroll one line up.
.SH EXAMPLES
.PP
Switch to a branch inside git repository (doesn\[aq]t handle
cancellation):
.IP
.nf
\f[C]
git\ checkout\ $(git\ branch\ |\ pipedial\ \-\-title\ \[aq]Pick\ destination\ branch:\[aq])
\f[]
.fi
.SH AUTHORS
xaizek <xaizek@posteo.net>.
Hints

Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://code.reversed.top/user/xaizek/pipedial

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@code.reversed.top/user/xaizek/pipedial

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a pull request:
... clone the repository ...
... make some changes and some commits ...
git push origin master