GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PICK (1)

NAME

pick - fuzzy select anything

CONTENTS

Synopsis
Description
Environment
Examples
Authors

SYNOPSIS

pick [-hv] [-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.
-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:
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.
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.
VIM If set, disables the use of the alternate screen terminal feature. This avoids issues with using the alternate screen when run using system in vim(1). To force the use of the alternate screen run pick with the -x option.

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


.An Calle Erlandsson Aq calle@thoughtbot.com
.An thoughtbot Aq hello@thoughtbot.com
Search for    or go to Top of page |  Section 1 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.