Awesome Open Source
Awesome Open Source

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
  • find, 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

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


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

[email protected]


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
shell (10,409
fuzzy-search (51
fuzzy-matching (21