textselect

Interactively select lines and pipe it to a command
Log | Files | Refs | README | LICENSE

textselect.1 (1828B)


      1 .TH textselect 1 "2024-08-07" "textselect 0.1" "User Commands"
      2 .SH NAME
      3 textselect \- Interactively select lines from a text file and optionally execute a command with the selected lines.
      4 .SH SYNOPSIS
      5 .B textselect
      6 .RB [ \-hnv0 ] 
      7 .RB [ \-o \ output ]
      8 .I input
      9 .I [command [args...]]
     10 .SH DESCRIPTION
     11 .B textselect
     12 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.
     13 .SH OPTIONS
     14 .TP
     15 .B \-h
     16 Display this help message and exit.
     17 .TP
     18 .B \-n
     19 Keep empty lines which are not selectable.
     20 .TP
     21 .B \-o \fIoutput\fR
     22 Specify an output file to save the selected lines.
     23 .TP
     24 .B \-v
     25 Invert the selection of lines.
     26 .TP
     27 .B \-0
     28 Print selected lines delimited by a NUL-character
     29 .SH NAVIGATION AND SELECTION KEYS
     30 .TP
     31 .B UP, LEFT
     32 Move the cursor up.
     33 .TP
     34 .B DOWN, RIGHT
     35 Move the cursor down.
     36 .TP
     37 .B v
     38 Invert the selection of lines.
     39 .TP
     40 .B SPACE
     41 Select or deselect the current line.
     42 .TP
     43 .B ENTER, q
     44 Quit the selection interface.
     45 .SH EXAMPLES
     46 .TP
     47 .B textselect input.txt
     48 most simple example, select couple lines from a text-file and print it to the terminal afterwards
     49 .TP
     50 .B textselect -o output.txt
     51 select couple lines from a text-file and save it to a text-file
     52 .TP
     53 .B textselect input.txt lolcat
     54 select couple lines from a text-file and pass these to `lolcat` for some funny output
     55 .TP
     56 .B textselect <(xbps-query -l)
     57 select couple lines from a command and print it to the terminal afterwards (choosing from installed packages in Void Linux)
     58 .TP
     59 .B textselect <(xbps-query -m) xargs xbps-remove
     60 select couple lines from a command and execute command with lines as arguments (removing unnecessary packages in Void Linux)
     61 .SH SEE ALSO
     62 .BR xargs (1),
     63 .SH AUTHOR
     64 Written by Friedel Schon.
     65 .SH BUGS
     66 Issue bugs at https://github.com/friedelschoen/textselect.
     67