Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jhawthorn/fzy

:mag: A simple, fast fuzzy finder for the terminal
https://github.com/jhawthorn/fzy

c cli fuzzy fuzzy-finders fuzzy-search fuzzyfinder fzy unix vim

Last synced: 5 days ago
JSON representation

:mag: A simple, fast fuzzy finder for the terminal

Host: GitHub
URL: https://github.com/jhawthorn/fzy
Owner: jhawthorn
License: mit
Created: 2014-07-12T04:30:53.000Z (over 10 years ago)
Default Branch: master
Last Pushed: 2024-12-10T02:01:38.000Z (about 2 months ago)
Last Synced: 2025-01-19T18:00:05.081Z (7 days ago)
Topics: c, cli, fuzzy, fuzzy-finders, fuzzy-search, fuzzyfinder, fzy, unix, vim
Language: C
Homepage:
Size: 331 KB
Stars: 3,011
Watchers: 38
Forks: 129
Open Issues: 53
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

awesome-tools - fzy - 类似 fzf。A simple, fast fuzzy finder for the terminal. (Command Line / Dependency Management)
my-awesome-github-stars - jhawthorn/fzy - :mag: A simple, fast fuzzy finder for the terminal (C)
awesome-list - fzy

README

        ![fzy](http://i.hawth.ca/u/fzy-github.svg)

**fzy** is a fast, simple fuzzy text selector for the terminal with an advanced scoring algorithm.

[Try it out online!](http://jhawthorn.github.io/fzy-demo)

![](http://i.hawth.ca/u/fzy_animated_demo.svg)



It's been kind of life-changing.

-@graygilmore





fzy works great btw

-@alexblackie



 [![Build Status](https://github.com/jhawthorn/fzy/workflows/CI/badge.svg)](https://github.com/jhawthorn/fzy/actions)

## Why use this over fzf, pick, selecta, ctrlp, ...?

fzy is faster and shows better results than other fuzzy finders.

Most other fuzzy matchers sort based on the length of a match. fzy tries to

find the result the user intended. It does this by favouring matches on

consecutive letters and starts of words. This allows matching using acronyms or

different parts of the path.

A gory comparison of the sorting used by fuzzy finders can be found in [ALGORITHM.md](ALGORITHM.md)

fzy is designed to be used both as an editor plugin and on the command line.

Rather than clearing the screen, fzy displays its interface directly below the current cursor position, scrolling the screen if necessary.

## Installation

**macOS**

Using Homebrew

    brew install fzy

Using MacPorts

    sudo port install fzy

**[Arch Linux](https://www.archlinux.org/packages/?sort=&q=fzy&maintainer=&flagged=)/MSYS2**: `pacman -S fzy`

**[FreeBSD](https://www.freebsd.org/cgi/ports.cgi?query=fzy&stype=all)**: `pkg install fzy`

**[Gentoo Linux](https://packages.gentoo.org/packages/app-shells/fzy)**: `emerge -av app-shells/fzy`

**[Ubuntu](https://packages.ubuntu.com/search?keywords=fzy&searchon=names&suite=bionic&section=all)/[Debian](https://packages.debian.org/search?keywords=fzy&searchon=names&suite=all&section=all)**: `apt-get install fzy`

**[pkgsrc](http://pkgsrc.se/misc/fzy) (NetBSD and others)**: `pkgin install fzy`

**[openSUSE](https://software.opensuse.org/package/fzy)**: `zypper in fzy`

### From source

    make

    sudo make install

The `PREFIX` environment variable can be used to specify the install location,

the default is `/usr/local`.

## Usage

fzy is a drop in replacement for [selecta](https://github.com/garybernhardt/selecta), and can be used with its [usage examples](https://github.com/garybernhardt/selecta#usage-examples).

### Use with Vim

fzy can be easily integrated with vim.

``` vim

function! FzyCommand(choice_command, vim_command)

  try

    let output = system(a:choice_command . " | fzy ")

  catch /Vim:Interrupt/

    " Swallow errors from ^C, allow redraw! below

  endtry

  redraw!

  if v:shell_error == 0 && !empty(output)

    exec a:vim_command . ' ' . output

  endif

endfunction

nnoremap e :call FzyCommand("find . -type f", ":e")

nnoremap v :call FzyCommand("find . -type f", ":vs")

nnoremap s :call FzyCommand("find . -type f", ":sp")

```

Any program can be used to filter files presented through fzy. [ag (the silver searcher)](https://github.com/ggreer/the_silver_searcher) can be used to ignore files specified by `.gitignore`.

``` vim

nnoremap e :call FzyCommand("ag . --silent -l -g ''", ":e")

nnoremap v :call FzyCommand("ag . --silent -l -g ''", ":vs")

nnoremap s :call FzyCommand("ag . --silent -l -g ''", ":sp")

```

## Sorting

fzy attempts to present the best matches first. The following considerations are weighted when sorting:

It prefers consecutive characters: `file` will match file over filter.

It prefers matching the beginning of words: `amp` is likely to match app/models/posts.rb.

It prefers shorter matches: `abce` matches abcdef over abc de.

It prefers shorter candidates: `test` matches tests over testing.

## See Also

* [fzy.js](https://github.com/jhawthorn/fzy.js) Javascript port