SandR - Recursive Search and Replace Utility

Project Home
Project Summary
   User Guide
   Java regex

This User Guide is for version 2.5. Here are the User Guildes for the older versions:

  1. User Guide for 1.0
  2. User Guide for 2.0

SandR has a simple and intuitive interface.

To start, open command prompt on Windows or a terminal window on *nix:

  1. Download the jar file (latest, sandr_2.5.jar) into a directory /path/to/directory (C:\path\to\directory)
  2. Go to the directory: cd /path/to/directory (cd C:\path\to\directory)
  3. Start the program: java -jar sandr_2.5.jar
  1. Download the zip file (latest, into a directory /path/to/directory
  2. Go to the directory: cd /path/to/directory
  3. Unzip: unzip
  4. Start the program (only on *nix): ./bin/
    (On windows go to dist directory and double-click on sandr.jar file or use java -jar sandr.jar command on command prompt)

File/Directory: Textbox. Type the complete path (from root, e.g. / for *nix, C:\ for Windows etc.) of the topmost directory where you want to start the recursive searching. If you enter a file path, the search will be limited to that file only. The box can be populated via the Browse button.

Browse: Button. For convenience, you can select the directory or the file from a File Chooser by clicking the Browse button.

File Type (Wildcard OK): Textbox. Enter the type of file you want your operation to limit on. If you want to do operation on all types of file, put a * (asterisk). For all files with .txt extension, enter *.txt; for all files starting with r and ending with e, enter r*e and so on. You can enter multiple types sseparated by comma. E.g. if you want to limit you search to only html and php files, enter *.htm*,*.php.

File Encoding: Textbox. If you know the file encoding for ALL files, select it from the dropdown menu. But for most cases, it's best to leave it to "Guess".

Search String (can be Java style Regular Expression): Textbox. Type in your search string in this box. If it is a Java style Regular Expression, Check the Regular Expression checkbox. Note: Regular Expressions are for the Advanced Users.

Replace String: Textbox. Type in the string you want to replace the string in Search String box.

SandR 2.5 on Linux, while executing a search only operation

Recursive: Checkbox. Check this box if you want to do the search and replace in the subdirectories. By default, it is ON.

Search only: Checkbox. Check this box if you want to do only search. The full path of the files which contain the search string is printed in bottom window. By default, it is OFF.

Log: Checkbox. Check this box if you want to have a log of the operation. The log is created in the current directory. By default, this is OFF.

Backups (Will keep backups of the original files): Checkbox. Check this box if you want to keep backup of all files which are changed by this program. By default, this is OFF.

Go: Button. Click to start operation. The button becomes inactive while the operation is in progress. If you do not have Search only option ON and you have no string in the Replace String box, you will get an error when this button is pressed.

Cancel: Button. Click to stop operation. The button is only active when an operation is in progress.

Status Lines

  1. There is one status line which shows your selection of Recursion, Search only, Logging and Backups.
  2. There is one status line showing the file or the directory the program is searching. This status line comes only after the first search (and replace) operation has started.
  3. Another status line shows the number of directories and files processed and the number of files which contains the search string (seach hits). This line also comes only after the first operation has started.

Contact the developer at: s a m b i t b a s u @ y a h o o . c o m