quickClip v0.4 Copyright (c) 1994-2006 Karl J. Runge quickClip: an X-windows Selection Clipboard Usage: quickClip [-G geom] [-S|-s] [-C] [-P] [-N] [-|file] Description: ------------ quickClip is an X selection clipboard with many features. It is meant to be convenient: when invoked it will automatically grab the current X-selection and place it in its TextArea (or use the X-clipboard if the selection is empty). This is in contrast to "xclipboard" where once started one must paste in the selection with the mouse. It is useful to bind the launching quickClip to easily executed keystrokes or mouse events so one can very quickly capture X-selections for later use. For example, one can bind it to a button press on a toolbar (e.g. GoodStuff in fvwm), or to "window-ops" popup menus, and/or mouseless, keystroke-only window-manager invocation, an editor macro, etc. Unlike "xclipboard's" multiple pages, all the selections are simply kept in a single TextArea. To have separate multiple selections start up additional "quickClip's". Features: --------- Here are the main buttons/features: Append Append a selection to bottom of Clipboard TextArea. Printing lpr, Enscript -bg -hp, or arbitrary filter. ("fmt" gives formatting with /bin/fmt) Save To file, append to file, or to pipe cmd. Rename window Change wm title. (under Etc...) Read Read in text from a file. (under Etc...) Find Search fwd/bwd for patterns in the selection. Select Quickly grab all of selection in TextArea. Copy Quickly grab selected text in TextArea. Clear Clean out the TextArea. ? This help. Quit Exit quickClip. Starting: --------- If started with no command line arguments, quickClip will attempt to capture the current X-selection (PRIMARY only, CUT_BUFFERS are currently not handled), and display it in its text widget (referred to here as the TextArea). If there is no current selection, the TextArea is initially empty. If started with an argument "-" it reads all of its standard input and displays it in the TextArea. If a file name is given on the command line, the text from that file is displayed in the TextArea. Options: -------- -f use file as the start file -G use geometry -S,-s select (highlight) the initial text -C try X-cutbuffer first (rather than X-selection and then X-clipboard) -P try X-clipboard first -N append with an extra newline. Basic Bindings: --------------- Append current X-selection. Print dialog. Save dialog. Find dialog. Select all text in TextArea. Clear TextArea. This help. Quit. Quit. Appending: ---------- Click the "Append" button or press to append the current X-selection to the bottom of the TextArea. The TextArea is scrolled to the bottom to make the added text visible. If you press the Right Button (Button3) on "Append", then that will try the cutbuffer first, rather than the selection. -C reverses all of this. If you press the Middle Button (Button2) on "Append", then that will append the CLIPBOARD selection. Printing: --------- Clicking the "Print" button or pressing starts up a Print dialog. The current contents of the TextArea will be sent to various filters. You can type an arbitrary filter command in the EntryBox, either "|command" or just "command". Then click "Filter" or press . The text is piped to that command. Click the "lpr" button to pass the Text to the line printer. Click the "Enscript" button to pass the Text to "Enscript -bg -hp". (two columns rotated output). Click the "X" button to terminate the Print dialog. Pressing when in the EntryBox (NOT TextArea) also terminates it. To filter text (say, before printing it) instead of "| " use "! " (exclamation point) or "text | ", then the contents of the TextArea is filtered by that command and replaced. No printing is done. Some filter examples: ! Xvi (vi pipe) ! sed -e "s/> //" (beware of single quotes) There are currently many hacks under Print. Including 1 column enscripting ("1" buttons), new printer "Deskjet" (Enscript -bg -dj), passing it to the "letter" program (letter -n). The "fmt" button filters fmt(1) and replaces the text and "tbl" does the same with debtl. No printing for these two. Saving: ------- Clicking the "Save" button or pressing starts up a Save dialog. The current contents of the TextArea will be saved. Type in the name of a file in the EntryBox. c-shell like file completion may be used: press to get a list of file/directory alternatives (Click the one you want), or press or to complete the filename until it is ambiguous. Then click the "Save" button to save to the filename in the EntryBox. Pressing has the same effect. The file will be overwritten; click the "Append" button to append to that filename. Click the "Etc..." button for even more actions: Enter a new window manager title name in the EntryBox and click "Title" to set the window title. Or Enter filename in the EntryBox and click the "Read" button to append the contents of that file to the TextArea. Click the "X" button to terminate the Save dialog.Pressing when in the EntryBox (NOT TextArea) also terminates it. Searching: ---------- Clicking the "Find" button or pressing starts up a Find dialog. The current contents of the TextArea can be searched. Type in the pattern to search for in the EntryBox. Then click the "Forward" button or press to search forward through the TextArea. Matches are highlighted in yellow. Pressing searches forward. Or click the "Back" button or press to search backward through the TextArea. Matches are highlighted in yellow. Click the "X" button to terminate the Find dialog. Pressing when in the EntryBox (NOT TextArea) also terminates it. Note that the cursor is usually at the bottom of the TextArea so it may be best to search backwards. Selecting: ---------- Click the "Select" button or press to select all of the text in the TextArea. Press to deselect it all. Selecting other text in any application will also remove the selection. Clearing: ---------- Click the "Clear" button or press to remove all text from the TextArea. ?: -- Clicking the "?" button displays this help. Quitting: --------- Click the "Quit" button or press or to Misc. Features: --------------- In the TextArea, if you click Mouse button 1 while holding down , this will spawn a new quickClip process that will grab the current X selection. Starting with "-S" will initially highlight and export the selection. TextArea Bindings: ------------------ Up a page Down a page Up 1/2 a page Down 1/2 a page Up a line Down a line Cursor up a line Cursor down a line Start a new quickClip Insert selection at mouse Insert selection at cursor Delete selected text Cycle backward one buffer Cycle forward one buffer (N.B. when two or more keypresses are noted, e.g. , it means you can press either one to get the action, not both in succession) EntryBox Bindings: ------------------ Clear EntryBox. Insert selection into EntryBox. In Print Dialog: Pass all text through filter in EntryBox. End Print dialog. Insert | mailx -s "" into EntryBox. In Save Dialog: Save all text to file in EntryBox. Append all to file in EntryBox. Insert | mailx -s "" into EntryBox. Set window title to text in EntryBox. and Filename Completion (expand non-ambiguous). Filename Completion (list of possibilities) (select with Mouse or press ) End Save dialog. In Save/Etc Dialog: Set window title to text in EntryBox. Read file in EntryBox, append to TextArea. (File Completion as under Save) End Save/Etc dialog. In Find Dialog: Search forward for match of string in EntryBox. Search backward for match of string in EntryBox. End Find dialog.