2013-10-23 23:25:19 -04:00
|
|
|
fzf - Fuzzy finder for your shell
|
|
|
|
=================================
|
2013-10-22 21:26:55 -04:00
|
|
|
|
|
|
|
fzf is a general-purpose fuzzy finder for your shell.
|
|
|
|
|
2013-10-29 09:14:11 -04:00
|
|
|
![](https://raw.github.com/junegunn/i/master/fzf.gif)
|
2013-10-28 02:50:46 -04:00
|
|
|
|
2013-10-23 23:25:19 -04:00
|
|
|
It was heavily inspired by [ctrlp.vim](https://github.com/kien/ctrlp.vim) and
|
|
|
|
the likes.
|
2013-10-22 21:26:55 -04:00
|
|
|
|
|
|
|
Requirements
|
|
|
|
------------
|
|
|
|
|
2013-12-25 11:15:46 -05:00
|
|
|
fzf requires Ruby (>= 1.8.5).
|
|
|
|
|
2013-10-22 21:26:55 -04:00
|
|
|
Installation
|
|
|
|
------------
|
|
|
|
|
2013-11-19 11:29:36 -05:00
|
|
|
Clone this repository and run
|
2013-10-22 21:26:55 -04:00
|
|
|
[install](https://github.com/junegunn/fzf/blob/master/install) script.
|
|
|
|
|
|
|
|
```sh
|
2013-11-19 11:29:36 -05:00
|
|
|
git clone https://github.com/junegunn/fzf.git ~/.fzf
|
|
|
|
~/.fzf/install
|
2013-10-22 21:26:55 -04:00
|
|
|
```
|
|
|
|
|
2014-04-25 06:16:33 -04:00
|
|
|
In case you don't have git installed:
|
|
|
|
|
|
|
|
```sh
|
|
|
|
mkdir -p ~/.fzf
|
2014-04-25 06:45:07 -04:00
|
|
|
curl -L https://github.com/junegunn/fzf/archive/master.tar.gz |
|
2014-04-25 06:16:33 -04:00
|
|
|
tar xz --strip-components 1 -C ~/.fzf
|
|
|
|
~/.fzf/install
|
|
|
|
```
|
|
|
|
|
2014-01-14 02:51:52 -05:00
|
|
|
The script will setup:
|
2013-11-19 11:29:36 -05:00
|
|
|
|
2014-01-14 02:51:52 -05:00
|
|
|
- `fzf` executable
|
2014-03-13 02:28:01 -04:00
|
|
|
- Key bindings (`CTRL-T`, `CTRL-R`, and `ALT-C`) for bash and zsh
|
2014-01-14 02:51:52 -05:00
|
|
|
- Fuzzy auto-completion for bash
|
2013-10-22 21:26:55 -04:00
|
|
|
|
2014-03-30 21:15:38 -04:00
|
|
|
If you don't use bash or zsh, you have to manually place fzf executable in a
|
2014-04-25 06:16:33 -04:00
|
|
|
directory included in `$PATH`. Key bindings and auto-completion will not be
|
|
|
|
available in that case.
|
2014-03-30 21:15:38 -04:00
|
|
|
|
2013-10-31 12:12:46 -04:00
|
|
|
### Install as Vim plugin
|
2013-10-22 21:26:55 -04:00
|
|
|
|
2014-03-03 21:25:50 -05:00
|
|
|
Once you have cloned the repository, add the following line to your .vimrc.
|
2013-10-22 21:26:55 -04:00
|
|
|
|
2014-03-03 21:25:50 -05:00
|
|
|
```vim
|
|
|
|
set rtp+=~/.fzf
|
|
|
|
```
|
2013-10-22 21:26:55 -04:00
|
|
|
|
2014-03-03 21:25:50 -05:00
|
|
|
Or you may use any Vim plugin manager, such as
|
|
|
|
[vim-plug](https://github.com/junegunn/vim-plug).
|
2013-10-22 21:26:55 -04:00
|
|
|
|
|
|
|
Usage
|
|
|
|
-----
|
|
|
|
|
2013-10-25 05:31:16 -04:00
|
|
|
```
|
|
|
|
usage: fzf [options]
|
|
|
|
|
2014-04-02 08:41:57 -04:00
|
|
|
Search
|
2014-01-21 22:03:17 -05:00
|
|
|
-x, --extended Extended-search mode
|
2014-03-04 07:29:45 -05:00
|
|
|
-e, --extended-exact Extended-search mode (exact match)
|
2014-04-02 08:41:57 -04:00
|
|
|
-i Case-insensitive match (default: smart-case match)
|
|
|
|
+i Case-sensitive match
|
2014-04-01 12:49:07 -04:00
|
|
|
-n, --nth=[-]N[,..] Comma-separated list of field indexes for limiting
|
|
|
|
search scope (positive or negative integers)
|
2014-03-29 04:05:35 -04:00
|
|
|
-d, --delimiter=STR Field delimiter regex for --nth (default: AWK-style)
|
2014-04-02 08:41:57 -04:00
|
|
|
|
|
|
|
Search result
|
2014-01-21 22:03:17 -05:00
|
|
|
-s, --sort=MAX Maximum number of matched items to sort (default: 1000)
|
|
|
|
+s, --no-sort Do not sort the result. Keep the sequence unchanged.
|
2014-04-02 08:41:57 -04:00
|
|
|
|
|
|
|
Interface
|
|
|
|
-m, --multi Enable multi-select with tab/shift-tab
|
|
|
|
--no-mouse Disable mouse
|
2014-01-21 22:03:17 -05:00
|
|
|
+c, --no-color Disable colors
|
2014-03-07 03:32:14 -05:00
|
|
|
+2, --no-256 Disable 256-color
|
2014-03-08 14:06:12 -05:00
|
|
|
--black Use black background
|
2014-04-02 08:41:57 -04:00
|
|
|
|
|
|
|
Scripting
|
|
|
|
-q, --query=STR Start the finder with the given query
|
2014-04-02 12:06:40 -04:00
|
|
|
-1, --select-1 Automatically select the only match
|
|
|
|
-0, --exit-0 Exit immediately when there's no match
|
2014-04-02 08:41:57 -04:00
|
|
|
-f, --filter=STR Filter mode. Do not start interactive finder.
|
2014-01-21 22:03:17 -05:00
|
|
|
|
|
|
|
Environment variables
|
|
|
|
FZF_DEFAULT_COMMAND Default command to use when input is tty
|
|
|
|
FZF_DEFAULT_OPTS Defaults options. (e.g. "-x -m --sort 10000")
|
2013-10-25 05:31:16 -04:00
|
|
|
```
|
|
|
|
|
2013-10-22 21:26:55 -04:00
|
|
|
fzf will launch curses-based finder, read the list from STDIN, and write the
|
|
|
|
selected item to STDOUT.
|
|
|
|
|
|
|
|
```sh
|
|
|
|
find * -type f | fzf > selected
|
|
|
|
```
|
|
|
|
|
|
|
|
Without STDIN pipe, fzf will use find command to fetch the list of
|
2013-11-01 23:56:43 -04:00
|
|
|
files excluding hidden ones. (You can override the default command with
|
|
|
|
`FZF_DEFAULT_COMMAND`)
|
2013-10-22 21:26:55 -04:00
|
|
|
|
|
|
|
```sh
|
2013-11-06 06:54:02 -05:00
|
|
|
vim $(fzf)
|
2013-10-22 21:26:55 -04:00
|
|
|
```
|
|
|
|
|
2013-10-25 05:31:16 -04:00
|
|
|
If you want to preserve the exact sequence of the input, provide `--no-sort` (or
|
|
|
|
`+s`) option.
|
2013-10-24 05:56:33 -04:00
|
|
|
|
|
|
|
```sh
|
2013-10-25 05:31:16 -04:00
|
|
|
history | fzf +s
|
2013-10-24 05:56:33 -04:00
|
|
|
```
|
|
|
|
|
2014-03-15 03:54:25 -04:00
|
|
|
### Keys
|
2013-10-22 21:26:55 -04:00
|
|
|
|
|
|
|
Use CTRL-J and CTRL-K (or CTRL-N and CTRL-P) to change the selection, press
|
2013-11-20 07:18:51 -05:00
|
|
|
enter key to select the item. CTRL-C, CTRL-G, or ESC will terminate the finder.
|
2013-10-22 21:26:55 -04:00
|
|
|
|
|
|
|
The following readline key bindings should also work as expected.
|
|
|
|
|
|
|
|
- CTRL-A / CTRL-E
|
|
|
|
- CTRL-B / CTRL-F
|
2014-03-15 03:54:25 -04:00
|
|
|
- CTRL-W / CTRL-U / CTRL-Y
|
2013-11-16 11:19:16 -05:00
|
|
|
- ALT-B / ALT-F
|
2013-10-22 21:26:55 -04:00
|
|
|
|
2013-11-09 13:56:18 -05:00
|
|
|
If you enable multi-select mode with `-m` option, you can select multiple items
|
2013-11-10 06:19:57 -05:00
|
|
|
with TAB or Shift-TAB key.
|
2013-11-09 13:56:18 -05:00
|
|
|
|
2014-03-07 03:30:44 -05:00
|
|
|
You can also use mouse. Double-click on an item to select it or shift-click (or
|
|
|
|
ctrl-click) to select multiple items. Use mouse wheel to move the cursor up and
|
|
|
|
down.
|
2014-03-06 06:52:38 -05:00
|
|
|
|
2013-11-15 12:21:39 -05:00
|
|
|
### Extended-search mode
|
2013-11-15 06:40:57 -05:00
|
|
|
|
2013-11-15 12:21:39 -05:00
|
|
|
With `-x` or `--extended` option, fzf will start in "extended-search mode".
|
2013-11-15 06:40:57 -05:00
|
|
|
|
2013-11-15 12:21:39 -05:00
|
|
|
In this mode, you can specify multiple patterns delimited by spaces,
|
|
|
|
such as: `^music .mp3$ sbtrkt !rmx`
|
2013-11-15 06:40:57 -05:00
|
|
|
|
2013-11-15 11:55:33 -05:00
|
|
|
| Token | Description | Match type |
|
|
|
|
| -------- | -------------------------------- | -------------------- |
|
|
|
|
| `^music` | Items that start with `music` | prefix-exact-match |
|
|
|
|
| `.mp3$` | Items that end with `.mp3` | suffix-exact-match |
|
|
|
|
| `sbtrkt` | Items that match `sbtrkt` | fuzzy-match |
|
|
|
|
| `!rmx` | Items that do not match `rmx` | inverse-fuzzy-match |
|
|
|
|
| `'wild` | Items that include `wild` | exact-match (quoted) |
|
|
|
|
| `!'fire` | Items that do not include `fire` | inverse-exact-match |
|
2013-11-15 06:40:57 -05:00
|
|
|
|
2014-03-04 07:29:45 -05:00
|
|
|
If you don't need fuzzy matching and do not wish to "quote" every word, start
|
|
|
|
fzf with `-e` or `--extended-exact` option.
|
|
|
|
|
2013-12-21 10:18:41 -05:00
|
|
|
Useful examples
|
|
|
|
---------------
|
2013-10-22 21:26:55 -04:00
|
|
|
|
|
|
|
```sh
|
2014-04-02 08:41:57 -04:00
|
|
|
# fe [FUZZY PATTERN] - Open the selected file with the default editor
|
|
|
|
# - Bypass fuzzy finder if there's only one match (--select-1)
|
|
|
|
# - Exit if there's no match (--exit-0)
|
|
|
|
fe() {
|
2014-03-14 04:46:55 -04:00
|
|
|
local file
|
2014-04-02 12:20:22 -04:00
|
|
|
file=$(fzf --query="$1" --select-1 --exit-0)
|
|
|
|
[ -n "$file" ] && ${EDITOR:-vim} "$file"
|
2013-10-24 11:40:04 -04:00
|
|
|
}
|
2013-10-22 21:26:55 -04:00
|
|
|
|
|
|
|
# fd - cd to selected directory
|
|
|
|
fd() {
|
2014-03-14 04:46:55 -04:00
|
|
|
local dir
|
2014-03-14 04:53:23 -04:00
|
|
|
dir=$(find ${1:-*} -path '*/\.*' -prune \
|
|
|
|
-o -type d -print 2> /dev/null | fzf +m) &&
|
|
|
|
cd "$dir"
|
2013-10-22 21:26:55 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
# fda - including hidden directories
|
|
|
|
fda() {
|
2014-03-14 04:46:55 -04:00
|
|
|
local dir
|
2014-03-14 04:53:23 -04:00
|
|
|
dir=$(find ${1:-.} -type d 2> /dev/null | fzf +m) && cd "$dir"
|
2013-10-22 21:26:55 -04:00
|
|
|
}
|
|
|
|
|
2013-10-24 05:56:33 -04:00
|
|
|
# fh - repeat history
|
|
|
|
fh() {
|
2014-04-03 21:21:35 -04:00
|
|
|
eval $(([ -n "$ZSH_NAME" ] && fc -l 1 || history) | fzf +s | sed 's/ *[0-9]* *//')
|
2013-10-24 05:56:33 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
# fkill - kill process
|
|
|
|
fkill() {
|
2013-11-09 14:00:27 -05:00
|
|
|
ps -ef | sed 1d | fzf -m | awk '{print $2}' | xargs kill -${1:-9}
|
2013-10-24 05:56:33 -04:00
|
|
|
}
|
2014-03-14 04:46:55 -04:00
|
|
|
|
|
|
|
# fbr - checkout git branch
|
|
|
|
fbr() {
|
|
|
|
local branches branch
|
|
|
|
branches=$(git branch) &&
|
|
|
|
branch=$(echo "$branches" | fzf +s +m) &&
|
|
|
|
git checkout $(echo "$branch" | sed "s/.* //")
|
|
|
|
}
|
|
|
|
|
2014-03-19 19:07:47 -04:00
|
|
|
# fco - checkout git commit
|
2014-03-14 04:46:55 -04:00
|
|
|
fco() {
|
|
|
|
local commits commit
|
2014-03-19 21:38:53 -04:00
|
|
|
commits=$(git log --pretty=oneline --abbrev-commit --reverse) &&
|
2014-03-14 04:46:55 -04:00
|
|
|
commit=$(echo "$commits" | fzf +s +m -e) &&
|
|
|
|
git checkout $(echo "$commit" | sed "s/ .*//")
|
|
|
|
}
|
2014-03-19 12:57:57 -04:00
|
|
|
|
2014-03-29 04:05:35 -04:00
|
|
|
# ftags - search ctags
|
|
|
|
ftags() {
|
|
|
|
local line
|
|
|
|
[ -e tags ] &&
|
2014-04-01 12:49:07 -04:00
|
|
|
line=$(
|
|
|
|
awk 'BEGIN { FS="\t" } !/^!/ {print toupper($4)"\t"$1"\t"$2"\t"$3}' tags |
|
|
|
|
cut -c1-80 | fzf --nth=1,2
|
|
|
|
) && $EDITOR $(cut -f3 <<< "$line") -c "set nocst" \
|
|
|
|
-c "silent tag $(cut -f2 <<< "$line")"
|
2014-03-29 04:05:35 -04:00
|
|
|
}
|
2013-11-26 11:00:23 -05:00
|
|
|
```
|
2013-10-24 05:56:33 -04:00
|
|
|
|
2013-12-21 10:22:23 -05:00
|
|
|
Key bindings for command line
|
|
|
|
-----------------------------
|
2013-12-21 10:18:41 -05:00
|
|
|
|
2014-01-14 02:51:52 -05:00
|
|
|
The install script will setup the following key bindings.
|
2013-12-21 10:18:41 -05:00
|
|
|
|
2014-03-13 01:29:27 -04:00
|
|
|
### bash/zsh
|
2013-12-21 10:18:41 -05:00
|
|
|
|
|
|
|
- `CTRL-T` - Paste the selected file path(s) into the command line
|
|
|
|
- `CTRL-R` - Paste the selected command from history into the command line
|
|
|
|
- `ALT-C` - cd into the selected directory
|
2013-11-08 11:16:39 -05:00
|
|
|
|
2014-03-27 12:39:20 -04:00
|
|
|
If you're on a tmux session, `CTRL-T` will launch fzf in a new split-window. You
|
|
|
|
may disable this tmux integration by setting `FZF_TMUX` to 0, or change the
|
2014-03-28 04:15:32 -04:00
|
|
|
height of the window with `FZF_TMUX_HEIGHT` (e.g. `20`, `50%`).
|
2014-03-27 12:39:20 -04:00
|
|
|
|
2014-03-13 01:29:27 -04:00
|
|
|
The source code can be found in `~/.fzf.bash` and in `~/.fzf.zsh`.
|
2013-11-08 11:16:39 -05:00
|
|
|
|
2013-12-14 08:29:57 -05:00
|
|
|
Auto-completion
|
|
|
|
---------------
|
2013-11-19 11:29:36 -05:00
|
|
|
|
|
|
|
Disclaimer: *Auto-completion feature is currently experimental, it can change
|
|
|
|
over time*
|
|
|
|
|
|
|
|
### bash
|
|
|
|
|
2013-11-29 04:08:22 -05:00
|
|
|
#### Files and directories
|
|
|
|
|
2013-11-29 03:49:48 -05:00
|
|
|
Fuzzy completion for files and directories can be triggered if the word before
|
|
|
|
the cursor ends with the trigger sequence which is by default `**`.
|
2013-11-23 06:09:56 -05:00
|
|
|
|
|
|
|
- `COMMAND [DIRECTORY/][FUZZY_PATTERN]**<TAB>`
|
2013-11-19 11:29:36 -05:00
|
|
|
|
|
|
|
```sh
|
2013-11-19 11:42:57 -05:00
|
|
|
# Files under current directory
|
|
|
|
# - You can select multiple items with TAB key
|
2013-11-19 11:29:36 -05:00
|
|
|
vim **<TAB>
|
2013-11-19 11:42:57 -05:00
|
|
|
|
|
|
|
# Files under parent directory
|
2013-11-23 06:09:56 -05:00
|
|
|
vim ../**<TAB>
|
|
|
|
|
|
|
|
# Files under parent directory that match `fzf`
|
|
|
|
vim ../fzf**<TAB>
|
2013-11-19 11:42:57 -05:00
|
|
|
|
|
|
|
# Files under your home directory
|
2013-11-19 11:29:36 -05:00
|
|
|
vim ~/**<TAB>
|
|
|
|
|
2013-11-19 11:42:57 -05:00
|
|
|
|
|
|
|
# Directories under current directory (single-selection)
|
2013-11-19 11:29:36 -05:00
|
|
|
cd **<TAB>
|
2013-11-19 11:42:57 -05:00
|
|
|
|
2013-11-23 06:09:56 -05:00
|
|
|
# Directories under ~/github that match `fzf`
|
|
|
|
cd ~/github/fzf**<TAB>
|
2013-11-19 11:29:36 -05:00
|
|
|
```
|
|
|
|
|
2013-11-29 04:08:22 -05:00
|
|
|
#### Process IDs
|
|
|
|
|
|
|
|
Fuzzy completion for PIDs is provided for kill command. In this case
|
2013-11-29 03:49:48 -05:00
|
|
|
there is no trigger sequence, just press tab key after kill command.
|
|
|
|
|
|
|
|
```sh
|
|
|
|
# Can select multiple processes with <TAB> or <Shift-TAB> keys
|
|
|
|
kill -9 <TAB>
|
|
|
|
```
|
|
|
|
|
2013-11-29 04:08:22 -05:00
|
|
|
#### Host names
|
|
|
|
|
2013-11-29 04:09:51 -05:00
|
|
|
For ssh and telnet commands, fuzzy completion for host names is provided. The
|
2013-12-23 09:16:07 -05:00
|
|
|
names are extracted from /etc/hosts and ~/.ssh/config.
|
2013-11-29 04:08:22 -05:00
|
|
|
|
|
|
|
```sh
|
2013-12-23 09:16:07 -05:00
|
|
|
ssh **<TAB>
|
|
|
|
telnet **<TAB>
|
2013-11-29 04:08:22 -05:00
|
|
|
```
|
|
|
|
|
2013-11-19 11:42:57 -05:00
|
|
|
#### Settings
|
2013-11-19 11:29:36 -05:00
|
|
|
|
|
|
|
```sh
|
2013-11-19 11:42:57 -05:00
|
|
|
# Use ~~ as the trigger sequence instead of the default **
|
2013-11-19 11:29:36 -05:00
|
|
|
export FZF_COMPLETION_TRIGGER='~~'
|
2013-11-19 11:42:57 -05:00
|
|
|
|
|
|
|
# Options to fzf command
|
|
|
|
export FZF_COMPLETION_OPTS='+c -x'
|
2013-11-19 11:29:36 -05:00
|
|
|
```
|
|
|
|
|
|
|
|
### zsh
|
|
|
|
|
2013-11-19 11:42:57 -05:00
|
|
|
TODO :smiley:
|
|
|
|
|
|
|
|
(Pull requests are appreciated.)
|
2013-11-19 11:29:36 -05:00
|
|
|
|
2014-01-07 03:07:02 -05:00
|
|
|
Usage as Vim plugin
|
|
|
|
-------------------
|
|
|
|
|
2014-03-27 11:58:07 -04:00
|
|
|
(fzf is a command-line utility, naturally it is only accessible in terminal Vim)
|
2014-03-25 06:55:52 -04:00
|
|
|
|
2014-03-27 11:58:07 -04:00
|
|
|
### `:FZF[!]`
|
|
|
|
|
|
|
|
If you have set up fzf for Vim, `:FZF` command will be added.
|
2014-01-07 03:07:02 -05:00
|
|
|
|
|
|
|
```vim
|
|
|
|
" Look for files under current directory
|
|
|
|
:FZF
|
|
|
|
|
|
|
|
" Look for files under your home directory
|
|
|
|
:FZF ~
|
|
|
|
|
|
|
|
" With options
|
|
|
|
:FZF --no-sort -m /tmp
|
|
|
|
```
|
|
|
|
|
2014-03-27 11:58:07 -04:00
|
|
|
Note that the environment variables `FZF_DEFAULT_COMMAND` and `FZF_DEFAULT_OPTS`
|
2014-03-25 06:55:52 -04:00
|
|
|
also apply here.
|
|
|
|
|
2014-03-27 12:39:20 -04:00
|
|
|
If you're on a tmux session, `:FZF` will launch fzf in a new split-window whose
|
2014-03-28 04:15:32 -04:00
|
|
|
height can be adjusted with `g:fzf_tmux_height` (default: '40%'). However, the
|
|
|
|
bang version (`:FZF!`) will always start in fullscreen.
|
2014-03-27 11:58:07 -04:00
|
|
|
|
2014-03-25 06:55:52 -04:00
|
|
|
### `fzf#run([options])`
|
|
|
|
|
|
|
|
For more advanced uses, you can call `fzf#run()` function which returns the list
|
|
|
|
of the selected items.
|
|
|
|
|
|
|
|
`fzf#run()` may take an options-dictionary:
|
|
|
|
|
2014-04-12 06:53:33 -04:00
|
|
|
| Option name | Type | Description |
|
|
|
|
| ------------- | ------------- | ------------------------------------------------------------------ |
|
|
|
|
| `source` | string | External command to generate input to fzf (e.g. `find .`) |
|
|
|
|
| `source` | list | Vim list as input to fzf |
|
|
|
|
| `sink` | string | Vim command to handle the selected item (e.g. `e`, `tabe`) |
|
|
|
|
| `sink` | funcref | Reference to function to process each selected item |
|
|
|
|
| `options` | string | Options to fzf |
|
|
|
|
| `dir` | string | Working directory |
|
|
|
|
| `tmux_width` | number/string | Use tmux vertical split with the given height (e.g. `20`, `50%`) |
|
|
|
|
| `tmux_height` | number/string | Use tmux horizontal split with the given height (e.g. `20`, `50%`) |
|
2014-03-25 06:55:52 -04:00
|
|
|
|
|
|
|
#### Examples
|
|
|
|
|
|
|
|
If `sink` option is not given, `fzf#run` will simply return the list.
|
2014-01-07 03:07:02 -05:00
|
|
|
|
|
|
|
```vim
|
2014-03-25 06:55:52 -04:00
|
|
|
let items = fzf#run({ 'options': '-m +c', 'dir': '~', 'source': 'ls' })
|
2014-01-07 03:07:02 -05:00
|
|
|
```
|
|
|
|
|
2014-03-25 06:55:52 -04:00
|
|
|
But if `sink` is given as a string, the command will be executed for each
|
|
|
|
selected item.
|
2014-01-07 03:07:02 -05:00
|
|
|
|
|
|
|
```vim
|
2014-03-25 06:55:52 -04:00
|
|
|
" Each selected item will be opened in a new tab
|
|
|
|
let items = fzf#run({ 'sink': 'tabe', 'options': '-m +c', 'dir': '~', 'source': 'ls' })
|
2014-01-07 03:07:02 -05:00
|
|
|
```
|
|
|
|
|
2014-03-25 06:55:52 -04:00
|
|
|
We can also use a Vim list as the source as follows:
|
2014-01-07 03:07:02 -05:00
|
|
|
|
|
|
|
```vim
|
2014-03-25 06:55:52 -04:00
|
|
|
" Choose a color scheme with fzf
|
2014-03-27 11:58:07 -04:00
|
|
|
nnoremap <silent> <Leader>C :call fzf#run({
|
2014-03-25 06:55:52 -04:00
|
|
|
\ 'source':
|
|
|
|
\ map(split(globpath(&rtp, "colors/*.vim"), "\n"),
|
|
|
|
\ "substitute(fnamemodify(v:val, ':t'), '\\..\\{-}$', '', '')"),
|
2014-04-12 06:53:33 -04:00
|
|
|
\ 'sink': 'colo',
|
|
|
|
\ 'options': '+m',
|
|
|
|
\ 'tmux_width': 20
|
2014-03-27 11:58:07 -04:00
|
|
|
\ })<CR>
|
2014-01-07 03:07:02 -05:00
|
|
|
```
|
|
|
|
|
2014-03-25 06:55:52 -04:00
|
|
|
`sink` option can be a function reference. The following example creates a
|
|
|
|
handy mapping that selects an open buffer.
|
|
|
|
|
|
|
|
```vim
|
|
|
|
" List of buffers
|
|
|
|
function! g:buflist()
|
|
|
|
redir => ls
|
|
|
|
silent ls
|
|
|
|
redir END
|
|
|
|
return split(ls, '\n')
|
|
|
|
endfunction
|
|
|
|
|
|
|
|
function! g:bufopen(e)
|
|
|
|
execute 'buffer '. matchstr(a:e, '^[ 0-9]*')
|
|
|
|
endfunction
|
|
|
|
|
2014-03-27 11:58:07 -04:00
|
|
|
nnoremap <silent> <Leader><Enter> :call fzf#run({
|
2014-04-12 07:02:04 -04:00
|
|
|
\ 'source': reverse(g:buflist()),
|
|
|
|
\ 'sink': function('g:bufopen'),
|
|
|
|
\ 'options': '+m',
|
|
|
|
\ 'tmux_height': '40%'
|
2014-03-25 06:55:52 -04:00
|
|
|
\ })<CR>
|
|
|
|
```
|
2014-01-07 03:07:02 -05:00
|
|
|
|
2014-04-25 06:16:33 -04:00
|
|
|
### Articles
|
|
|
|
|
|
|
|
- [fzf+vim+tmux](http://junegunn.kr/2014/04/fzf+vim+tmux)
|
|
|
|
|
2013-11-10 05:51:32 -05:00
|
|
|
Tips
|
|
|
|
----
|
|
|
|
|
2014-03-08 20:43:59 -05:00
|
|
|
### Rendering issues
|
|
|
|
|
|
|
|
If you have any rendering issues, check the followings:
|
|
|
|
|
|
|
|
1. Make sure `$TERM` is correctly set. fzf will use 256-color only if it
|
|
|
|
contains `256` (e.g. `xterm-256color`)
|
2014-03-08 21:52:35 -05:00
|
|
|
2. If you're on screen or tmux, `$TERM` should be either `screen` or
|
2014-03-08 20:43:59 -05:00
|
|
|
`screen-256color`
|
|
|
|
3. Some terminal emulators (e.g. mintty) have problem displaying default
|
|
|
|
background color and make some text unable to read. In that case, try `--black`
|
|
|
|
option. And if it solves your problem, I recommend including it in
|
|
|
|
`FZF_DEFAULT_OPTS` for further convenience.
|
|
|
|
4. If you still have problem, try `--no-256` option or even `--no-color`.
|
|
|
|
5. Ruby 1.9 or above is required for correctly displaying unicode characters.
|
2013-11-10 05:51:32 -05:00
|
|
|
|
2013-12-21 10:22:23 -05:00
|
|
|
### Ranking algorithm
|
|
|
|
|
|
|
|
fzf sorts the result first by the length of the matched substring, then by the
|
|
|
|
length of the whole string. However it only does so when the number of matches
|
|
|
|
is less than the limit which is by default 1000, in order to avoid the cost of
|
|
|
|
sorting a large list and limit the response time of the query.
|
|
|
|
|
|
|
|
This limit can be adjusted with `-s` option, or with the environment variable
|
2014-01-21 22:03:17 -05:00
|
|
|
`FZF_DEFAULT_OPTS`.
|
2013-12-21 10:22:23 -05:00
|
|
|
|
|
|
|
```sh
|
2014-01-21 22:03:17 -05:00
|
|
|
export FZF_DEFAULT_OPTS="--sort 20000"
|
2013-12-21 10:22:23 -05:00
|
|
|
```
|
|
|
|
|
2014-04-06 02:25:58 -04:00
|
|
|
### Respecting `.gitignore`, `.hgignore`, and `svn:ignore`
|
|
|
|
|
|
|
|
[ag](https://github.com/ggreer/the_silver_searcher) or
|
|
|
|
[pt](https://github.com/monochromegane/the_platinum_searcher) will do the
|
|
|
|
filtering:
|
|
|
|
|
|
|
|
```sh
|
|
|
|
# Feed the output of ag into fzf
|
|
|
|
ag -l -g "" | fzf
|
|
|
|
|
|
|
|
# Setting ag as the default source for fzf
|
|
|
|
export FZF_DEFAULT_COMMAND='ag -l -g ""'
|
|
|
|
|
|
|
|
# Now fzf (w/o pipe) will use ag instead of find
|
|
|
|
fzf
|
|
|
|
```
|
|
|
|
|
|
|
|
### Windows
|
|
|
|
|
|
|
|
fzf works on [Cygwin](http://www.cygwin.com/) and
|
|
|
|
[MSYS2](http://sourceforge.net/projects/msys2/). You may need to use `--black`
|
2014-04-12 06:52:25 -04:00
|
|
|
option on MSYS2 to avoid rendering issues.
|
2014-04-06 02:25:58 -04:00
|
|
|
|
|
|
|
|
2013-10-22 21:26:55 -04:00
|
|
|
License
|
|
|
|
-------
|
|
|
|
|
|
|
|
MIT
|
|
|
|
|
|
|
|
Author
|
|
|
|
------
|
|
|
|
|
|
|
|
Junegunn Choi
|
|
|
|
|