1JOSM(1) General Commands Manual JOSM(1)
2
6 josm - Java OpenStreetMap Editor
7
9 josm
10
12 JOSM is an editor for OpenStreetMap written in Java 8.
13 OpenStreetMap is a project aimed squarely at creating and providing
15 free geographic data such as street maps to anyone who wants them. It
16 allows you to view, edit and use geographical data in a collaborative
17 way from anywhere on earth. The project was started because most maps
18 you think of as free actually have legal or technical restrictions on
19 their use, holding back people from using them in creative, productive
20 or unexpected ways.
21
23 -h, -?, --help
24 Show help
25 --geometry=<width>x<height>(+|-)x(+|-)y
27 Standard X geometry argument
28 [--download=]minlat,minlon,maxlat,maxlon
30 Download the bounding box
31 [--download=]<url>
33 Download the location at the url (with lat=x&lon=y&zoom=z)
34 [--download=]<filename>
36 Open file (any file type that can be opened with File/Open)
37 --downloadgps=minlat,minlon,maxlat,maxlon
39 Download the bounding box as raw gps
40 --selection=<searchstring>
42 Select with the given search
43 --[no-]maximize
45 Do [not] launch in maximized mode
46 --reset-preferences
48 Reset the preferences to the default
49 --load-preferences=<url-to-xml>
51 Change preferences according to the XML file
52 --set=<key>=<value>
54 Set preference key to value
55 --language=<language>
57 Set the language
58 --version
60 Display the JOSM version
61 --debug
63 Print debugging messages to console
64 --offline=<osm_api|josm_website|all>
66 Disable access to the given resource(s), separated by comma
67
69 JOSM files are saved according to the XDG Base Directory Specification:
70 $HOME/.config/JOSM
72 Preferences
73 $HOME/.local/share/JOSM
75 User data
76 $HOME/.cache/JOSM
78 Cache
79 If the directory $HOME/.josm exists, all files are stored there.
81
83 The following options can be set by using Java system properties (i.e.
84 -Dkey=value passed to java, or specified inside JAVA_OPTS).
85 josm.pref=<path>
87 Set the JOSM preferences directory.
88 josm.userdata=<path>
90 Set the JOSM user data directory.
91 josm.cache=<path>
93 Set the JOSM cache directory.
94 josm.home=<homedir>
96 Relocate all 3 directories to homedir. Cache directory will be
97 in <homedir>/cache.
98 josm.name=<JOSM>
100 Change the JOSM directory name.
101
103 JAVA_HOME
104 Specify an alternate Java environment.
105 JAVA_OPTS
107 Specify Java options. For example, to use a HTTP proxy server
108 with this program, set this environment variable to something
109 like JAVA_OPTS="-Dhttp.proxyHost=yourProxyURL" before starting
110 josm.
111
113 JOSM was originally designed and coded by Immanuel Scholz, and is now
114 maintained by the OpenStreetMap community.
115 The current JOSM maintainer is Dirk Stöcker. A lot of administration
117 work is done by Paul Hartmann and Vincent Privat.
118 Major code contributions from (in alphabetical order):
120 Stefan Breunig David Earl Gabriel Ebner Dave Hansen Paul Hartmann Karl
122 Guggisberg Matthias Julius Alexei Kasatkin Jiri Klement Ulf Lamping
123 Simon Legner Raphael Mack Upliner Mikhalych Vincent Privat Frederik
124 Ramm Dirk Stöcker
125 Many minor contributions and patches by others; see SVN history at
127 https://josm.openstreetmap.de/svn/ for details. Use "josm-dev AT open‐
128 streetmap.org" to contact still active authors. The logo has been
129 designed by Ilya Palikov.
130 This manual page was initially written by Andreas Putzo
132 <andreas@putzo.net>, for the Debian project (but may be used by oth‐
133 ers).
134 July 21, 2016 JOSM(1)