SEL(1)

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 <thomas@darkstar.rhein-neckar.de>

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 <thomas@darkstar.rhein-neckar.de> as i'll try to fix it immediately.

COPYRIGHT
Copyright 1997, 1998 by Thomas Kluge. 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.