CINXE.COM
Help/Dialog/Notes – JOSM
<!DOCTYPE html> <html lang="en-US"> <head> <!-- # block head (placeholder in theme.html) --> <!-- # block head (content inherited from layout.html) --> <title> Help/Dialog/Notes – JOSM </title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <!--[if IE]><script> if (/^#__msie303:/.test(window.location.hash)) window.location.replace(window.location.hash.replace(/^#__msie303:/, '#')); </script><![endif]--> <link rel="start" href="/wiki" /> <link rel="search" href="/search" /> <link rel="help" href="/wiki/TracGuide" /> <link rel="stylesheet" href="/chrome/common/css/trac.css" type="text/css" /> <link rel="stylesheet" href="/chrome/common/css/wiki.css" type="text/css" /> <link rel="stylesheet" href="/chrome/vote/css/tracvote.css" type="text/css" /> <link rel="icon" href="/favicon.ico" type="image/x-icon" /> <link rel="alternate" href="/wiki/Help/Dialog/Notes?format=txt" title="Plain Text" type="text/x-trac-wiki" /> <link rel="up" href="/wiki/Help/Dialog" title="View parent page" /> <noscript> <style> .trac-noscript { display: none !important } </style> </noscript> <link type="application/opensearchdescription+xml" rel="search" href="/search/opensearch" title="Search JOSM"/> <script src="/chrome/common/js/jquery.js"></script> <script src="/chrome/common/js/babel.js"></script> <script src="/chrome/common/js/trac.js"></script> <script src="/chrome/common/js/search.js"></script> <script src="/chrome/common/js/folding.js"></script> <script src="/chrome/common/js/wiki.js"></script> <script> jQuery(function($) { $(".trac-autofocus").focus(); $(".trac-target-new").attr("target", "_blank"); if ($.ui) { /* is jquery-ui added? */ $(".trac-datepicker:not([readonly])") .prop("autocomplete", "off").datepicker(); // Input current date when today is pressed. var _goToToday = $.datepicker._gotoToday; $.datepicker._gotoToday = function(id) { _goToToday.call(this, id); this._selectDate(id) }; $(".trac-datetimepicker:not([readonly])") .prop("autocomplete", "off").datetimepicker(); } $(".trac-disable").disableSubmit(".trac-disable-determinant"); setTimeout(function() { $(".trac-scroll").scrollToTop() }, 1); $(".trac-disable-on-submit").disableOnSubmit(); }); </script> <!-- # include 'site_head.html' (layout.html) --> <link rel="stylesheet" type="text/css" href="/josm.css"/> <!-- end of site_head.html --> <!-- # endblock head (content inherited from layout.html) --> <link rel="alternate" type="application/x-wiki" href="/wiki/Help/Dialog/Notes?action=edit&version=" title="Edit this page"/> <script> jQuery(function($) { wikiColumn($("#wikipage")); }); </script> <!-- # endblock head (placeholder in theme.html) --> </head> <body> <!-- # block body (content inherited from theme.html) --> <!-- # include 'site_header.html' (theme.html) --> <!-- end of site_header.html --> <div id="banner"> <div id="header"> <a id="logo" href="https://josm.openstreetmap.de"> <img alt="JOSM" height="80" src="/svn/trunk/nodist/images/logo/header.png" width="156" /></a> </div> <form id="search" action="/search" method="get"> <div> <label for="proj-search">Search:</label> <input type="text" id="proj-search" name="q" size="18" value="" /> <input type="submit" value="Search" /> </div> </form> <div id="metanav" class="nav"> <ul><li class="first"><a href="/login">Login</a></li><li ><a href="/prefs">Preferences</a></li><li ><a href="/wiki/TracGuide">Help/Guide</a></li><li ><a href="/about">About Trac</a></li><li ><a href="/register">Register</a></li><li class="last"><a href="/reset_password">Forgot your password?</a></li></ul> </div> </div> <div id="mainnav" class="nav"> <ul><li class="active first"><a href="/wiki">Wiki</a></li><li ><a href="/timeline">Timeline</a></li><li ><a href="/log/josm/?verbose=on">Changelog</a></li><li ><a href="/browser">Browse Source</a></li><li ><a href="/report">View Tickets</a></li><li ><a href="/newticket">New Ticket</a></li><li ><a href="/roadmap">Roadmap</a></li><li ><a href="/jenkins/">Builds</a></li><li ><a href="/sonar/">Sonar</a></li><li class="last"><a href="/search">Search</a></li></ul> </div> <div id="main" > <div id="pagepath" class="noprint"> <a class="pathentry first" title="View WikiStart" href="/wiki">wiki:</a><a href="/wiki/Help" title="View Help" class="pathentry">Help</a><span class="pathentry sep">/</span><a href="/wiki/Help/Dialog" title="View Help/Dialog" class="pathentry">Dialog</a><span class="pathentry sep">/</span><a href="/wiki/Help/Dialog/Notes" title="View Help/Dialog/Notes" class="pathentry">Notes</a></div> <div id="ctxtnav" class="nav"> <h2>Context Navigation</h2> <ul> <li class="first"><span id="vote" title="Vote count"><img alt="Up-vote" src="/chrome/vote/aupgray.png" /><span id="votes">+0</span><img alt="Down-vote" src="/chrome/vote/adowngray.png" /></span></li> <li ><a href="/wiki/Help/Dialog">Up</a></li> <li ><a href="/wiki/WikiStart">Start Page</a></li> <li ><a href="/wiki/TitleIndex">Index</a></li> <li class="last"><a href="/wiki/Help/Dialog/Notes?action=history">History</a></li> </ul> <hr /> </div> <!-- # block content (placeholder in theme.html) --> <div id="content" class="wiki narrow"> <div class="wikipage searchable"> <div id="wikipage" class="trac-content borderless"><p> </p> <div class="wiki-toc trac-nav" style="clear:both"> <h4>Languages:</h4> <ul><li><a class="wiki" href="/wiki/De%3AHelp/Dialog/Notes">Deutsch</a> </li><li><strong>English</strong> </li><li><a class="wiki" href="/wiki/Es%3AHelp/Dialog/Notes">español</a> </li><li><a class="wiki" href="/wiki/Fr%3AHelp/Dialog/Notes">français</a> </li><li><a class="wiki" href="/wiki/Nl%3AHelp/Dialog/Notes">Nederlands</a> </li><li><a class="wiki" href="/wiki/Ru%3AHelp/Dialog/Notes">русский</a> </li></ul> </div><p> </p> <h1 class="section" id="NotesPanel">Notes Panel</h1> <p> <img alt="source:trunk/resources/images/dialogs/notes/note_open.svg" src="/browser/trunk/resources/images/dialogs/notes/note_open.svg?format=raw" style="margin-right:20px; vertical-align:middle" title="source:trunk/resources/images/dialogs/notes/note_open.svg" width="48" /> <em>Keyboard shortcut:</em> <strong><code>none</code></strong> — one of the <a class="wiki" href="/wiki/Help/ToggleDialogs#Toactivateawindow">JOSM panels</a> </p> <p> This panel presents a list of <a class="ext-link" href="https://wiki.openstreetmap.org/wiki/Notes" title="Notes in Wiki of OpenStreetMap"><span class="icon"></span>OSM notes</a> and allows to create new, comment, close or reopen notes. These notes can also be edited on the <a class="ext-link" href="https://www.openstreetmap.org/" title=" in OpenStreetMap webpage"><span class="icon"></span>OSM main page</a> (right toolbar). </p> <p> <img src="/raw-attachment/wiki/Help/Dialog/Notes/notesdialog.png" /> </p> <h2 class="section" id="Downloadingnotes">Downloading notes</h2> <p> There are different possibilities: </p> <ul><li>Use the "Notes" checkbox in the <a class="wiki" href="/wiki/Help/Action/Download">download dialog</a>. </li><li>Use the <img alt="source:trunk/resources/images/download_in_view.svg" src="/browser/trunk/resources/images/download_in_view.svg?format=raw" style="vertical-align:middle" title="source:trunk/resources/images/download_in_view.svg" /> "Download notes in current view" button of this panel </li><li>Search for a Note via the <a class="wiki" href="/wiki/Help/Menu/File">File menu</a> → <img alt="source:trunk/resources/images/note_search.svg" src="/browser/trunk/resources/images/note_search.svg?format=raw" style="vertical-align:middle" title="source:trunk/resources/images/note_search.svg" /> <a class="wiki" href="/wiki/Help/Action/SearchNotesDownload">Search Notes ...</a> </li><li>Use File menu → <img alt="source:trunk/resources/images/openlocation.svg" src="/browser/trunk/resources/images/openlocation.svg?format=raw" style="vertical-align:middle" title="source:trunk/resources/images/openlocation.svg" /> <a class="wiki" href="/wiki/Help/Action/OpenLocation">Open Location...</a> and enter a special URL or simply paste (<code>Ctrl+V</code>) the special URL into the JOSM <a class="wiki" href="/wiki/Help/MapView">Map View</a>. </li><li>Use File menu → <img alt="source:trunk/resources/images/dialogs/notes/note_open.svg" src="/browser/trunk/resources/images/dialogs/notes/note_open.svg?format=raw" style="vertical-align:middle" title="source:trunk/resources/images/dialogs/notes/note_open.svg" /> <a class="wiki" href="/wiki/Help/Action/DownloadNotesInView">Download notes in current view</a> </li><li><img alt="source:trunk/resources/images/open.svg" src="/browser/trunk/resources/images/open.svg?format=raw" style="vertical-align:middle" title="source:trunk/resources/images/open.svg" /> <a class="wiki" href="/wiki/Help/Action/Open">Open</a> a local .osc file containing Notes (e.g. created by the smartphone app OSMAnd). </li><li>(Downloading via <a class="wiki" href="/wiki/Help/Preferences/RemoteControl">remote control</a> on www.openstreetmap.org is not yet working, see <a class="new ticket" href="/ticket/11367" title="#11367: enhancement: Download notes when using remote control on osm.org with note layer enabled (new)">#11367</a> and <a class="ext-link" href="https://github.com/openstreetmap/openstreetmap-website/issues/957"><span class="icon"></span>github issue</a>) </li></ul><h2 class="section" id="Features">Features</h2> <table class="wiki"> <tr><th> Icon </th><th> Name </th><th> Description </th></tr><tr><td style="text-align: center"> <img alt="source:trunk/resources/images/download_in_view.svg" src="/browser/trunk/resources/images/download_in_view.svg?format=raw" style="vertical-align:middle" title="source:trunk/resources/images/download_in_view.svg" /> </td><td style="text-align: center"> Download notes in current view </td><td> </td></tr><tr><td style="text-align: center"> <img alt="source:trunk/resources/images/dialogs/notes/note_new.svg" src="/browser/trunk/resources/images/dialogs/notes/note_new.svg?format=raw" style="vertical-align:middle" title="source:trunk/resources/images/dialogs/notes/note_new.svg" /> </td><td style="text-align: center"> Create a new note </td><td> </td></tr><tr><td style="text-align: center"> <img alt="source:trunk/resources/images/dialogs/notes/note_comment.svg" src="/browser/trunk/resources/images/dialogs/notes/note_comment.svg?format=raw" style="vertical-align:middle" title="source:trunk/resources/images/dialogs/notes/note_comment.svg" /> </td><td style="text-align: center"> Add comment </td><td> Add a comment to an open note. </td></tr><tr><td style="text-align: center"> <img alt="source:trunk/resources/images/dialogs/notes/note_closed.svg" src="/browser/trunk/resources/images/dialogs/notes/note_closed.svg?format=raw" style="vertical-align:middle" title="source:trunk/resources/images/dialogs/notes/note_closed.svg" /> </td><td style="text-align: center"> Close note </td><td> </td></tr><tr><td style="text-align: center"> <img alt="source:trunk/resources/images/dialogs/notes/note_open.svg" src="/browser/trunk/resources/images/dialogs/notes/note_open.svg?format=raw" style="vertical-align:middle" title="source:trunk/resources/images/dialogs/notes/note_open.svg" /> </td><td style="text-align: center"> Reopen note </td><td> </td></tr><tr><td style="text-align: center"> <img alt="source:trunk/resources/images/dialogs/sort.svg" src="/browser/trunk/resources/images/dialogs/sort.svg?format=raw" style="vertical-align:middle" title="source:trunk/resources/images/dialogs/sort.svg" /> </td><td style="text-align: center"> Sort notes </td><td> You can sort the notes in the list by state (open, closed, new), username, created date or last change date. </td></tr><tr><td style="text-align: center"> <img alt="source:trunk/resources/images/help/internet.svg" src="/browser/trunk/resources/images/help/internet.svg?format=raw" style="vertical-align:middle" title="source:trunk/resources/images/help/internet.svg" /> </td><td style="text-align: center"> Open the note in an <br /> external browser </td><td> Opens the selected note in your defaut web browser. Alternatively you can use <a class="wiki" href="/wiki/Help/Action/InfoAboutElementsWeb">Advanced info (web)</a> from the View menu. </td></tr><tr><td style="text-align: center"> <img alt="source:trunk/resources/images/upload.svg" src="/browser/trunk/resources/images/upload.svg?format=raw" style="vertical-align:middle" title="source:trunk/resources/images/upload.svg" /> </td><td style="text-align: center"> Upload note changes <br /> to server </td><td> After you created a note or made changes to existing notes, the changes are not uploaded automatically. You need to press this button. If you try to delete the Notes layer or close JOSM with not yet uploaded note changes, JOSM will ask, if you want to upload the changes. </td></tr><tr><td> </td><td style="text-align: center"> (left click) </td><td> A left click on a notes symbol in the map view or on a list entry in the list opens the note's content in a tooltip in the map area </td></tr><tr><td> </td><td style="text-align: center"> (double click) </td><td> A double click will move the map view so that the note is centered </td></tr><tr><td> </td><td style="text-align: center"> <strong><code>Ctrl+C</code></strong> </td><td> Select a note in the list and press <strong><code>Ctrl+C</code></strong> to copy the ID of the note and the text of the first comment to the clipboard. (A more usable way is to select and copy text directly in the notes tooltip.) </td></tr></table> <p> There is also a context menu if you right click a note in the list to Comment/Open in browser/Close/Reopen a note. </p> <h3 class="section" id="Filtering">Filtering</h3> <p> With the searchbox above the notes in the Notes Panel you can filter the downloaded notes. Some words have a special meaning. </p> <table class="wiki"> <tr><th>Word</th><th>Description </th></tr><tr><td style="text-align: center"> open </td><td> Only show notes that are open </td></tr><tr><td style="text-align: center"> closed </td><td> Only show notes that are closed </td></tr><tr><td style="text-align: center"> reopened </td><td> Only show notes that are reopened </td></tr><tr><td style="text-align: center"> new </td><td> Only show notes that have not yet been uploaded </td></tr><tr><td style="text-align: center"> modified </td><td> Only show notes that have new comments that have not yet been uploaded </td></tr></table> <h2 class="section" id="AdvancedPreferences">Advanced Preferences</h2> <p> There are some advanced settings for notes. To change them first download some notes and then go to the <a class="wiki" href="/wiki/Help/Preferences/Advanced">Advanced preference</a> and search for the following keys: </p> <ul><li><code>osm.notes.daysClosed</code>: you can specify how long (in days) the notes should still be downloaded after they were closed. The default value is <code>7</code>. <strong>Note</strong>: This preference is also available under <a class="wiki" href="/wiki/Help/Preferences/Connection#OSMNotes">Connection preferences</a>. <ul><li>set a positive number to set the days (e.g. <code>10</code> means a note which was closed 10 days ago will be downloaded, a note which was closed 11 days ago will not) </li><li>set it to <code>0</code>, to download only open notes </li><li>set it to <code>-1</code>, to download all created notes ever (of course only in the selected area and limited to the maximum download limit, see below) </li></ul></li><li><code>osm.notes.downloadLimit</code>: you can specify the maximum number of downloaded notes. The default value is <code>1000</code>. The maximum value is <code>10000</code>. There is a warning displayed if you reach the limit. </li></ul><h2 class="section" id="Seealso">See also</h2> <ul><li><a class="wiki" href="/wiki/Help/Action/AutoSave">Autosave</a> - restores unsaved Notes layers in case of a JOSM crash. </li><li>a <a class="ext-link" href="https://ksmapper.blogspot.de/2015/02/a-note-about-josm.html"><span class="icon"></span>description</a> how you may use notes from the main developer of the JOSM notes implementation </li></ul><hr /> <p> Back to <a class="wiki" href="/wiki/Help/Menu/Windows">Windows menu</a><br /> Back to <a class="wiki" href="/wiki/Help/ToggleDialogs">Sidebar</a><br /> Back to <a class="wiki" href="/wiki/Help">Main Help</a> </p> </div> <div class="trac-modifiedby"> <span> <a href="/wiki/Help/Dialog/Notes?action=diff&version=68" title="Version 68 by skyper: precise link">Last modified</a> <a class="timeline" href="/timeline?from=2024-05-14T21%3A02%3A43%2B02%3A00&precision=second" title="See timeline at 2024-05-14T21:02:43+02:00">9 months ago</a> </span> <span class="trac-print"> Last modified on 2024-05-14T21:02:43+02:00 </span> </div> </div> <div id="attachments"> <h3 class="foldable"> Attachments <span class="trac-count">(1)</span></h3> <div> <ul> <li> <a href="/attachment/wiki/Help/Dialog/Notes/notesdialog.png" title="View attachment">notesdialog.png</a><a href="/raw-attachment/wiki/Help/Dialog/Notes/notesdialog.png" class="trac-rawlink" title="Download">​</a> (<span title="28384 bytes">27.7 KB</span> ) - added by <span class="trac-author">Klumbumbus</span> <a class="timeline" href="/timeline?from=2022-08-31T21%3A07%3A43%2B02%3A00&precision=second" title="See timeline at 2022-08-31T21:07:43+02:00">2 years ago</a>. </li> </ul> <p> Download all attachments as: <a rel="nofollow" href="/zip-attachment/wiki/Help/Dialog/Notes/">.zip</a> </p> </div> </div> <div class="buttons"> <form method="get" action="/wiki/Help/Dialog/Notes" id="modifypage"> <div> <input type="hidden" name="action" value="edit" /> <input type="submit" value="Edit this page" /> </div> </form> <form method="get" action="/attachment/wiki/Help/Dialog/Notes/" id="attachfile"> <div> <input type="hidden" name="action" value="new" /> <input type="submit" id="attachfilebutton" value="Attach another file"/> </div> </form> </div> <div class="trac-help"> <strong>Note:</strong> See <a href="/wiki/TracWiki">TracWiki</a> for help on using the wiki. </div> </div> <!-- # block content (content inherited from layout.html) --> <script type="text/javascript"> jQuery("body").addClass("trac-has-js"); </script> <div id="altlinks"> <h3>Download in other formats:</h3> <ul> <li class="first last"> <a rel="nofollow" href="/wiki/Help/Dialog/Notes?format=txt" class=""> Plain Text</a> </li> </ul> </div> <!-- # endblock content (content inherited from layout.html) --> <!-- # endblock content (placeholder in theme.html) --> </div> <div id="footer"><hr/> <a id="tracpowered" href="https://trac.edgewall.org/" ><img src="/chrome/common/trac_logo_mini.png" height="30" width="107" alt="Trac Powered"/></a> <p class="left"> Powered by <a href="/about"><strong>Trac 1.6</strong></a> <br /> By <a href="http://www.edgewall.org/">Edgewall Software</a> . </p> <p class="right">Server sponsored by <a href="https://www.fossgis.de/">FOSSGIS</a>. Visit the OpenStreetMap project at <a href="https://www.openstreetmap.org/">https://www.openstreetmap.org/</a><br />Content is available under <a href="https://creativecommons.org/licenses/by-sa/3.0/">Creative Commons (CC-BY-SA)</a> and anything since April 2014 also under <a href="https://www.gnu.org/licenses/lgpl.html">LGPL</a> license.</p> </div> <!-- # include 'site_footer.html' (theme.html) --> <!-- end of site_footer.html --> <!-- # endblock body (content inherited from theme.html) --> </body> </html>