Skip to content

Vespucci 22.0 BETA Highlights#

2026-03-23

Export and import configuration data#

We now support exporting and importing configuration data in a simple XML format, see the Tools menu. This is useful for migrating your settings from a different device or distributing them to multiple users.

While exporting will always include all non-default settings, you can import just a subset by preparing a file that only includes the relevant sections for example a keyboard shortcut setup. If your preset or style configuration contains an URL to a relevant resource the importer will try to download it for you automatically.

Improve layer support on pre-Android 14 devices#

As discussed here Wasn't it just yesterday that Android 13 was shiny and new?, pre-Android 14 devices have no way to automatically have the set of root certificates that they use updated. This does and can cause problems with certain layer sources. V22 enables support for using custom/user provided certificate authorities and adds a small number of missing root certificates for some important sources.

This issue will not go away, it will just get worse, if a layer that previously worked suddenly stops working you should check if this is not due to this problem.

Better keyboard shortcut handling#

Previously keyboard shortcuts were hardwired and couldn't be modified by the user. This has been replaced by a more flexible system that allows the user to change the mappings and load them from a file with the new configuration export/import facility.

If you want a shortcut for an action that isn't covered yet, please open an issue on our tracker.

Changes to "Replace geometry"#

If you are updating a way geometry with a new geometry previously nodes shared with other ways would indiscriminately be moved, as a result you always had to unjoin the way before replacing its geometry. This has now been changed to use the same, configurable, logic as for tagged nodes: that is that nodes that would be moved more than a configurable distance will automatically be unjoined. Further to guarantee that this can be detected the area around each way node needs to be downloaded (so that other way memberships can be detected), if you try to use the function without doing that you will be shown an error and the operation will be aborted.

To make checking unjoined nodes after the operation easier, they will automatically be added to a todo list.

Support splitting ways without existing Nodes#

Vespuccis "Simple mode" has since its introduction with V12 in 2019 received support for most functionality in the legacy "Non-simple mode", but one, some times, annoying omission was that you could only split a way if a node was already present at the location. V22 now supports direct splitting with a long click, see the Split menu item for more information.

Improvements split window mode#

This release contains a few improvements to usage in split window mode. Preferences for these options can be found in the Experimental section of the advanced preferences.

  • Improve behaviour with samsung DeX and add option to force tab layout for the property editor.
  • Display a badge indicating the position of the property editor fragment.
  • Add support for showing the review modal in a separate window, this could be useful even on a phone.

Improve style management#

While previously it was possible to install custom data styles, it was a bit of a black art and not at all friction free. V22 changes style management to use the same UI as used for presets and API configurations which should make it far easier to load and remove custom styles.

Ignore parents of subareas in the disambiguation menu#

Vespucci will recursively show parent relations of potentially selectable objects in the disambiguation menu. For example if you select a way that is part of a boundary relation you will be shown an entry for that way and the parent relation, however if that boundary relation itself is a subarea member of a further boundary, you would be shown that relation too, and potentially recursively more. This can be very annoying as it leads to you being shown relations for that the way itself is not part of the geometry, starting with V22 this behaviour is suppressed and needs to be explicitly enabled in the Advanced preferences.

Improved behaviour when applying an OSC file#

Previously if you didn't pre-load the necessary data applying an OSC file would fail if it referenced way nodes that were not present. This is not an issue if the changes only affected a small easy to download area, but could be very painful if the edits were spread out over a larger area. V22 changes the behaviour to automatically attempt to download any missing way nodes.

Improvements to safe mode#

V22 adds an option to remove the current UI state and any selections. This provides another low impact way to get out of situations that may stop the app from starting, consider selecting all 27'525 members of the Tongass National Forest by accident.

Other behaviour changes#

  • Add ability to show parents and relation members in the info modal
  • Support for the deprecated attribute for checks in checkgoups
  • Support for numeric suffixes in tag2link
  • Hardwire reversing behaviour for railway:turnout_side
  • Change use a double colon as separator in changeset auto-comments
  • Disable "Query Overpass" if there is no network connectivity
  • Allow octet-stream as mime type for vector tiles

Miscellaneous#

Upgrading from previous versions#

As a general precaution you should upload any pending changes before updating, particularly if you are upgrading from any major version that doesn't immediately precede this one.

Known problems#

  • The documentation is out of date.
  • For other known problems with this build please see our issue tracker