{"id":15058947,"url":"https://github.com/josm/josm","last_synced_at":"2026-04-21T06:08:54.784Z","repository":{"id":891224,"uuid":"641525","full_name":"JOSM/josm","owner":"JOSM","description":"!!!Mirror!!! of JOSM Subversion repository","archived":false,"fork":false,"pushed_at":"2025-05-09T20:10:58.000Z","size":2085070,"stargazers_count":399,"open_issues_count":21,"forks_count":198,"subscribers_count":32,"default_branch":"master","last_synced_at":"2025-05-09T21:24:43.371Z","etag":null,"topics":["editor","git","java","josm","mirror","openstreetmap","svn"],"latest_commit_sha":null,"homepage":"https://josm.openstreetmap.de","language":"Java","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"tmpvar/jsdom","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JOSM.png","metadata":{"files":{"readme":"README","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2010-05-01T16:34:52.000Z","updated_at":"2025-05-09T20:10:22.000Z","dependencies_parsed_at":"2023-09-21T23:26:15.553Z","dependency_job_id":"dfbfeea0-0012-4c31-9bb1-1bdc970f0f53","html_url":"https://github.com/JOSM/josm","commit_stats":{"total_commits":18931,"total_committers":29,"mean_commits":652.7931034482758,"dds":0.6502561935449791,"last_synced_commit":"0f7d0028c2180fed0bd7ba7ca548507ab405fd41"},"previous_names":[],"tags_count":1865,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JOSM%2Fjosm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JOSM%2Fjosm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JOSM%2Fjosm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JOSM%2Fjosm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JOSM","download_url":"https://codeload.github.com/JOSM/josm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254328386,"owners_count":22052632,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["editor","git","java","josm","mirror","openstreetmap","svn"],"created_at":"2024-09-24T22:34:10.868Z","updated_at":"2026-01-12T15:26:33.776Z","avatar_url":"https://github.com/JOSM.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"Supplemental information for JOSM -- the Java OpenStreetMap Editor\n\n=============================================================================\n            I. Install \u0026 Launch\n=============================================================================\n\nInstallation notes\n------------------\nTo run JOSM, you need:\n\n* The JOSM .jar file, e.g., josm-tested.jar or josm-latest.jar\n* Java Runtime Environment (JRE) 11, or later.\n\n\nHow to get Java Runtime Environment\n-----------------------------------\nYou need JRE Version 11, or later.\n\nMicrosoft Windows and Apple macOS users should visit one of:\n- https://www.azul.com/downloads/?package=jdk#download-openjdk\n- https://bell-sw.com/pages/downloads/#mn\nand download the latest Java executable for their system.\n\nLinux users should visit http://www.oracle.com/technetwork/java/index.html\nThere is a Linux binary installer, which you must execute from a console, or\nuse the mechanism of your distribution's packaging system.\n\n\nHow to launch\n-------------\nMicrosoft Windows users launch by double-clicking on the .jar file.\nIf this does not work, open a command shell and type\n\"java -jar josm-latest.jar\"  in the directory that holds the file. (Please\nreplace josm-latest.jar with the name of your .jar file, if you aren't using\nthe latest version.)\n\nUnder Linux, open a shell, go to the file directory and type\n\"java -jar josm-latest.jar\" to launch. If this does not work, try to set\nyour JAVA_HOME variable to the java executable location (the root location,\nnot the bin).\n\nmacOS users just click on the .jar file icon.\n\n=============================================================================\n            II. Development\n=============================================================================\n\nHow to get the source code\n--------------------------\nDownload it directly from the subversion at\nhttps://josm.openstreetmap.de/svn/trunk. To use the command line subversion\nclient, type\n\nsvn co https://josm.openstreetmap.de/svn/trunk josm\n\n\nFiles \u0026 directories\n-------------------\nThis is an overview of the files and directories in the JOSM code repository:\n- build.xml                 ant build file (standard way to create a JOSM binary)\n- CONTRIBUTION              list of major code contributors\n- gpl-2.0.txt, gpl-3.0.txt  full text of the GNU General Public License\n- LICENSE                   the JOSM license terms\n- native/                   OS-specific files\n  - linux/                  files useful for Linux distributions, including Appdata files, .desktop\n                            files, Debian/Ubuntu scripts, man pages, icons, etc.\n  - macosx/                 files needed to create the MacOS package\n  - windows/                files needed to create the Windows installer\n  - josm.jnlp               Java Web Start launcher file (used on the website for the tested version)\n  - josm-latest.jnlp        Java Web Start launcher file (used on the website for the latest version)\n- nodist/                   files not included in JOSM binary\n  - data/                   data files that are useful for development, but not distributed\n    - exif-direction-example.jpg\n                            sample image, that contains direction information in the EXIF header\n                            (keys: Exif.GPSInfo.GPSImgDirectionRef, Exif.GPSInfo.GPSImgDirection)\n    - filterTests.osm       used for unit testing of the filter feature\n                            (see test/unit/org/openstreetmap/josm/data/osm/FilterTest.java)\n    - Join_Areas_Tests.osm  some examples to test the 'join areas' feature\n    - *.*                   various other data files used for unit testing and as reference file\n    - projection/           projection files\n      - *.gsb               NTv2 grid files for projection support, downloaded by the\n                            client on demand (see CONTRIBUTION)\n      - CHENyx06-Distribution.pdf\n                            archive of terms of use for the CHENyx06.gsb file\n      - epsg                EPSG data file, taken from the proj.4 project\n                            (see https://github.com/OSGeo/proj.4/blob/master/nad/epsg)\n      - esri                ESRI data file, taken from the proj.4 project\n                            (see https://github.com/OSGeo/proj.4/blob/master/nad/esri)\n      - josm-epsg           customizations to the epsg file, used together with the epsg file\n                            to generate data/projection/custom-epsg\n                            \n      - projection-reference-data.csv\n                            reference data for projection tests\n                            (see test/unit/org/openstreetmap/josm/data/projection/ProjectionRefTest.java)\n      - projection-regression-test-data.csv\n                            regression data for projection tests\n                            (see test/unit/org/openstreetmap/josm/data/projection/ProjectionRegressionTest.java)\n    - trans/*.lang          translation data for files that are not distributed, but used\n                            by the server for localization of the services;\n                            currently contains plugin descriptions in order to include translations\n                            in the downloaded plugin list\n  - images/                 images, which are not for distribution, but may be useful later (e.g. high\n                            resolution and vector versions)\n  - styles/                 files needed for map style maintenance\n- README                    this file\n- resources/                resource files that will be included in the JOSM jar file\n  - data/                   data files that will be included in the JOSM jar file\n    - fonts/                font files used for map rendering\n    - gpx/                  different color gradients for gpx drawing\n    - projection/           projection files\n      - custom-epsg         list of projection definitions, auto-generated file created by ant task 'epsg'\n    - security/*.pem        certificates that we like to accept for TLS connections, but are missing in the\n                            default Java certificate store\n    - validator/            data files used by the JOSM validator\n      - *.cfg               files designed for the old tagchecker, still in use\n      - *.mapcss            default validation rules for the MapCSS-based tagchecker\n    - boundaries.osm        OSM file containing boundary data for the states of the earth, including\n                            data for right and left-hand traffic\n    - defaultpresets.xml    data file for the core tagging presets\n    - help-browser.css      CSS file for the help sites (HTML content is downloaded from the website\n                            on demand, but displayed inside the programm in a Java web browser component.)\n    - *.lang                translation data\n    - *.xsd                 xml schema files for validation of configuration files\n  - images/                 images distributed with the JOSM binary\n    - icons                 images for the Potlatch 2 style\n    - presets               images for the main mappaint style and the internal presets\n  - styles/                 map styles included in JOSM\n- scripts/                  various scripts used by JOSM developers\n  - BuildProjectionDefinitions.java\n                            called from the ant build file to combine the files epsg and josm-epsg\n                            to create the custom-epsg file for distribution\n  - geticons.pl             tool to find all used icons and allows deleting unused icons\n                            searches also for images with incompatible svg code\n  - optimize-images         short script to decrease size of PNG images\n  - since_xxx.py            developer tool to replace \"@since xxx\" in Javadoc by the upcoming revision number\n  - SyncEditorLayerIndex.java\n                            script to compare and analyse the differences of the editor layer index and the\n                            JOSM imagery list (see https://josm.openstreetmap.de/wiki/ImageryCompare)\n  - TagInfoExtract.java     extracts tag information for the taginfo project\n- src/                      the source code of the application\n- start.html                HTML page to run the applet version of JOSM\n- test/                     automated software tests\n    - data/                 resources used for some tests\n    - functional/           functional tests (source code)\n    - lib/                  libraries needed for (some of) the tests, including JUnit\n    - performance/          performance tests (source code)\n    - unit/                 unit tests (source code)\n- tools/                    libraries, tools and configuration files that help in the development process\n    - checkstyle/           libs and config files for checkstyle (automatically detects code style\n                            problems in source code); can be launched as an ant target in build.xml\n    - eclipse/              preconfigured Eclipse configuration files\n    - ivy/                  Apache Ivy binary, configuration file, and downloaded dependencies \n    - jacocoant.jar         used to include coverage data into JUnit test reports\n    - japicc/               used to generate a compatibility report between optimized jar and normal one\n    - netbeans/             preconfigured Netbeans project\n    - pmd/                  config files for PMD (source code analyzer, finds common programming flaws)\n    - spotbugs/             libs and config files for spotbugs (automatically detects common bugs and potential\n                            problems in source code); can be launched as an ant target in build.xml\n\nThird party libraries\n---------------------\nThere are some third party libraries which are directly included in the source code tree, in particular:\n\n* jmapviewer: Java component to browse a TMS map\n    src/org/openstreetmap/gui (svn external)\n    -\u003e https://josm.openstreetmap.de/osmsvn/applications/viewer/jmapviewer/\n* Apache commons compress: Support for bzip2 compression when opening files\n    -\u003e https://github.com/apache/commons-compress\n* Apache commons validator: Improved validator routines\n    src/org/openstreetmap/josm/data/validation/routines\n    -\u003e http://commons.apache.org/proper/commons-validator\n* SVG Salamander: Support for SVG image format\n    -\u003e https://github.com/blackears/svgSalamander\n* Metadata Extractor: Read EXIF Metadata of photos\n    -\u003e https://github.com/drewnoakes/metadata-extractor\n* MultiSplitPane: Small lib for GUI layout management\n    src/org/openstreetmap/josm/gui/MultiSplitLayout.java, MultiSplitPane.java\n    -\u003e https://github.com/floscher/multi-split\n    -\u003e https://community.oracle.com/docs/DOC-983539\n* swinghelper: Class CheckThreadViolationRepaintManager to find EDT violations\n    src/org/openstreetmap/josm/gui/util/CheckThreadViolationRepaintManager.java\n    -\u003e https://github.com/floscher/swinghelper\n* xz extractor (0BSD)\n    -\u003e https://tukaani.org/xz/java.html\n* OpeningHoursParser (MIT license)\n    -\u003e https://github.com/simonpoole/OpeningHoursParser\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosm%2Fjosm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjosm%2Fjosm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosm%2Fjosm/lists"}