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

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
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
     pick allows users to select from a	set of choices using an	ncurses(3X)
     interface with fuzzy search functionality.

     pick accepts a list of choices as input and produces the selected choice
     as	output.

     pick supports these options and arguments:

     -h	       output a	help message and exit.

     -v	       output the version and exit.

     -S	       disable sorting.

	       Only filter the choices instead of additionally sorting by
	       score.

     -q	QUERY  supply an initial search	query.

     -d	       read and	display	descriptions.

	       When the	-d option is supplied, 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.

     -o	       output description of selected on exit.

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

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

     The pick ncurses(3X) interface is operated	with the following keys:

     Ctrl-C	Exit with a status of 130 without outputting the selected
		choice.

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

     Enter	Output the currently selected choice and exit.

     Alt-Enter	Output the current input query and exit.

     Printable characters
		Printable characters are added to the search query input field
		and will refine	the current search query.

     Left/Right	or 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 or 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.

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

     IFS  Determines the separator used	between	choices	and descriptions.

EXAMPLES
     pick can be used to select	anything and is	very effective when combined
     with utilities like xargs(1).

     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

AUTHORS
     Calle Erlandsson <calle@thoughtbot.com>
     thoughtbot	<hello@thoughtbot.com>

FreeBSD	11.0			August 17, 2014			  FreeBSD 11.0

NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT | EXAMPLES | 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.0-RELEASE+and+Ports>

home | help