Upgrading from v3 to v4

Version 4 of Plover is a major change and has updated both the configuration file format and the default dictionaries.

Check the version of Plover you are using
If the main window of Plover has an about and a configure button, and you don't see a list of dictionaries, you are on version 3.

Backup
You may want to backup your previous settings just in case.


 * 1) Find your your config folder. In version 3, you can find out where this is by opening up Plover, pressing configure, going to the logging tab and seeing where the strokes log file lives.
 * 2) Backup your config files. This includes   and any user dictionaries you would like to keep. You can backup the files by copying them elsewhere.

Install version 4

 * 1) Uninstall version 3
 * 2) Follow the guide in Getting Started § Installing Plover.

Upgrading the dictionaries
Version 4 of Plover comes with new dictionaries. It's recommended that you update them so that they are in line with current learning resources.


 * 1) Open the config folder. In version 4, you can do this by opening up Plover, opening the File menu, then clicking Open config folder.
 * 2) Delete  and.
 * 3) Restart Plover, and it will automatically replace these with the newest version.

Plover isn't recreating the dictionaries
Instead of deleting the dictionaries, you can replace them manually.


 * 1) Download the latest dictionaries: main.json and commands.json. You can right click the link and select Save as to download.
 * 2) Replace the files in the config folder.

I can't find the config folder
The default folder is different for different operating systems.

Windows
%LOCALAPPDATA%\plover\plover You can open the folder by doing any of these:


 * Via start menu
 * Click on start menu, or press the windows key
 * Paste
 * Click Open
 * Via run dialog
 * Press Win
 * Paste
 * Click OK

The full path is equivalent to

Mac
~/Library/Application Support/plover
 * 1) From Finder either:
 * 2) *Navigate to Go > Go to Folder...
 * 3) *Using your keyboard: Press Command.
 * 4) In the "Go to the folder:" field enter  as the path. You may wish to copy and paste this path.
 * 5) Click Go.
 * 6) The Finder window should now reveal your plover configuration directory for the user you're currently logged into.

The full path is equivalent to.

Linux
This depends on the exact version you are using. See Help > About to check.

dev8 and earlier
~/.local/share/plover

dev9 and later
~/.config/plover