Code Monkey home page Code Monkey logo

faint's Introduction

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]

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.