2. 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 before doing anything else! This is because it keeps open some of its files at runtime so you would not be able to modify/delete them...

To exit Keypirinha, you have two options:

  • Fire up the LaunchBox and search-then-execute the Keypirinha: Exit item.
  • Or, 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’re sure Keypirinha is not running anymore, the procedure depends on whether you chose the Installed Mode or the Portable Mode.

Tip

To check in which mode Keypirinha is, open its install directory and check for a portable directory. If it is there, you are in Portable Mode.

2.1. Update in Installed Mode

  • Open Keypirinha‘s install directory.
    Say it’s U:\Keypirinha for example.
    Ensure there is no U:\Keypirinha\portable directory!
  • Delete it.
    Don’t worry. 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.zip).
  • Extract its content to U:\.
    You should now have a U:\Keypirinha directory.
  • Delete the U:\Keypirinha\portable directory.
    That indicates Keypirinha it must run in Installed Mode.
  • You’re done!
    You may now execute the U:\Keypirinha\keypirinha.exe file.
    It might be named keypirinha in your Windows Explorer view, so to recognize it, it is the one with the squared-K icon.

Warning

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

2.2. Update in Portable Mode

  • Open Keypirinha‘s install directory.
    Say it’s U:\Keypirinha for example.
    Ensure there is a U:\Keypirinha\portable directory!
  • Delete everything in U:\Keypirinha except U:\Keypirinha\portable.
    Don’t mess up with this one, this is where your configuration files are located!
  • Open Keypirinha‘s distribution archive (its name should be something like keypirinha-x64-portable.zip).
  • Extract its content to U:\.
    It is safe to anwser yes to the Overwrite? question concerning the portable directory since it is just about replacing a dummy file (i.e. KEEPME).
  • You’re done!
    You may now execute the U:\Keypirinha\keypirinha.exe file.
    It might be named keypirinha in your Windows Explorer view, so to recognize it, it is the one with the squared-K icon.

Warning

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

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

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