2. Installation

Warning

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

2.1. Requirements

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

2.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.

2.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 the portable folder exists under Keypirinha‘s directory. If it does, the application will run in Portable Mode, otherwise the Installed Mode is selected.

Note

There is currently no automated way 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. Please ensure first that the application is not running.

2.3.1. 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.

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

2.3.2. 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.

Cache 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.