--- name: "sel" section: "1" platform: "linux" package: "sel" version: "0.08.4-2" release: "Debian 3.1 (Sarge)" platforms: ["linux"] url: "https://new.carta.tech/sel" --- # sel(1) Fullscreen file-selection and execution tool ## 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 \ - 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 \ 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 \ 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.