# Find & Replace It! - Installation Instructions

## Supported Platforms

Here is a list of supported platforms:

- Windows:
  - Windows 2000 [not tested]
  - Windows XP [partially tested]
  - Windows Vista [not tested]
  - Windows 7 (32-bit and 64-bit)
  - Windows 8 (32-bit and 64-bit) [partially tested]
  - Windows 8.1 (32-bit and 64-bit) [partially tested]
  - Windows 10 (64-bit) [partially tested]
- Mac OS X Intel:
  - Mac OS X 10.5 "Leopard" [not tested]
  - Mac OS X 10.6 "Snow Leopard" [not tested]
  - Mac OS X 10.7 "Lion" [not tested]
  - Mac OS X 10.8 "Mountain Lion" (64-bit)
  - Mac OS X 10.9 "Mavericks" (64-bit)
  - Mac OS X 10.10 and 10.11 (64-bit) [there are some known issues with the look and feel]
  - macOS 10.12 to 10.14 (64-bit) [there are some known issues with the look and feel]
- Linux:
  - Ubuntu 14.04 (32-bit and 64-bit)
  - Most of the recent Linux distributions (32-bit and 64-bit): Ubuntu 10.04 and up, Kubuntu 10.04 and up, Fedora 13 and up, OpenSUSE 11.2 and up, etc. [not tested]

NOTES:

- The PowerPC architecture support has been dropped since version 1.4.0 of Find & Replace It!. You can still download version 1.3.3 (Universal Binary) on our website.
- The support for Mac OS X 10.4 has been dropped since version 1.4.0 of Find & Replace It!.
- The official support for Mac OS X 10.5 has been dropped since version 2.0.5 of Find & Replace It! (2012-05-14). Older versions might contain bugs, but there will be no fix for them on that platform.
- The official support for Mac OS X 10.6 and Mac OS X 10.7 has been dropped since version 2.3.1 of Find & Replace It! (2015-03-30). Older versions might contain bugs, but there will be no fix for them one those platforms.
- Since version 2.3.1 of Find & Replace It! (2015-03-30), the 32-bit distribution for Mac OS X has been dropped.
- The platforms noted as [not tested] in the list, are platforms on which the software should work but with no warranty. All development tools used in this software are certified on these non-tested platforms but we didn't check by ourself. Most of these platforms are pretty old, that's why they are not actively supported.
- The platforms noted as [partially tested] in the list, are platforms on which the software works but that have not been intensively tested. Therefore there might be some platform specific bugs that haven't been detected yet. Most of these platforms are pretty new, that's why they have not been actively tested so far.
- The Linux installer requires the following commands: bzip2, lzma, xdg-mime, xdg-desktop-menu, xdg-icon-resource. If one of them is missing, the installation will stop and you might have to manually remove the installation folder.
- Most of the modern Linux platforms should be supported. However the only tested platforms are Ubuntu 14.04 32-bit, and Ubuntu 14.04 64-bit.

## Install

### Windows

If you opt for the installer version:

1. Run the FindReplaceIt-x.y.z-setup.exe application.
2. Select the language to use for the installation and click OK.
3. When the welcome screen is displayed, click on Next to continue with the installation.
4. Read carefully the End User License Agreement. If you accept it, click on the checkbox and then Next.
5. Select the destination folder, and click Install to proceed with the installation.
6. When the installation is done, you can choose to run Find & Replace It! from the installer. You'll find a shortcut for launching Find & Replace It! in the Start Menu. The application is located in the `dProg/Find & Replace It! <version>` sub-menu.

Alternatively, you may opt for the no-install version:

1. In the Windows explorer, right-clic on the archive `FindReplaceIt_x.y.z.zip` and click on the Extract… command.
2. Select the location to extract the files.
3. Read carefully the End User License Agreement located in `doc/license_en.html`.
4. The user's settings are stored beside the application, in the folder named `settings`. For more details about that folder, see the chapter Customizing Installation in this document.

### Linux

If you opt for the installer version:

1. Open a terminal
2. Make the installer executable: `chmod u+x FindReplaceIt-x.y.z-setup-<architecture>.run`
3. Execute the installer: `./FindReplaceIt-x.y.z-setup-<architecture>.run`
4. When the welcome screen is displayed, click on Next to continue with the installation.
5. Read carefully the End User License Agreement. If you accept it, click on the checkbox and then Next.
6. Select the destination folder, and click Install to proceed with the installation.
7. When the installation is done, you can choose to run Find & Replace It! from the installer. You'll find a shortcut for launching Find & Replace It! in the Application Menu. The application is located in the Accessories sub-menu.

NOTE: This will create the MIME-types associated to Find & Replace It! as well as appropriate menu entries. If you have a previous installation of the software, this installer will override previous the MIME-types associations and menu entries. Therefore we strongly suggest that you remove any previous version before installing a new one.

Alternatively, you may opt for the no-install version:

1. Open a terminal
2. Type: `tar -xzvf FindReplaceIt-x.y.z-<architecture>.tar.gz`
3. [optional] Execute the script: `./xdg-desktop-install.sh` located in the extraction directory. NOTE: This will create the MIME-types associated to Find & Replace It! as well as appropriate menu entries. If you have a previous installation of the software, this installer will override previous the MIME-types associations and menu entries. Therefore we strongly suggest that you remove any previous version before installing a new one.
4. Read carefully the End User License Agreement located in `doc/license_en.html`.
5. The user's settings are stored beside the application, in the folder named `settings`. For more details about that folder, see the chapter Customizing Installation in this document.

### Mac OS X

If you buy this Software on the App Store from Apple, there is nothing to do to install this Software. It will be automatically installed when you download it for the App Store. Otherwise, you should follow the following instructions.

1. Open the `FindReplaceIt-x.y.z-setup.dmg`
2. Read carefully the End User License Agreement in `Documentation/License.rtf`.
3. Drag & drop `Find & Replace It!.app` into your `/Applications` folder or wherever you want. You might use the Applications symbolic link provided in the DMG.
4. You can run `Find & Replace It!.app` by simply double-clicking on it, from the folder where it has been installed.
5. For users of Mac OS X 10.8 and higher, you might have to change the default Security & Privacy settings in the System Preferences in order to allow the application to run. The application is signed with a certificate named dProg - Philippe Docourt: Application issued by our own Certificate Autority (CA). Therefore we are considered as identified developers. Hence, turning the setting Allow application downloaded from: to Mac App Store and identified developers must do the job.

## Customizing Installation

In order to use Qt's libraries that are installed on your system instead of those distributed alongside the application, you have to:

- On Mac OS X: remove the Qt private frameworks located in `<app/install/dir>FindReplaceIt.app/Contents/Frameworks/` (i.e. `Qtxxx.framework` folders)
- On Windows: remove the Qt dll files from the `<app/install/dir>` folder (i.e. `Qtxxx4.dll`)
- On Linux: remove the Qt so files from the `<app/install/dir>/lib/` folder (i.e.`libQtxxx.so.4`

If you want to use your own version of Qt's libraries without modifying your system, you can replace the appropriate files in the locations mentioned above.

Your are free to change the icons by replacing those distributed alongside the application, in the resources folder. On Windows and Linux the icons are located in `<app/install/dir>/res/images`. On Mac OS X, they are located in `<app/install/dir>Find & Replace It!.app/Contents/Resources/images`.

If you want a portable installation of Find & Replace It!, then you need to have the software settings stored locally with the executable, instead of into the default location used on your platform (see where the settings are stored in the chapter Uninstall). This is easily achieved by creating a folder named `settings` right beside the executable named FindReplaceIt (on Mac OS X, this means the folder must be in `FindReplaceItd.app/Contents/MacOS/`, but right in the installation directory on Linux and Windows). There is more information about what is stored in that settings folder in the user's manual (PDF) of Find & Replace It!, in the chapter Using Local Storage for Settings.

## Uninstall

### Generalities

When using this software, some settings files might be generated. The settings files location varies with the platform. All these files and directories are prefixed by either dProg or FindReplaceIt.

The settings might also be stored beside the application, instead of the default folder as explained below. In particular, this is by default the case when using a no-installer distribution on Windows or Linux since version 2.1.1 (such a distribution does not explicitely exist on Mac OS X since there is no installer by default, nevertheless the settings are stored in their default location on Mac OS X, into the user's home folder). To know more about this feature, see the chapter Customizing Installation in this document.

Until version 1.3.x the following folders might have been used:

- On Unix and Mac OS X:
  - $HOME/.config/dProg/FindReplaceIt*
  - $HOME/.config/dProg*
  - /etc/xdg/dProg/FindReplaceIt*
  - /etc/xdg/dProg*
- On Windows:
  - %APPDATA%\dProg\FindReplaceIt*
  - %APPDATA%\dProg*
  - %COMMON_APPDATA%\dProg\FindReplaceIt*
  - %COMMON_APPDATA%\dProg*

Since version 1.4.x the following folders might be used:

- On Mac OS X, since 1.4.3:
  - ~/Library/ch.dprog.FindReplaceIt/<version>
- On Mac OS X prior to 1.4.3:
  - $HOME/.config/dProg/FindReplaceIt/<version>/
- On Linux:
  - $HOME/.config/dProg/FindReplaceIt/<version>/
  - /etc/xdg/dProg/FindReplaceIt*
  - /etc/xdg/dProg*
- On Windows:
  - %APPDATA%\dProg\FindReplaceIt\<version>\

Since version 2.0.2 the following folders might be used:

- On Mac OS X:
  - ~/Library/ch.dprog.FindReplaceIt/<minor-version>
- On Linux:
  - $HOME/.config/dProg/FindReplaceIt/<minor-version>/
  - /etc/xdg/dProg/FindReplaceIt*
  - /etc/xdg/dProg*
- On Windows:
  - %APPDATA%\dProg\FindReplaceIt\<minor-version>\

NOTE: These files are not removed automatically during uninstallation. They are indeed preserved for future installation or upgrades. If you do not need it anymore, please remove them manually.

### Windows

To remove Find & Replace It! from your computer, go to the Start menu, search for `dProg/Find & Replace It!/<version>` folder into the program list, then click Uninstall.

### Linux

Find & Replace It! can be removed through the uninstall script:

1. Open a terminal
2. Type: `<FindReplaceIt/install/dir>/uninstall.sh` (where `<FindReplaceIt/install/dir>` is your installation directory)

NOTE: This will remove all MIME-types associated to Find & Replace It! as well as menu entries. If you have many installations of the software in different locations, this script will remove the software only from the current installation directory. The other installations will be left untouched even if MIME-types associations are removed anyway.

### Mac OS X

To remove Find & Replace It! from your computer, simply drag & drop the installed bundle (`Find & Replace It!.app`) to the trash. Optionally, you might remove the package receipt located in `/Library/Receipts/FindReplaceIt.pkg`. This file was only used when doing an installation to detect previous installations. It is not used anymore since version 1.0.

    Copyright© 2007-2018, dProg - Philippe Docourt