Context Navigation

Editing Help/Preferences/Advanced

Adjust edit area height: Edit side-by-side

[[TranslatedPages]]
[[PageOutline(2-10,Table of Contents)]]

=  Preferences > Advanced Preferences =
[[JOSMImage(preferences/advanced,link=,48,middle,margin-right=20)]] **''Setting Preference directly. Use with caution! ''**

The **Advanced Peferences** register shows all raw settings and allows to manipulate them. It is visible in [wikitr:/Help/ExpertMode expert mode] only.

Most settings can easily and safely be modified via the other registers of this dialog box. 
Normally you should not need to use this register. 
Do so with caution.
Invalid settings can cause errors and/or loss of data.
Some setting changes need a restart to work. Unlike the other registers there is no warning about it.
You may be instructed to edit here in order to access experimental features.
See more about user settings in the [wikitr:/Help/Preferences Preferences Overwiew].

== Search ==
Use the Search field to quickly access values and keys grouped by namespace.
 
== List colors ==
1. [[span(style=background-color:#FFFFC8;font-weight:bold;, Bold on yellow)]] - value has changed at least once.
1. [[span(style=background-color:#C8FFC8;font-weight:bold;, Bold on green)]] - value was changed in this dialog.
1. [[span(style=background-color:#C8FFC8;font-weight:normal;, Normal on green)]] - value was reset to default in this dialog.
After a restart of JOSM all preference settings which are equal to their default values loose any list colors.

[[Image(PreferencesAdvancedPreferences.png,link=,45%,right,margin-left=10)]]

== Buttons ==#Buttons
 Add:: To add keys with simple values and with a XML structure.

Edit:: To edit one marked key/value pair.

Reset:: Sets all marked key/value pairs to their default value.

Read from file:: Imports a JOSM custom configuration XML file. 
 That can contain preferences modifications, commands to download some files or plugins and even JavaScript code. \\
 After a 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:: Generates 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...:: launches a popup menu with additional actions:
 * **Save ... profile** - saves part of preferences related to shortcuts, colors, toolbar and imagery to a 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** - reset all preferences by deleting the preferences.xml file.
  See [wikitr:/Help/ResetPreferences Reset preferences] also.

== Explanation ==
The table below contains settings not accessible in the other tabs of the Preferences dialog (incomplete list):
||= **Key** =||\
||= **Values** =||= **Default** =||\
||= **Description** =||\
||
|| **''$panel''`.buttonhiding`** ||\
|| DYNAMIC, ALWAYS_HIDDEN or ALWAYS_SHOWN || DYNAMIC ||\
|| See [wikitr:"/Help/JOSM interface customization" JOSM interface customization] ||\
||
|| **''$panel''`.minimized`** ||\
|| true or false || false ||\
|| See [wikitr:"/Help/JOSM interface customization" JOSM interface customization] ||\
||
|| **''$panel''`.docked`** ||\
|| true or false || true ||\
|| if a window is in the side pane or floating ||\
||
|| **''$panel''`.lastHeight`** ||\
|| integer || mixed ||\
|| is used to store the last used height of a panel ||\
||
|| **''$panel''`.preferredHeight`** ||\
|| integer || mixed ||\
|| can be used to overwrite the hard coded preferred height of a panel ||\
||
|| **''$dialogname''`.geometry`** ||\
|| ''`x=*,y=*,width=*,height=*`'' || || Size and position of dialog boxes ||\
||
|| **''$widget''`.always-visible`** ||\
|| true or false || true ||\
|| if TAB toggles this screen widget ||\
||
|| **`validator.*`** \\ **`overlapping-ways.*`** ||\
|| mixed || mixed ||\
|| See [wikitr:/Help/Preferences/Validator validator preferences] ||\
||
|| **`draw.anglesnap.*`** and probably keys starting with **`color.draw.angle.snap`** ||\
|| mixed || mixed ||\
|| should be explained at [wikitr:/Help/Action/Draw Draw] ||\
||
|| **`edit.initial-move-threshold`** ||\
|| pixels || || See [wikitr:/Help/Action/Select#Advanceddetails Select] ||\
||
|| **`edit.initial-move-delay`** ||\
|| ms || || See [wikitr:/Help/Action/Select#Advanceddetails Select] ||\
||
|| **`message.movedManyElements`** ||\
|| true or false  || unset ||\
|| Decision of "do not ask again" message after moving many objects. ||\
||
|| **`draw.fullscreen`** ||\
|| true or false || false || See [wikitr:/Help/Action/FullscreenView Fullscreen view] ||\
||
|| **`zoom.undo.delay` \\ `zoom.undo.max`** ||\
|| || || See [wikitr:/Help/Action/ZoomToPrevious#AdvancedPreferences Zoom to previous] ||\
||
|| **`relation.editor.presets.visible?`** ||\
|| true or false || true || If set to true, displays the list of presets matching the current tags in the relation editor. ||\
||
|| **`properties.presets.visible`** ||\
|| true or false || true || See [wikitr:/Help/Dialog/TagsMembership#AdvancedPreferences Tags/Membership panel] ||\
||
|| **`properties.presets.top`** ||\
|| true or false || true || See [wikitr:/Help/Dialog/TagsMembership#AdvancedPreferences Tags/Membership panel] ||\
||
|| **`url.openstreetmap-wiki`** ||\
|||| !https://wiki.openstreetmap.org/wiki/ ||\
|| See [wikitr:/Help/Dialog/TagsMembership#AdvancedPreferences Tags/Membership panel] ||\
||
|| **`selectaction.cycles.multiple.matches`** ||\
|| true or false || false ||\
|| See [wikitr:/Help/Action/Select#Selectsingle] ||\
||
|| **`osm.notes.daysClosed`** ||\
|| -1, 0 or positive integer || 7 || See [wikitr:/Help/Dialog/Notes#AdvancedPreferences Notes panel], available in [wikitr:/Help/Preferences/Connection OSM Server preferences] ||\
||
|| **`osm.notes.downloadLimit`** ||\
|| from ... to 10000 || 1000 || See [wikitr:/Help/Dialog/Notes#AdvancedPreferences Notes panel] ||\
||
|| **`latlon.dms.decimal-format` \\ `latlon.dm.decimal-format` \\ `statusbar.decimal-format`** ||\
||  ||  || See [wikitr:/Help/StatusBar#AdvancedPreferences StatusBar] ||\
||
|| **`statusbar.distance-threshold`** ||\
||  ||  || See [wikitr:/Help/StatusBar#AdvancedPreferences StatusBar] ||\
||
|| **`override.numbering.format`** ||\
|| true or false || `true` || disable/enable overriding of number format. So far only Arabic languages and Khmer are supported, see #18856. ''(since r16111)'' ||\
||
|| **`simplify-way.max-error`** ||\
|| integer, meters || `3` || See [wikitr:/Help/Action/SimplifyWay Simplify Way] ||\
||
|| **`message.way.split.segment-selection-dialog`** ||\
|| true or false || `false` || See [wikitr:/Help/Action/SplitWay#AdvancedPreferences Split Way] ||\
||
|| **`mappaint.wireframe.use-antialiasing`** ||\
|| true or false || `false` || See [wikitr:/Help/Action/WireframeToggle#AdvancedPreferences Wireframe view], available in the [[JOSMImage(layer/osmdata_small,24,link=,middle)]] [wikitr:/Help/Preferences/DrawingPreference OSM Data preferences] ||\
||
|| **`merge-nodes.mode`** ||\
|| 0 or 1 or 2 || `0` || See [wikitr:/Help/Action/MergeNodes#AdvancedPreferences Merge Nodes] ||\
||
|| **`upload.comment.max-age`** ||\
|| integer || `4*3600*1000` || See [wikitr:/Help/Concepts/Changeset#AdvancedPreferences Changeset] ||\
||
|| **`upload.show.review.request`** ||\
|| true or false || `true` || displays the "I want someone to review my edits." check box in the upload dialog ||\
||
|| **`upload.show.automatic.source`** ||\
|| true or false || `true` || displays the "Automatically obtain source from current layers" check box in the upload dialog ||\
||
|| **`mappaint.fillalpha`**, **`mappaint.showicons`** and couple others ||\
||  ||  || See [wikitr:/Styles#AdvancedPreferences Styles] ||\
||
|| **`browser.unix`** ||\
|| || ["xdg-open", \\ "#DESKTOP#", \\ "$BROWSER", \\ "gnome-open", \\ "kfmclient openURL", \\ "firefox"] || sets another external browser than the default browser to open external links on unix os ||\
||
|| **`browser.windows`** ||\
|| || || sets another external browser than the default browser to open external links on windows os (use the browser executable) ||\
||
||||
|| **`osm-primitives.localize-name`** ||\
|| true or false || `false` || See [wikitr:/Help/Preferences/Display Display preferences] ||\
||
|| **`osm-primitives.showcoor`** ||\
|| true or false || `false` || See [wikitr:/Help/Preferences/Display Display preferences] ||\
||
|| **`osm-primitives.showid`** ||\
|| true or false || `false` || See [wikitr:/Help/Preferences/Display Display preferences] ||\
||
|| **`osm-primitives.showid.new-primitives`** ||\
|| true or false || `false` || Instead of `id:0`, displays the internal negative id for new objects beside the object in lists ||\
||
|| **`osm-primitives.showversion`** ||\
|| true or false || `false` || See [wikitr:/Help/Preferences/Display Display preferences] ||\
||
||||
|| **`propertiesdialog.autoresizeTagsTable`** ||\
|| true or false || `false` || Enables automatic column width of the tags table to fit content, see #14666 ||\
||
|| **`zoom.scale-follow-native-resolution-at-load`** ||\
|| true or false || `true` || `true` means "Scale follows native resolution of layer" is enabled when layer is created ||\
||
|| **`properties.autocomplete-keys`** ||\
|| true or false || `true` || `true` means autocomplete keys by default in the add tag dialog ||\
||
|| **`properties.autocomplete-values`** ||\
|| true or false || `true` || `true` means autocomplete values by default in the add tag dialog ||\
||
|| **`imagery.generic.popupmenu`** ||\
|| true or false || `true` || `false` disables the imagery context menu in the mapview ||\
||
|| **`gui.start.animation`** ||\
|| true or false || `true` || `false` disables the animation while displaying the [wikitr:/StartupPage Startup page] ||\
||
|| **`jcs.cache.use_image_resource_cache`** ||\
|| true or false || `false` || `true` enables caching rendered SVG images using JCS ''(since r17364)'' ||\
||
||||
|| **`osm.download.threads`** ||\
|| integer || `2` || Maximum parallel download threads downloading OSM data objects ||\
||
|| **`socket.maxredirects`** ||\
|| integer || `5` || Maximum of allowed redirects ||\
||
|| **`socket.timeout.connect`** ||\
|| integer || `15` || Maximum interval to wait for a connection with server ||\
||
|| **`socket.timeout.read`** ||\
|| integer || `30` || Maximum interval to wait for an answer from server ||\
||
||||
|| **`autosave.deletedLayersBackupCount`** ||\
|| integer || `5` || ||\
||
|| **`autosave.enabled`** ||\
|| true or false || `true` || See [wikitr:/Help/Preferences/BackupPreference File backup] ||\
||
|| **`autosave.extension`** ||\
|| || `osm` || File extension to use for data layers when [wikitr:/Help/Action/AutoSave auto saving] ||\
||
|| **`autosave.filesPerLayer`** ||\
|| integer || `1` || See [wikitr:/Help/Preferences/BackupPreference File backup] ||\
||
|| **`autosave.index-limit`** ||\
|| integer || `1000` || ||\
||
|| **`autosave.interval`** ||\
|| integer || `300` || See [wikitr:/Help/Preferences/BackupPreference File backup] ||\
||
|| **`autosave.notification`** ||\
|| true or false || `false` || See [wikitr:/Help/Preferences/BackupPreference File backup] ||\
||
||||
|| **`multipoly.alltags`** ||\
|| true or false || `false` || See [[JOSMImage(multipoly_create)]] [wikitr:/Help/Action/CreateMultipolygon#AdvancedPreferences Create Multipolygon] ||\
||
|| **`multipoly.lineartagstokeep`** ||\
|| key list || `[barrier,fence_type,source]` || See [[JOSMImage(multipoly_create)]] [wikitr:/Help/Action/CreateMultipolygon#AdvancedPreferences Create Multipolygon] ||\
||
|| **`multipoly.movetags`** ||\
|| true or false || `true` || See [[JOSMImage(multipoly_create)]] [wikitr:/Help/Action/CreateMultipolygon#AdvancedPreferences Create Multipolygon] ||\
||
|| **`multipoly.show-relation-editor`** ||\
|| true or false || `false` || See [[JOSMImage(multipoly_create)]] [wikitr:/Help/Action/CreateMultipolygon#AdvancedPreferences Create Multipolygon] ||\
||
||||

**''$dialogname''** is short for a dialog name \\
**''$panel''** is short for changesetdialog, commandstack, conflict, filter, layerlist, mapstyle, notes/note_open, propertiesdialog, relationlist, selectionlist, userlist or validator \\
**''$widget''** is short for menu, sidetoolbar, statusbar or toolbar \\

== Details ==
The list of preferences is build like this:
* Not all possible available keys are listed at the beginning.
* Whenever JOSM internally requests a particular setting, it remembers and lists the key and the default value.
* A setting is only saved in the preference file if the value is different from the default. 
* However, if you already know the key, you can still set it explicitly.

----
Back to [wikitr:/Help/Action/Preferences Preferences dialog] \\
Back to [wikitr:/Help/Menu/Edit Edit Menu] \\
Back to [wikitr:/Help/Menu Main Menu] \\
Back to [wikitr:/Help Main Help]

Note: See WikiFormatting and TracWiki for help on editing wiki content.

Change information

Your email or username:

E-mail address and name can be saved in the Preferences

Comment about this change (optional):

Attachments (3)

AdvancedPreferences.png (131.9 KB ) - added by Klumbumbus 10 years ago.
AdvancedPreferencesTab.png (96.0 KB ) - added by Hb--- 7 years ago.
PreferencesAdvancedPreferences.png (223.7 KB ) - added by skyper 4 years ago. new screenshot

Download all attachments as: .zip

Note: See TracWiki for help on using the wiki.