Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PICK(1)			FreeBSD	General	Commands Manual		       PICK(1)

NAME
     pick -- fuzzy select anything

SYNOPSIS
     pick [-hvS] [-d [-o]] [-x | -X] [-q query]

DESCRIPTION
     The pick utility allows users to select from a set	of choices using an
     curses(3) interface with fuzzy search functionality.

     The choices are read from stdin, and the selected choice written to
     stdout.

     The options are as	follows:

     -d	       Read and	display	descriptions.  Input lines will	be split into
	       two parts by the	last occurrence	of IFS.	 Both parts will be
	       displayed but only the first part will be used when searching.

     -h	       Output a	help message and exit.

     -o	       Output description of selected choice on	exit.

     -q	query  Supply an initial search	query.

     -S	       Disable sorting.	 Only filter the choices instead of addition-
	       ally sorting by score.

     -v	       Output the version and exit.

     -x	       Enable the use of the alternate screen terminal feature.

     -X	       Disable the use of the alternate	screen terminal	feature.

COMMANDS
     Ctrl-C
	   Exit	with a erroneous status	without	outputting the selected
	   choice.

     Up/Down | Ctrl-P/Ctrl-N
	   Select between choices matching the current search query.

     Page-Down/Page-Up
	   Move	the selection to the choice located one	page down/up from the
	   currently selected choice.

     Enter
	   Output the currently	selected choice	and exit.

     Alt-Enter
	   Output the current input query and exit.

     Left/Right	| Ctrl-B/Ctrl-F
	   Move	the cursor left	and right in the search	query input field.

     Ctrl-A
	   Move	the cursor to the beginning of the line	in the search query
	   input field.

     Ctrl-E
	   Move	the cursor to the end of the line in the search	query input
	   field.

     Backspace
	   Delete one character	to the left of the cursor in the search	query
	   input field.

     Delete | Ctrl-D
	   Delete the character	under the cursor in the	search query input
	   field.

     Ctrl-W
	   Delete to the beginning of the closest word to the left in the
	   search query	input field.

     Ctrl-U
	   Delete to the beginning of the line in the search query input
	   field.

     Ctrl-K
	   Delete to the end of	the line in the	search query input field.

     Printable characters
	   Added to the	search query and will refine the current search.

ENVIRONMENT
     The following environment variables will affect the execution of pick:

     IFS  Determines the separator used	between	choices	and descriptions.

EXAMPLES
     Select a file in the current directory to open using xdg-open(1):
	   $ find -type	f | pick | xargs xdg-open

     Select a man page to display with man(1):
	   $ apropos -l. | fltr	| pick -do | tac | xargs man

DIAGNOSTICS
     The pick utility exits 0 on success, and >0 if an error occurs.

HISTORY
     The first version of pick was released on August 18, 2014.	 Development
     was sponsored by thoughtbot: https://thoughtbot.com from the start	of the
     project until September 2016.

AUTHORS
     Calle Erlandsson <calle@calleerlandsson.com>
     Anton Lindqvist <anton.lindqvist@gmail.com>

FreeBSD	11.1			August 17, 2014			  FreeBSD 11.1

NAME | SYNOPSIS | DESCRIPTION | COMMANDS | ENVIRONMENT | EXAMPLES | DIAGNOSTICS | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pick&sektion=1&manpath=FreeBSD+11.1-RELEASE+and+Ports>

home | help