wiki:Help/Preferences/Advanced

Preferences > Advanced Preferences

source:trunk/images/preferences/advanced.png

Advanced preferences gives you a view of all your raw preferences data.

This tab is only visible in expert mode.

The majority of preference settings can be more easily and safely modified via the other preference panels. Normally you should not need to use this display to change settings. Do so with caution because there is no validation, and invalid or missing settings can cause unexpected errors and/or loss of data. You may be instructed to change or add settings here in order to access experimental or under-development features e.g. if somebody developed a plugin and provided a setting, but didn't get around to creating a more attractive interface for changing it.

As you can see, your 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 'Advanced' preferences panel is intended to provide a easier alternative.

Color-coding:

  • yellow background - values which have changed atleast once appear bold
  • green background - values which you just changed get a green background; when you close and reopen the preference window, they get also the yellow background

Explanation

Please note that if key was utilized by menu (Help/Keys by menu), it won't be listed here. I.e. list below contains only hidden to the end user settings:

Single key or group? KeyValuesDefaultDescription
groupchangesetdialog.buttonhiding;
commandstack.buttonhiding;
conflict.buttonhiding;
filter.buttonhiding;
layerlist.buttonhiding;
mapstyle.buttonhiding;
notes/note_open.buttonhiding;
propertiesdialog.buttonhiding;
relationlist.buttonhiding;
selectionlist.buttonhiding;
userlist.buttonhiding;
validator.buttonhiding
DYNAMIC or ALWAYS_HIDDEN or ALWAYS_SHOWN DYNAMIC explained at JOSM interface customization
groupchangesetdialog.minimized;
commandstack.minimized;
conflict.minimized;
filter.minimized;
layerlist.minimized;
mapstyle.minimized;
notes/note_open.minimized;
propertiesdialog.minimized;
relationlist.minimized;
selectionlist.minimized;
userlist.minimized;
validator.minimized
true or falsefalse explained at JOSM interface customization
groupchangesetdialog.docked;
commandstack.docked;
conflict.docked;
filter.docked;
layerlist.docked;
mapstyle.docked;
notes/note_open.docked;
propertiesdialog.docked;
relationlist.docked;
selectionlist.docked;
userlist.docked;
validator.docked
true or falsefalse explained at JOSM interface customization
groupmenu.always-visible;
sidetoolbar.always-visible;
statusbar.always-visible;
toolbar.always-visible
true or false true explained at JOSM interface customization
group gui.geometry;
org.openstreetmap.josm.actions.SessionSaveAsAction$SessionSaveAsDialog.geometry;
org.openstreetmap.josm.gui.dialogs.DeleteFromRelationConfirmationDialog.geometry;
org.openstreetmap.josm.gui.dialogs.properties.TagEditHelper$AddTagsDialog.geometry;
org.openstreetmap.josm.gui.dialogs.properties.TagEditHelper$EditTagDialog.geometry;
org.openstreetmap.josm.gui.dialogs.relation.GenericRelationEditor.geometry;
org.openstreetmap.josm.gui.download.DownloadDialog.geometry;
org.openstreetmap.josm.gui.help.HelpBrowser.geometry;
org.openstreetmap.josm.gui.history.HistoryBrowserDialogManager.geometry;
org.openstreetmap.josm.gui.io.UploadDialog.geometry;
org.openstreetmap.josm.gui.preferences.PreferenceDialog.geometry;
org.openstreetmap.josm.gui.preferences.advanced.ListEditor.geometry
unset JOSM interface customization
groupstarts with draw.anglesnap. and probably keys starting with color.draw.angle.snap mixedmixed should be explained at Help/Action/Draw under "Angle snapping" section
Single key or group? KeyValuesDefaultDescription
single edit.initial-move-threshold pixels was explained at Help/Action/Select#Advanceddetails
single edit.initial-move-delay ms was explained at Help/Action/Select#Advanceddetails
single draw.fullscreen true or false false Help/Action/FullscreenView and JOSM interface customization
single createcircle.nodecount Help/Action/CreateCircle#AdvancedPreferences
single zoom.undo.delay Help/Action/ZoomToPrevious#AdvancedPreferences
single zoom.undo.max Help/Action/ZoomToPrevious#AdvancedPreferences
single properties.presets.top true Help/Dialog/TagsMembership#AdvancedPreferences
single url.openstreetmap-wiki https://wiki.openstreetmap.org/wiki/ Help/Dialog/TagsMembership#AdvancedPreferences
single selectaction.cycles.multiple.matches true or false false Help/Action/Select#Selectingsingleobjects
single osm.notes.daysClosed -1, 0 or positive integer 7 Help/Dialog/Notes#AdvancedPreferences
single osm.notes.downloadLimit from ... to 10000 1000 Help/Dialog/Notes#AdvancedPreferences
single latlon.dms.decimal-format Help/StatusBar#AdvancedPreferences
single latlon.dm.decimal-format Help/StatusBar#AdvancedPreferences
single statusbar.decimal-format Help/StatusBar#AdvancedPreferences
single statusbar.distance-threshold Help/StatusBar#AdvancedPreferences
single simplify-way.max-error integer, meters 3 Help/Action/SimplifyWay#AdvancedPreferences
single message.way.split.segment-selection-dialog true or false false Help/Action/SplitWay#AdvancedPreferences
single mappaint.wireframe.use-antialiasing true or false false Help/Action/WireframeToggle#AdvancedPreferences
single curves.circlearc.angle-separation 20 Action/CreateCircleArc#AdvancedPreferences
single merge-nodes.mode 0 or 1 or 2 0 Action/MergeNodes#AdvancedPreferences
single upload.comment.max-age integer 4 * 3600 * 1000 Help/Concepts/Changeset#AdvancedPreferences
group mappaint.fillalpha, mappaint.showicons and couple others Styles#AdvancedPreferences
single message.movedManyElements true or false unset "Move multiple objects at once message" at Select,move,rotate page

Details

The list of preferences is build like this:

  • Not all possible available keys are listed at the beginning.
  • Whenever JOSM internally requests the value of a particular setting, it remembers the key and the default value.
  • Note that a setting is not saved in the preference file, unless the value is different from the default. However JOSM will remember all keys and their default values which were previously requested.
  • This means, that settings related to download may not be in the list, before you did your first download. However, if you already know the key, you can still set it explicitly.

Import and export items

  • Read from file button can be used to open JOSM custom configuration XML file. It can contain preferences modifications, commands to download some files or plugins, and even JavaScript code.
    After file import is complete, you can see a detailed log and the changed preferences will be represented. You can reject these changes by pressing Cancel button. Caution: You can not undo reject file or plugin operations (download, delete, etc.), so be careful and do not open scripts from untrusted sources!
  • Export selected items button allows to generate a custom configuration XML file automatically. When reading this file, the key-value pairs will replace existing ones or be appended to them (in case of properties containing lists or maps). You can use it together with the Search field to find all preferences you need to backup or share.

More

More button launches the popup menu with extra actions:

  • Save ... profile - save part of preferences related to shortcuts, colors, toolbar and imagery to separate custom configuration XML files.
  • Load profile - replace existing part of preferences with previously saved fragment (for example, reset all shortcuts to default and then load them from file). User should press OK to confirm changes.
  • Reset preferences - delete all entries from preferences.xml (files are not deleted).

See also Reset preferences.

See also

  • Help/Preferences - more information on custom configuration (preferences.xml): scripts, file format and command line parameters

Back to Preferences
Back to Main Help

Last modified 5 months ago Last modified on 2016-11-27T09:31:22+01:00

Attachments (1)

Download all attachments as: .zip