:cherry_blossom: A command-line fuzzy finder

Related tags

vim go bash zsh tmux cli fish unix neovim fzf
Overview

fzf - a command-line fuzzy finder github-actions

fzf is a general-purpose command-line fuzzy finder.

It's an interactive Unix filter for command-line that can be used with any list; files, command history, processes, hostnames, bookmarks, git commits, etc.

Pros

  • Portable, no dependencies
  • Blazingly fast
  • The most comprehensive feature set
  • Flexible layout
  • Batteries included
    • Vim/Neovim plugin, key bindings, and fuzzy auto-completion

Table of Contents

Installation

fzf project consists of the following components:

  • fzf executable
  • fzf-tmux script for launching fzf in a tmux pane
  • Shell extensions
    • Key bindings (CTRL-T, CTRL-R, and ALT-C) (bash, zsh, fish)
    • Fuzzy auto-completion (bash, zsh)
  • Vim/Neovim plugin

You can download fzf executable alone if you don't need the extra stuff.

Using Homebrew

You can use Homebrew (on macOS or Linux) to install fzf.

brew install fzf

# To install useful key bindings and fuzzy completion:
$(brew --prefix)/opt/fzf/install

fzf is also available via MacPorts: sudo port install fzf

Using git

Alternatively, you can "git clone" this repository to any directory and run install script.

git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
~/.fzf/install

Using Linux package managers

Package Manager Linux Distribution Command
APK Alpine Linux sudo apk add fzf
APT Debian 9+/Ubuntu 19.10+ sudo apt-get install fzf
Conda conda install -c conda-forge fzf
DNF Fedora sudo dnf install fzf
Nix NixOS, etc. nix-env -iA nixpkgs.fzf
Pacman Arch Linux sudo pacman -S fzf
pkg FreeBSD pkg install fzf
pkg_add OpenBSD pkg_add fzf
XBPS Void Linux sudo xbps-install -S fzf
Zypper openSUSE sudo zypper install fzf

⚠️ Key bindings (CTRL-T / CTRL-R / ALT-C) and fuzzy auto-completion may not be enabled by default.

Refer to the package documentation for more information. (e.g. apt-cache show fzf)

Windows

Pre-built binaries for Windows can be downloaded here. fzf is also available via Chocolatey and Scoop:

Package manager Command
Chocolatey choco install fzf
Scoop scoop install fzf

Known issues and limitations on Windows can be found on the wiki page.

As Vim plugin

If you use vim-plug, add this line to your Vim configuration file:

Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }

fzf#install() makes sure that you have the latest binary, but it's optional, so you can omit it if you use a plugin manager that doesn't support hooks.

For more installation options, see README-VIM.md.

Upgrading fzf

fzf is being actively developed, and you might want to upgrade it once in a while. Please follow the instruction below depending on the installation method used.

  • git: cd ~/.fzf && git pull && ./install
  • brew: brew update; brew upgrade fzf
  • macports: sudo port upgrade fzf
  • chocolatey: choco upgrade fzf
  • vim-plug: :PlugUpdate fzf

Building fzf

See BUILD.md.

Usage

fzf will launch interactive finder, read the list from STDIN, and write the selected item to STDOUT.

find * -type f | fzf > selected

Without STDIN pipe, fzf will use find command to fetch the list of files excluding hidden ones. (You can override the default command with FZF_DEFAULT_COMMAND)

vim $(fzf)

Using the finder

  • CTRL-J / CTRL-K (or CTRL-N / CTRL-P) to move cursor up and down
  • Enter key to select the item, CTRL-C / CTRL-G / ESC to exit
  • On multi-select mode (-m), TAB and Shift-TAB to mark multiple items
  • Emacs style key bindings
  • Mouse: scroll, click, double-click; shift-click and shift-scroll on multi-select mode

Layout

fzf by default starts in fullscreen mode, but you can make it start below the cursor with --height option.

vim $(fzf --height 40%)

Also, check out --reverse and --layout options if you prefer "top-down" layout instead of the default "bottom-up" layout.

vim $(fzf --height 40% --reverse)

You can add these options to $FZF_DEFAULT_OPTS so that they're applied by default. For example,

export FZF_DEFAULT_OPTS='--height 40% --layout=reverse --border'

Search syntax

Unless otherwise specified, fzf starts in "extended-search mode" where you can type in multiple search terms delimited by spaces. e.g. ^music .mp3$ sbtrkt !fire

Token Match type Description
sbtrkt fuzzy-match Items that match sbtrkt
'wild exact-match (quoted) Items that include wild
^music prefix-exact-match Items that start with music
.mp3$ suffix-exact-match Items that end with .mp3
!fire inverse-exact-match Items that do not include fire
!^music inverse-prefix-exact-match Items that do not start with music
!.mp3$ inverse-suffix-exact-match Items that do not end with .mp3

If you don't prefer fuzzy matching and do not wish to "quote" every word, start fzf with -e or --exact option. Note that when --exact is set, '-prefix "unquotes" the term.

A single bar character term acts as an OR operator. For example, the following query matches entries that start with core and end with either go, rb, or py.

^core go$ | rb$ | py$

Environment variables

  • FZF_DEFAULT_COMMAND
    • Default command to use when input is tty
    • e.g. export FZF_DEFAULT_COMMAND='fd --type f'
    • ⚠️ This variable is not used by shell extensions due to the slight difference in requirements.

      (e.g. CTRL-T runs $FZF_CTRL_T_COMMAND instead, vim **<tab> runs _fzf_compgen_path(), and cd **<tab> runs _fzf_compgen_dir())

      The available options are described later in this document.

  • FZF_DEFAULT_OPTS
    • Default options
    • e.g. export FZF_DEFAULT_OPTS="--layout=reverse --inline-info"

Options

See the man page (man fzf) for the full list of options.

Demo

If you learn by watching videos, check out this screencast by @samoshkin to explore fzf features.

Examples

fzf-tmux script

fzf-tmux is a bash script that opens fzf in a tmux pane.

# usage: fzf-tmux [LAYOUT OPTIONS] [--] [FZF OPTIONS]

# See available options
fzf-tmux --help

# select git branches in horizontal split below (15 lines)
git branch | fzf-tmux -d 15

# select multiple words in vertical split on the left (20% of screen width)
cat /usr/share/dict/words | fzf-tmux -l 20% --multi --reverse

It will still work even when you're not on tmux, silently ignoring -[pudlr] options, so you can invariably use fzf-tmux in your scripts.

Alternatively, you can use --height HEIGHT[%] option not to start fzf in fullscreen mode.

fzf --height 40%

Key bindings for command-line

The install script will setup the following key bindings for bash, zsh, and fish.

  • CTRL-T - Paste the selected files and directories onto the command-line
    • Set FZF_CTRL_T_COMMAND to override the default command
    • Set FZF_CTRL_T_OPTS to pass additional options
  • CTRL-R - Paste the selected command from history onto the command-line
    • If you want to see the commands in chronological order, press CTRL-R again which toggles sorting by relevance
    • Set FZF_CTRL_R_OPTS to pass additional options
  • ALT-C - cd into the selected directory
    • Set FZF_ALT_C_COMMAND to override the default command
    • Set FZF_ALT_C_OPTS to pass additional options

If you're on a tmux session, you can start fzf in a tmux split-pane or in a tmux popup window by setting FZF_TMUX_OPTS (e.g. -d 40%). See fzf-tmux --help for available options.

More tips can be found on the wiki page.

Fuzzy completion for bash and zsh

Files and directories

Fuzzy completion for files and directories can be triggered if the word before the cursor ends with the trigger sequence, which is by default **.

  • COMMAND [DIRECTORY/][FUZZY_PATTERN]**<TAB>
# Files under the current directory
# - You can select multiple items with TAB key
vim **<TAB>

# Files under parent directory
vim ../**<TAB>

# Files under parent directory that match `fzf`
vim ../fzf**<TAB>

# Files under your home directory
vim ~/**<TAB>


# Directories under current directory (single-selection)
cd **<TAB>

# Directories under ~/github that match `fzf`
cd ~/github/fzf**<TAB>

Process IDs

Fuzzy completion for PIDs is provided for kill command. In this case, there is no trigger sequence; just press the tab key after the kill command.

# Can select multiple processes with <TAB> or <Shift-TAB> keys
kill -9 <TAB>

Host names

For ssh and telnet commands, fuzzy completion for hostnames is provided. The names are extracted from /etc/hosts and ~/.ssh/config.

ssh **<TAB>
telnet **<TAB>

Environment variables / Aliases

unset **<TAB>
export **<TAB>
unalias **<TAB>

Settings

# Use ~~ as the trigger sequence instead of the default **
export FZF_COMPLETION_TRIGGER='~~'

# Options to fzf command
export FZF_COMPLETION_OPTS='--border --info=inline'

# Use fd (https://github.com/sharkdp/fd) instead of the default find
# command for listing path candidates.
# - The first argument to the function ($1) is the base path to start traversal
# - See the source code (completion.{bash,zsh}) for the details.
_fzf_compgen_path() {
  fd --hidden --follow --exclude ".git" . "$1"
}

# Use fd to generate the list for directory completion
_fzf_compgen_dir() {
  fd --type d --hidden --follow --exclude ".git" . "$1"
}

# (EXPERIMENTAL) Advanced customization of fzf options via _fzf_comprun function
# - The first argument to the function is the name of the command.
# - You should make sure to pass the rest of the arguments to fzf.
_fzf_comprun() {
  local command=$1
  shift

  case "$command" in
    cd)           fzf "[email protected]" --preview 'tree -C {} | head -200' ;;
    export|unset) fzf "[email protected]" --preview "eval 'echo \$'{}" ;;
    ssh)          fzf "[email protected]" --preview 'dig {}' ;;
    *)            fzf "[email protected]" ;;
  esac
}

Supported commands

On bash, fuzzy completion is enabled only for a predefined set of commands (complete | grep _fzf to see the list). But you can enable it for other commands as well by using _fzf_setup_completion helper function.

# usage: _fzf_setup_completion path|dir|var|alias|host COMMANDS...
_fzf_setup_completion path ag git kubectl
_fzf_setup_completion dir tree

Custom fuzzy completion

(Custom completion API is experimental and subject to change)

For a command named "COMMAND", define _fzf_complete_COMMAND function using _fzf_complete helper.

# Custom fuzzy completion for "doge" command
#   e.g. doge **<TAB>
_fzf_complete_doge() {
  _fzf_complete --multi --reverse --prompt="doge> " -- "[email protected]" < <(
    echo very
    echo wow
    echo such
    echo doge
  )
}
  • The arguments before -- are the options to fzf.
  • After --, simply pass the original completion arguments unchanged ("[email protected]").
  • Then, write a set of commands that generates the completion candidates and feed its output to the function using process substitution (< <(...)).

zsh will automatically pick up the function using the naming convention but in bash you have to manually associate the function with the command using the complete command.

[ -n "$BASH" ] && complete -F _fzf_complete_doge -o default -o bashdefault doge

If you need to post-process the output from fzf, define _fzf_complete_COMMAND_post as follows.

_fzf_complete_foo() {
  _fzf_complete --multi --reverse --header-lines=3 -- "[email protected]" < <(
    ls -al
  )
}

_fzf_complete_foo_post() {
  awk '{print $NF}'
}

[ -n "$BASH" ] && complete -F _fzf_complete_foo -o default -o bashdefault foo

Vim plugin

See README-VIM.md.

Advanced topics

Performance

fzf is fast and is getting even faster. Performance should not be a problem in most use cases. However, you might want to be aware of the options that affect performance.

  • --ansi tells fzf to extract and parse ANSI color codes in the input, and it makes the initial scanning slower. So it's not recommended that you add it to your $FZF_DEFAULT_OPTS.
  • --nth makes fzf slower because it has to tokenize each line.
  • --with-nth makes fzf slower as fzf has to tokenize and reassemble each line.
  • If you absolutely need better performance, you can consider using --algo=v1 (the default being v2) to make fzf use a faster greedy algorithm. However, this algorithm is not guaranteed to find the optimal ordering of the matches and is not recommended.

Executing external programs

You can set up key bindings for starting external processes without leaving fzf (execute, execute-silent).

# Press F1 to open the file with less without leaving fzf
# Press CTRL-Y to copy the line to clipboard and aborts fzf (requires pbcopy)
fzf --bind 'f1:execute(less -f {}),ctrl-y:execute-silent(echo {} | pbcopy)+abort'

See KEY BINDINGS section of the man page for details.

Reloading the candidate list

By binding reload action to a key or an event, you can make fzf dynamically reload the candidate list. See https://github.com/junegunn/fzf/issues/1750 for more details.

1. Update the list of processes by pressing CTRL-R

FZF_DEFAULT_COMMAND='ps -ef' \
  fzf --bind 'ctrl-r:reload($FZF_DEFAULT_COMMAND)' \
      --header 'Press CTRL-R to reload' --header-lines=1 \
      --height=50% --layout=reverse

2. Switch between sources by pressing CTRL-D or CTRL-F

FZF_DEFAULT_COMMAND='find . -type f' \
  fzf --bind 'ctrl-d:reload(find . -type d),ctrl-f:reload($FZF_DEFAULT_COMMAND)' \
      --height=50% --layout=reverse

3. Interactive ripgrep integration

The following example uses fzf as the selector interface for ripgrep. We bound reload action to change event, so every time you type on fzf, the ripgrep process will restart with the updated query string denoted by the placeholder expression {q}. Also, note that we used --disabled option so that fzf doesn't perform any secondary filtering.

INITIAL_QUERY=""
RG_PREFIX="rg --column --line-number --no-heading --color=always --smart-case "
FZF_DEFAULT_COMMAND="$RG_PREFIX '$INITIAL_QUERY'" \
  fzf --bind "change:reload:$RG_PREFIX {q} || true" \
      --ansi --disabled --query "$INITIAL_QUERY" \
      --height=50% --layout=reverse

If ripgrep doesn't find any matches, it will exit with a non-zero exit status, and fzf will warn you about it. To suppress the warning message, we added || true to the command, so that it always exits with 0.

Preview window

When the --preview option is set, fzf automatically starts an external process with the current line as the argument and shows the result in the split window. Your $SHELL is used to execute the command with $SHELL -c COMMAND. The window can be scrolled using the mouse or custom key bindings.

# {} is replaced with the single-quoted string of the focused line
fzf --preview 'cat {}'

Preview window supports ANSI colors, so you can use any program that syntax-highlights the content of a file, such as Bat or Highlight:

fzf --preview 'bat --style=numbers --color=always --line-range :500 {}'

You can customize the size, position, and border of the preview window using --preview-window option, and the foreground and background color of it with --color option. For example,

fzf --height 40% --layout reverse --info inline --border \
    --preview 'file {}' --preview-window up,1,border-horizontal \
    --color 'fg:#bbccdd,fg+:#ddeeff,bg:#334455,preview-bg:#223344,border:#778899'

See the man page (man fzf) for the full list of options.

For more advanced examples, see Key bindings for git with fzf (code).


Since fzf is a general-purpose text filter rather than a file finder, it is not a good idea to add --preview option to your $FZF_DEFAULT_OPTS.

# *********************
# ** DO NOT DO THIS! **
# *********************
export FZF_DEFAULT_OPTS='--preview "bat --style=numbers --color=always --line-range :500 {}"'

# bat doesn't work with any input other than the list of files
ps -ef | fzf
seq 100 | fzf
history | fzf

Tips

Respecting .gitignore

You can use fd, ripgrep, or the silver searcher instead of the default find command to traverse the file system while respecting .gitignore.

# Feed the output of fd into fzf
fd --type f | fzf

# Setting fd as the default source for fzf
export FZF_DEFAULT_COMMAND='fd --type f'

# Now fzf (w/o pipe) will use fd instead of find
fzf

# To apply the command to CTRL-T as well
export FZF_CTRL_T_COMMAND="$FZF_DEFAULT_COMMAND"

If you want the command to follow symbolic links and don't want it to exclude hidden files, use the following command:

export FZF_DEFAULT_COMMAND='fd --type f --hidden --follow --exclude .git'

Fish shell

CTRL-T key binding of fish, unlike those of bash and zsh, will use the last token on the command-line as the root directory for the recursive search. For instance, hitting CTRL-T at the end of the following command-line

ls /var/

will list all files and directories under /var/.

When using a custom FZF_CTRL_T_COMMAND, use the unexpanded $dir variable to make use of this feature. $dir defaults to . when the last token is not a valid directory. Example:

set -g FZF_CTRL_T_COMMAND "command find -L \$dir -type f 2> /dev/null | sed '1d; s#^\./##'"

Related projects

https://github.com/junegunn/fzf/wiki/Related-projects

License

The MIT License (MIT)

Copyright (c) 2013-2021 Junegunn Choi

Issues
  • [Ubuntu] --preview error : Failed to read /dev/tty

    [Ubuntu] --preview error : Failed to read /dev/tty

    • Category
      • [x ] fzf binary
      • [ ] fzf-tmux script
      • [ ] Key bindings
      • [ ] Completion
      • [ ] Vim
      • [ ] Neovim
      • [ ] Etc.
    • OS
      • [x ] Linux
      • [ ] Mac OS X
      • [ ] Windows
      • [ ] Windows Subsystem for Linux
      • [ ] Etc.
    • Shell
      • [ x] bash
      • [ ] zsh
      • [ ] fish

    When I use --preview I got the error message: Failed to read /dev/tty

    $ echo "hello" | fzf
    hello
    $ echo "hello" | fzf --preview 'echo {}'
    Failed to read /dev/tty
    $ echo $TERM
    xterm-256color
    $ tty
    /dev/pts/6
    $ fzf --version
    0.17.5 (b46227d)
    $ lsb_release -a
    No LSB modules are available.
    Distributor ID:	Ubuntu
    Description:	Ubuntu 18.04.1 LTS
    Release:	18.04
    Codename:	bionic
    
    opened by erch 70
  • fzf on gvim windows without WSL?

    fzf on gvim windows without WSL?

    • Category
      • [] fzf binary
      • [ ] fzf-tmux script
      • [ ] Key bindings
      • [ ] Completion
      • [x] Vim
      • [ ] Neovim
      • [ ] Etc.
    • OS
      • [ ] Linux
      • [ ] Mac OS X
      • [x] Windows
      • [ ] Windows Subsystem for Linux
      • [ ] Etc.
    • Shell
      • [ ] bash
      • [ ] zsh
      • [ ] fish

    I'm not sure that fzf can run without a shell yet. But if possible, please add this feature, the only thing that I can't try fzf on my windows is I don't have a shell except cmd.exe.

    question windows 
    opened by ghost 66
  • [neovim] :FZF sometimes fails to open certain files

    [neovim] :FZF sometimes fails to open certain files

    Sometimes when I :FZF, select a file, and then press <Enter>, NeoVim becomes unresponsive.

    When this happens, pressing <Enter> a couple more times brings up the following:

    W10: Warning: Changing a readonly file
    E315: ml_get: invalid lnum: 570
    Press ENTER or type command to continue
    E315: ml_get: invalid lnum: 568
    Press ENTER or type command to continue
    E315: ml_get: invalid lnum: 403
    Press ENTER or type command to continue
    ...
    

    Interestingly, opening the same file in a split (via <C-v>) seems to work, although nothing happens until I press <Enter> one extra time... i.e. <C-v> nothing happens <Enter> buffer opens as expected.

    Quitting & relaunching NeoVim seems to make the problem go away for a while, so it's difficult to reproduce.

    neovim 
    opened by adambiggs 48
  • Neovim compatibility

    Neovim compatibility

    https://github.com/neovim/neovim/issues/1477

    :confused:

    Vim plugin of fzf relies on :! for running fzf when not on tmux, and Neovim currently does not (and probably will not) support running interactive programs using :!.

    enhancement 
    opened by junegunn 48
  • cd tab completion not working

    cd tab completion not working

    • Category
      • [ ] fzf binary
      • [ ] fzf-tmux script
      • [ ] Key bindings
      • [x] Completion
      • [ ] Vim
      • [ ] Neovim
      • [ ] Etc.
    • OS
      • [x] Linux
      • [ ] Mac OS X
      • [ ] Windows
      • [ ] Windows Subsystem for Linux
      • [ ] Etc.
    • Shell
      • [x] bash
      • [ ] zsh
      • [ ] fish

    For some reason, cd <tab> is not auto-complete for me. I am running on a linux terminal X11-forwarded to a Windows machine.

    fzf version is 0.16.6.

    I have narrowed down the problem to these lines in shell/completion.bash:

    # Directory
    for cmd in $d_cmds; do
      _fzf_defc "$cmd" _fzf_dir_completion "-o nospace -o plusdirs"
    done
    

    Commenting them out gives me back the regular tab autocompletion behavior.

    Please let me know if there's some way I could debug this further.

    help-needed not-reproducible 
    opened by tnguyen14 43
  • Option to preview focused item with an external command

    Option to preview focused item with an external command

    Something like:

    git ls-files | fzf --preview "head -$LINES {}" --color light --margin 5,20
    
    head

    With some ANSI colors:

    git ls-files | fzf --preview "pygmentize {}" --color light --margin 5,20
    
    pygmentize

    TBD:

    • Yes or no
    • Layout: top/bottom/left/right(/hidden), size
    feature 
    opened by junegunn 38
  • Use the terminal by default for nvim-0.2.1 or GVim (nightly)

    Use the terminal by default for nvim-0.2.1 or GVim (nightly)

    Initial work to use the neovim terminal by default in Windows. The double keypress remains for Windows 8+ because https://github.com/gdamore/tcell/pull/159 is unresolved.

    I prefer to keep this open/unmerged until the 0.2.1 release while I test this with my pull requests in fzf.vim.

    @mikesmiffy128 I cherry-pick the commit as you suggested in https://github.com/junegunn/fzf/pull/962#issuecomment-322936545

    neovim windows 
    opened by janlazo 35
  • Fix ExecCommandWith for cmd.exe in Windows

    Fix ExecCommandWith for cmd.exe in Windows

    Close #1018

    Run the command as is in cmd.exe with no parsing and escaping. Explicity set cmd.SysProcAttr so execCommand does not escape the command. Technically, the command should be escaped with ^ for special characters, including ". This allows cmd.exe commands to be chained together.

    See https://github.com/neovim/neovim/pull/7343#issuecomment-333350201

    However, this requires a new shellescape function that is specific to one of the following:

    • interactive prompt
    • batchfile
    • command name

    fzf#shellescape in the Vim plugin can handle only the batchfile.

    enhancement windows 
    opened by janlazo 34
  • [Question] Can you tell me the test files?

    [Question] Can you tell me the test files?

    https://raw.githubusercontent.com/junegunn/i/master/fzf-commandt-ctrlp-unite.gif

    I read the page and found unite.vim cache performance was too bad. But I have improved file_rec/async performance in unite.vim.

    I want to re-test for the files.

    question 
    opened by Shougo 32
  • Support cygwin vim via cygpath and Windows binary

    Support cygwin vim via cygpath and Windows binary

    Since cygwin sh/bash runs cmd.exe in the back (sh/bash by itself is run in a cmd.exe terminal) and use TERM=cygwin, we can run cygwin vim and the fzf (Windows) binary in cmd.exe/powershell. Benefit of including cygwin support to the vim plugin is running the tests as is in Windows. I'm currently using this for the Vader tests.

    By unsetting TERM, fzf runs as if vim (Windows) is used. cygpath (via s:cygpath) is used for path conversion between Windows and cygwin filepaths. I updated s:escape to escape () for Windows filepaths.

    Currently, this PR does not support mintty (TERM=xterm) because fzf is run inline (no shell script or batchfile) and I can't get the start command to work with shell redirection yet. Neovim TUI in cygwin sh/bash is not supported in the vim plugin even though it runs fine (without mintty) in sh/bash. I'll work on that along with :terminal when 0.2.1 is released.

    I'm using the cygwin environment from Git For Windows and tested this PR in sh.exe with TERM=cygwin.

    windows 
    opened by janlazo 32
  • Numbers on numpad (123..) are incorrectly translated to 'qrstuvwxy'

    Numbers on numpad (123..) are incorrectly translated to 'qrstuvwxy'

    • [x] I have read through the manual page (man fzf)
    • [x] I have the latest version of fzf
    • [x] I have searched through the existing issues using keywords "numpad" and "number"

    Info

    • OS
      • [ x ] Mac OS X
    • Shell
      • [ x ] zsh

    Problem / Steps to reproduce

    1. Initiate fzf
    2. Start typing numbers with number pad (I'm sending these key events: KC_P1, KC_P2, etc. from number pad, see here https://beta.docs.qmk.fm/using-qmk/simple-keycodes/keycodes_basic#number-pad )

    expected results

    numbers are typed

    actual results

    letters are typed, where 1 stands for q, 2 stands for r, 3 stands for s... 123456789 is qrstuvwxy

    side note

    This does not happen in terminal in general, only within fzf.

    See gif CleanShot 2021-09-22 at 14 32 36

    opened by mimkorn 0
  • Align keyboard and mouse support in FullscreenRenderer with LightRenderer

    Align keyboard and mouse support in FullscreenRenderer with LightRenderer

    This pull request is focused on fixing some issues and adding new features in the FullscreenRenderer. Most of the branch is about keyboard events, but the last commit also implements mouse events.

    Keyboard

    • I tried to bring the keyboard events in FullscreenRenderer as close as possible to the LightRenderer
    • additions:
      • extensive testing of the tcell events that fzf uses as source for keyboard events
      • ability to input AltGr characters on foreign keyboards
    • fixes:
      • CtrlSpace event didn't work
      • CtrlCaret event wasn't implement
      • there was big discrepancy in how backspace key is handled between FullscreenRenderer and LightRenderer. The CtrlH event was emitted even in the cases where BSpace or AltBS was appropriate.

    Mouse

    The mouse events in LightRenderer are consumed by the shell in Windows, so I didn't have reference point. Based on existing code it should be close to what user would expect, but I noticed something that looked like Shift+Click support in LightRenderer, so this implementation may still lag behind the unix one.

    enhancement windows 
    opened by vovcacik 1
  • Change the tests to run on Windows

    Change the tests to run on Windows

    I needed to write some tests, but the existing tests were failing on Windows. In this pull request you can find changes that make the tests run and pass on both platforms.

    The first commit prepares the ground and make some strings in the tests parametric. I'm using the text/templates package from Go. The second commit then contains all changes related to Windows platform.

    opened by vovcacik 0
  • Minor changes

    Minor changes

    This is few minor things I came across lately.

    • fmt.Println in tests doesn't honor verbosity flags like t.Log does
    • the keyboard event works just fine for space character
    opened by vovcacik 0
  • feature request: add a truely 'exact' match to extended search mode

    feature request: add a truely 'exact' match to extended search mode

    • [x] I have read through the manual page (man fzf)
    • [x] I have the latest version of fzf
    • [x] I have searched through the existing issues

    Info

    • OS
      • [x] Linux
      • [ ] Mac OS X
      • [ ] Windows
      • [ ] Etc.
    • Shell
      • [ ] bash
      • [x] zsh
      • [ ] fish

    Problem / Steps to reproduce

    You start any search in extended search mode with either case-insensative or smart-case (default). You type a word and then realize that your next search term needs to be case-sensitive. You then look at the extended search mode section of the man page and try to use a single quote before your search term, expecting it to be an "exact match". You soon discover that the manual's usage of the term "exact match" really only means "non-fuzzy", not exact. Exact should include case-sensitivity. I now have no other option but to restart fzf in case-insensitive mode.

    Unless there's some other way to enforce the case-sensitivity dynamically (preferably by search term rather than for the entire fzf instance), I propose:

    1. rename "exact match" to "non-fuzzy match"
    2. add an actual "exact match" function that includes both "non-fuzzy match" and case-sensitivity.
    opened by cpakkala 1
  • Bump github.com/mattn/go-isatty from 0.0.12 to 0.0.14

    Bump github.com/mattn/go-isatty from 0.0.12 to 0.0.14

    Bumps github.com/mattn/go-isatty from 0.0.12 to 0.0.14.

    Commits
    • 504425e Merge pull request #66 from cookieY/sys
    • ee4b64c Update golang.org/x/sys commit hash to 0f9fa26a
    • 68134e7 Merge pull request #65 from shogo82148/introduce-go-build-comments
    • bea4d7c Merge pull request #64 from shogo82148/migrate-github-actions
    • 3ba961d add //go:build
    • 56b25a0 migrate from travis-ci to GitHub Actions
    • 712ea5b Merge pull request #62 from marcauberer/master
    • be5a901 Fix typo
    • 8b0c6d8 Merge pull request #61 from tklauser/fix-solaris-isterminal
    • 518b0c1 Don't set termio in IsTerminal on solaris
    • Additional commits viewable in compare view

    Dependabot compatibility score

    Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.


    Dependabot commands and options

    You can trigger Dependabot actions by commenting on this PR:

    • @dependabot rebase will rebase this PR
    • @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
    • @dependabot merge will merge this PR after your CI passes on it
    • @dependabot squash and merge will squash and merge this PR after your CI passes on it
    • @dependabot cancel merge will cancel a previously requested merge and block automerging
    • @dependabot reopen will reopen this PR if it is closed
    • @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
    • @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
    • @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
    • @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
    dependencies 
    opened by dependabot[bot] 0
  • Transform presentation of input by cutting out regex patterns

    Transform presentation of input by cutting out regex patterns

    • [x] I have read through the manual page (man fzf)
    • [x] I have the latest version of fzf
    • [x] I have searched through the existing issues

    Info

    • OS
      • [x] Linux
      • [ ] Mac OS X
      • [ ] Windows
      • [ ] Etc.
    • Shell
      • [ ] bash
      • [x] zsh
      • [ ] fish

    Similar to with-nth, but instead of delimiting the input and selecting a field, you just pass in a regex pattern to cut out of the input lines without effecting the final selected output.

    As an example, I use fzf to select video files to open with mpv, and I have files with names like [SubsPlease] Fumetsu no Anata e - 01 (1080p) [1D65E30D].mkv, all the extra information isn't exactly condusive to searching and it's not nice to look at either, and while this one example could be handled with a delimiter, not every file would have the same exact field for with-nth so it isn't an effective option. Instead, if I could do something like fzf --cut '(\[\w+\])|(\(\w+\))|\.\w+$' to transform the line to Fumetsu no Anata e - 01 that would be much nicer and more widely applicable.

    opened by BanchouBoo 0
  • [Issue] Expanding {n} automatically adds quotes and character escapes

    [Issue] Expanding {n} automatically adds quotes and character escapes

    • [x] I have read through the manual page (man fzf)
    • [x] I have the latest version of fzf
    • [x] I have searched through the existing issues

    Info

    • OS
      • [ ] Linux
      • [ ] Mac OS X
      • [x] Windows
      • [ ] Etc.
    • Shell
      • [ ] bash
      • [ ] zsh
      • [ ] fish
      • [x] PowerShell

    Problem / Steps to reproduce

    I'm using this command:

    fzf --preview="bat --style=numbers --color=always {2}" --bind "ctrl-b:execute(notepad++ -n{1} {2})"
    

    This is executed when applying Ctrl+B on a result:

    notepad++ -n"12" "C:\\Work\\Test Folder\\File.txt"
    

    I see that {2} is automatically expanded with the properly escaped path.

    But {1} is causing issues. I would need to expand it without adding any quote, also without making use of any further tool such as sed/awk.

    How could this be achieved in FZF?

    opened by pidgeon777 7
  • After setting key bindings in .zshrc, I encoutered login loop in Arch Linux

    After setting key bindings in .zshrc, I encoutered login loop in Arch Linux

    Arch Linux + xfce4 + lightdm

    removing the source line in .zshrc solves the login loop problems

    opened by lingyiy 0
  • Error: invalid color specification: pointer:

    Error: invalid color specification: pointer:

    • [x ] I have read through the manual page (man fzf)
    • [ x] I have the latest version of fzf
    • [ x] I have searched through the existing issues

    Info

    • OS
      • [x ] Linux
      • [ ] Mac OS X
      • [ ] Windows
      • [ ] Etc.
    • Shell
      • [ x] bash
      • [ ] zsh
      • [ ] fish

    Problem / Steps to reproduce

    I'm getting this error every time I try to run the package/program. It even prevents me from reinstalling. I used the uninstall script first.

    opened by karnaKali 1
Releases(0.27.2)
Owner
Junegunn Choi
Junegunn Choi
Command-line program to download videos from YouTube.com and other video sites

youtube-dl - download videos from youtube.com or other video platforms INSTALLATION DESCRIPTION OPTIONS CONFIGURATION OUTPUT TEMPLATE FORMAT SELECTION

youtube-dl 100.6k Sep 25, 2021
A smarter cd command for your terminal

zoxide A smarter cd command for your terminal zoxide is a blazing fast replacement for your cd command, inspired by z and z.lua. It keeps track of the

Ajeet D'Souza 3.7k Sep 15, 2021
A code-searching tool similar to ack, but faster.

The Silver Searcher A code searching tool similar to ack, with a focus on speed. Do you know C? Want to improve ag? I invite you to pair with me. What

Geoff Greer 22.5k Sep 15, 2021
cloc counts blank lines, comment lines, and physical lines of source code in many programming languages.

cloc Count Lines of Code cloc counts blank lines, comment lines, and physical lines of source code in many programming languages. Latest release: v1.9

null 12.3k Sep 17, 2021
:bookmark: Browser-independent bookmark manager

buku buku in action! Introduction buku is a powerful bookmark manager written in Python3 and SQLite3. When I started writing it, I couldn't find a fle

Piña Colada 4.7k Sep 17, 2021
A new way to see and navigate directory trees : https://dystroy.org/broot

Broot A better way to navigate directories Install Broot Get an overview of a directory, even a big one br -s Notice the unlisted? That's what makes i

Canop 6.1k Sep 15, 2021
Magnificent app which corrects your previous console command.

The Fuck The Fuck is a magnificent app, inspired by a @liamosaur tweet, that corrects errors in previous console commands. Is The Fuck too slow? Try t

Vladimir Iakovlev 63.9k Sep 19, 2021
:speech_balloon: Command-line translator using Google Translate, Bing Translator, Yandex.Translate, etc.

Translate Shell Translate Shell (formerly Google Translate CLI) is a command-line translator powered by Google Translate (default), Bing Translator, Y

Mort Yao 5.2k Sep 19, 2021
A modern replacement for ‘ls’.

exa exa is a modern replacement for ls. README Sections: Options — Installation — Development exa is a modern replacement for the venerable file-listi

Benjamin Sago 14.7k Sep 24, 2021
Git repository summary on your terminal

A command-line Git information tool written in Rust Onefetch is a command-line Git information tool written in Rust that displays project information

Ossama Hjaji 3.4k Sep 15, 2021
A fast CSV command line toolkit written in Rust.

xsv is a command line program for indexing, slicing, analyzing, splitting and joining CSV files. Commands should be simple, fast and composable: Simpl

Andrew Gallant 7.6k Sep 21, 2021
Command-line program to download image galleries and collections from several image hosting sites

gallery-dl gallery-dl is a command-line program to download image galleries and collections from several image hosting sites (see Supported Sites). It

Mike Fährmann 3.8k Sep 17, 2021
🖼️ A command-line system information tool written in bash 3.2+

A command-line system information tool written in bash 3.2+ Neofetch is a command-line system information tool written in bash 3.2+. Neofetch displays

dylan 12.9k Sep 15, 2021
A command-line benchmarking tool

hyperfine 中文 A command-line benchmarking tool. Demo: Benchmarking fd and find: Features Statistical analysis across multiple runs. Support for arbitra

David Peter 8.6k Sep 15, 2021
Linux Kernel Manager and Activity Monitor 🐧💻

Linux Kernel Manager and Activity Monitor ?? ?? The kernel is the part of the operating system that facilitates interactions between hardware and soft

Orhun Parmaksız 1.3k Sep 14, 2021
Notifies you when long-running terminal commands complete

undistract-me Notifies you when long-running terminal commands complete. What is this? Does this ever happen to you? You're doing some work, and as pa

Jonathan Lange 479 Sep 15, 2021
:mag: Google from the terminal

googler is a power tool to Google (web, news, videos and site search) from the command-line. It shows the title, URL and abstract for each result, whi

Piña Colada 5.3k Sep 18, 2021