Kaart: JOSM Download and Optimization/sandbox

Introduction

JOSM, Java OpenStreetMap, is an advanced desktop OSM mapping editor. It has various customization abilities and tools that make mapping easier and faster. These guidelines provide a foundation, but you are free to personalize your appearance settings and toolbars to optimize your workflow. However, we advise against modifying the hotkeys so you can learn the basics.

Prerequisites

You will need:

• An OSM account
• The most recent version of Java downloaded
• JOSM installed

Installing and Updating JOSM

JOSM now uses OpenWebStart to run/update. You'll receive a popup upon opening JOSM to update if there is one available.

Follow these instructions to install JOSM and setup OpenWebStart:
Download and install the latest version of Java:	https://www.java.com/en/download/manual.jsp
Install the latest version of JOSM:	Go to https://josm.openstreetmap.de/ Download either the josm-tested.jar(standard) or josm.jnlp(recommended)updates to newest version each time its opened) Follow the instructions to complete installation
Install OpenWebStart	Mac	OpenWebStart_macos-aarch64_1_8_0.dmg(download for newer macs) OpenWebStart_macos-x64_1_8_0.dmg(download for older macs)
	Windows	OpenWebStart_windows-x64_1_10_0.exe(recommended) OpenWebStart_windows-x32_1_10_0.exe(for computers 10+ years old)
	Linux	OpenWebStart_linux_1_10_0.deb(for Debian based distribution) Install icedtea-web(recommended)
Set as default start up for:	Mac	Right click on the JOSM/JNLP file Click Get Info Go down to Open with Click the dropdown and select OpenWebStart
	Windows	Right click the JOSM/JNLP app Click Open with→choose another app Click More Apps→Look for another app on this PC Browse for OpenWebStart at:C:\Program Files\OpenWebStart\javaws Click Open to associate the JOSM/JNLP file with OpenWebStart
	Linux	Should automatically apply

Skill Instruction

Initial Setup

JOSM is most useful when the settings are set to support your editing. The following are the recommended JOSM settings.

Navigating JOSM Preferences

In order to navigate the installation/update process, it is important to know where to find the options you need to access.

At the top of the screen you will see several buttons:

This is where you will find preferences/settings, imagery, new data layers, and many of the other functions of JOSM you will be using. The most important of these for JOSM installation, update, and set up is Settings which can be found under the button that says JOSM or opened using the hotkey CMD + , / Ctrl + ,.

The settings menu has a navigation sidebar that will help you find many of the other options you will need to access during the setup and updating of JOSM. As you go through this setup process, there may be instances where the program tells you that it needs to restart in order for some settings to take effect. It is okay to restart the program as many times as needed.

Available Settings:
	Display		OSM Data		GPS Points		Colors		Language
	OSM Server		Proxy		Map Projection		Map Paint Styles		Tagging Presets
	File Backup		Plugins		Toolbar		Audio		Keyboard Shortcuts
	Data Validator		Remote Control		Imagery		Advanced Preferences

Remote Control

To load task from a tasking manager like HOT TM or Maproulette into JOSM, we have to turn on the Remote Control.

• Open Settings
• Select the Remote Control tab
• Select Enable remote control and Enable HTTPS support
• Select Download as new layer
• Press Ok to accept the changes

OSM Login

• Open Settings
• Select the OSM Server tab
• Select Use OAuth 2.0
• Select Authorize now (Semi-automatic)
  • Follow the prompts
• Select Ok to accept the changes

Expert Mode

Expert mode enables us to perform more than the basic functions of JOSM. This is one of the first things we do when setting up JOSM for the first time.

• Open Settings
• In the bottom left corner select Expert Mode
• Select Ok to accept the changes

You can also enable expert mode by:

• Click View
• Check Expert Mode

Display

• OpenSettings
• Select the Display tab
• The following settings are recommended:
  • Show splash screen at startup
  • Show username in title
  • Show localized name in selection lists
  • Remember dialog geometries
  • Use native file choosers
  • Intermediate steps between native resolutions
  • Zoom steps to get double scale (adjust from 1 to 5)
• Select Ok to accept the changes

Toolbars

If you want to reduce clutter on your screen, you can remove the supporting toolbars:

• Click View
• Uncheck the Toolbars(optional)
  • These sit at the top and left sides of JOSM.

If you want to add/remove tools on the main toolbar, you can customize them in Settings.

• Open Settings
• Open the Toolbar tab or right click on a blank space on the main toolbar and select Configure Toolbar.
• Modify your toolbar. Current tools are on the left and available tools are on the right.
  • Recommended tools include:
    • Satellite imageries you use
    • Commonly used Tools
    • Tools specific to the project you are working on

Keyboard Shortcuts

JOSM has standard keyboard shortcuts for each tool, but also lets you create/customize shortcuts.

To do this:

• Open Settings
• Open the Keyboard Shortcuts tab
• Search for a specific hotkey you wish to change/create to see if there is a tool associated with it.
  • If you want to change an existing hotkey deselect Use default and then select Disable.
    • Use the available tools to create a new hotkey for that tool.
  • If you want to create a custom hotkey:
    • Use the available tools to create a new hotkey for that tool then assign it to your tool.
• Select Ok to confirm the changes

A list of keyboard shortcuts can be found here.

Practical Application

There are many others tools that can be used in JOSM to assist you with editing. Take the time to learn more about these tools to improve your knowledge/efficiency with JOSM.

Suggested Bookmarks

• Java download
• JOSM download
• OpenWebStart download
• Kaart: Keyboard Shortcuts/sandbox
• Kaart: JOSM Filters, Presets, Paint Styles and Validator/sandbox