https://github.com/ashish0kumar/fzfm
📂 fuzzy finder file manager
https://github.com/ashish0kumar/fzfm
Last synced: 4 months ago
JSON representation
📂 fuzzy finder file manager
- Host: GitHub
- URL: https://github.com/ashish0kumar/fzfm
- Owner: ashish0kumar
- Created: 2025-02-15T15:43:25.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-02-15T16:11:52.000Z (9 months ago)
- Last Synced: 2025-02-15T16:30:33.592Z (9 months ago)
- Language: Shell
- Homepage:
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-cli-apps-in-a-csv - fzfm - A command-line fuzzy finder file manager. (<a name="file-manager"></a>File manager)
README
fzfm
fuzzy finder file manager
---
## 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`](https://github.com/junegunn/fzf) - Core dependency, the entire file
manager is built around it
- [`eza`](https://github.com/eza-community/eza) - For enhanced directory listing
(fallback to `ls`)
- [`bat`](https://github.com/sharkdp/bat) - For file previewing (fallback to
`cat`)
- [`nvim`](https://github.com/neovim/neovim) - For text editing (fallback to
`nano`)
- A media opener like `wslview`, `xdg-open`, or `open`
- [Nerd Fonts](https://www.nerdfonts.com/) - For proper icon rendering in the
terminal
## Installation
1. Clone the repository:
```bash
git clone https://github.com/ashish0kumar/fzfm.git
cd fzfm
```
2. Optionally, move it to a directory in your `$PATH`:
```bash
mv fzfm ~/.local/bin/fzfm
```
## Usage
Run the script:
```bash
./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:
```bash
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!
© 2025-present Ashish Kumar
 Â