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) written in [https://www.azul.com/downloads/?version=java-21-lts&package=jdk-fx#zulu Java 11+]. |
| 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 and online sources, and allows editing the OSM data (nodes, ways, and relations) and their metadata tags. |
| 20 | |
| 21 | JOSM is [source:/trunk open source] and licensed under the [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 | Launch [/download/josm.jnlp josm.jnlp] (Latest 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 | Windows installer ([/download/windows/josm-setup.msi MSI], [/download/windows/josm-setup.exe EXE]) (version |
| 46 | [[Version(windows)]]), or install 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 app] (version |
| 52 | [[Version(macos)]]), or use [https://formulae.brew.sh/cask/josm homebrew] (see [wikitr:/Download#macOS how to install]). |
| 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 of [/download/josm-latest.jnlp josm-latest.jnlp], [/josm-latest.jar josm-latest.jar] (version [[Version(latest)]]). Windows (MSI, EXE) and macOS builds are available on [https://github.com/JOSM/josm/releases GitHub]. |
| 58 | }}} |
| 59 | }}} |
| 60 | {{{#!tr ==================================== |
| 61 | {{{#!td colspan=2 align=left valign=top style="background:#eee; padding:0px 15px 0px 13px; border:1px solid #ccc" |
| 62 | [wikitr:/Download#Ubuntu Ubuntu / Debian repository], and all other [wikitr:/Download download] options. |
| 63 | }}} |
| 64 | }}} |
| 67 | == Getting Started == |
| 68 | * The [wikitr:/Introduction Introduction] page will guide you through your first successful edit. |
| 69 | * See the official **[wikitr:/Help help system]** – Press `<F1>` anywhere in the JOSM interface or the [[JOSMImage(help,link=wikitr:/Help/Menu/Help,24,middle,title=Help)]] Help button in dialogs to access the help bowser. |
| 70 | * Ask members of the OpenStreetMap community at |
| 71 | * the [https://community.openstreetmap.org/tag/josm OSM Community Forum] |
| 72 | * various [osmwiki:Mailing_List OSM mailing lists] (e.g. [https://lists.openstreetmap.org/listinfo/talk talk], [https://lists.openstreetmap.org/ list overview]) |
| 73 | * 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. |
| 75 | == Extensions == |
| 76 | * [[JOSMImage(preferences/plugin,link=wikitr:/Plugins,24,middle,alt=plugins,title=Plugins)]] **[wikitr:/Plugins]** add more complex program features to JOSM. ([wikitr:/Help/Preferences/Plugins installation instructions]) |
| 77 | * [[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]) |
| 78 | * [[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]) |
| 79 | * [[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]) |
| 80 | * [[JOSMImage(imagery_menu,link=wikitr:/Maps,24,middle,alt=maps,title=Maps)]] **[wikitr:/Maps Backgrounds]** allow you to trace OSM data, such as 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 USB flash drive] 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 [[Changelog|summarized changelog]] or the [/log/?verbose=on SVN changelog]. Major changes are noted in the [wiki:StartupPage JOSM startup notes]. |
27 | | * If download size is an issue for you, you may append `?lang=..` to the download link for both releases to strip all unused translations (e.g. `?lang=de` would download JOSM in German language only). |
28 | | * Other [[Download]] options like Ubuntu PPA |
| 82 | == Recent Changes == |
| 83 | * [wikitr:/StartupPage Startup notes] (most important changes) |
| 84 | * [wikitr:/Changelog Summarized changelog] (nicely summarized) |
| 85 | * [/log/?verbose=on SVN changelog] (complete log) |
30 | | === Extensions === |
31 | | * Get many [wiki:Plugins plugins], [wiki:Presets presets] or [wiki:Styles styles] (Easier installation via JOSM preferences). |
32 | | * URLs of usable WMS services can be viewed and added at [wiki:Maps] page. |
33 | | * Problems with plugins? Have a look at the [/download/ JOSM download directory]. |
34 | | * 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]. |
| 87 | == Found a bug? | Have an idea? | Make a suggestion? | [=#Contribute Like to contribute?]==#Bugs |
| 88 | * **Report** any bugs you found! The **[wikitr:/Help/Action/ReportBug Report Bug]** form in the [wikitr:/Help/Menu/Help Help] menu makes it easy. |
| 89 | * **Create** [/newticket tickets] with your ideas and enhancements and [#contact discuss] with the team. |
| 90 | * **Contribute** with updates, corrections and [wikitr:/Translations translations] to standardize all JOSM-related pages and connect them with the [wikitr:/Help help system]. |
| 91 | * **Participate** in [/report bug tracking] by reviewing bugs, finding duplicates, testing bugs, adding more descriptive text. |
| 92 | * **Design** fancy new [wikitr:/Styles#Icons icons]. |
| 93 | * **Develop** the [wikitr:"/Source code#Getthesource" source code] further. See the [wikitr:/DevelopersGuide developers guide] for build instructions and more details. |
36 | | == Development == |
37 | | * View the [[Changelog|summarized changelog]] or the [/log/?verbose=on SVN changelog]. Major changes are noted in the [wiki:StartupPage JOSM startup notes]. |
38 | | * Download the '''[/josm-latest.jar latest JOSM]''' version [[Version(latest)]] (may have more errors than "tested", be careful with this one). |
39 | | * Try '''[/applet JOSM applet]''' after reading the [wiki:Applet applet description]. |
40 | | * Get the source: |
41 | | * From the official Subversion repository (recommended): {{{svn co http://josm.openstreetmap.de/svn/trunk}}} |
42 | | * From the unofficial [http://github.com/openstreetmap/josm GitHub mirror]: {{{git clone git://github.com/openstreetmap/josm.git}}} |
43 | | * From the official OSM Subversion repository (including plugins): {{{svn co http://svn.openstreetmap.org/applications/editors/josm josm}}} |
44 | | * See [wiki:DevelopersGuide Developers Guide] or [wiki:Translations Translations Guide] |
45 | | * The Ubuntu JOSM project on [https://launchpad.net/ubuntu/+source/josm launchpad] |
| 95 | == About this site == |
| 96 | * This site is a combined help and bug tracking system for JOSM and JOSM plugins. |
| 97 | * No login is required to use this site (either to read or edit the Wiki or the bug tracker). |
| 98 | * But logging in has advantages: |
| 99 | * You will receive notifications of changes to your bug tracker tickets. This is also possible by entering an e-mail as a username in the tickets, but be aware that the address will be publicly visible and you will not be able to change it later. |
| 100 | * Page settings will be remembered (e.g. input field size and a lot of other stuff). |
| 101 | * Registrations without an e-mail address and unused registrations are automatically deleted. |
| 102 | * Accounts for editing the OpenStreetMap database are separate from the accounts on this server. |
| 103 | * The copyright (CC-BY-SA and LGPL since April 2014) of this site is stated in the footer. |
| 104 | * Personal data, such as e-mail address, is used only for contact purposes related to the JOSM software. There is no user tracking or advertising. |
| 105 | * Data about the usage of this website is stored for statistical purposes (including usage initiated by JOSM). Raw logs including IP addresses are deleted after a few weeks when no longer required. |
47 | | == Help and Support == |
48 | | * The official '''[wiki:Help help system / documentation]''' (can be reached with <F1> from within JOSM). |
49 | | * Comprehensive introduction on the [http://wiki.openstreetmap.org/wiki/JOSM Openstreetmap wiki]. |
50 | | * Tutorial on [http://en.flossmanuals.net/openstreetmap/editing-with-josm/ flossmanuals.net]. |
51 | | * Some [wiki:TutorialVideos video tutorials] (mostly outdated) |
52 | | * Ask members of the Openstreetmap community on |
53 | | * the [http://forum.openstreetmap.org/viewforum.php?id=54 OSM-forum] |
54 | | * various [http://wiki.openstreetmap.org/wiki/Mailing_List OSM mailinglists] (e.g. [http://lists.openstreetmap.org/listinfo/talk talk] and [http://lists.openstreetmap.org/listinfo/newbies newbies], [http://lists.openstreetmap.org/pipermail/ list overview]) |
55 | | * the [http://wiki.openstreetmap.org/wiki/IRC OSM IRC channel] |
| 107 | == About Certificates == |
| 108 | * JOSM wiki page uses a Let's Encrypt certificate which is constantly renewed ([/certs/josm.openstreetmap.de.crt]). |
| 109 | * JOSM JAR release files are signed with a private certificate ([/certs/josm.openstreetmap.de_code.crt]) from a private CA ([/certs/stoecker2023.pem]). **You'll may have to accept a warning at least once.** |
| 110 | * JOSM GitHub files and Windows version are signed with a private certificate ([/certs/josm.openstreetmap.de_code_github.crt]) from the same CA. **You'll may have to accept a warning at least once.** |
| 111 | * JOSM MacOS software is signed with an Apple certificate ([/certs/josm.openstreetmap.de_code_apple.crt]). |
| 112 | * JOSM repository is signed with an individual OpenPGP key ([/josm-apt.key]). |
57 | | === Problems === |
58 | | * For install troubles, look at the InstallNotes page and/or [http://wiki.openstreetmap.org/index.php/JOSM] |
59 | | * Report bugs via [/newticket trac]. When reporting a bug please include the version (version number can be found in menu ''[wiki:Help/Menu/Help Help] -> [wiki:Help/Action/About About]''). |
60 | | * Understand [wiki:Releases JOSM release] system |
61 | | |
62 | | == How to help == |
63 | | * [wiki:DevelopersGuide Help developing code] (e.g. write patches for entries in [/report bug tracker]) |
64 | | * Review bugs in [/report bug tracker]: find duplicates, test bugs and add more descriptive texts |
65 | | * [wiki:Translations Translate] JOSM and the online help into your language. |
66 | | * Update and translate the [wiki:Help online help] |
67 | | * Unify and translate all JOSM related Wiki pages and join them with the online help |
68 | | * Review translations |
69 | | * Review original texts (program, online help, ...) |
70 | | * Create fancy new icons for presets or tools without icons |
71 | | * ... |
72 | | |
73 | | == This site == |
74 | | * This site is a combined online help and bug tracking system for JOSM and JOSM plugins |
75 | | * No login is required to use this site (neither for reading nor for changes to wiki or bug tracker) |
76 | | * A login has following advantages: |
77 | | * The JOSM applet can store settings on the server |
78 | | * Mails are sent for changes in own bug tracker tickets (This is possible also by entering an e-mail as username in the tickets, but you are unable to change that later and the address is openly visible). |
79 | | * Page settings are remembered (e.g. input field size and a lot of other stuff) |
80 | | * Logins which have no e-mail address or which have not been used at least once are automatically deleted. |
81 | | * The login to edit the OpenStreetMap database has nothing to do with this server! |
82 | | * '''NOTE: The secured HTTPS version of this site uses a [wiki:ServerCertificate self-signed certificate] with 26:8B:4D:CB:AD:04:E7:50:EC:94:F8:34:83:CE:7C:06:8D:FD:61:3D as SHA1 fingerprint.[[BR]]You need to [wiki:ServerCertificate accept] this certificate as valid to silence the warnings of your browser.''' |
83 | | |
84 | | == Contact == |
85 | | |
86 | | * For problems, ideas, suggestions use the [/newticket bug tracker] |
87 | | * The volunteers creating JOSM can be reached using the [http://lists.openstreetmap.org/listinfo/josm-dev josm-dev] mailinglist |
88 | | * The server running this service is operated by [http://www.fossgis.de/impressum.html FOSSGIS] society |
| 114 | == Contact ==#contact |
| 115 | {{{ |
| 116 | #!div class="wikipage compact" style="padding:0px; margin:0px; float:right; color: darkgray; font-size: 80%" |
| 117 | Server sponsored by: \\ |
| 118 | [[Image(wiki:Sponsoring:fossgis.png,title=FOSSGIS e.V.,alt=FOSSGIS e.V.,link=https://www.fossgis.de/)]] |
| 119 | }}} |
| 120 | * Please use the bug [/newticket reporting system] for problems, but also for ideas and suggestions. |
| 121 | * Inactive: The volunteers behind JOSM can be reached using the [https://lists.openstreetmap.org/listinfo/josm-dev josm-dev] mailing list (Closed on 2024-05-16) or the [irc://irc.oftc.net/josm #josm] IRC chat. |
| 122 | * Inactive: 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. |