[[TranslatedPages]]

Our preference data is composed of a set of name->value pairs. The setting names are often "namespaced" with dot ('.') separated words. Many JOSM plugins will store preferences grouped in a namespace.

You can get a similar raw view by viewing this file, but this [Help/Preferences/Advanced 'Advanced' preferences panel] is intended to provide a easier alternative.

= Menus =

Most of the settings can be reached via menus
* [[Help/Action/Preferences]] (see also [[Help/Keys by menu]])

= Other preferences =

* [[Help/JOSM interface customization]]
* [[Help/Preferences/Advanced]]

= JOSM preference/data/cache directories =

||= Priority  =||= Preference =||= Data =||= Cache =||
|| 1. specific system property specified from [[Help/CommandLineOptions|commandline]] || `-Djosm.pref=...` || `-Djosm.userdata=...` || `-Djosm.cache=...` ||
|| 2. `josm.home` system property specified from commandline || `-Djosm.home=...` || `-Djosm.home=...` || `-Djosm.home=...`[[BR]]→`{josm.home}/cache` ||
|| 3a. Windows defaults (since r7829) || `%APPDATA%\<JOSM>` || `%APPDATA%\<JOSM>` || `%LOCALAPPDATA%\<JOSM>\cache` or[[BR]] `%APPDATA%\<JOSM>\cache` ||
|| 3b. Mac OS X defaults (since r7829) || `$HOME/Library/Preferences/<JOSM>` || `$HOME/Library/<JOSM>` || `$HOME/Library/Caches/<JOSM>` ||
|| 3c. Linux defaults (for fresh installations after r11162) || `$XDG_CONFIG_HOME/<JOSM>` or[[BR]]`$HOME/.config/<JOSM>` || `$XDG_DATA_HOME/<JOSM>` or[[BR]]`$HOME/.local/share/<JOSM>` || `$XDG_CACHE_HOME/<JOSM>` or[[BR]]`$HOME/.cache/<JOSM>` ||
|| 3d. Linux defaults (prior r11162) || `$HOME/.<josm>` || `$HOME/.<josm>` || `$HOME/.<josm>`/cache ||

Notes:
* `<JOSM>` defaults to JOSM and can be customized using `-Djosm.dir.name=...`, and `<josm>` corresponds to lowercase `<JOSM>`
* Windows: try opening Explorer window and paste following text in location, then hit enter: {{{%APPDATA%\JOSM}}}.
* Linux: To show the contents of the 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''.

== preferences.xml Schema ==
http://josm.openstreetmap.de/preferences-1.0

Some descriptions can be found in [[Help/Preferences/ImportExport]] (stub)


== Auto save subfolder ==

Utilized by [wiki:/Help/Action/AutoSave autosave function].

== See also ==
* [[Help/ResetPreferences]] - there many ways to reset preferences
* [[Help/Action/AutoSave]] feature
* [[Help/CommandLineOptions]] - how to change/load custom settings via command line