fzf file manager
fzf filemanager
A file manager for the terminal, using fzf
.
Homepage: https://github.com/sc0ttj/fzf-filemanager
Screenshot
Features
- fast navigation
- sensible key bindings
- easy directory & file searching
- file previews of various types
- open selected file(s) in various programs, based on MIME type or extension
- integrated command prompt
Has 2 modes:
- filemanager: browse and select files and folders
- shellprompt: run commands on the current selection
This is a hack, not than a proper thing, don't expect too much.
Requirements
fzf
- used for filtering and choosing files & dirs
Optional:
exa
- used for listing dirs (supports.gitignore
, icons, ..)bat
- used for colourful file previewsfd
- used for Alt-C (finding lots of dirs, many levels deep)
Usage
Code: Select all
filemanager [-fs] [path/to/dir]
You can load fzf filemanager fullscreen (-fs
) and pass the directory to start in.
"file manager" mode
You can navigate around your files and folders, TAB to multi-select,
or ENTER to open current selection, ESC to clear your selection.
If you open one file, it's mime-type will be used to decide what to do.
If you open many files, and they're of the same type, they will all be
opened together in the same program (your preferred, editor, player, etc).
If you chose files of different types, they'll be opened one after the other.
Alternatively, you can TAB select multiple files and press !
to open the
"shellprompt" mode, where you can run any commands you like against the selection.
"shell prompt" mode
Here you can run commands on the "current selection" (the files/dirs you
chose using enter or tab, in the file manager).
You will see a long list of commands, type to filter them and choose the
command you want to run.
Hit enter to run the chosen command on each item in the "current selection".
Key bindings
Key bindings: all modes
- ! - enter/exit shell prompt mode
- ctrl-q - quit
Key Bindings: "filemanager" mode
Navigation:
- up/down - move up and down the file/dir list
- left - cd to
..
- right - cd into the current dir, or open the currently selected file(s)
- shift+up/down or page-up/page-down - move up and down, half a page at a time
- shift+left/right or ] and [ - scroll the preview panel up and down
Choosing items:
- enter or / - choose item
- tab - toggle item (multi select) and move down
- shift-tab - toggle item (multi-select) and move up
- escape - clear selection
File manager controls:
- shift+/ - (the
?
key) a help menu showing the controls - ctrl-l - toggle "long" (detailed) list view
- ctrl-h - toggle show/hide hidden files
- ctrl-p - toggle show/hide the preview panel
- alt-c - list & filter all dirs from
.
, hit enter tocd
into one
Searching
Just type stuff while in any dir to start filtering the list.
Key Bindings: "shell prompt" mode
- up/down - move up and down the command list
- shift+up/down - move up and down your command history
- tab - complete the selected command, in one go
- enter - choose and run the chosen command on the selected files/dirs
- ctrl-q - exit back to main prompt menu, or exit program
Contributing
Pull Requests welcome.
Just read the Issues page, pick one, fix it, issue a PR.
Also see the lines marked @TODO
, at the top of the script itself.