Release

The latest release is JOSM 1.5. Get it at: ​http://josm.openstreetmap.de/download/josm-1.5.jar. The hotlink to the always latest release is ​http://josm.openstreetmap.de/download/josm.jar

Nightly Builds

You can always grab the latest nightly build - version from ​http://josm.openstreetmap.de/download/josm-latest.jar. It is usually pretty stable too.

Getting the Source

JOSM is available under GPL, and so of course you can get the sources and compile, modify or redistribute it by yourself. You can grab the sources via ​subversion

svn co ​http://josm.openstreetmap.de/svn josm

Hint: If you don't like those funny .svn directories, use svn export instead of svn co

Or you can inspect single files over the web frontend at ​http://josm.openstreetmap.de/svn.

Compiling

To build the source the easiest way, use eclipse and the provided .project and .classpath file. Just add a new Java Project using the JOSM source folder as existing path.

You can also build it without eclipse. To do so, change into the src/ folder and call javac on the file org/openstreetmap/josm/Main with all libs from ../lib/*.jar in your classpath (you have to specify all subsequent). If running linux, be sure to have your JAVA_HOME set.

As example, this could look like:

 $ cd ~/src
 $ svn co http://josm.openstreetmap.de/svn josm
 ''tons of output here''
 $ export JAVA_HOME=/usr/local/jdk1.5.0
 $ cd josm/src
 $ javac -cp .:../lib/MinML2.jar:../lib/metadata-extractor-2.3.1.jar:../lib/gettext-common-0.9.jar org/openstreetmap/josm/gui/MainApplication.java

Compiling with ant

Much more comfortable is it to use "ant".
First of all you have to set your JAVA_HOME. Than change into the src folder and just type "ant".
This will compile JOSM automatically and a "Josm_custom.jar" can be found under "/dist"

Running

Microsoft Windows

Double clicking on the jar file.

If this does not help, you probably need to install ​Java

If you want to be able to handle more points in JOSM you can create a shortcut like the following example:

C:\WINNT\system32\java.exe -jar -Xmx512M "C:\PATH-TO-JOSM\josm-latest.jar"

Linux / *BSD

using the shell

Go to the directory where the josm-latest.jar is and type

java -jar josm-latest.jar

to launch. Replace ''josm-latest.jar'' with the name of the jar file you loaded, e.G. josm.jar for releases.

If this don't help, try to set you JAVA_HOME variable to the java location (the root location, not the bin. As example:

 export JAVA_HOME=/usr/lib/sun-j2se5.0-jdk
 java -jar ''josm.jar''

KDE

There is a ​tutorial on how to setup your environment to start jar-files by clicking on them.

GNOME

Right click on the JAR file, and select Open with "Sun Java 5.0 Runtime", or whatever java version you have.

XGL/Compiz

Type this into a shell:

export AWT_TOOLKIT=MToolkit && java -jar josm-test.jar

as described here: ​http://kubasik.net/blog/index.php/2006/06/19/java-sun-150-and-xglcompiz-on-ubuntu/

MacOS

Just click on the jar-file.