3. Update Procedure

If Keypirinha is not installed on your machine yet. You should head over to the Installation chapter instead.

Keypirinha does not come with an installer yet so the update procedure must be done manually.

Warning

You must first ensure Keypirinha is not running!

To exit Keypirinha, you have two options:

  • Fire up the LaunchBox and search-then-execute the Keypirinha: Exit item.
  • Use the Exit item of the main contextual menu. To get the contextual menu, right-click of Keypirinha‘s icon in the system tray, or right-click directly on the LaunchBox.

Once you have ensured Keypirinha is not running, the procedure depends on whether you chose the Installed Mode or the Portable Mode.

Tip

To check which mode Keypirinha is running in, open its install directory and check if the portable directory exists. If it does, you are in Portable Mode.

3.1. Update in Installed Mode

  • Open Keypirinha‘s install directory
    U:\Keypirinha for example
    Ensure there is no U:\Keypirinha\portable directory
  • Delete it
    It is safe to do so. In this mode, your configuration files are stored in your Home folder (i.e. under %APPDATA%\Keypirinha)
  • Open Keypirinha‘s distribution archive
    Its name should be something like keypirinha-x64-portable.7z
  • Extract its content to U:\
    You should now have a U:\Keypirinha directory
  • Delete the U:\Keypirinha\portable directory
    So Keypirinha knows it must run in Installed Mode
  • You’re done
    You may now execute the U:\Keypirinha\keypirinha.exe file

Warning

Be sure to read the section below about Overridden Shipped Packages.

3.2. Update in Portable Mode

  • Open Keypirinha‘s install directory
    U:\Keypirinha for example
    Ensure there is a U:\Keypirinha\portable directory
  • Delete everything in U:\Keypirinha except U:\Keypirinha\portable (this is where your configuration files are located)
  • Open Keypirinha‘s distribution archive
    Its name should be something like keypirinha-x64-portable.7z
  • Extract its content to U:\
    It is OK to overwrite the dummy file portable\KEEPME
  • You’re done
    You may now execute the U:\Keypirinha\keypirinha.exe file

Warning

Be sure to read the section below about Overridden Shipped Packages.

3.3. Overridden Shipped Packages

If you have modified some official package, you may want to ensure their code, their resources and the nomenclature of their default configuration files hasn’t changed!

If you run into trouble with an official package, try first to move away its loose folder to check if your issue is reproducible.