John Hawthorn authored on 12/07/2025 06:54:23
| ... | ... |
@@ -1,4 +1,4 @@ |
| 1 |
-.TH FZY 1 "2018-09-23" "fzy 1.0" |
|
| 1 |
+.TH FZY 1 "2025-07-12" "fzy 1.1" |
|
| 2 | 2 |
.SH NAME |
| 3 | 3 |
fzy \- A fuzzy text selector menu for the terminal. |
| 4 | 4 |
.SH SYNOPSIS |
| ... | ... |
@@ -45,6 +45,10 @@ Non-interactive mode. Print the matches in sorted order for QUERY to stdout. |
| 45 | 45 |
Read input delimited by ASCII NUL characters. |
| 46 | 46 |
. |
| 47 | 47 |
.TP |
| 48 |
+.BR \-i ", " \-\-show-info |
|
| 49 |
+Show selection info line. |
|
| 50 |
+. |
|
| 51 |
+.TP |
|
| 48 | 52 |
.BR \-h ", " \-\-help |
| 49 | 53 |
Usage help. |
| 50 | 54 |
. |
| ... | ... |
@@ -61,10 +61,10 @@ Print the selected item to stdout and exit |
| 61 | 61 |
.BR "Ctrl+c, Ctrl+g, Esc" |
| 62 | 62 |
Exit with status 1, without making a selection. |
| 63 | 63 |
.TP |
| 64 |
-.BR "Up Arrow, Ctrl+p" |
|
| 64 |
+.BR "Up Arrow, Ctrl+p, Ctrl+k" |
|
| 65 | 65 |
Select the previous item |
| 66 | 66 |
.TP |
| 67 |
-.BR "Down Arrow, Ctrl+n" |
|
| 67 |
+.BR "Down Arrow, Ctrl+n, Ctrl+j" |
|
| 68 | 68 |
Select the next item |
| 69 | 69 |
.TP |
| 70 | 70 |
Tab |
Update man page regarding `--read-null`; it is already present in `fzy -h`.
Kevin Kainan Li authored on 28/05/2020 16:28:27
• GitHub committed on 28/05/2020 16:28:27
| ... | ... |
@@ -41,6 +41,10 @@ Use QUERY as the initial search query. |
| 41 | 41 |
Non-interactive mode. Print the matches in sorted order for QUERY to stdout. |
| 42 | 42 |
. |
| 43 | 43 |
.TP |
| 44 |
+.BR \-0 ", " \-\-read-null |
|
| 45 |
+Read input delimited by ASCII NUL characters. |
|
| 46 |
+. |
|
| 47 |
+.TP |
|
| 44 | 48 |
.BR \-h ", " \-\-help |
| 45 | 49 |
Usage help. |
| 46 | 50 |
. |
Greg Anders authored on 13/10/2019 22:10:34
John Hawthorn authored on 23/09/2018 21:17:22
John Hawthorn authored on 10/09/2018 06:04:49
Jason Felice authored on 04/05/2018 16:32:40
John Hawthorn authored on 17/04/2017 07:55:42
John Hawthorn authored on 01/01/2017 12:33:41
John Hawthorn authored on 04/08/2016 06:54:51
John Hawthorn authored on 27/07/2016 01:53:26
John Hawthorn authored on 12/06/2016 03:35:08
Setting update date based on 0bdcf35
Taylor Stearns authored on 23/05/2016 21:11:43
• John Hawthorn committed on 01/06/2016 16:49:20
John Hawthorn authored on 17/05/2016 02:46:22
| ... | ... |
@@ -33,6 +33,10 @@ Show the scores for each item. |
| 33 | 33 |
Use TTY instead of the default tty device (/dev/tty). |
| 34 | 34 |
. |
| 35 | 35 |
.TP |
| 36 |
+.BR \-q ", " \-\-query =\fIQUERY\fR |
|
| 37 |
+Use QUERY as the initial search query. |
|
| 38 |
+. |
|
| 39 |
+.TP |
|
| 36 | 40 |
.BR \-e ", " \-\-show-matches =\fIQUERY\fR |
| 37 | 41 |
Non-interactive mode. Print the matches in sorted order for QUERY to stdout. |
| 38 | 42 |
. |
John Hawthorn authored on 21/09/2014 21:04:00
| ... | ... |
@@ -21,6 +21,10 @@ heuristics for the best match. |
| 21 | 21 |
How many lines of items to display. If unspecified, defaults to 10 lines. |
| 22 | 22 |
. |
| 23 | 23 |
.TP |
| 24 |
+.BR \-p ", " \-\-prompt =\fIPROMPT\fR |
|
| 25 |
+Input prompt (default: '> ') |
|
| 26 |
+. |
|
| 27 |
+.TP |
|
| 24 | 28 |
.BR \-s ", " \-\-show-scores |
| 25 | 29 |
Show the scores for each item. |
| 26 | 30 |
. |
John Hawthorn authored on 15/09/2014 07:08:48
| ... | ... |
@@ -79,6 +79,9 @@ List files under the current directory and open the one selected in vi. |
| 79 | 79 |
.BR "cd $(find -type d | fzy)" |
| 80 | 80 |
Present all directories under current path, and change to the one selected. |
| 81 | 81 |
.TP |
| 82 |
+.BR "ps aux | fzy | awk '{ print $2 }' | xargs kill"
|
|
| 83 |
+List running processes, kill the selected process |
|
| 84 |
+.TP |
|
| 82 | 85 |
.BR "git checkout $(git branch | cut -c 3- | fzy)" |
| 83 | 86 |
Same as above, but switching git branches. |
| 84 | 87 |
.SH AUTHOR |
John Hawthorn authored on 15/09/2014 02:25:14
| 1 | 1 |
new file mode 100644 |
| ... | ... |
@@ -0,0 +1,85 @@ |
| 1 |
+.TH FZY 1 "2014-09-11" "fzy 0.1beta" |
|
| 2 |
+.SH NAME |
|
| 3 |
+fzy \- A fuzzy text selector menu for the terminal. |
|
| 4 |
+.SH SYNOPSIS |
|
| 5 |
+.B fzy |
|
| 6 |
+.IR [OPTION]... |
|
| 7 |
+.SH DESCRIPTION |
|
| 8 |
+.B fzy is a fuzzy text selector/file finder for the terminal using a search |
|
| 9 |
+similar to that of TextMate or CmdT. |
|
| 10 |
+ |
|
| 11 |
+fzy reads a list of newline-separated items from stdin to be displayed as a |
|
| 12 |
+menu in the terminal. |
|
| 13 |
+Upon pressing ENTER, the currently selected item is printed to stdout. |
|
| 14 |
+ |
|
| 15 |
+Entering text narrows the items using fuzzy matching. Results are sorted using |
|
| 16 |
+heuristics for the best match. |
|
| 17 |
+ |
|
| 18 |
+.SH OPTIONS |
|
| 19 |
+.TP |
|
| 20 |
+.BR \-l ", " \-\-lines =\fILINES\fR |
|
| 21 |
+How many lines of items to display. If unspecified, defaults to 10 lines. |
|
| 22 |
+. |
|
| 23 |
+.TP |
|
| 24 |
+.BR \-s ", " \-\-show-scores |
|
| 25 |
+Show the scores for each item. |
|
| 26 |
+. |
|
| 27 |
+.TP |
|
| 28 |
+.BR \-t ", " \-\-tty =\fITTY\fR |
|
| 29 |
+Use TTY instead of the default tty device (/dev/tty). |
|
| 30 |
+. |
|
| 31 |
+.TP |
|
| 32 |
+.BR \-e ", " \-\-show-matches =\fIQUERY\fR |
|
| 33 |
+Non-interactive mode. Print the matches in sorted order for QUERY to stdout. |
|
| 34 |
+. |
|
| 35 |
+.TP |
|
| 36 |
+.BR \-h ", " \-\-help |
|
| 37 |
+Usage help. |
|
| 38 |
+. |
|
| 39 |
+.TP |
|
| 40 |
+.BR \-v ", " \-\-version |
|
| 41 |
+Usage help. |
|
| 42 |
+. |
|
| 43 |
+.SH KEYS |
|
| 44 |
+. |
|
| 45 |
+.TP |
|
| 46 |
+.BR "ENTER" |
|
| 47 |
+Print the selected item to stdout and exit |
|
| 48 |
+.TP |
|
| 49 |
+.BR "Up Arrow, Ctrl+p" |
|
| 50 |
+Select the previous item |
|
| 51 |
+.TP |
|
| 52 |
+.BR "Down Arrow, Ctrl+n" |
|
| 53 |
+Select the next item |
|
| 54 |
+.TP |
|
| 55 |
+Tab |
|
| 56 |
+Replace the current search string with the selected item |
|
| 57 |
+.TP |
|
| 58 |
+.BR "Backspace, Ctrl+h" |
|
| 59 |
+Delete the character before the cursor |
|
| 60 |
+.TP |
|
| 61 |
+.BR Ctrl+w |
|
| 62 |
+Delete the word before the cursor |
|
| 63 |
+.TP |
|
| 64 |
+.BR Ctrl+u |
|
| 65 |
+Delete the entire line |
|
| 66 |
+. |
|
| 67 |
+.SH USAGE EXAMPLES |
|
| 68 |
+. |
|
| 69 |
+.TP |
|
| 70 |
+.BR "ls | fzy" |
|
| 71 |
+Present a menu of items in the current directory |
|
| 72 |
+.TP |
|
| 73 |
+.BR "ls | fzy -l 25" |
|
| 74 |
+Same as above, but show 25 lines of items |
|
| 75 |
+.TP |
|
| 76 |
+.BR "vi $(find -type f | fzy)" |
|
| 77 |
+List files under the current directory and open the one selected in vi. |
|
| 78 |
+.TP |
|
| 79 |
+.BR "cd $(find -type d | fzy)" |
|
| 80 |
+Present all directories under current path, and change to the one selected. |
|
| 81 |
+.TP |
|
| 82 |
+.BR "git checkout $(git branch | cut -c 3- | fzy)" |
|
| 83 |
+Same as above, but switching git branches. |
|
| 84 |
+.SH AUTHOR |
|
| 85 |
+John Hawthorn <john.hawthorn@gmail.com> |
git.rcrnstn.net