Question 1

How do I build a custom fzf picker with nvim-fzf?

Accepted Answer

Write a Lua function that uses the fzf API, wrap it in a coroutine, and call it with your data. For instance, use fzf.fzf with a table of strings or a shell command, and add previews via the action API for interactive elements.

Question 2

nvim-fzf vs fzf.vim: which should I use?

Accepted Answer

Choose nvim-fzf if you need custom Lua integrations with asynchronous previews and actions, like live buffer previews. Use fzf.vim for ready-made Vim commands without coding, as it provides out-of-the-box functionality.

Question 3

How to handle live previews of Neovim buffers in nvim-fzf?

Accepted Answer

Use the action API, such as require("fzf.actions").action, to define a Lua function that returns buffer lines. Pass this as a --preview argument in fzf calls, as shown in the buffer picker example.

Question 4

Can I reuse my existing fzf config with nvim-fzf?

Accepted Answer

Yes, nvim-fzf inherits environment variables like $FZF_DEFAULT_OPTS, so your global fzf settings apply. However, command-line arguments in the API override them for fine-grained control.

Question 5

What are the common pitfalls when using nvim-fzf asynchronously?

Accepted Answer

Forgetting to wrap calls in coroutines can cause errors, and mishandling callbacks in action functions might lead to unresponsive UI. The README warns about this and provides examples using coroutine.wrap.

Question 6

How to customize the floating window colors in nvim-fzf?

Accepted Answer

Set the window_on_create option in fzf.default_options to a function that adjusts winhl, such as vim.cmd("set winhl=Normal:Normal"), to match your Neovim theme's background.

nvim-fzf

What is nvim-fzf?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions