sel(1) · carta

NAME

sel - Fullscreen file-selection and execution tool

SYNOPSIS

sel [ options ] [ File-list ]

DESCRIPTION

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

AUTHOR

Thomas Kluge <[email protected]>

Web-Site: http://www.rhein-neckar.de/~darkstar/

BUGS

That's alpha-software, so be warned that there may still be bugs. Be sure to have it tested carefully before you use it to submit "dangerous" commands like rm, mv, chmod etc. If you find a bug, please report it to <[email protected]> as i'll try to fix it immediately.

COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.