dylanaraps/fff sits at 4.2k stars on GitHub, written primarily in Shell. 📁 A simple file manager written in bash.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Run make install inside the script directory to install the script.
El Capitan: make PREFIX=/usr/local install
Haiku: make PREFIX="$(finddir B_USER_NONPACKAGED_DIRECTORY)" MANDIR='$(PREFIX)/documentation/man' DOCDIR='$(PREFIX)/documentation/fff' install
OpenIndiana: gmake install
MinGW/MSys: make -i install
NOTE: You may have to run this as root.
NOTE:fff can be uninstalled easily using make uninstall. This removes all of files from your system.
CD on Exit
Bash and Zsh
# Add this to your .bashrc, .zshrc or equivalent.
# Run 'fff' with 'f' or whatever you decide to name the function.
f() {
fff "$@"
cd "$(cat "${XDG_CACHE_HOME:=${HOME}/.cache}/fff/.fff_d")"
}
Fish
# Add this to you config.fish or equivalent.
# Fish don't support recursive calls so use f function
function f
fff $argv
set -q XDG_CACHE_HOME; or set XDG_CACHE_HOME $HOME/.cache
cd (cat $XDG_CACHE_HOME/fff/.fff_d)
end
Usage
j: scroll down
k: scroll up
h: go to parent dir
l: go to child dir
enter: go to child dir
backspace: go to parent dir
-: Go to previous dir.
g: go to top
G: go to bottom
:: go to a directory by typing.
.: toggle hidden files
/: search
t: go to trash
~: go to home
e: refresh current dir
!: open shell in current dir
x: view file/dir attributes
i: display image with w3m-img
down: scroll down
up: scroll up
left: go to parent dir
right: go to child dir
f: new file
n: new dir
r: rename
X: toggle executable
y: mark copy
m: mark move
d: mark trash (~/.local/share/fff/trash/)
s: mark symbolic link
b: mark bulk rename
Y: mark all for copy
M: mark all for move
D: mark all for trash (~/.local/share/fff/trash/)
S: mark all for symbolic link
B: mark all for bulk rename
p: execute paste/move/delete/bulk_rename
c: clear file selections
[1-9]: favourites/bookmarks (see customization)
q: exit with 'cd' (if enabled).
Ctrl+C: exit without 'cd'.
Customization
# Show/Hide hidden files on open.
# (Off by default)
export FFF_HIDDEN=1
# Use LS_COLORS to color fff.
# (On by default if available)
# (Ignores FFF_COL1)
export FFF_LS_COLORS=1
# Directory color [0-9]
export FFF_COL1=2
# Status background color [0-9]
export FFF_COL2=7
# Selection color [0-9] (copied/moved files)
export FFF_COL3=6
# Cursor color [0-9]
export FFF_COL4=1
# Status foreground color [0-9]
export FFF_COL5=0
# Text Editor
export EDITOR="vim"
# File Opener
export FFF_OPENER="xdg-open"
# File Attributes Command
export FFF_STAT_CMD="stat"
# Enable or disable CD on exit.
# (On by default)
export FFF_CD_ON_EXIT=0
# CD on exit helper file
# Default: '${XDG_CACHE_HOME}/fff/fff.d'
# If not using XDG, '${HOME}/.cache/fff/fff.d' is used.
export FFF_CD_FILE=~/.fff_d
# Trash Directory
# Default: '${XDG_DATA_HOME}/fff/trash'
# If not using XDG, '${HOME}/.local/share/fff/trash' is used.
export FFF_TRASH=~/.local/share/fff/trash
# Trash Command
# Default: 'mv'
# Define a custom program to use to trash files.
# The program will be passed the list of selected files
# and directories.
export FFF_TRASH_CMD="mv"
# Favourites (Bookmarks) (keys 1-9) (dir or file)
export FFF_FAV1=~/projects
export FFF_FAV2=~/.bashrc
export FFF_FAV3=~/Pictures/Wallpapers/
export FFF_FAV4=/usr/share
export FFF_FAV5=/
export FFF_FAV6=
export FFF_FAV7=
export FFF_FAV8=
export FFF_FAV9=
# w3m-img offsets.
export FFF_W3M_XOFFSET=0
export FFF_W3M_YOFFSET=0
# File format.
# Customize the item string.
# Format ('%f' is the current file): "str%fstr"
# Example (Add a tab before files): FFF_FILE_FORMAT="\t%f"
export FFF_FILE_FORMAT="%f"
# Mark format.
# Customize the marked item string.
# Format ('%f' is the current file): "str%fstr"
# Example (Add a ' >' before files): FFF_MARK_FORMAT="> %f"
export FFF_MARK_FORMAT=" %f*"
Customizing the keybindings.
Keybindings
This is the list of full keybindings along with their default values. You only need to modify the keybindings that you'd like to change from the default. fff will run perfectly fine without any of these defined.
### Moving around.
# Go to child directory.
export FFF_KEY_CHILD1="l"
export FFF_KEY_CHILD2=$'\e[C' # Right Arrow
export FFF_KEY_CHILD3="" # Enter / Return
# Go to parent directory.
export FFF_KEY_PARENT1="h"
export FFF_KEY_PARENT2=$'\e[D' # Left Arrow
export FFF_KEY_PARENT3=$'\177' # Backspace
export FFF_KEY_PARENT4=$'\b' # Backspace (Older terminals)
# Go to previous directory.
export FFF_KEY_PREVIOUS="-"
# Search.
export FFF_KEY_SEARCH="/"
# Spawn a shell.
export FFF_KEY_SHELL="!"
# Scroll down.
export FFF_KEY_SCROLL_DOWN1="j"
export FFF_KEY_SCROLL_DOWN2=$'\e[B' # Down Arrow
# Scroll up.
export FFF_KEY_SCROLL_UP1="k"
export FFF_KEY_SCROLL_UP2=$'\e[A' # Up Arrow
# Go to top and bottom.
export FFF_KEY_TO_TOP="g"
export FFF_KEY_TO_BOTTOM="G"
# Go to dirs.
export FFF_KEY_GO_DIR=":"
export FFF_KEY_GO_HOME="~"
export FFF_KEY_GO_TRASH="t"
export FFF_KEY_REFRESH="e"
### File operations.
export FFF_KEY_YANK="y"
export FFF_KEY_MOVE="m"
export FFF_KEY_TRASH="d"
export FFF_KEY_LINK="s"
export FFF_KEY_BULK_RENAME="b"
export FFF_KEY_YANK_ALL="Y"
export FFF_KEY_MOVE_ALL="M"
export FFF_KEY_TRASH_ALL="D"
export FFF_KEY_LINK_ALL="S"
export FFF_KEY_BULK_RENAME_ALL="B"
export FFF_KEY_PASTE="p"
export FFF_KEY_CLEAR="c"
export FFF_KEY_RENAME="r"
export FFF_KEY_MKDIR="n"
export FFF_KEY_MKFILE="f"
export FFF_KEY_IMAGE="i" # display image with w3m-img
### Miscellaneous
# Show file attributes.
export FFF_KEY_ATTRIBUTES="x"
# Toggle executable flag.
export FFF_KEY_EXECUTABLE="X"
# Toggle hidden files.
export FFF_KEY_HIDDEN="."
Disabling keybindings.
You can't unset keybindings by making their value ''. What you need to do is change their value to off.
Example:
# KEY_GO_TRASH was bound to 't', now its unset.
export FFF_KEY_GO_TRASH="off"
# KEY_MKFILE is now set to 't' and its original
# keybinding is also unset 'f'.
export FFF_KEY_MKFILE="t"
Dealing with conflicting keybindings.
When rebinding a key in fff make sure you don't have two bindings with the same value. You can avoid this by setting the other conflicting key-binding to something else or by changing its value to off.
How to figure out special keys.
Below is a tiny script I've written which will tell you the exact value to use. It automates the deciphering of special key escape sequences to the exact value fff needs. Save this to a file and run it. Give it a key-press and it'll spit out the exact value needed.
No homepage URL was recorded for dylanaraps/fff in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How does dylanaraps/fff compare to other Developer Tools projects?
dylanaraps/fff is tracked by TopGit in the Developer Tools category, with 4.2k GitHub stars and written in Shell. Browse the Developer Tools topic page on TopGit to compare it against similar projects by stars and activity.
How many stars does dylanaraps/fff have?
dylanaraps/fff has 4.2k GitHub stars — refresh the page for the live number, or check github.com/dylanaraps/fff. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is dylanaraps/fff open source?
Yes — dylanaraps/fff ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/dylanaraps/fff.
What else is in the Developer Tools space?
dylanaraps/fff is tracked by TopGit under the Developer Tools category, alongside 4 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is dylanaraps/fff?
dylanaraps/fff (dylanaraps/fff) is a Shell project on GitHub. From the project's own README: 📁 A simple file manager written in bash.
Where do I read more about dylanaraps/fff?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/dylanaraps/fff is the definitive source.
Read full README in the tab above.
Curious whether fff is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about fff.