Skip to content

Troubleshooting

Jump to bottom
Patrick edited this page Feb 20, 2022 · 52 revisions

Default or custom key bindings do not work

  • Execute bind and check if there are bindings overriding the bindings starting with _fzf_search_.
  • Check your terminal's key bindings to see if it's intercepting the key binding (see #210 and #223).
  • Ensure jethrokuan/fzf and the Fish extension that ships with fzf are uninstalled.
  • Ensure you're using the minimum required version of fish.
  • In your terminal's settings, map Option to Meta (see #54).
  • Switch to a new terminal session (#168).

Search directory feature does not work

  • If you are on certain distribution of Linux, you will need to symlink fdfind to fd (see #93).
  • Similarly, on Debian-based distributions, you will need to symlink batcat to bat (see https://github.com/sharkdp/bat#installation).
  • fd, by default, ignores files also ignored by git. Check your local and global .gitignore files to see if the files not showing up have been ignored.
  • Ensure fdclone is not installed.

Unable to set custom FZF_DEFAULT_OPTS

Originally reported in #106. If you're getting this error set: Universal variable 'FZF_DEFAULT_OPTS' is shadowed by the global variable of the same name., try these steps:

  • close your current fish session, open a new shell, and checking if FZF_DEFAULT_OPTS is now the right value
  • use set --show FZF_DEFAULT_OPTS to determine what's overshadowing it
  • uninstall and reinstall the plugin

Search history command preview is missing colors

See https://github.com/fish-shell/fish-shell/issues/7855.

Unknown command: fzf_fish_custom_keybindings

You may have missed the v7 migration announcement. Follow the directions here to migrate.

Other text is being printed on top in fzf previews

Whenever fzf previews a file, it executes the preview command in a new instance of Fish. And whenever Fish starts up, it sources your config.fish and the config files of installed plugins. So, check all your config files to see if they are printing something. See https://github.com/PatrickF1/fzf.fish/discussions/182.

Custom fzf bindings to open file in another program not working

See https://github.com/PatrickF1/fzf.fish/issues/203.

Getting complete: Too many arguments, fzf_configure_bindings completions don't work

fzf.fish requires fish version >= 3.2.0. You are probably running a version pre-3.2.0. Double check your version by checking $version instead of fish --version. The reason is that it's possible for the fish on your PATH to be updated but your terminal be configured to open up a different, out-dated fish binary. This is especially the case on Ubuntu. See https://github.com/PatrickF1/fzf.fish/issues/226

Home

About

Help

Contributing

Clone this wiki locally