1. Installation

Warning

If Keypirinha is already installed and you just want to update, go to the Update Procedure chapter.

1.1. Requirements

Keypirinha works on Windows 64bits (7, 8, 8.1, 10) and does not require additional dependencies.

1.2. Installation

Keypirinha currently comes in a simple archive that can be uncompressed about anywhere you want. There is no installer.

Out of the box, it is configured to run in Portable Mode, which means all the configuration and runtime files are stored in Keypirinha‘s directory.

1.3. Installed vs. Portable mode

Keypirinha can run in two different flavors: Installed Mode or Portable Mode.

Each time Keypirinha is being launched, it checks if a portable folder exists under Keypirinha‘s directory. In that case, the application will run in Portable Mode, otherwise the Installed Mode is selected.

Note

There is currently no automated tool to ease switching between the two modes so you will have to copy the directories manually if you wish to switch to the Installed Mode. Just ensure first the application is not running.

1.3.1. Installed Mode

The Installed Mode complies to the Windows’ conventional way of storing applications’ data under user’s dedicated folder. Usually something like: C:\Users\%USERNAME%.

The configuration files and downloaded extra packages will be stored in the %APPDATA%\Keypirinha folder. That might be translated to something like that on your machine: C:\Users\%USERNAME%\AppData\Roaming\Keypirinha.

Runtime files and any other kind of temporary files will be stored in the %LOCALAPPDATA%\Keypirinha folder. That might be translated to something like that on your machine: C:\Users\%USERNAME%\AppData\Local\Keypirinha.

Warning

In order to be able to run under this mode, the portable directory must not exist. So be sure you have deleted it after copying your files to their new locations.

1.3.2. Portable Mode

The Portable Mode keeps all the files needed by Keypirinha in a single folder, making it easy to be moved around on a USB stick for example.

The configuration files and downloaded extra packages will be stored in the portable\Profile folder, directly located in Keypirinha‘s directory.

Runtime files and any other kind of temporary files will be stored in the portable\Local folder, directly located in Keypirinha‘s directory.