sel1

Usage

Overview

sel displays a listing of files like a file-manager. You can move around using the arrow-keys and run a command given on the command-line on the selected file with the <RETURN> - key. If you've installed the terminfo- library delivered with ncurses, sel will use colors.

Options

Short Options can be combined and strings like -aflq are allowed. An option that requires an argument has to be the last option in the string and the argument must follow (-aflqm "*.c"). Available command line options are the following:

-a

Ask before executing a command

-b headline

Text-string to display as headline. This might be useful when you use sel as file-selector in a shell-script to tell the user what to do. Use inverted commas, for example -b "Choose filename".

-c command

Command to execute. '%' will be replaced by selected entry. You will need to set this command into "" if it consists of more than one word, e.g. "ls -l"

-C Filename-Substitutor (default is "%")

-d path

Start directory

-f

Use complete (absolute) filename with full path in executed commands

-h

Display some help about availiable commandline-options

-l

Long file-listing with uid, gid, size, date and permissions

-m mask

Filemask to limit the display to a certain group of files. For example, -m "*.c" displays only your c-sources. Don't forget the inverted commas ("") to protect the mask from the shell!

-t type

File-type filter-string. Combinations such as -t fdl are allowed. The following filetypes are availiable:

f

regular file

d

directory

l

symbolic link

b

block device

c

character device

p

named pipe (FIFO)

s

socket

-w

Wait after executing a command

-s

Blank screen before executing a command

-q

Quit after executing a command

-u

Update directory after executing a command

--no-tagging

Don't allow tagging of files

--no-command-entry

Don't allow changing the command to be executed

--color-status_fg color-value

Set foreground-color of statusline. See list of availiable color-values below.

--color-status_bg color-value

Set background-color of statusline. See list of availiable color-values below.

--color-pointer-fg color-value

Set foreground-color of pointer. See list of availiable color-values below.

--color-pointer-bg color-value

Set background-color of pointer. See list of availiable color-values below.

--color-backgnd-fg color-value

Set background-color of file-list. See list of availiable color-values below.

--color-backgnd-bg color-value

Set foreground-color of file-list. See list of availiable color-values below.

--color-msg-fg color-value

Set foreground-color of warnings. See list of availiable color-values below.

--color-msg-bg color-value

Set background-color of warnings. See list of availiable color-values below.

--color-backgnd-tag-fg color-value

Set foreground-color of tagged file. See list of availiable color-values below.

--color-backgnd-tag-bg color-value

Set background-color of tagged file. See list of availiable color-values below.

--color-pointer-tag-fg color-value

Set foreground-color of tagged pointer. See list of availiable color-values below.

--color-pointer-tag-bg color-value

Set background-color of tagged pointer. See list of availiable color-values below.

Availiable color-values are:

black

red

green

yellow

blue

magenta

cyan

white

Keyboard commands

While running sel, you can use the following keyboard-commands. When there is listed more than one keystroke, you can choose one of them.

Enter

Select an entry and execute command. If selected entry is a directory, cd there

Blank

Select an entry and execute command. Don't cd to directories but execute command on it

+

Tag marked file

-

Untag marked file

*

Select all files

#

Unselect all files

!

Invert Selection

x

Run command on tagged files (file by file)

X

Run command on tagged files (all in a single run)

c

Enter a new command

C

Enter a new character as filename-substitution (default %)

Left

cd ..

Right

cd to selected directory, no reaction on selected files

Up p

One up (previous entry)

PageUp P

One page up (previous page)

Down n

One down (next entry)

PageDown N

One page down (next page)

t

Jump to the top

b

Jump to the bottom

d

Go back to start-directory

r

Return to last directory

R

Change to root-directory

H ~

Go to your home-directory

U

Update current directory immediately

/

Find file (Simple Substring search)

a

Toggle ask before executing a command (Default off)

l

Toggle long/short listing (Default short)

Q

Toggle exit after executing a command (Default off)

s

Toggle blank screen before executing a command (Default off)

u

Toggle update directory after executing a command (Default off)

w

Toggle wait after executing a command (Default off)

h

Show help

?

Display current settings

q

Exit sel

Return codes

0

Ok, executed the given command

1

Ok, leaving without having executed the command (hit q)

10

Ooops, internal error

11

Terminal error

20

Commandline-error

30

Error initializing signal-handler