View source for Updating V3 Dictionaries

= Upgrading V3 Dictionaries =
If you've installed Plover version 3 but have later switched to version 4, it is recommended you update the dictionaries to stay up to date with the current learning resources. Since Plover does not remove the dictionaries on uninstallation, it is necessary to do this manually.

== Check your Plover version before continuing ==
[[File:Plover version check 1.png|frameless|678x678px]]


To check if you've installed Plover version 3, the main Plover window and the Plover Configuration window will look like the image above—with the main Plover window having a Configure and About button. Clicking the About button will reveal detailed information on the version of Plover you're running. If it looks like this, you'll have to [https://github.com/openstenoproject/plover/releases/latest download and install the latest version of Plover] before continuing.

== Steps (recommended) ==
First ensure that Plover version 4 is installed.

On later versions of Plover version 4, you can open Plover's config folder via the option in the file menu:
[[File:Open config folder gui.png|frameless|650x650px]]


In this folder you will find the dictionaries. Simply delete <code>main.json</code> and <code>commands.json</code>. You will then need to either restart Plover, or reconnect the machine so that Plover will replace it with its own version.

Alternatively, you can also download an up-to-date version of the Plover dictionaries ([https://raw.githubusercontent.com/openstenoproject/plover/master/plover/assets/main.json main.json], [https://raw.githubusercontent.com/openstenoproject/plover/master/plover/assets/commands.json commands.json]) (either open the link and save the file, or right click the link and press "save link as"), then replace the old dictionaries in the config folder.  You will then need to either restart Plover, or reconnect the machine to refresh the dictionaries.

== Location of the config folder (advanced users) ==
The exact location of this folder depends on the operating system, and it is as follows.

=== Windows ===
 <code>%LOCALAPPDATA%\plover\plover</code>
In Windows 10 and later you can copy and paste the path <code>%LOCALAPPDATA%\plover\plover</code> into the Start menu search field and clicking Open.

[[File:Local app data plover location windows.png|frameless|782x782px]]

Alternatively, you can use the shortcut <code>Windows Logo + R</code> to open the Run dialog box and

# Pasting the <code>%LOCALAPPDATA%\plover\plover</code> path described earlier into the Open field.
# Click OK.

For example the full path may be <code>C:\Users\<Username>\AppData\Local\plover\plover</code> after entering the <code>%LOCALAPPDATA%\plover\plover</code> location described above.

=== Mac ===
 <code>~/Library/Application Support/plover</code>

# On your Mac, from the Finder, do any of the following:
#* ''Using your mouse or trackpad:'' Navigate to Go > Go to Folder...
#* ''Using keyboard shortcuts:'' Reveal the "Go to Folder..." prompt by using the shortcut <code>Command-Shift-G</code>.
# In the "Go to the folder:" field enter <code>~/Library/Application Support/plover</code> as the path. You may wish to copy and paste this path.
# Click Go.
# The Finder window should now reveal your plover configuration directory for the user you're currently logged into.

The full path is equivalent to navigating to <code>/Users/<Username>/Library/Application Support/plover</code>.

=== Linux (AppImage) ===

==== dev8 and before: ====
 <code>~/.local/share/plover</code>
<blockquote>NOTE: this location will still work for later versions of Plover due to backwards compatibility, as long as there's no <code>plover.cfg</code> file in the latter location.</blockquote>

==== dev9 and after: ====
 <code>~/.config/plover</code>