Troubleshooting

Table of contents

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

---

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.

---

Warning prompt

If using a Readline version prior to 7.0 (released almost 9 years ago) you might experience some glitches in the warning prompt.¹ As of now, there are two possible workarounds:

1. Remove the color codes from the WarningPrompt field, either in your prompts file (via prompt edit) or in the color scheme file (via cs edit) as follows:

#WarningPrompt="\[\e[00;02;31m\](!) > "
WarningPrompt="(!) > "

2. Install a newer version of the library (7.0 or newer is recommended).

For example, Solaris 10 ships readline-4.2, and Openindiana Hipster 2023.05 ships readline-6.3. To install readline-7.0 on any of these platforms follows these instructions:

a. Install the library:

pkgadd -d http://get.opencsw.org/now
/opt/csw/bin/pkgutil -U
/opt/csw/bin/pkgutil -y -i libreadline7
/usr/sbin/pkgchk -L CSWlibreadline7 # list files

b. Link the .so file to the corresponding libraries directory: ln -s /opt/csw/lib/amd64/libreadline.so.7 /usr/lib/64/libreadline.so.7

c. Compile against this library: gcc -o clifm *.c /usr/lib/64/libreadline.so.7 -ltermcap -lmagic ...

¹ These glitches, related to the rl_redisplay function, has been solved upstream in 7.0. See https://lwn.net/Articles/700983/