faint: Extensible TUI fuzzy file explorer

faint is a fuzzy file explorer for the CLI that supports various extensible features.

Features

• Fuzzy Finding & Depth Searching.

• Custom Operations

• Custom Launch Behaviors

• Filters & Hidden Files

• Bookmarking

• Multiple Instances

Dependencies

• fzf
• fd
• xdotool
• diff, sort, sed, pkill & awk
• setsid (Optional; For better launching experience)
• hulk (Optional; For bulk moving/renaming)

Installation

Git

git clone https://github.com/salman-abedin/faint.git && cd faint && make && sudo make install

AUR

yay -S --noconfirm faint
# Or
yay -S --noconfirm faint-git # Nightly

Commands

Command	Effect
faint	Explore current directory
faint <PATH>	Explore specified directory
faint -l	Explore last visited directory

Functions

# Leaves on the last visited directory (Recommended as default)
faint(){
    faint
    read -r faint_last_dir < ~/.local/share/faint/FAINT_FINAL
    cd "$faint_last_dir" || exit
}

Default Bindings

Navigation

Key	Effect
;	cd into directory/launch file + resets query & position
:	Launches file without resetting the query & position
,	Changes directory backward
enter	Drops down to shell on the current directory
esc	Clears the query / quits the program
tab	Navigates down
btab	Navigates up

List

Key	Effect
.	Toggles filtered files visual
>	Toggles hidden files visual
=	Increases max depth
-	Decreases max depth
_	Resets max depth
<	Refreshes the list

Operations

Key	Effect
]	Toggles mark down
[	Toggles mark up
\	Toggles mark All
space	Launches operations menu for the marked files

Bookmarks

Key	Effect
'	Launches bookmark browser / Remove selected bookmark
"	Adds current directory to bookmark list

Modifications

• Consult the ~/.config/faintrc for all your modifications need

Update

Git

cd faint
git pull rebase && sudo make install

AUR

yay -Syu --noconfirm

Uninstallation

cd faint
sudo make uninstall

Contributors

• orhun ( AUR package maintainer)
• NICHOLAS85

---

Shameful Plug

Name	Description
devour	X11 window swallower
bolt	The launcher wrapper
uniblocks	The status bar wrapper
tide	Minimal Transmission CLI client
puri	Minimal URL launcher
Magpie	The dotfiles
Alfred	The scripts

---

Contact

SalmanAbedin@disroot.org