| 17 | | == preferences.xml == |
| 18 | | === Schema === |
| | 17 | = JOSM preference/data/cache directories = |
| | 18 | |
| | 19 | ||= Priority =||= Preference =||= Data =||= Cache =|| |
| | 20 | || 1. specific system property specified from [[Help/CommandLineOptions|commandline]] || `-Djosm.pref=...` || `-Djosm.userdata=...` || `-Djosm.cache=...` || |
| | 21 | || 2. `josm.home` system property specified from commandline || `-Djosm.home=...` || `-Djosm.home=...` || `-Djosm.home=...`[[BR]]→`{josm.home}/cache` || |
| | 22 | || 3a. Windows defaults (since r7829) || `%APPDATA%\<JOSM>` || `%APPDATA%\<JOSM>` || `%LOCALAPPDATA%\<JOSM>\cache` or[[BR]] `%APPDATA%\<JOSM>\cache` || |
| | 23 | || 3b. Mac OS X defaults (since r7829) || `$HOME/Library/Preferences/<JOSM>` || `$HOME/Library/<JOSM>` || `$HOME/Library/Caches/<JOSM>` || |
| | 24 | || 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>` || |
| | 25 | || 3d. Linux defaults (prior r11162) || `$HOME/.<josm>` || `$HOME/.<josm>` || `$HOME/.<josm>`/cache || |
| | 26 | |
| | 27 | Notes: |
| | 28 | * `<JOSM>` defaults to JOSM and can be customized using `-Djosm.dir.name=...`, and `<josm>` corresponds to lowercase `<JOSM>` |
| | 29 | * Windows: try opening Explorer window and paste following text in location, then hit enter: {{{%APPDATA%\JOSM}}}. |
| | 30 | * 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''. |
| | 31 | |
| | 32 | == preferences.xml Schema == |
| 22 | | |
| 23 | | == Default location == |
| 24 | | |
| 25 | | === Windows === |
| 26 | | |
| 27 | | In short, try opening Explorer window and paste following text in location, then hit enter: {{{%APPDATA%\JOSM}}}. |
| 28 | | |
| 29 | | Resources: |
| 30 | | * https://blogs.msdn.microsoft.com/patricka/2010/03/18/where-should-i-store-my-data-and-configuration-files-if-i-target-multiple-os-versions/ |
| 31 | | * [https://github.com/openstreetmap/josm/search?l=java&q=getAllPossiblePreferenceDirs&utf8=%E2%9C%93 getAllPossiblePreferenceDirs()] in JOSM |
| 32 | | |
| 33 | | Probably outdated info below: |
| 34 | | * Under **Windows Vista and newer**, the josm located in {{{C:\Users\}}}''username''{{{\AppData\Roaming\JOSM}}}. |
| 35 | | * Under **older Windows** versions, this is in {{{C:\Documents and Settings\}}}''username''{{{\Application Data\JOSM}}}. |
| 36 | | |
| 37 | | === Linux === |
| 38 | | |
| 39 | | hidden system folder ~/.josm |
| 40 | | |
| 41 | | 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''. |
| 42 | | |
| 43 | | === MacOS === |
| 44 | | |
| 45 | | hidden system folder ~/.josm |
| 46 | | |
| 47 | | 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. |
