Changes between Version 23 and Version 36 of Help/Preferences
- Timestamp:
- (multiple changes)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Help/Preferences
v23 v36 1 1 [[TranslatedPages]] 2 [[PageOutline(2-10,Table of Contents)]] 2 3 3 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. 4 = Preferences Overview = 5 The preference data in JOSM is composed of a set of name->value pairs. The setting names are mostly ''namespaced'' with dot `.` separated words. Many JOSM plugins store their preferences grouped in a namespace. 4 6 5 You can get a similar raw view by viewing th is file, but this [Help/Preferences/Advanced 'Advanced' preferences panel] is intended to provide aeasier alternative.7 You can get a similar raw view by viewing these files, but the preferences' panel [[JOSMImage(preferences/advanced,link=,24,middle)]] [wikitr:/Help/Preferences/Advanced advanced preferences] is intended to provide an easier alternative. 6 8 7 = Menus = 9 Most of the settings can be reached via menus in the [[JOSMImage(preference)]] [wikitr:/Help/Action/Preferences preferences dialog]. 8 10 9 Most of the settings can be reached via menus 10 * [[Help/Action/Preferences]] (see also [[Help/Keys by menu]]) 11 * [[Help/Preferences/Advanced]] 11 == Other preferences == 12 * [wikitr:"/Help/JOSM interface customization" JOSM interface customization] 12 13 13 = Other preferences =14 14 15 * [[Help/JOSM interface customization]] 16 17 = JOSM preference/data/cache directories = 15 == JOSM preference/data/cache directories ==#JOSMpreferencedatacachedirectories 16 {{{#!comment 17 #JOSMpreferencedatacachedirectories is called from Help/Preferences/Plugins - Manual installation 18 }}} 18 19 19 20 JOSM stores 3 kinds of files in different directories: 20 21 Preferences:: Configuration data and settings, such as authentication for the OSM server, list of last opened files, selection of expandable dialogs on the right, etc. 21 User data:: User 22 User data:: User-specific data files, for example, autosave data, plugins and ignored validator errors 22 23 Cache:: Files downloaded from the internet and stored for a limited time to avoid repeated downloads and allow faster access. For example imagery tiles and startup news. 23 24 24 The default location of the directories depends on your operating system .25 The default location of the directories depends on your operating system and is listed in the [wikitr:/Help/Action/About#InstallationDetails Installation details] tab of the [[JOSMImage(logo_48x48x32,link=,middle,24)]][wikitr:/Help/Action/About About dialog] in the [wikitr:/Help/Menu/Help Help menu] 25 26 26 == Windows == 27 28 '''Preferences''' and '''user data''' is stored in 27 === Windows === 28 **Preferences** and **user data** is stored in 29 29 {{{ 30 30 %APPDATA%\JOSM 31 31 }}} 32 To locate this folder, try opening Explorer window and paste following text in location, then hit enter: `%APPDATA%\JOSM`, On Windows Vista and later, it should be something like `C:\Users\<YourName>\AppData\Roaming\JOSM`. Note, that the directory `C:\Users\<YourName>\AppData` can be hidden by default. 32 To locate this folder, try opening Explorer window and paste the following text in location, then hit enter: `%APPDATA%\JOSM`, On Windows Vista and later, it should be something like `C:\Users\<YourName>\AppData\Roaming\JOSM`. Note, that the directory `C:\Users\<YourName>\AppData` can be hidden by default. 33 33 34 The '''cache'''is located in34 The **cache** is located in 35 35 {{{ 36 36 %LOCALAPPDATA%\JOSM\cache … … 42 42 On Windows XP and earlier, the cache is in `%APPDATA%\JOSM\cache`. 43 43 44 == Mac OS X == 44 === MacOS=== 45 On MacOS, the default locations are as follows: 46 Preferences:: `Users/<YourName>/Library/Preferences/JOSM` 47 User data:: `Users/<YourName>/Library/JOSM` 48 Cache:: `Users/<YourName>/Library/Caches/JOSM` 45 49 46 On Mac OS X, the default locations are as follows: 47 Preferences:: `$HOME/Library/Preferences/JOSM` 48 User data:: `$HOME/Library/JOSM` 49 Cache:: `$HOME/Library/Caches/JOSM` 50 51 == Linux == 52 50 === Linux === 53 51 Since r11162, JOSM uses the [https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html XDG Base Directory Specification] for fresh installations, i.e. 54 52 Preferences:: `$HOME/.config/JOSM` … … 56 54 Cache:: `$HOME/.cache/JOSM` 57 55 58 JOSM respects the `$XDG_CONFIG_HOME`, `$XDG_DATA_HOME` and `$XDG_CACHE_HOME` environment variables to chan ce these locations.56 JOSM respects the `$XDG_CONFIG_HOME`, `$XDG_DATA_HOME` and `$XDG_CACHE_HOME` environment variables to change these locations. 59 57 60 58 Prior to r11162, the locations were … … 63 61 Cache:: `$HOME/.josm/cache` 64 62 65 JOSM will continue to use the old locations, if the directory `$HOME/.josm` exists. If you have a fresh installation, but prefer the old scheme, you can create the `$HOME/.josm` directory by hand. 63 If JOSM is installed via flatpak, the locations are 64 Preferences:: `$HOME/.var/app/org.openstreetmap.josm/config` 65 User data:: `$HOME/.var/app/org.openstreetmap.josm/data` 66 Cache:: `$HOME/.var/app/org.openstreetmap.josm/cache` 66 67 67 Note on hidden files: File names beginning with a dot are hidden on 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.68 68 69 == Customization (all operating systems) == 69 JOSM will continue to use the old locations if the directory `$HOME/.josm` exists. If you have a fresh installation but prefer the old scheme, you can create the `$HOME/.josm` directory by hand. 70 70 71 === Setting all 3 locations === 72 The locations can be set using system properties specified from the [[Help/CommandLineOptions|commandline]]: 71 Note on hidden files: File names beginning with a dot are hidden on 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`. 72 73 === Customization (all operating systems) === #Customizationalloperatingsystems 74 ==== Setting all 3 locations ==== 75 The locations can be set using system properties specified from the [wikitr:/Help/CommandLineOptions command line]: 73 76 Preferences:: `-Djosm.pref=...` 74 77 User data:: `-Djosm.userdata=...` 75 78 Cache:: `-Djosm.cache=...` 76 79 77 For example to store the cache in `D:\cache\JOSM`, you would need to run a command like this: 80 For example to store the cache located in `D:\cache\JOSM`, you would need to run a command like this: 78 81 {{{ 79 82 java -Djosm.cache=D:\cache\JOSM -jar josm.jar 80 83 }}} 81 84 82 === Setting a common directory === 83 85 ==== Setting a common directory ==== 84 86 Alternatively, all 3 locations can be moved to a common location using the system property `-Djosm.home=...`. 85 87 For example with … … 92 94 Cache:: `D:\myJOSM\cache` 93 95 94 === Changing the directory base name === 95 96 Instead of specifying the full path for the JOSM directories, you can use the system property `-Djosm.dir.name=` to modify just the name of the last directory component, which is `JOSM` by default. This is especially useful in order to keep multiple ''profiles'' on one computer, which should not interfere. For example to have one profile for productive work with the stable tested version and one for the experimental development version, you would start the development version like this: 97 {{{ 96 ==== Changing the directory base name ==== 97 Instead of specifying the full path for the JOSM directories, you can use the system property `-Djosm.dir.name=` to modify just the name of the last directory component, which is `JOSM` by default. This is especially useful in order to keep multiple ''profiles'' on one computer, which should not interfere. For example, to have one profile for productive work with the stable tested version and one for the experimental development version, you would start the development version like this: 98 {{{#!sh 98 99 java -Djosm.dir.name=JOSM-dev -jar josm-latest.jar 99 100 }}} … … 103 104 Cache:: `$HOME/.cache/JOSM-dev` 104 105 105 (For locations in the style prior to r11162, the lower-case version with prepended dot will be used, e.g. `$HOME/.josm-dev`.) 106 107 == preferences.xml Schema == 108 http://josm.openstreetmap.de/preferences-1.0 109 110 Some descriptions can be found in [[Help/Preferences/ImportExport]] (stub) 106 (For locations in the style prior to r11162, the lower-case version with the prepended dot will be used, e.g. `$HOME/.josm-dev`.) 111 107 112 108 113 == Auto save subfolder == 109 === preferences.xml Schema === 110 See [/preferences-1.0.xml]. 114 111 115 Utilized by [wiki:/Help/Action/AutoSave autosave function]. 112 Some descriptions can be found in [wikitr:/Help/Preferences/ImportExport Custom configuration XML files for JOSM] 113 114 === Auto save subfolder === 115 Utilized by [wikitr:/Help/Action/AutoSave autosave function]. 116 116 117 117 118 == See also == 118 * [[Help/ResetPreferences]] - there many ways to reset preferences 119 * [[Help/Action/AutoSave]] feature 120 * [[Help/CommandLineOptions]] - how to change/load custom settings via command line 119 * [wikitr:/Help/Action/About#InstallationDetails Installation details] 120 * [wikitr:/Help/ResetPreferences Reset preferences] - ways to reset preferences 121 * [wikitr:/Help/Action/AutoSave Autosave] feature 122 * [wikitr:/Help/CommandLineOptions Command line options] - how to change/load custom settings via command line 123 124 125 ---- 126 Back to [wikitr:/Help/Action/Preferences Preferences dialog] \\ 127 Back to [wikitr:/Help Main Help]
