lf (as in "list files") is a terminal file manager written in Go with a heavy inspiration from ranger. Outstanding features are a fast startup and low memory footprint, a server/client architecture and high customization. Unlike ranger, some features like tabs or windows are intentionally not included and instead left to be handled by window manager or terminal multiplexer.
Install the package.
To start the application, launch a terminal and run
The default keybindings are similar to those of vim with some difference from rangers default.
Copy the default configuration at
~/.config/lf/lfrc to use as a template for further customization. Some common features are already included as comments in the configuration example. For more extensive configurations see the documentation. Useful configuration examples from the community can also be found on GitHub.
Tips and tricks
Transition guide (From ranger to lf)
For users who are already used to ranger as a file manager, moving to lf means less default features and a slightly different behavior. The lf project wiki includes a step by step guide on how to configure lf to add features and defaults from ranger.
Using rifle file opener
lf can use the file opener rifle which is included in thepackage.
Set an environment variable to automatically use rifle to open files in the related applications.
For editing file, you can also set your default editor:
To automatically preview contents from currently selected files, set a custom previewer script in lfrc. It is possible to add a wrapper for the
scope.sh script from ranger which serves as a good template for customization.
There are many other previewers that can be used with lf, see the lf wiki on GitHub.
While the default lf configuration only previews text files, using more complex preview parsers is somewhat dangerous. In case there is a vulnerability in a preview parser like pdftotext, it is possible to use this simple script to sandbox the previewer using:
#!/bin/bash set -euo pipefail ( exec bwrap \ --ro-bind /usr/bin /usr/bin \ --ro-bind /usr/share/ /usr/share/ \ --ro-bind /usr/lib /usr/lib \ --ro-bind /usr/lib64 /usr/lib64 \ --symlink /usr/bin /bin \ --symlink /usr/bin /sbin \ --symlink /usr/lib /lib \ --symlink /usr/lib64 /lib64 \ --proc /proc \ --dev /dev \ --ro-bind /etc /etc \ --ro-bind ~/.config ~/.config \ --ro-bind ~/.cache ~/.cache \ --ro-bind "$PWD" "$PWD" \ --unshare-all \ --new-session \ bash ~/.config/lf/preview.sh "$@" )
Set your previewer to the sandbox script and have your real preview script at
set previewer ~/.config/lf/previewSandbox.sh