[[TranslatedPages]]
= Java !OpenStreetMap Editor =
{{{
#!html
}}}
[[Image(/svn/trunk/images/logo.png)]]
{{{
#!html
}}}
JOSM is an editor for [http://www.openstreetmap.org OpenStreetMap] (OSM) written in [http://java.sun.com/javase/downloads/ Java] 1.6.
Currently it supports loading stand alone GPX tracks and GPX track data from the OSM database as well as loading and editing existing nodes, ways, metadata tags and relations from the OSM database.
== Download ==
* '''Note that there are fairly regular updates, so always try running a recent version (and also recent plugins).'''
* Access [http://josm.openstreetmap.de/download/josm.jnlp JOSM-WebStart] without installation
* Download the '''[http://josm.openstreetmap.de/josm-tested.jar tested JOSM ]''' version [[Version(tested)]]
* Download the [http://josm.openstreetmap.de/download/windows/josm-setup.exe Windows JOSM installer] version [[Version(windows)]]
* Download the [http://josm.openstreetmap.de/download/macosx/josm-macosx.zip Mac OS X JOSM package] version [[Version(macos)]]
* Prepare a [wiki:USB_Stick] to use JOSM on any foreign Windows machine.
* For download scripts use version check for [http://josm.openstreetmap.de/latest latest] and [http://josm.openstreetmap.de/tested tested] (or [http://josm.openstreetmap.de/version both]) to reduce download bandwith
* View the [http://josm.openstreetmap.de/log/?verbose=on change log]. Major changes are noted in the [wiki:StartupPage JOSM startup notes].
=== Extensions ===
* Get many [wiki:Plugins plugins], [wiki:Presets presets] or [wiki:Styles styles] (Easier installation via JOSM preferences).
* URLs of usable WMS services can be viewed and added at [wiki:Maps] page.
* Problems with plugins? Have a look at the [http://josm.openstreetmap.de/download/ JOSM download directory].
* Requests for new features can also be made via [/newticket trac] or via the JOSM developer mailing list ([mailto:josm-dev@openstreetmap.org josm-dev@openstreetmap.org]). You can [http://lists.openstreetmap.org/cgi-bin/mailman/listinfo/josm-dev subscribe here].
* Follow [http://twitter.com/fakejosm the unofficial JOSM feed] on Twitter
== Development ==
* Download the '''[http://josm.openstreetmap.de/josm-latest.jar latest JOSM]''' version [[Version(latest)]] (may have more errors than "tested", be careful with this one).
* Try '''[http://josm.openstreetmap.de/applet JOSM applet]''' (very new, may be defective - please report bugs, currently you need to be logged in before or loading and saving preferences wont work)
* Get the source:
* From the official Subversion repository (recommended): {{{svn co http://josm.openstreetmap.de/svn/trunk}}}
* From the unofficial [http://github.com/openstreetmap/josm GitHub mirror]: {{{git clone git://github.com/openstreetmap/josm.git}}}
* See [wiki:DevelopersGuide Developers Guide] or [wiki:Translations Translations Guide]
* The Ubuntu JOSM project on [https://launchpad.net/ubuntu/+source/josm launchpad]
== Help and Support ==
* Start of [wiki:Help] pages of the software (reached with from within JOSM)
* Tutorial videos are available at any [wiki:Mirrors mirror]. You may need [http://de.techsmith.com/download/codecs.asp TSCC codecs] for some AVI files.
* Further help is available when using [http://lists.openstreetmap.org/pipermail/ various OSM mailinglists]. It's best to ask questions [http://lists.openstreetmap.org/listinfo/newbies on the newbies list] or the language specific talk lists.
=== Problems ===
* For install troubles, look at the InstallNotes page and/or [http://wiki.openstreetmap.org/index.php/JOSM]
* Report bugs via [/newticket trac]. When reporting a bug please include the version (version number can be found in menu ''Help -> About'').
* Understand [wiki:Releases JOSM release] system
== How to help ==
* [wiki:DevelopersGuide Help developing code] (e.g. write patches for entries in [/report bug tracker])
* Review bugs in [/report bug tracker]: find duplicates, test bugs and add more descriptive texts
* [wiki:Translations Translate] JOSM into your language using [https://translations.launchpad.net/josm/trunk/+pots/josm Launchpad].
* [wiki:Translations Translate] [wiki:StartupPageSource StartupPage] or [wiki:VersionHistorySource VersionHistory] into other languages
* Update and translate the [wiki:Help online help]
* Unify and translate all JOSM related Wiki pages and join them with the online help
* Review translations
* Review original texts (program, online help, ...)
* Create fancy new icons for presets or tools without icons
* ...