🥾 walk

Walk — a terminal navigator; a cd and ls replacement.

Run lk, navigate using arrows or hjkl. Press, esc to jump to a new location; or ctrl+c to stay.

Install

brew install walk

pkg_add walk

go install github.com/antonmedv/walk@latest

curl https://raw.githubusercontent.com/antonmedv/walk/master/install.sh | sh

Or download prebuild binaries.

Setup

Put the next function into the .bashrc or a similar config:

function lk {
  cd "$(walk "$@")"
}

function lk
  set loc (walk $argv); and cd $loc;
end

function lk() {
  cd $(walk $args)
}

Now use lk command to start walking.

Features

Preview mode

Press Space to toggle preview mode.

Delete file or directory

Press dd to delete file or directory. Press u to undo.

Display icons

Install Nerd Fonts and add --icons flag.

Image preview

No additional setup is required.

Usage

| Key binding | Description | |--------------------------------------|--------------------| | arrows, hjkl | Move cursor | | shift + arrows | Jump to start/end | | enter | Enter directory | | backspace | Exit directory | | space | Toggle preview | | esc, q | Exit with cd | | ctrl + c | Exit without cd | | / | Fuzzy search | | d, delete | Delete file or dir | | y | yank current dir | | . | Hide hidden files |

Configuration

The EDITOR or WALK_EDITOR environment variable used for opening files from the walk.

export EDITOR=vim

To specify a command to be used to open files per extension, use the WALKOPENWITH environment variable.

export WALKOPENWITH="txt:less -N;go:vim;md:glow -p"

The WALKREMOVECMD environment variable can be used to specify a command to be used to remove files. This is useful if you want to use a different command to remove files than the default rm.

export WALKREMOVECMD=trash

Change main color with WALKMAINCOLOR environment variable. Available colors are here.

export WALKMAINCOLOR="#0000FF"

Use WALKSTATUSBAR environment variable to specify a status bar program.

export WALKSTATUSBAR="Size() + ' ' + Mode()"

Flags

Flags can be used to change the default behavior of the program.

| Flag | Description | |-----------------|-----------------------------| | --icons | Show icons | | --dir-only | Show dirs only | | --hide-hidden | Hide hidden files | | --preview | Start with preview mode on | | --with-border | Show border in preview mode | | --fuzzy | Start with fuzzy search on |

Related

• fx – terminal JSON viewer
• howto – terminal command LLM helper
• countdown – terminal countdown timer

License

MIT