[[TranslatedPages]]
= Preferences > Plugins =

Plugins extend the core functionality of JOSM. The [wiki:/Plugins list of JOSM plugins] explains which plugins are available and with what kind of functionality they extend JOSM.   

Most JOSM users don't work with the bare JOSM core only. They usually install at a set of at least 3-5 plugins.

**Please, install only the plugins you need.** Plugins will probably rise the chance of code errors and some combinations might even not been tested.

[[TOC(inline)]]

== Installing plugins ==

1. Launch the [[Image(source:/trunk/images/preference.png,15)]] **Preferences** dialog.
1. Select the tab [[Image(source:trunk/images/preferences/plugin.png,15)]] **Plugins**.
1. Click on [[Image(source:trunk/images/download.png,15)]] **Download list** to download the list of available plugins.
1. Tick the checkbox for every plugin you want to install.
1. Click on [[Image(source:trunk/images/dialogs/refresh.png,15)]] **Update plugins**.

JOSM will download and install the plugins. You have to restart JOSM to **load and activate** the newly downloaded plugins. 

== Manually updating plugins ==
1. Launch the [[Image(source:trunk/images/preference.png,15)]] **Preferences** dialog.
1. Select the tab [[Image(source:trunk/images/preferences/plugin.png,15)]] **Plugins**.
1. Click on [[Image(source:trunk/images/download.png,15)]] **Download list** do download the list of available plugins.
1. Tick the checkbox for every plugin you want to update.
1. Click on [[Image(source:trunk/images/dialogs/refresh.png,15)]] **Update plugins**.

JOSM will download and install the most recent version of the selected plugins. You have to restart JOSM to **load and activate** the newly downloaded plugins. 

== Automatically updating plugins == #AutomaticUpdate
JOSM checks at startup whether the currently active plugins should be updated. JOSM attempts to update the plugins
* if JOSM itself has been updated since the last plugin update. This is called the **version based update mode**.
* if a certain periode of time has elapsed since the last plugin update. This is called the **time based updated mode**.

In the preferences you can define the policy for both updating plugins modes.

1. Launch the [[Image(source:trunk/images/preference.png,15)]] **Preferences** dialog.
1. Select the tab [[Image(source:trunk/images/preferences/plugin.png,15)]] **Plugins**.
1. Click the tab **Plugin update policy**.

[[Image(plugin_update_policy_preferences.png,450)]]

* Select the radio button **Ask before updating** if JOSM shall ask before updating plugins in version and/or time based update mode.
* Select the radio button **Always update without asking** if JOSM shall automatically update plugins without asking. 
* Select the radio button **Never update** to disable version or time based automatic update. JOSM will skip automatic update at startup if this policy is selected. 

The interval in days for the **time based updated mode** can be set below the radio buttons (''default=30'').

== Manually installing plugins ==
If the automatic way does not work, you can install plugins manually by putting the .jar files in the **plugins** directory under the JOSM directory

 * Under **Windows**, this is in {{{C:\Documents and Settings\}}}''username''{{{\Application Data\JOSM\plugins}}}.
 * Under **Vista**, the plugins are located in  {{{C:\Users\}}}''username''{{{\AppData\Roaming\JOSM\plugins}}}.
 * On a **Mac** you will find the JOSM directory in the user directory {{{/Users/}}}''username''{{{/.josm/plugins}}}. The point "." in front of ".josm" indicates that this folder is invisible. To show the contents of this hidden folder, use the Finders Go to folder menu command ({{{Cmd+Shift+G}}}), and enter "~/.josm") in the dialog that pops up. Drag any plugins you'd like to install into the {{{plugins}}} folder.[[BR]] (You can also copy the plugin files using the command line.)
 * On a **Linux** system you will find the JOSM directory in the user directory {{{/home/}}}''username''{{{/.josm/plugins}}}. The point "." in front of ".josm" indicates that this folder is invisible. To show the contents of this hidden folder, use the file manager and enter "~/.josm" in the address line (if no address line is visible just try to enter a letter and hopefully a popup to enter the address will open). Alternatively it is possible to "show hidden" files and folders in the file manager, using the keyboard shortcut ''Ctrl+H''. Drag any plugins you'd like to install into the {{{plugins}}} folder.[[BR]] (You can also copy the plugin files using the command line.)

Now restart JOSM and the plugins should show up in the plugin list under **''Edit -> Preferences -> [[Image(source:trunk/images/preferences/plugin.png,15)]] [wiki:Help/Preferences/Plugins Plugins]''**.[[BR]] Activate the Plugins, click on [[Image(source:/trunk/images/ok.png,15)]] **OK** to save the preferences and restart JOSM once more.


== See also ==
* [wiki:/Plugins List of JOSM plugins]
* [Help/Plugins Plugin Help]

----
Back to [Action/Preferences Preferences][[BR]]
Back to [Help/Plugins Plugin Help][[BR]]
Back to [wiki:/Help Main Help]