Skip to content

salman-abedin/faint

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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


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]