@@ -48,7 +48,7 @@ Using MacPorts

 **[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`

+**[Gentoo Linux](https://packages.gentoo.org/packages/app-text/fzy)**: `emerge -av app-text/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`

@@ -16,6 +16,8 @@ fzy works great btw

 -<a href="https://twitter.com/alexblackie/status/719297828892188672">@alexblackie</a>

 </blockquote>

+ [![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.

@@ -16,8 +16,6 @@ fzy works great btw

 -<a href="https://twitter.com/alexblackie/status/719297828892188672">@alexblackie</a>

 </blockquote>

-[![Build Status](https://travis-ci.org/jhawthorn/fzy.svg?branch=master)](https://travis-ci.org/jhawthorn/fzy)

-

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

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

@@ -85,9 +85,9 @@ function! FzyCommand(choice_command, vim_command)

   endif

 endfunction

-nnoremap <leader>e :call FzyCommand("find -type f", ":e")<cr>

-nnoremap <leader>v :call FzyCommand("find -type f", ":vs")<cr>

-nnoremap <leader>s :call FzyCommand("find -type f", ":sp")<cr>

+nnoremap <leader>e :call FzyCommand("find . -type f", ":e")<cr>

+nnoremap <leader>v :call FzyCommand("find . -type f", ":vs")<cr>

+nnoremap <leader>s :call FzyCommand("find . -type f", ":sp")<cr>

 ```

 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`.

@@ -114,3 +114,4 @@ It prefers shorter candidates: `test` matches <tt><b>test</b>s</tt> over <tt><b>

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

+

@@ -110,3 +110,7 @@ It prefers shorter matches: `abce` matches <tt><b>abc</b>d<b>e</b>f</tt> over <t

 It prefers shorter candidates: `test` matches <tt><b>test</b>s</tt> over <tt><b>test</b>ing</b></tt>.

+## See Also

+

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

+

@@ -1,7 +1,8 @@

 ![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](#sorting).

+**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)

@@ -43,17 +43,17 @@ Using MacPorts

     sudo port install fzy

-**Arch Linux/MSYS2**: `pacman -S fzy`

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

-**FreeBSD**: `pkg install fzy`

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

-**Gentoo Linux**: `emerge -av app-shells/fzy`

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

-**Ubuntu/Debian 64-bit**: `apt-get install 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 (NetBSD and others)**: `pkgin install fzy`

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

-**openSUSE**: `zypper in fzy`

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

 ### From source

@@ -33,52 +33,35 @@ Rather than clearing the screen, fzy displays its interface directly below the c

 ## Installation

-### From source

-

-    make

-    sudo make install

-

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

-the default is `/usr/local`.

-

-### Arch Linux/MSYS2

-

-fzy is available in the `community` repo.

-

-    sudo pacman -S fzy

-

-### Fedora/Redhat/CentOS

-

-    sudo yum install https://github.com/jhawthorn/fzy/releases/download/0.9/fzy-0.9-1.x86_64.rpm

-

-### FreeBSD

+**macOS**

-    pkg install fzy

+Using Homebrew

-### Gentoo Linux

+    brew install fzy

-fzy is available in the main repo.

+Using MacPorts

-    emerge -av app-shells/fzy

+    sudo port install fzy

-### macOS

+**Arch Linux/MSYS2**: `pacman -S fzy`

-Using Homebrew

+**FreeBSD**: `pkg install fzy`

-    brew install fzy

+**Gentoo Linux**: `emerge -av app-shells/fzy`

-Using MacPorts

+**Ubuntu/Debian 64-bit**: `apt-get install fzy`

-    sudo port install fzy

+**pkgsrc (NetBSD and others)**: `pkgin install fzy`

-### Ubuntu/Debian 64-bit

+**openSUSE**: `zypper in fzy`

-    wget https://github.com/jhawthorn/fzy/releases/download/0.9/fzy_0.9-1_amd64.deb

-    sudo dpkg -i fzy_0.9-1_amd64.deb

+### From source

-### pkgsrc (NetBSD and others)

+    make

+    sudo make install

-    sudo pkgin install fzy

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

+the default is `/usr/local`.

 ## Usage

@@ -3,7 +3,7 @@

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

 algorithm](#sorting).

-![](http://i.hawth.ca/u/fzy2.gif)

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

 <blockquote>

 It's been kind of life-changing.

@@ -41,30 +41,19 @@ Rather than clearing the screen, fzy displays its interface directly below the c

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

 the default is `/usr/local`.

-### MacOS

-

-Using Homebrew

-

-    brew install fzy

-

-Using MacPorts

-

-    sudo port install fzy

+### Arch Linux/MSYS2

-### Ubuntu/Debian 64-bit

+fzy is available in the `community` repo.

-    wget https://github.com/jhawthorn/fzy/releases/download/0.9/fzy_0.9-1_amd64.deb

-    sudo dpkg -i fzy_0.9-1_amd64.deb

+    sudo pacman -S fzy

 ### Fedora/Redhat/CentOS

     sudo yum install https://github.com/jhawthorn/fzy/releases/download/0.9/fzy-0.9-1.x86_64.rpm

-### Arch Linux/MSYS2

-

-fzy is available in the `community` repo.

+### FreeBSD

-    sudo pacman -S fzy

+    pkg install fzy

 ### Gentoo Linux

@@ -72,6 +61,21 @@ fzy is available in the main repo.

     emerge -av app-shells/fzy

+### macOS

+

+Using Homebrew

+

+    brew install fzy

+

+Using MacPorts

+

+    sudo port install fzy

+

+### Ubuntu/Debian 64-bit

+

+    wget https://github.com/jhawthorn/fzy/releases/download/0.9/fzy_0.9-1_amd64.deb

+    sudo dpkg -i fzy_0.9-1_amd64.deb

+

 ### pkgsrc (NetBSD and others)

     sudo pkgin install fzy

@@ -60,7 +60,7 @@ Using MacPorts

     sudo yum install https://github.com/jhawthorn/fzy/releases/download/0.9/fzy-0.9-1.x86_64.rpm

-### Arch Linux

+### Arch Linux/MSYS2

 fzy is available in the `community` repo.

@@ -66,6 +66,12 @@ fzy is available in the `community` repo.

     sudo pacman -S fzy

+### Gentoo Linux

+

+fzy is available in the main repo.

+

+    emerge -av app-shells/fzy

+

 ### pkgsrc (NetBSD and others)

     sudo pkgin install fzy

@@ -66,6 +66,10 @@ fzy is available in the `community` repo.

     sudo pacman -S fzy

+### pkgsrc (NetBSD and others)

+

+    sudo pkgin install fzy

+

 ## 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).

@@ -45,7 +45,7 @@ the default is `/usr/local`.

 Using Homebrew

-    sudo brew install fzy

+    brew install fzy

 Using MacPorts

@@ -62,10 +62,9 @@ Using MacPorts

 ### Arch Linux

-fzy is available

-[in the AUR](https://aur.archlinux.org/packages/fzy/)

-with a very simple

-[PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=fzy)

+fzy is available in the `community` repo.

+

+    sudo pacman -S fzy

 ## Usage

@@ -41,6 +41,16 @@ Rather than clearing the screen, fzy displays its interface directly below the c

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

 the default is `/usr/local`.

+### MacOS

+

+Using Homebrew

+

+    sudo brew install fzy

+

+Using MacPorts

+

+    sudo port install fzy

+

 ### Ubuntu/Debian 64-bit

     wget https://github.com/jhawthorn/fzy/releases/download/0.9/fzy_0.9-1_amd64.deb

@@ -57,11 +67,6 @@ fzy is available

 with a very simple

 [PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=fzy)

-### MacOS

-

-    brew install fzy  # Homebrew

-    sudo port install fzy  # MacPorts

-

 ## 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).

@@ -57,9 +57,10 @@ fzy is available

 with a very simple

 [PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=fzy)

-### OS X via Homebrew

+### MacOS

-    brew install fzy

+    brew install fzy  # Homebrew

+    sudo port install fzy  # MacPorts

 ## Usage

@@ -90,9 +90,9 @@ nnoremap <leader>s :call FzyCommand("find -type f", ":sp")<cr>

 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 <leader>e :call FzyCommand("ag . -l -g ''", ":e")<cr>

-nnoremap <leader>v :call FzyCommand("ag . -l -g ''", ":vs")<cr>

-nnoremap <leader>s :call FzyCommand("ag . -l -g ''", ":sp")<cr>

+nnoremap <leader>e :call FzyCommand("ag . --silent -l -g ''", ":e")<cr>

+nnoremap <leader>v :call FzyCommand("ag . --silent -l -g ''", ":vs")<cr>

+nnoremap <leader>s :call FzyCommand("ag . --silent -l -g ''", ":sp")<cr>

 ```

 ## Sorting

@@ -43,12 +43,12 @@ the default is `/usr/local`.

 ### Ubuntu/Debian 64-bit

-    wget https://github.com/jhawthorn/fzy/releases/download/0.8/fzy_0.8-1_amd64.deb

-    sudo dpkg -i fzy_0.8-1_amd64.deb

+    wget https://github.com/jhawthorn/fzy/releases/download/0.9/fzy_0.9-1_amd64.deb

+    sudo dpkg -i fzy_0.9-1_amd64.deb

 ### Fedora/Redhat/CentOS

-    sudo yum install https://github.com/jhawthorn/fzy/releases/download/0.8/fzy-0.8-1.x86_64.rpm

+    sudo yum install https://github.com/jhawthorn/fzy/releases/download/0.9/fzy-0.9-1.x86_64.rpm

 ### Arch Linux

@@ -59,7 +59,7 @@ with a very simple

 ### OS X via Homebrew

-    brew install jhawthorn/fzy/fzy

+    brew install fzy

 ## Usage

@@ -59,8 +59,7 @@ with a very simple

 ### OS X via Homebrew

-    brew tap jhawthorn/fzy

-    brew install fzy

+    brew install jhawthorn/fzy/fzy

 ## Usage

@@ -68,7 +68,7 @@ fzy is a drop in replacement for [selecta](https://github.com/garybernhardt/sele

 ### Use with Vim

-fzy can be integrated very simply in vim. There is also [fzy-vim](https://github.com/Dkendal/fzy-vim), a more fully featured vim plugin.

+fzy can be easily integrated with vim.

 ``` vim

 function! FzyCommand(choice_command, vim_command)

@@ -43,12 +43,12 @@ the default is `/usr/local`.

 ### Ubuntu/Debian 64-bit

-    wget https://github.com/jhawthorn/fzy/releases/download/0.7/fzy_0.7-1_amd64.deb

-    sudo dpkg -i fzy_0.7-1_amd64.deb

+    wget https://github.com/jhawthorn/fzy/releases/download/0.8/fzy_0.8-1_amd64.deb

+    sudo dpkg -i fzy_0.8-1_amd64.deb

 ### Fedora/Redhat/CentOS

-    sudo yum install https://github.com/jhawthorn/fzy/releases/download/0.7/fzy-0.7-1.x86_64.rpm

+    sudo yum install https://github.com/jhawthorn/fzy/releases/download/0.8/fzy-0.8-1.x86_64.rpm

 ### Arch Linux

@@ -43,12 +43,12 @@ the default is `/usr/local`.

 ### Ubuntu/Debian 64-bit

-    wget https://github.com/jhawthorn/fzy/releases/download/0.6/fzy_0.6-1_amd64.deb

-    sudo dpkg -i fzy_0.6-1_amd64.deb

+    wget https://github.com/jhawthorn/fzy/releases/download/0.7/fzy_0.7-1_amd64.deb

+    sudo dpkg -i fzy_0.7-1_amd64.deb

 ### Fedora/Redhat/CentOS

-    sudo yum install https://github.com/jhawthorn/fzy/releases/download/0.6/fzy-0.6-1.x86_64.rpm

+    sudo yum install https://github.com/jhawthorn/fzy/releases/download/0.7/fzy-0.7-1.x86_64.rpm

 ### Arch Linux

@@ -43,12 +43,12 @@ the default is `/usr/local`.

 ### Ubuntu/Debian 64-bit

-    wget https://github.com/jhawthorn/fzy/releases/download/0.5/fzy_0.5-1_amd64.deb

-    sudo dpkg -i fzy_0.5-1_amd64.deb

+    wget https://github.com/jhawthorn/fzy/releases/download/0.6/fzy_0.6-1_amd64.deb

+    sudo dpkg -i fzy_0.6-1_amd64.deb

 ### Fedora/Redhat/CentOS

-    sudo yum install https://github.com/jhawthorn/fzy/releases/download/0.5/fzy-0.5-1.x86_64.rpm

+    sudo yum install https://github.com/jhawthorn/fzy/releases/download/0.6/fzy-0.6-1.x86_64.rpm

 ### Arch Linux

@@ -43,12 +43,12 @@ the default is `/usr/local`.

 ### Ubuntu/Debian 64-bit

-    wget https://github.com/jhawthorn/fzy/releases/download/0.4/fzy_0.4-1_amd64.deb

-    sudo dpkg -i fzy_0.4-1_amd64.deb

+    wget https://github.com/jhawthorn/fzy/releases/download/0.5/fzy_0.5-1_amd64.deb

+    sudo dpkg -i fzy_0.5-1_amd64.deb

 ### Fedora/Redhat/CentOS

-    sudo yum install https://github.com/jhawthorn/fzy/releases/download/0.4/fzy-0.4-1.x86_64.rpm

+    sudo yum install https://github.com/jhawthorn/fzy/releases/download/0.5/fzy-0.5-1.x86_64.rpm

 ### Arch Linux

@@ -1,4 +1,4 @@

-![fzy](fzy.png)

+![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](#sorting).

@@ -1,4 +1,4 @@

-<img src="http://i.hawth.ca/u/fzy-200.png" width="200" height="116" alt="fzy" />

+![fzy](fzy.png)

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

 algorithm](#sorting).

@@ -1,6 +1,6 @@

-# fzy

+<img src="http://i.hawth.ca/u/fzy-200.png" width="200" height="116" alt="fzy" />

-A fast, simple fuzzy text selector for the terminal with an advanced [scoring

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

 algorithm](#sorting).

 ![](http://i.hawth.ca/u/fzy2.gif)

@@ -48,8 +48,7 @@ the default is `/usr/local`.

 ### Fedora/Redhat/CentOS

-    wget https://github.com/jhawthorn/fzy/releases/download/0.4/fzy-0.4-1.x86_64.rpm

-    sudo rpm -i fzy-0.4-1.x86_64.rpm

+    sudo yum install https://github.com/jhawthorn/fzy/releases/download/0.4/fzy-0.4-1.x86_64.rpm

 ### Arch Linux

@@ -43,8 +43,13 @@ the default is `/usr/local`.

 ### Ubuntu/Debian 64-bit

-    wget https://github.com/jhawthorn/fzy/releases/download/0.3/fzy_0.3-1_amd64.deb

-    sudo dpkg -i fzy_0.3-1_amd64.deb

+    wget https://github.com/jhawthorn/fzy/releases/download/0.4/fzy_0.4-1_amd64.deb

+    sudo dpkg -i fzy_0.4-1_amd64.deb

+

+### Fedora/Redhat/CentOS

+

+    wget https://github.com/jhawthorn/fzy/releases/download/0.4/fzy-0.4-1.x86_64.rpm

+    sudo rpm -i fzy-0.4-1.x86_64.rpm

 ### Arch Linux

@@ -87,9 +87,9 @@ nnoremap <leader>s :call FzyCommand("find -type f", ":sp")<cr>

 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 <leader>e :call FzyCommand("ag . --no-color -l -g ''", ":e")<cr>

-nnoremap <leader>v :call FzyCommand("ag . --no-color -l -g ''", ":vs")<cr>

-nnoremap <leader>s :call FzyCommand("ag . --no-color -l -g ''", ":sp")<cr>

+nnoremap <leader>e :call FzyCommand("ag . -l -g ''", ":e")<cr>

+nnoremap <leader>v :call FzyCommand("ag . -l -g ''", ":vs")<cr>

+nnoremap <leader>s :call FzyCommand("ag . -l -g ''", ":sp")<cr>

 ```

 ## Sorting

@@ -41,12 +41,17 @@ Rather than clearing the screen, fzy displays its interface directly below the c

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

 the default is `/usr/local`.

+### Ubuntu/Debian 64-bit

+

+    wget https://github.com/jhawthorn/fzy/releases/download/0.3/fzy_0.3-1_amd64.deb

+    sudo dpkg -i fzy_0.3-1_amd64.deb

+

 ### Arch Linux

 fzy is available

 [in the AUR](https://aur.archlinux.org/packages/fzy/)

 with a very simple

-[PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=fzy).

+[PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=fzy)

 ### OS X via Homebrew

@@ -41,6 +41,13 @@ Rather than clearing the screen, fzy displays its interface directly below the c

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

 the default is `/usr/local`.

+### Arch Linux

+

+fzy is available

+[in the AUR](https://aur.archlinux.org/packages/fzy/)

+with a very simple

+[PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=fzy).

+

 ### OS X via Homebrew

     brew tap jhawthorn/fzy

@@ -33,12 +33,19 @@ Rather than clearing the screen, fzy displays its interface directly below the c

 ## Installation

-    $ make

-    $ sudo make install

+### From source

+

+    make

+    sudo make install

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

 the default is `/usr/local`.

+### OS X via Homebrew

+

+    brew tap jhawthorn/fzy

+    brew install fzy

+

 ## 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).

@@ -1,16 +1,35 @@

 # fzy

-A fuzzy text selector for terminals in C inspired by

-[selecta](https://github.com/garybernhardt/selecta),

-but with an improved [scoring algorithm](#sorting).

+A fast, simple fuzzy text selector for the terminal with an advanced [scoring

+algorithm](#sorting).

 ![](http://i.hawth.ca/u/fzy2.gif)

-> It's been kind of life-changing.

-> -[@graygilmore](https://github.com/graygilmore/)

+<blockquote>

+It's been kind of life-changing.

+-<a href="https://github.com/graygilmore/">@graygilmore</a>

+</blockquote>

-> fzy works great btw

-> -[@alexblackie](https://twitter.com/alexblackie/status/719297828892188672)

+<blockquote>

+fzy works great btw

+-<a href="https://twitter.com/alexblackie/status/719297828892188672">@alexblackie</a>

+</blockquote>

+

+[![Build Status](https://travis-ci.org/jhawthorn/fzy.svg?branch=master)](https://travis-ci.org/jhawthorn/fzy)

+

+## 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

@@ -9,6 +9,9 @@ but with an improved [scoring algorithm](#sorting).

 > It's been kind of life-changing.

 > -[@graygilmore](https://github.com/graygilmore/)

+> fzy works great btw

+> -[@alexblackie](https://twitter.com/alexblackie/status/719297828892188672)

+

 ## Installation

     $ make

@@ -6,6 +6,9 @@ but with an improved [scoring algorithm](#sorting).

 ![](http://i.hawth.ca/u/fzy2.gif)

+> It's been kind of life-changing.

+> -[@graygilmore](https://github.com/graygilmore/)

+

 ## Installation

     $ make

@@ -25,7 +25,7 @@ fzy can be integrated very simply in vim. There is also [fzy-vim](https://github

 ``` vim

 function! FzyCommand(choice_command, vim_command)

   try

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

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

   catch /Vim:Interrupt/

     " Swallow errors from ^C, allow redraw! below

   endtry

@@ -24,7 +24,11 @@ fzy can be integrated very simply in vim. There is also [fzy-vim](https://github

 ``` vim

 function! FzyCommand(choice_command, vim_command)

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

+  try

+    silent 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

@@ -48,10 +48,10 @@ nnoremap <leader>s :call FzyCommand("ag . --no-color -l -g ''", ":sp")<cr>

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

-It prefers matching the beginning of words: `amo` is likely to match <tt><b>a</b>pp/<b>m</b>odels/<b>o</b>rder.rb</tt>.

-

 It prefers consecutive characters: `file` will match <tt><b>file</b></tt> over <tt><b>fil</b>t<b>e</b>r</tt>.

+It prefers matching the beginning of words: `amp` is likely to match <tt><b>a</b>pp/<b>m</b>odels/<b>p</b>osts.rb</tt>.

+

 It prefers shorter matches: `abce` matches <tt><b>abc</b>d<b>e</b>f</tt> over <tt><b>abc</b> d<b>e</b></tt>.

 It prefers shorter candidates: `test` matches <tt><b>test</b>s</tt> over <tt><b>test</b>ing</b></tt>.

@@ -1,9 +1,8 @@

 # fzy

 A fuzzy text selector for terminals in C inspired by

-[selecta](https://github.com/garybernhardt/selecta)

-and

-[dmenu](http://tools.suckless.org/dmenu/)

+[selecta](https://github.com/garybernhardt/selecta),

+but with an improved [scoring algorithm](#sorting).

 ![](http://i.hawth.ca/u/fzy2.gif)

@@ -14,3 +13,46 @@ and

 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 integrated very simply in vim. There is also [fzy-vim](https://github.com/Dkendal/fzy-vim), a more fully featured vim plugin.

+

+``` vim

+function! FzyCommand(choice_command, vim_command)

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

+  redraw!

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

+    exec a:vim_command . ' ' . output

+  endif

+endfunction

+

+nnoremap <leader>e :call FzyCommand("find -type f", ":e")<cr>

+nnoremap <leader>v :call FzyCommand("find -type f", ":vs")<cr>

+nnoremap <leader>s :call FzyCommand("find -type f", ":sp")<cr>

+```

+

+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 <leader>e :call FzyCommand("ag . --no-color -l -g ''", ":e")<cr>

+nnoremap <leader>v :call FzyCommand("ag . --no-color -l -g ''", ":vs")<cr>

+nnoremap <leader>s :call FzyCommand("ag . --no-color -l -g ''", ":sp")<cr>

+```

+

+## Sorting

+

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

+

+It prefers matching the beginning of words: `amo` is likely to match <tt><b>a</b>pp/<b>m</b>odels/<b>o</b>rder.rb</tt>.

+

+It prefers consecutive characters: `file` will match <tt><b>file</b></tt> over <tt><b>fil</b>t<b>e</b>r</tt>.

+

+It prefers shorter matches: `abce` matches <tt><b>abc</b>d<b>e</b>f</tt> over <tt><b>abc</b> d<b>e</b></tt>.

+

+It prefers shorter candidates: `test` matches <tt><b>test</b>s</tt> over <tt><b>test</b>ing</b></tt>.

+

@@ -5,6 +5,8 @@ A fuzzy text selector for terminals in C inspired by

 and

 [dmenu](http://tools.suckless.org/dmenu/)

+![](http://i.hawth.ca/u/fzy2.gif)

+

 ## Installation

     $ make

@@ -5,3 +5,10 @@ A fuzzy text selector for terminals in C inspired by

 and

 [dmenu](http://tools.suckless.org/dmenu/)

+## Installation

+

+    $ make

+    $ sudo make install

+

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

+the default is `/usr/local`.

new file mode 100644

@@ -0,0 +1,7 @@

+# fzy

+

+A fuzzy text selector for terminals in C inspired by

+[selecta](https://github.com/garybernhardt/selecta)

+and

+[dmenu](http://tools.suckless.org/dmenu/)

+