Changeset Manager

Work in progress!
The features described here are not yet available in either latest or tested.

TOC(inline)

Launching Changeset Manager

There are several ways to launch the Changeset Manager:

1. Select the menu item View->Changeset Manager
2. Press Ctrl-Alt-C
3. Select one or more changesets in the Changeset List Dialog and click there on

The Changeset Manager window

Querying changesets

There are several ways to query and download changesets. The most common query and download operations can be invoked directly from the Changset Manager. Other more advanced features are provided by the Changeset Query Dialog.

Query and download a changeset by its unique ID

If you want to download a specific changeset whose ID you know, you can download it directly in the Changeset Manager.

1. Enter the changeset ID in the input field in the toolbar section of the Changeset Manager
2. Press ENTER or click on

If you download a single changeset JOSM downloads both the changeset properties (for instance its id or the date it was created) and the changeset content (i.e. the list of objects created, updated, or deleted with this changeset).

Query and download your open changesets

Changesets can be open or closed. A mapper can always upload additional objects to an open changeset he or she owns.

If you want to download the list of open changesets you own

1. Click on My open changesets in the toolbar section of the Changeset Manager

Note that this download only the changeset properties without the changeset content. For downloading the content of changesets see below.

Advanced queries

Advanced queries like

• querying the changesets owned by another mapper
• querying the most recent changesets open or closed on the OSM server
• querying changesets which modified object in a specific area (called a "bounding box")

can be run using the Changeset Query Dialog.

To launch the Changeset Query Dialog:

1. Click on Query in the toolbar section of the Changeset Manager

Managing the cache of downloaded changesets

JOSM locally maintains a cache of the changesets downloaded from the OSM server. The content of this cache is displayed in the upper half of the Changeset Manager.

Removing changesets from the cache

Changesets can be removed from the local cache. Removing a changeset from the cache is purely local operation. The changeset isn't deleted on the OSM server. In fact, it is not possible to delete a changeset on the server.

Removing changesets from the local cache can be useful because the local changeset cache consumes memory. You can remove changesets you don't need from the cache in order to free it up.

To remove one or more changesets from the local cache

1. Select the changesets in the Changeset Manager
2. Click on or press DEL. Alternatively you may select Remove from cache from the popup menu.

Updating the properties of changesets in the cache

Properties of changesets can cache over time. For instance, an open changeset can become closed or the tags of an open changeset can change because it is assigned a new set of tags in another upload.

In order to update the properties of one or more changesets

1. Select the changesets in the Changeset Manager
2. Click on . Alternatively you may select Update changeset from the popup menu.

Note that this will update the changeset properties only. For updating the changeset content, see below.

Downloading/Updating the content of changesets in the cache

A changeset includes a collection of object which have been created, updateded, or deleted by the changeset. These objects are called the changeset content. The size of a changeset content varies, but in general it can become very large. Changesets can grow up to 50'000 objects. Changeset content is therefore not automatically downloaded from the OSM server.

In order to download the changeset content of one or more changesets

1. Select the changesets in the Changeset Manager
2. Click on . Alternatively you may select Download changeset content from the popup menu.

In additionl, the content of a changeset may change over time provided the changeset is still open. The same steps will always retrieve the most recent content for a given changeset. If the local cache already includes the content of a changeset, this operation will update it with the latest content.

Selecting the objects in changesets in the Map View

Zooming to changesets

Managing a single changeset

Browsing properties, tags, and content

Remove a changeset from the local cache

Updating/Downloading changeset content

Selecting objects in the changeset content in the Map View

Zooming to objects in the changeset content

Download and display the history of objects in the changeset content

See also