| 56 | | Latest [[Download#DevelopmentVersion|development version]] ([[Version(latest)]]), [[Download#Ubuntu|Ubuntu package repository]] and other [[Download|download]] options. |
| | 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. |
| | 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] |
| 62 | | == What has been changed recently? == |
| 63 | | * [wiki:StartupPage Startup notes] (most important changes) |
| 64 | | * [wiki:Changelog Summarized changelog] (nicely summarized) |
| 65 | | * [/log/?verbose=on SVN changelog] (very detailed) |
| | 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]) |
| 68 | | == Extensions == |
| 69 | | * [[Image(/svn/trunk/images/preferences/plugin.png,link=wiki:Plugins,24px)]] **[wiki:Plugins]** ([Help/Preferences/Plugins installation instructions]) |
| 70 | | * [[Image(/svn/trunk/images/dialogs/propertiesdialog.png,link=wiki:Presets)]] **[wiki:Presets]** ([TaggingPresets installation instructions]) |
| 71 | | * [[Image(/svn/trunk/images/dialogs/mapstyle.png,link=wiki:Styles)]] **[wiki:Styles]** (installation instructions) |
| 72 | | * [[Image(/svn/trunk/images/imagery_menu.png,link=wiki:Maps)]] **[wiki:Maps Backgrounds]** ([Help/Preferences/Imagery installation instructions]) |
| | 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. |
| | 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. |
| 75 | | == Getting Started | [[Help]] == |
| 76 | | * Comprehensive introduction on the [https://wiki.openstreetmap.org/wiki/JOSM OpenStreetMap wiki]. |
| 77 | | * The official [[Image(/svn/trunk/images/help.png,link=wiki:Help,24px,valign=middle)]] **[wiki:Help help system / documentation]** (can be reached with {{{<F1>}}} from within JOSM). |
| 78 | | * Tutorial on [http://en.flossmanuals.net/openstreetmap/editing-with-josm/ flossmanuals.net]. |
| 79 | | * Some [wiki:TutorialVideos video tutorials] (mostly outdated) |
| 80 | | * Ask members of the OpenStreetMap community on |
| 81 | | * the [http://forum.openstreetmap.org/viewforum.php?id=54 OSM-forum] |
| 82 | | * various [http://wiki.openstreetmap.org/wiki/Mailing_List OSM mailing lists] (e.g. [http://lists.openstreetmap.org/listinfo/talk talk] and [http://lists.openstreetmap.org/listinfo/newbies newbies], [http://lists.openstreetmap.org/pipermail/ list overview]) |
| 83 | | * the [http://wiki.openstreetmap.org/wiki/IRC OSM IRC channel], including our [irc://irc.oftc.net/josm own channel] |
| 84 | | * [wiki:HowTo HowTos] |
| | 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]). |
| 86 | | == Found a bug? | Have an idea? | Make a suggestion? ==#Bugs |
| 87 | | * Please report any bug found: |
| 88 | | Create a [/newticket new ticket]. When reporting a bug, please include the first three blocks of the **status report** (Help -> [wiki:Help/Action/ShowStatusReport Show status report]). |
| 89 | | * Discuss ideas and suggestions also in the [/newticket bug tracker], on the [http://lists.openstreetmap.org/listinfo/josm-dev josm-dev] mailing list, or on the [irc://irc.oftc.net/josm #josm] IRC channel. |
| 90 | | |
| 91 | | == Contribute == |
| 92 | | |
| 93 | | * **Use JOSM** |
| 94 | | * Report bugs, discuss ideas, think of possible enhancements ([#Bugs see above]). |
| 95 | | * Participate in **[/report bug tracking]** |
| 96 | | * Review bugs, up/down vote tickets, find duplicates, test bugs, add more descriptive texts. |
| 97 | | * Correct/update/extend the **[wiki:Help online help]** |
| 98 | | * Unify all JOSM-related Wiki pages and join them with the online help. |
| 99 | | * **[wiki:Translations Translate]** program/documentation. |
| 100 | | * **Design** fancy new [wiki:Styles#Icons icons]. |
| 101 | | * **Write code** – get the code and write patches … |
| 102 | | * [wiki:Download#Source get the code] |
| 103 | | * See [wiki:DevelopersGuide developers guide] for build instructions and other details. |
| 104 | | |
| 105 | | ---- |
| 106 | | |
| 107 | | == This site == |
| 108 | | * This site is a combined online help and bug tracking system for JOSM and JOSM plugins. |
| 109 | | * No login is required to use this site (neither for reading nor for changes to wiki or bug tracker). |
| 110 | | * A login has the following advantages: |
| 111 | | * The JOSM applet can store settings on the server. |
| 112 | | * Mail is sent for changes in your own bug tracker tickets. This is possible by entering an e-mail as user name in the tickets, too, but then be aware that the address is openly visible and you are unable to change that later. |
| 113 | | * Page settings are remembered (e.g. input field size and a lot of other stuff). |
| 114 | | * Logins which have no e-mail address or which have not been used at least once are automatically deleted. |
| 115 | | * Logins to edit the OpenStreetMap database are separate from the logins on this server. |
| 116 | | * **NOTE: The secured HTTPS version of this site uses a [wiki:ServerCertificate self-signed certificate] with the SHA1 fingerprint 26:8B:4D:CB:AD:04:E7:50:EC:94:F8:34:83:CE:7C:06:8D:FD:61:3D. [[BR]] |
| 117 | | You need to [wiki:ServerCertificate accept] this certificate as valid to silence the warnings of your browser.** |
| 118 | | |
| 119 | | == Contact == |
| 120 | | |
| | 114 | == Contact ==#contact |
| 125 | | * For problems, ideas, suggestions use the [/newticket bug tracker]. |
| 126 | | * The volunteers creating JOSM can be reached using the [http://lists.openstreetmap.org/listinfo/josm-dev josm-dev] mailing list or the [irc://irc.oftc.net/josm #josm] IRC chat. |
| 127 | | * The server running this service is operated by [http://www.fossgis.de/impressum.html FOSSGIS] society. |
| | 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. |
