5 | | #!html |
6 | | <div style="float: left; margin: 15px;"> |
| 7 | #!table style="border:0; border-collapse:separate; border-spacing:0 10px;" |
| 8 | {{{#!tr ==================================== |
| 9 | {{{#!td valign=top style="border:1px solid #ccc; border-right:0" |
| 10 | [[Image(/logo.png,top,link=,title=JOSM logo,alt=JOSM logo,128,margin-left=10)]] |
| 11 | }}} |
| 12 | {{{#!td valign=top style="border:1px solid #ccc; border-left:0; padding: 20px;" |
| 13 | {{{#!span style="font-size:120%" |
| 14 | **JOSM** is an extensible editor for [osmwww: OpenStreetMap] (OSM) for [https://www.azul.com/downloads/?version=java-17-lts&package=jre-fx#download-openjdk Java 8+]. |
| 15 | }}} |
| 16 | {{{#!comment |
| 17 | FIXME: add a better description here |
8 | | [[Image(/svn/trunk/images/logo.png)]] |
9 | | {{{ |
10 | | #!html |
11 | | </div> |
| 19 | It supports loading GPX tracks, background imagery, and OSM data from local sources as well as from online sources and allows to edit the OSM data (nodes, ways, and relations) and their metadata tags. |
| 20 | |
| 21 | JOSM is [source:/trunk open source] and licensed under [source:/trunk/LICENSE GPL]. |
| 22 | }}} |
| 23 | }}} |
| 24 | {{{#!tr ==================================== |
| 25 | {{{#!td colspan=2 align=left valign=top style="background:#CBEEA7; font-size:120%; padding:0px 15px 15px 13px; border:1px solid #ccc" |
| 26 | [[JOSMImage(openlocation,middle,link=,alt=open,title="")]] |
| 27 | Start [/download/josm.jnlp josm.jnlp] (newest tested version, currently [[Version(tested)]]) \\ |
| 28 | {{{#!span style="font-size:83%" |
| 29 | preferred distribution channel, all platforms, monthly automatic update ([wikitr:/Download#Webstart how to start]; [wikitr:/Changelog changelog]) |
| 30 | }}} |
| 31 | }}} |
| 32 | }}} |
| 33 | {{{#!tr ==================================== |
| 34 | {{{#!td colspan=2 align=left valign=top style="background:#CBEEA7; font-size:120%; padding:0px 15px 15px 13px; border:1px solid #ccc" |
| 35 | [[JOSMImage(download,middle,link=,alt=download,title="")]] |
| 36 | Download [/josm-tested.jar josm-tested.jar] (version |
| 37 | [[Version(tested)]]) \\ |
| 38 | {{{#!span style="font-size:83%" |
| 39 | all platforms ([wikitr:/Download#Java how to run]; [wikitr:/Changelog changelog]) |
| 40 | }}} |
| 41 | }}} |
| 42 | }}} |
| 43 | {{{#!tr ==================================== |
| 44 | {{{#!td colspan=2 align=left valign=top style="background:#eee; padding:0px 15px 0px 13px; border:1px solid #ccc;" |
| 45 | [/download/windows/josm-setup.exe Windows installer] (version |
| 46 | [[Version(windows)]], or from [https://apps.microsoft.com/store/detail/josm/XPFCG1GV0WWGZX Microsoft Store], see [wikitr:/Download#Mswindowswrapper how to install]) |
| 47 | }}} |
| 48 | }}} |
| 49 | {{{#!tr ==================================== |
| 50 | {{{#!td colspan=2 align=left valign=top style="background:#eee; padding:0px 15px 0px 13px; border:1px solid #ccc" |
| 51 | [/download/macosx/josm-macosx.zip macOS package] (version |
| 52 | [[Version(macos)]], or use [https://formulae.brew.sh/cask/josm homebrew], see [wikitr:/Download#macOS how].) |
| 53 | }}} |
| 54 | }}} |
| 55 | {{{#!tr ==================================== |
| 56 | {{{#!td colspan=2 align=left valign=top style="background:#eee; padding:0px 15px 0px 13px; border:1px solid #ccc" |
| 57 | Development version (version [[Version(latest)]], [/download/josm-latest.jnlp josm-latest.jnlp] or [/josm-latest.jar josm-latest.jar]), [https://github.com/JOSM/josm/releases macOS dev builds], [wikitr:/Download#Ubuntu Ubuntu repository] and all [wikitr:/Download Download] options. |
| 58 | }}} |
| 59 | }}} |
| 62 | == Getting Started == |
| 63 | * The [wikitr:/Introduction Introduction] page will guide you to your first successful edit. |
| 64 | * See the official **[wikitr:/Help help system]** – `<F1>` reaches it everywhere on JOSMs interface and the [[JOSMImage(help,link=wikitr:/Help/Menu/Help,24,middle,title=Help)]] help button in dialogs. |
| 65 | * Ask members of the OpenStreetMap community on |
| 66 | * the [https://community.openstreetmap.org/tag/josm OSM-forum] |
| 67 | * OpenStreetMap's [https://help.openstreetmap.org/ question-and-answer site] |
| 68 | * various [osmwiki:Mailing_List OSM mailing lists] (e.g. [https://lists.openstreetmap.org/listinfo/talk talk], [https://lists.openstreetmap.org/pipermail/ list overview]) |
| 69 | * the [osmwiki:IRC OSM IRC channel], including our [irc://irc.oftc.net/josm own room] |
15 | | JOSM is an editor for [http://www.openstreetmap.org OpenStreetMap] (OSM) written in [http://java.sun.com/javase/downloads/ Java] 1.6. |
16 | | 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. |
| 71 | == Extensions == |
| 72 | * [[JOSMImage(preferences/plugin,link=wikitr:/Plugins,24,middle,alt=plugins,title=Plugins)]] **[wikitr:/Plugins]** add more complex program features. ([wikitr:/Help/Preferences/Plugins installation instructions]) |
| 73 | * [[JOSMImage(dialogs/propertiesdialog,link=wikitr:/Presets,24,middle,alt=presets,title=Presets)]] **[wikitr:/Presets]** allow you to select predefined tags for objects. ([wikitr:/Help/Preferences/TaggingPresetPreference installation instructions]) |
| 74 | * [[JOSMImage(dialogs/validator,link=wikitr:/Rules,24,middle,alt=rules,title=Rules)]] **[wikitr:/Rules]** check and fix invalid data. ([wikitr:/Help/Preferences/Validator#TagCheckerRules installation instructions]) |
| 75 | * [[JOSMImage(dialogs/mapstyle,link=wikitr:/Styles,24,middle,alt=styles,title=Styles)]] **[wikitr:/Styles]** change the appearance of the mapview. ([wikitr:/Help/Preferences/MapPaintPreference installation instructions]) |
| 76 | * [[JOSMImage(imagery_menu,link=wikitr:/Maps,24,middle,alt=maps,title=Maps)]] **[wikitr:/Maps Backgrounds]** allow you to trace osm data from e.g. aerial imageries. ([wikitr:/Help/Preferences/Imagery installation instructions]) |
18 | | == Download == |
19 | | * '''Note that there are fairly regular updates, so always try running a recent version (and also recent plugins).''' |
20 | | * Access [/download/josm.jnlp JOSM-WebStart] without installation |
21 | | * Download the '''[/josm-tested.jar tested JOSM ]''' version [[Version(tested)]] |
22 | | * Download the [/download/windows/josm-setup.exe Windows JOSM installer] version [[Version(windows)]] |
23 | | * Download the [/download/macosx/josm-macosx.zip Mac OS X JOSM package] version [[Version(macos)]] |
24 | | * Prepare a [wiki:USB_Stick] to use JOSM on any foreign Windows machine. |
25 | | * For download scripts use version check for [/latest latest] and [/tested tested] (or [/version both]) to reduce download bandwith |
26 | | * View the [/log/?verbose=on change log]. Major changes are noted in the [wiki:StartupPage JOSM startup notes]. |
| 78 | == Recent changes == |
| 79 | * [wikitr:/StartupPage Startup notes] (most important changes) |
| 80 | * [wikitr:/Changelog Summarized changelog] (nicely summarized) |
| 81 | * [/log/?verbose=on SVN changelog] (complete log) |
28 | | === Extensions === |
29 | | * Get many [wiki:Plugins plugins], [wiki:Presets presets] or [wiki:Styles styles] (Easier installation via JOSM preferences). |
30 | | * URLs of usable WMS services can be viewed and added at [wiki:Maps] page. |
31 | | * Problems with plugins? Have a look at the [/download/ JOSM download directory]. |
32 | | * 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]. |
33 | | * Follow [http://twitter.com/fakejosm the unofficial JOSM feed] on Twitter |
| 83 | == Found a bug? | Have an idea? | Make a suggestion? | [=#Contribute Like to contribute?]==#Bugs |
| 84 | * Please report any bug found! Via the **[wikitr:/Help/Action/ReportBug Report Bug]** form in the [wikitr:/Help/Menu/Help Help] menu it is easy. |
| 85 | * **Create** and discuss ideas and enhancements as [/newticket ticket] and [#contact contact] the team. |
| 86 | * **Contribute** with updates, corrections and [wikitr:/Translations translations] to unify all JOSM-related pages and join them with the [wikitr:/Help online help]. |
| 87 | * **Participate** in [/report bug tracking] with reviewing bugs, up/down vote tickets, find duplicates, test bugs, add more descriptive texts. |
| 88 | * **Design** fancy new [wikitr:/Styles#Icons icons]. |
| 89 | * **Develop** get the [wikitr:"/Source code#Getthesource" Source] and see the [wikitr:/DevelopersGuide developers guide] for build instructions and other details. |
35 | | == Development == |
36 | | * View the [/log/?verbose=on change log]. |
37 | | * Download the '''[/josm-latest.jar latest JOSM]''' version [[Version(latest)]] (may have more errors than "tested", be careful with this one). |
38 | | * Try '''[/applet JOSM applet]''' after reading the [wiki:Applet applet description]. |
39 | | * Get the source: |
40 | | * From the official Subversion repository (recommended): {{{svn co http://josm.openstreetmap.de/svn/trunk}}} |
41 | | * From the unofficial [http://github.com/openstreetmap/josm GitHub mirror]: {{{git clone git://github.com/openstreetmap/josm.git}}} |
42 | | * From the official OSM Subversion repository (including plugins): {{{svn co http://svn.openstreetmap.org/applications/editors/josm josm}}} |
43 | | * See [wiki:DevelopersGuide Developers Guide] or [wiki:Translations Translations Guide] |
44 | | * The Ubuntu JOSM project on [https://launchpad.net/ubuntu/+source/josm launchpad] |
| 91 | == This site == |
| 92 | * This site is a combined help and bug tracking system for JOSM and JOSM plugins. |
| 93 | * No login is required to use this site (neither for reading nor for wiki edits or the bug tracker). |
| 94 | * But logging in has advantages: |
| 95 | * Mail is sent for changes in your bug tracker tickets. This is possible by entering an e-mail as a username in the tickets too, but then be aware that the address is openly visible and you are unable to change that later. |
| 96 | * Page settings are remembered (e.g. input field size and a lot of other stuff). |
| 97 | * Logins that have no e-mail address or which have not been used at least once are automatically deleted. |
| 98 | * Logins to edit the OpenStreetMap database are separate from the logins on this server. |
| 99 | * Copyright (CC-BY-SA and LGPL since April 2014) of this site is stated in the footer. |
51 | | === Problems === |
52 | | * For install troubles, look at the InstallNotes page and/or [http://wiki.openstreetmap.org/index.php/JOSM] |
53 | | * Report bugs via [/newticket trac]. When reporting a bug please include the version (version number can be found in menu ''Help -> About''). |
54 | | * Understand [wiki:Releases JOSM release] system |
55 | | |
56 | | == How to help == |
57 | | * [wiki:DevelopersGuide Help developing code] (e.g. write patches for entries in [/report bug tracker]) |
58 | | * Review bugs in [/report bug tracker]: find duplicates, test bugs and add more descriptive texts |
59 | | * [wiki:Translations Translate] JOSM and the online help into your language. |
60 | | * Update and translate the [wiki:Help online help] |
61 | | * Unify and translate all JOSM related Wiki pages and join them with the online help |
62 | | * Review translations |
63 | | * Review original texts (program, online help, ...) |
64 | | * Create fancy new icons for presets or tools without icons |
65 | | * ... |
| 103 | {{{ |
| 104 | #!div class="wikipage compact" style="padding:0px; margin:0px; float:right; color: darkgray; font-size: 80%" |
| 105 | Server sponsored by: \\ |
| 106 | [[Image(wiki:Sponsoring:fossgis.png,title=FOSSGIS e.V.,alt=FOSSGIS e.V.,link=https://www.fossgis.de/)]] |
| 107 | }}} |
| 108 | * The volunteers creating JOSM can be reached using the [https://lists.openstreetmap.org/listinfo/josm-dev josm-dev] mailing list or the [irc://irc.oftc.net/josm #josm] IRC chat. |
| 109 | * If you use social networks, see our [https://en.osm.town/@josmeditor Mastodon], [https://www.facebook.com/josmeditor Facebook] and [https://twitter.com/josmeditor Twitter] pages. |