textselect.1

.TH textselect 1 "2024-08-07" "textselect 0.1" "User Commands"
.SH NAME
textselect \- Interactively select lines from a text file and optionally execute a command with the selected lines.
.SH SYNOPSIS
.B textselect
.RB [ \-hnv0 ] 
.RB [ \-o \ output ]
.I input
.I [command [args...]]
.SH DESCRIPTION
.B textselect
allows users to interactively select lines from a text file. The selected lines can be saved to an output file or passed to a command for execution.
.SH OPTIONS
.TP
.B \-h
Display this help message and exit.
.TP
.B \-n
Keep empty lines which are not selectable.
.TP
.B \-o \fIoutput\fR
Specify an output file to save the selected lines.
.TP
.B \-v
Invert the selection of lines.
.TP
.B \-0
Print selected lines delimited by a NUL-character
.SH NAVIGATION AND SELECTION KEYS
.TP
.B UP, LEFT
Move the cursor up.
.TP
.B DOWN, RIGHT
Move the cursor down.
.TP
.B v
Invert the selection of lines.
.TP
.B SPACE
Select or deselect the current line.
.TP
.B ENTER, q
Quit the selection interface.
.SH EXAMPLES
.TP
.B textselect input.txt
most simple example, select couple lines from a text-file and print it to the terminal afterwards
.TP
.B textselect -o output.txt
select couple lines from a text-file and save it to a text-file
.TP
.B textselect input.txt lolcat
select couple lines from a text-file and pass these to `lolcat` for some funny output
.TP
.B textselect <(xbps-query -l)
select couple lines from a command and print it to the terminal afterwards (choosing from installed packages in Void Linux)
.TP
.B textselect <(xbps-query -m) xargs xbps-remove
select couple lines from a command and execute command with lines as arguments (removing unnecessary packages in Void Linux)
.SH SEE ALSO
.BR xargs (1),
.SH AUTHOR
Written by Friedel Schon.
.SH BUGS
Issue bugs at https://github.com/friedelschoen/textselect.