-2
Daily
9,599
stars
390
forks
61
watchers
1,104
prs
1,340
issues
42
releases
README
LF Doc | Wiki | lf:matrix.org (with IRC bridge) lf (as in "list files") is a terminal file manager written in Go with a heavy inspiration from ranger file manager. See faq for more information and tutorial for a gentle introduction with screencasts. !icons-and-border !image-preview !new-features Features - Cross-platform (Linux, macOS, BSDs, Windows) - Single binary without any runtime dependencies - Fast startup and low memory footprint due to native code and static binaries - Asynchronous IO operations to avoid UI locking - Server/client architecture and remote commands to manage multiple instances - Extendable and configurable with shell commands - Customizable keybindings (vi and readline defaults) - A reasonable set of other features (see the documentation) Non-Features - Tabs or windows (better handled by window manager or terminal multiplexer) - Builtin pager/editor (better handled by your pager/editor of choice) - Builtin commands for file operations (better handled by the underlying shell tools including but not limited to mkdir, touch, chmod, chown, chgrp, and ln) Installation See packages for community maintained packages. See releases for pre-built binaries. Building from the source requires Go. On Unix: bash env CGO_ENABLED=0 go install -trimpath -ldflags="-s -w" github.com/gokcehan/lf@latest On Windows cmd: cmd set CGO_ENABLED=0 go install -trimpath -ldflags="-s -w" github.com/gokcehan/lf@latest On Windows PowerShell: powershell $env:CGO_ENABLED = '0' go install -trimpath -ldflags="-s -w" github.com/gokcehan/lf@latest Usage After the installation lf command should start the application in the current directory. Run lf -help to see command line options. Run lf -doc to see the documentation. See etc directory to integrate lf to your shell and/or editor. Example configuration files along with example colors and icons files can also be found in this directory. See integrations to integrate lf to other tools. See tips for more examples. Contributing See contributing for guidelines.
Top issues
#1903Missing file update after move34 comments · 2025-02-03#2076[Feature request] Improved handling for error messages30 comments · 2025-08-05#1234`select` command not functioning as expected18 comments · 2023-05-10#84[Feature request] Expose menu drawing command18 comments · 2017-05-23#2581Sixels are not cleared properly inside tmux15 comments · 2026-05-11#1219Unexpected Space Added After First Unquoted '$' in CLI Commands15 comments · 2023-05-01#2440Limitation on replacing locale sort with custom sort.13 comments · 2026-03-17#1135[Feature request] Add `on-find` command (mimic `ranger`'s `find` command)12 comments · 2023-03-04
Discussions
#2741Change background transparency / blur1 comments · 2026-11-13#2729number column padding/gutter1 comments · 2026-10-31#2719Introducing issue forms 📋📋📋1 comments · 2026-10-26#2706Behavior differences with ranger2 comments · 2026-10-11#2686Can I make it not scroll to file when left/right clicking it1 comments · 2026-09-23#2673An easy way to hide file extension in view only?1 comments · 2026-09-01#2670Search and Filter by Custom Data1 comments · 2026-08-22#2641Borderfmt examples1 comments · 2026-07-12
Latest release
r42 r42 2026-07-31Changed - The key has been renamed to for map keybindings (2286). - .Stat.DirSize and .Stat.DirCount in the ruler file no longer have a pointer type, and will be set to -1 instead of nil if the corresponding value cannot be determined (2397). - setlocal commands no longer support the ability to specify recursive directories (2415). For use cases where setlocal should apply to a directory based on some condition, it is recommended to script this inside the on-load hook command. - On Windows, files are now considered executable according to PATHEXT when matching colors and icons (2448).