Troubleshooting

Table of contents

• General considerations
• Icons
• Keybindings
• Image previews
• FZF

---

General considerations

Issues may steam from different sources: a configuration conflict, your environment, or, finally, clifm itself.

1. Configuration

If you ever run into issues, it is recommended to run in stealth mode (clifm -S), so that clifm runs with default values skipping all configuration files. If the issue is gone, you most likely have a configuration problem. In this case (once running again in normal mode), you can run config dump to list settings and their current values, highlighting those differing from default values.

Instead of running in stealth mode, you can also run under a new profile (for example, clifm -P testing), regenerating thus all configuration files.

As a last resource, you can also generate a fresh config file via the config reset command (a backup of the old config file is created, in case you want to revert changes).

2. Environment

Your system environment can be sometimes a source of issues. To make sure your current issue is not related to your environment, run clifm in secure environment mode (clifm --secure-env-full). If the issue is gone, you need to troubleshot your environment.

3. Give us a call

If the issue persists, you can always open a new issue.

---

Icons

You most likely need to install an emoji fonts package. See the icons section.

---

Keybindings

Consult the keybindings section.

---

Image previews

Issues are normally caused by some missing dependency. Consult the image previews section and the description page of the fzfnav-BFG plugin.

---

FZF

Consult the TAB completion page.