{"id":35038937,"url":"https://github.com/osmcha/osmcha-cli","last_synced_at":"2026-05-22T10:35:04.051Z","repository":{"id":275671826,"uuid":"926820420","full_name":"OSMCha/osmcha-cli","owner":"OSMCha","description":"View any OpenStreetMap augmented diff file on a map in your browser","archived":false,"fork":false,"pushed_at":"2025-08-13T05:40:28.000Z","size":4433,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-09-16T12:04:01.894Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OSMCha.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2025-02-03T23:01:53.000Z","updated_at":"2025-08-13T05:40:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"87c8dc36-7a0d-4f3a-ae4d-7b2226b4197d","html_url":"https://github.com/OSMCha/osmcha-cli","commit_stats":null,"previous_names":["osmcha/osmcha-cli"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/OSMCha/osmcha-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OSMCha%2Fosmcha-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OSMCha%2Fosmcha-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OSMCha%2Fosmcha-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OSMCha%2Fosmcha-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OSMCha","download_url":"https://codeload.github.com/OSMCha/osmcha-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OSMCha%2Fosmcha-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28075838,"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","status":"online","status_checked_at":"2025-12-27T02:00:05.897Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-12-27T08:08:58.166Z","updated_at":"2025-12-27T08:09:01.212Z","avatar_url":"https://github.com/OSMCha.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# osmcha-cli\n\nThis is a command line tool for visualizing changes to OpenStreetMap (loaded from an [augmented diff](https://wiki.openstreetmap.org/wiki/Overpass_API/Augmented_Diffs) file) on a map in your browser.\n\nIt is similar to the [osmcha.org](https://osmcha.org) interface in that both can display changes made to OSM on a map. However, `osmcha-cli` is more flexible in that it can load and display any augmented diff file, regardless of what that file represents (it could represent a single changeset, or a collection of changes made by many users, or even a change you're preparing in JOSM but haven't uploaded yet).\n\n## Installation\n\nThis tool is written in Rust and is published to [crates.io](https://crates.io/crates/osmcha-cli). If you have a Rust toolchain installed, you can download and build it by running:\n\n```\n$ cargo install osmcha-cli\n```\n\nYou can also clone this repository and run `cargo install --path .` in it.\n\n## Usage\n\nLet's first get some augmented diff data to visualize. In this example I'll use [overpass-cli](https://github.com/jake-low/overpass-cli) to create a diff file representing all changes made to roads in Kauai, HI in 2024.\n\n```\n$ overpass --adiff 2024-01-01T00:00:00Z 2025-01-01T00:00:00Z \\\n           --bbox -159.83 21.84 -159.24 22.24 \\\n           --out geom \\\n           'way[highway]' \\\n  \u003e kauai.adiff\n```\n\nFrom there you can run the `osmcha` command line program to view the result.\n\n```\n$ osmcha kauai.adiff\nlistening on http://localhost:48756\n```\n\nYour browser should open automatically and display something like this:\n\n![Screenshot of the osmcha-cli browser interface showing roads in Kauai](./screenshot.png)\n\nClicking on individual features will open a popup that shows details about what was changed.\n\n## Implementation\n\n`osmcha-cli` uses components from OSMCha:\n\n- [osm-adiff-parser](https://github.com/OSMCha/osm-adiff-parser) to parse augmented diff XML files\n- [maplibre-adiff-viewer](https://github.com/OSMCha/maplibre-adiff-viewer) to render diffs on a MapLibre map\n\nYou can use these components in your own projects if you want to visualize changes on a map in the style of OSMCha.\n\n## License\n\nThis program's source code is available under the ISC License. See the [LICENSE](./LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosmcha%2Fosmcha-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fosmcha%2Fosmcha-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosmcha%2Fosmcha-cli/lists"}