Skip to content

ashish0kumar/fzfm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

19 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

fzfm

fuzzy finder file manager

demo


Features

  • Navigate directories seamlessly using only your keyboard
  • Blazing-fast fuzzy search powered by fzf
  • File preview using bat (fallback to cat)
  • Directory preview using eza (fallback to ls)
  • Customizable multimedia file opener (wslview, xdg-open, etc.)
  • Fully configurable via environment variables

Dependencies

Ensure you have the following installed:

  • fzf - Core dependency, the entire file manager is built around it
  • eza - For enhanced directory listing (fallback to ls)
  • bat - For file previewing (fallback to cat)
  • nvim - For text editing (fallback to nano)
  • A media opener like wslview, xdg-open, or open
  • Nerd Fonts - For proper icon rendering in the terminal

Installation

  1. Clone the repository:

    git clone https://github.com/ashish0kumar/fzfm.git
    cd fzfm
  2. Optionally, move it to a directory in your $PATH:

    mv fzfm ~/.local/bin/fzfm

Usage

Run the script:

./fzfm  # or just `fzfm` if added to PATH

Key Bindings

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

Environment Variables

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

Contributions

Feel free to fork the repository, submit issues, or contribute improvements!

License

MIT License



Sponsor this project

  •  

Languages