🍂 Fall

^{Fall with vim-glyph-pallet (Colors on glyphs) on NordFox (Vim's colorscheme)}

Fall is a fuzzy finder for Vim and Neovim, implemented in Denops, and stands for "Filter All."

See Features for more information about Fall's features.

Warning

This is a beta version. Please be aware that there might be backward-incompatible changes.

Requirements

Users must install Deno version 2.x. Additionally, the nerdfont renderer is enabled by default, so configure your terminal to use a NerdFont, or disable it by removing the builtin.renderer.nerdfont renderer from the custom file and use non builtin.theme.modern.MODERN_THEME theme (:FallCustom).

Note that Deno version 1.x is not tested and not supported.

Installation

To install Denops and this plugin using your preferred plugin manager, such as vim-plug, add the following lines to your Vim configuration:

Plug 'vim-denops/denops.vim'
Plug 'vim-fall/fall.vim'

Usage

Use the :Fall command to open the fuzzy finder. The command accepts the following arguments:

Fall {source} {source_args}...

For example, if you'd like to use the file source, you can use the following:

Fall file

Or use the line source with README.md as an argument:

Fall line README.md

Mappings

Users can view available mappings by pressing <F1> in the picker window. See the Mappings page for more details.

Configuration

In Fall, settings that utilize Vim’s built-in functionality are categorized as “Configuration.” This includes key mappings, highlights, and buffer option modifications.

Refer to the Configuration page on the GitHub Wiki for more details.

Customization

In Fall, settings written in TypeScript to enhance Fall’s functionality are categorized as “Customization.” These specifically refer to modifications made to the user customization file, which can be accessed via the FallCustom command.

Visit the Customization page on the GitHub Wiki for more information.

Related Projects

Repository	Package	Description
vim-fall/deno-fall-core	@vim-fall/core	Core types for Fall. Not meant for external use.
vim-fall/deno-fall-custom	@vim-fall/custom	Library to customize Fall.
vim-fall/deno-fall-std	@vim-fall/std	Standard library for using Fall.
vim-fall/deno-fall-extra	@vim-fall/extra	Extra library for using Fall.

Similar Projects

• ddu.vim
  A highly customizable and extensible fuzzy finder for Vim/Neovim written in Denops.
• telescope.nvim
  The de facto standard fuzzy finder for Neovim.
• ctrlp.vim
  A classic and famous fuzzy finder for Vim.

License

The code in this repository follows the MIT license, as detailed in LICENSE. Contributors must agree that any modifications submitted to this repository also adhere to the license.