fzfm is a minimal and fast terminal-based file manager powered by fzf
,
written in Bash. It showcases how powerful fzf
can be, demonstrating
its potential beyond simple fuzzy finding. It allows you to navigate
directories, preview files and directories, and open them using your
preferred applications directly from the command line.
- Navigate directories seamlessly using only your keyboard
- Blazing-fast fuzzy search powered by
fzf
- File preview using
bat
(fallback tocat
) - Directory preview using
eza
(fallback tols
) - Customizable multimedia file opener (
wslview
,xdg-open
, etc.) - Fully configurable via environment variables
Ensure you have the following installed:
fzf
- Core dependency, the entire file manager is built around iteza
- For enhanced directory listing (fallback tols
)bat
- For file previewing (fallback tocat
)nvim
- For text editing (fallback tonano
)- A media opener like
wslview
,xdg-open
, oropen
- Nerd Fonts - For proper icon rendering in the terminal
-
Clone the repository:
git clone https://github.com/ashish0kumar/fzfm.git cd fzfm
-
Optionally, move it to a directory in your
$PATH
:mv fzfm ~/.local/bin/fzfm
Run the script:
./fzfm # or just `fzfm` if added to PATH
Key | Action |
---|---|
Up/Down Arrow |
Move selection up/down |
Enter / Right Arrow |
Open file/folder |
Shift + Up/Down |
Scroll preview |
Ctrl + R |
Refresh file list |
Customize behavior according to your system by setting the following:
export FZFM_MEDIA_OPENER="xdg-open" # Set preferred media opener
export FZFM_TEXT_EDITOR="nvim" # Set preferred text editor
export FZFM_LIST_COMMAND="eza" # Set directory listing command
export FZFM_PREVIEW_COMMAND="bat" # Set preview command
This project is open-source and licensed under the MIT License.
Feel free to fork the repository, submit issues, or contribute improvements!