Troubleshooting

Key bindings do not work

• Execute bind and check if there are bindings overriding the bindings starting with _fzf_search_.
• 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 distrubutions, 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 option: --marker=*

See https://github.com/PatrickF1/fzf.fish/discussions/149

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.