== Release ==
The latest release is JOSM 1.4. Get it at: http://www.eigenheimstrasse.de/josm/josm-1.4.jar. The hotlink to the always latest release is http://www.eigenheimstrasse.de/josm/josm.jar

== Nightly Builds ==
You can always grab the latest nightly build - version from http://www.eigenheimstrasse.de/josm/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 [http://subversion.tigris.org subversion]

 svn co http://josm.eigenheimstrasse.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.eigenheimstrasse.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://www.eigenheimstrasse.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
}}}
== Running ==
=== Microsoft Windows ===
Launch it by double clicking on the jar file. If this does not help, open a command shell and type

 java -jar ''josm.jar''

in the directory that holds the file. Replace `''josm.jar''` with the name of the jar file you downloaded, e.G. `josm-latest.jar`

=== Linux ===
Open a shell, go to the file directory and type

 java -jar ''josm.jar''

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

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''

If you are using KDE, there is a [http://www.eigenheimstrasse.de/josm/tutorials/setting_up_kde.avi tutorial] on how to setup your environment to start jar-files by clicking on them.

If you are using GNOME, just right click on the JAR file, and select <u>O</u>pen with "Sun Java 5.0 Runtime", or whatever java version you have.

If you are using XGL/Compiz then you may have to do the following:

  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.