Skip to content

rcmdnk/shell-explorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 

Repository files navigation

shell-explorer

File explorer with preview, made with shell script.

shell-explorer

Installation

On Mac, you can install the script by Homebrew:

$ brew install rcmdnk/rcmdnkpac/shell-explorer

You can also use an install script on the web like:

$ curl -fsSL https://raw.github.com/rcmdnk/shell-explorer/install/install.sh| sh

This will install scripts to /usr/bin and you may be asked root password.

If you want to install other directory, do like:

$ curl -fsSL https://raw.github.com/rcmdnk/shell-explorer/install/install.sh|  prefix=~/usr/local/ sh

Or, simply download the script and set where you like.

⚠️ Install sentaku, too if you download directly.

Usage

Start shell-explorer

Explore current directory:

$ se

Start from given directory:

$ se $HOME/my_dir/

Give the list from stdin:

$ echo file1 file2 file3|se

Show the content of the file in the right (give -r if SENTAKU_CONTENT_SHOW is set to other than 1.):

$ se

shell-explorer-right

Show the content of the file under the list:

$ se -u

shell-explorer-under

If you don't want to show preview, use -n.

Help:

$ se -h

Usage: ex_explorer.sh [directory] [-aruvC]

Arguments:
   -a         Show hidden files/directories.
   -r         Show file content in the right.
   -u         Show file content under the list.
   -d         Show contents of the directory.
   -D         Do not show contents of the directory.
   -n         No preview.
   -C         No confirmation at deletion.
   -h         print this help and exit.

Usage during explorer

  • sentaku actions (vim like movement, emacs like movement):
Key Action
n(any number) Set number. Multi-digit can be used (13, 320, etc...). Used/reset by other key.
k/j, C-p/C-n Up/Down (if n is given, n-th up/n-th down).
gg/G Go to top/bottom. (If n is given, move to n-th candidate.)
C-a/C-e Go to the beggining/end.
C-u/C-d Half page down/Half page down.
C-b/C-f Page up/Page down.
M-v/C-v Page up/Page down.
C-i/C-o Move the item up/down.
q, C-x Quit.
Space Select/unselect current line for multi-selection. At Emacs mode or search mode in Vim mode, it selects when space is pushed twice.
C-s Start/Stop Visual mode (multi-selection).
v Visual mode.
Esc At search mode, first Esc takes it back to normal mode with selected words. Second Esc clear search mode. Visual mode is cleared by first Esc.
/ Search.
  • shell-explorer actions:
Key Action
l Show contents of selected files with $VISUAL (or less).
e Edit selected files with $EDITOR (or vi).
s Show details of selected items with ls -l.
d Delete selected items.
p Exit and print selected items' full paths.
c Change to a directory under the cursor. (No action for a file.)
Enter If an item under the cursor is a directory, move to it. Otherwise same as l.

Environment Variables

Name Description Default
SENTAKU_CONTENT_SHOW 0: No preview, 1: Preview in the right (-r), 2: Preview under the list (-u) 1
SENTAKU_SHOW_DIRECTORY_CONTENT 0: No preview for a directory. 1: Show directory content as preview. 1
SENTAKU_FILE_CONTENT_LINES Number of lines of content to be shown. (Only for -u mode) 10
SENTAKU_EDITOR Editor to be used by e. $EDITOR (or vi if $EDITOR is not set)
SENTAKU_VISUALAPP Viewer to be used by l $VISUAL (or less if $VISUAL is not set)
SENTAKU_CONFIRM If 1, se will ask a confirmation at deletion. 1
SENTAKU_START_DIR= Starting directory in case of no files/directories inputs. Current direcotry (.)

About

File explorer made with shell script。

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages