logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

SEARCHMONKEY - search files using regular expressions aiming to replace find/grep tools

Advanced File Name And/Or Contents Searching

       To find files, using regular expressions can be achieved by filling out the File Name and Look In  boxes.
       The  starting  file  name  can  be typed, copied or selected by using the Open dialog. To search a single
       folder, uncheck the Search Subfolders box.

       If you want to find a specific regular expression within a text file, then fill out the  Containing  Text
       box  with  a  regular  expression. Note: significantly less files are shown when Containing Text is added
       because binary files are skipped.

       For a more specific search, add in min/max file size, and the after/before modified date (if known).

       Once ready, press Play to start the search process.

       Results (if any) immediately start appearing in the File name results table, and once complete the  total
       number of matches is shown in the status bar

Author

       This manual page was written by Varun Hiremath <varunhiremath@gmail.com>, for the Debian project (but may
       be used by others).

                                               September 12, 2006                                SEARCHMONKEY(1)

Context Results

       This pane is only filled when text matches are found, and a result has been selected.

       The  line  that  matches  the  search expression will be shown in full, and the actual match text will be
       highlighted. Once text has been selected with the left-button, the right button will allow copy  options,
       or  select-all  to  be  performed on the text. These allow text to be copied from the results window, and
       pasted elsewhere.

File Name Results

       This pane is only filled when matches are found.  Left clicking on a match will bring up content  matches
       (displayed in the Context Results pane, if any), and right-clicking the row will bring up a sub-menu.

   RightClickMenuOpen   Opens the file name in your preferred text editor. See configuration.

       Copy   Copies the full file name into the clipboard for use elsewhere.

       Delete
              Deletes the selected file forever, once confirmed.

       Explore
              Opens your preferred file browser that contains the selected file

Introduction

searchMonkey is a GTK+ application designed to replace the find/grep command line tools.  The aim of this
       utility it to provide fast, slick text search ability to the GTK community.

Name

       SEARCHMONKEY - search files using regular expressions aiming to replace find/grep tools

Searchmonkey User Guide Online

       To         view         the         same         guide         in         HTML        please        visit
       <http://searchmonkey.sourceforge.net/index.php/SearchMonkey_User_Guide>

Status Bar

       Describes what is currently going on.

           *  Phase  1  searching  is  the  gathering  of  files that match the filename, size and modified date
       criteria.

           * Phase 2 searching is the internal checking of text files to match the search strings.

           * Upon completion, the number of hits is displayed, along with whether this was an  inverse  filename
       search [inv] or [cancelled] by the user

The Options Tab

       Available at all times from the main screen.

       SpecifiesNotExpression
              Inverts the search i.e. finds everything except your regular expression. Status bar shows [INV] to
              indicate inverted.

       Matchcase
              When disabled allows case insensitive searching of file names and/or content.

       RegularExpression
              When selected allows regular expressions to be used.

       DOSExpression
              When selected allows file names to be found using DOS/Glob style pattern matching i.e. * and ?.

       Open/Multi
              Brings  up  a  folder  search  dialog.  Multi  allows  multiple  folders to be selected for expert
              searches.

       More/LessThan
              Type a file size (in KBytes) to narrow searches to  files  less-than  and/or  more-than  specified
              size.

       More/LessThan
              Type  a  date  expression  (e.g.  dd/mm/yyyy  or dd mmm yyyy) to narrow searches to files modified
              before and/or after specified date.

The Toolbar

       Can be hidden from the main-menu (view->toolbar).

       New    Starts a brand new search (losing previous search history).

       Open   Opens a previously saved search criteria.

       Save   Saves a search criteria (excluding the results).

       SaveResults
              Saves the results to a custom XML file. Only available when search complete.

       Play   Start the search.

       Stop   Stop the search. Only available when search in progress.

       Print
              Print the search results in a well formatted way.

       Forums
              Starts a new browser instance to the searchMonkey Forums

The User Interface

       This section describes every button, window, table and what it shows or does.

   FileMenuNew
              Starts a brand new search (losing previous search history).

       OpenCriteria
              Opens a previously saved search criteria.

       Close  Close a child criteria window, but not the main application.

       SaveCriteria
              Saves  a  search  criteria  (excluding  the  results).  SaveCriteriaAs     As Save Criteria, but
              brings up a save-as dialog.

       SaveResults
              Saves the results to a custom XML file. Only available when search complete.

       Print
              Print the search results in a well formatted way.

       PrintPreview
              Brings up a display of what would have been printed.

       PrintSetup
              Brings up the system's printer setup dialog.

   EditMenuWordWrap
              When selected, allow the results text to wrap instead of keeping to strict lines.

       SetFont
              Brings up a font dialog to adjust the results window base font.

       SetColor
              Brings up a color selection dialog to adjust the highlight colour for the match results.

       ClearHistory
              Remove search history from drop down criteria.

       SelectAll
              Selects all file name matches in the left results pane.

       Delete
              Deletes the selected file name(s) forever (once confirmed).

       Copy   Copies the selected file name(s) to clipboard.

   ViewMenuToolbar
              If selected, the tool bar is shown.

       StatusBar
              If selected, the status bar is shown.

       Sortby
              Within sub-menu, choose sort criteria e.g. file name, file size, modified date.

   SearchMenuStart
              Starts the search.

       Stop   Stops the search. Enabled when search is running.

       Onephasesearching
              Allows content matches to be displayed immediately, instead of waiting for all files to be found.

       Configuration
              Brings up application configuration dialog.

   TestMenuReg.Expression
              Allows a regular expression to be entered, along with sample text as a way of checking  that  your
              expression returns the expected results.

   WindowMenuSearchXX
              Allows quick switching between open search criteria/results windows.

       HelpMenu
              Description

       UserGuide
              Brings up this web address from your default browser

       Support
              Brings up the searchMonkey support page from Sourceforge

       About
              Brings up a dialog showing version number, license, and author's email.

Tips And Tricks

       This section gives examples of some cool things to do with searchMonkey.

   RegularExpressions
       Some examples of regular expressions are given here:

       (.[ch])$
              Finds all of the C source code, plus headers.

       ^(make)
              Finds every make file instance.

       ^(voidfunction_name)(;)$
              Finds a function declaration, as opposed to the definition

       \([a-zA-Z0-9\s]+\)
              Highlights all text within brackets

See Also