NAME

gpicker - fast (file)name chooser

SYNOPSIS

gpicker [options] directory-path

DESCRIPTION

This manual page documents briefly the gpicker program.

gpicker is a gtk+ program that allows you to quickly and conveniently pick file in a (possibly very large) project. You type significant letters of file name (typically from the start of words) and gpicker provides you with a list of files you most likely mean to pick. The program filters and orders project's list of files in real-time as you type. It prints selected item (or items in multi-select mode) on standard output.

You can use also gpicker to filter & sort arbitrary list of names by piping that list of names to it's stdin and passing '-' instead of path.

gpicker has a concept of project type which allows it to skip files that are ignored by project's version control system. Default project type invokes find to gather list of files. You can change find command line via GPICKER_FIND environment variable.

gpicker is typically used from programmer's editors or IDEs. VIM and Emacs integration is included in gpicker package. See gpicker.el and gpicker.vim correspondingly. There's also NetBeans plugin at http://github.com/avsej/gpicker-netbeans and gedit plugin at http://github.com/yltsrc/gedit-gpicker

gpicker can be used from other programs as well. http://github.com/alk/supermegadoc uses gpicker to pick names from documentation system index.

OPTIONS

This program follows the usual GNU command line syntax. A summary of options is included below.

-h, --help

Show help options and quit

--version

show version

-t, --project-type

respect ignored files for given kind of VCS (default, git, bzr, hg, guess, script). mlocate project type is used for loading file list from mlocate database.

Type script will use .gpicker-script script located in project dir to read all relevant filenames. Script must separate entries with zero character. It will be run with project directory as current directory and should normally output relative path. Not however that gpicker doesn't care if items output from script are files and do exist.

Type guess will try to guess project type based on presence of directories and files (such as .gpicker-script or .git ).

--disable-bzr

disable autodetection of Bazaar project type

--disable-hg

disable autodetection of Mercurial project type

-n, --name-separator

Set separator of filenames from stdin (\0 is default). Interprets \0 as zero byte, \n as new line, \r as carriage return, \t as tab character.

-d, --dir-separator

Sets separator of directory names from stdin (/ is default). Interprets \0 as zero byte, \n as new line, \r as carriage return, \t as tab character.

--eat-prefix

eat this prefix from names (./ is default)

-m, --multiselect

enable multiselect

-l, --left-align

left align gpicker entries (default is right-align)

-p, --print-pattern

print pattern if nothing matched

-S, --dont-sort

dont sort result list

-i, --init-filter

initial filter value

--load-stdin-too

read additional filenames from stdin

-I, --output-index

print selection index instead of value (implies -S)

--display=DISPLAY

X display to use

LICENSE

The gpicker is distributed under the GPLv3 license. See COPYING file that comes with it. On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-3.

AUTHOR