{"id":130026,"name":"WaterwayMap","description":"River Basins from OpenStreetMap.","url":"https://github.com/amandasaurus/waterwaymap.org","last_synced_at":"2026-04-07T14:30:29.309Z","repository":{"id":152468657,"uuid":"621849213","full_name":"amandasaurus/waterwaymap.org","owner":"amandasaurus","description":"WaterwayMap.org | River Basins from OpenStreetMap","archived":false,"fork":false,"pushed_at":"2025-11-09T10:17:45.000Z","size":88725,"stargazers_count":73,"open_issues_count":26,"forks_count":17,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-12-18T02:21:34.893Z","etag":null,"topics":["data-visualization","geo","geospatial","openstreetmap","openstreetmap-data","osm","osm-data","river-network-analysis","river-networks","topology","water","watershed"],"latest_commit_sha":null,"homepage":"https://WaterwayMap.org","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amandasaurus.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-03-31T14:16:13.000Z","updated_at":"2025-12-10T14:24:14.000Z","dependencies_parsed_at":"2023-11-24T11:25:39.569Z","dependency_job_id":"c6754a6c-d742-41af-ad6c-2f612b42ac94","html_url":"https://github.com/amandasaurus/waterwaymap.org","commit_stats":{"total_commits":551,"total_committers":9,"mean_commits":61.22222222222222,"dds":0.04174228675136116,"last_synced_commit":"e76676c4fa6ae411953e7ba48045daed3fefda74"},"previous_names":["amandasaurus/waterwaymap.org"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/amandasaurus/waterwaymap.org","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amandasaurus%2Fwaterwaymap.org","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amandasaurus%2Fwaterwaymap.org/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amandasaurus%2Fwaterwaymap.org/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amandasaurus%2Fwaterwaymap.org/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amandasaurus","download_url":"https://codeload.github.com/amandasaurus/waterwaymap.org/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amandasaurus%2Fwaterwaymap.org/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27812551,"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-19T02:00:08.705Z","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"}},"owner":{"login":"amandasaurus","name":"Amanda","uuid":"1547","kind":"user","description":"","email":"","website":"https://www.technomancy.org","location":"EU","twitter":null,"company":null,"icon_url":"https://avatars.githubusercontent.com/u/1547?u=264e93f44be07d54f51be1f46acf3b8ddb86588e\u0026v=4","repositories_count":211,"last_synced_at":"2025-03-23T02:34:04.029Z","metadata":{"has_sponsors_listing":false},"html_url":"https://github.com/amandasaurus","funding_links":[],"total_stars":894,"followers":95,"following":45,"created_at":"2022-11-02T16:59:36.540Z","updated_at":"2025-03-23T02:34:04.030Z","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amandasaurus","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amandasaurus/repositories"},"packages":[],"commits":{"id":1444079,"full_name":"amandasaurus/waterwaymap.org","default_branch":"main","total_commits":623,"total_committers":9,"total_bot_commits":0,"total_bot_committers":0,"mean_commits":69.22222222222223,"dds":0.036918138041733495,"past_year_total_commits":93,"past_year_total_committers":2,"past_year_total_bot_commits":0,"past_year_total_bot_committers":0,"past_year_mean_commits":46.5,"past_year_dds":0.010752688172043001,"last_synced_at":"2025-12-13T23:41:42.184Z","last_synced_commit":"c0eb42ba7a3b4116796c12da2354d62878911ae7","created_at":"2023-11-03T00:04:20.251Z","updated_at":"2025-12-13T23:41:42.153Z","committers":[{"name":"Amanda McCann","email":"amanda@technomancy.org","login":"amandasaurus","count":600},{"name":"mxdanger","email":"32040254+mxdanger","login":"mxdanger","count":13},{"name":"Quincy Morgan","email":"2046746+quincylvania","login":"quincylvania","count":4},{"name":"yvecai","email":"506919+yvecai","login":"yvecai","count":1},{"name":"limex","email":"guebosch@gmail.com","login":"limex","count":1},{"name":"kaleidoscopica","email":"rayearth53@yahoo.com","login":"kaleidoscopica","count":1},{"name":"Matt Whilden","email":"118567155+watmildon","login":"watmildon","count":1},{"name":"Jesse Weinstein","email":"jesse@wefu.org","login":"JesseWeinstein","count":1},{"name":"Douglas Gardner","email":"douglas@chippy.ch","login":"zuzak","count":1}],"past_year_committers":[{"name":"Amanda McCann","email":"amanda@technomancy.org","login":"amandasaurus","count":92},{"name":"Matt Whilden","email":"118567155+watmildon","login":"watmildon","count":1}],"commits_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories/amandasaurus%2Fwaterwaymap.org/commits","host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2025-12-23T00:00:57.120Z","repositories_count":6132071,"commits_count":926293068,"contributors_count":35964862,"owners_count":1125451,"icon_url":"https://github.com/github.png","host_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories"}},"issues_stats":{"full_name":"amandasaurus/waterwaymap.org","html_url":"https://github.com/amandasaurus/waterwaymap.org","last_synced_at":"2025-12-21T23:04:06.654Z","status":null,"issues_count":74,"pull_requests_count":24,"avg_time_to_close_issue":2276184.15,"avg_time_to_close_pull_request":1148726.1304347827,"issues_closed_count":40,"pull_requests_closed_count":23,"pull_request_authors_count":9,"issue_authors_count":48,"avg_comments_per_issue":1.0135135135135136,"avg_comments_per_pull_request":1.4166666666666667,"merged_pull_requests_count":20,"bot_issues_count":0,"bot_pull_requests_count":0,"past_year_issues_count":18,"past_year_pull_requests_count":3,"past_year_avg_time_to_close_issue":453595.75,"past_year_avg_time_to_close_pull_request":1368446.0,"past_year_issues_closed_count":4,"past_year_pull_requests_closed_count":3,"past_year_pull_request_authors_count":2,"past_year_issue_authors_count":12,"past_year_avg_comments_per_issue":0.6666666666666666,"past_year_avg_comments_per_pull_request":1.0,"past_year_bot_issues_count":0,"past_year_bot_pull_requests_count":0,"past_year_merged_pull_requests_count":2,"created_at":"2023-11-03T00:04:20.754Z","updated_at":"2025-12-21T23:04:06.654Z","repository_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/amandasaurus%2Fwaterwaymap.org","issues_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/amandasaurus%2Fwaterwaymap.org/issues","issue_labels_count":{"enhancement":1},"pull_request_labels_count":{},"issue_author_associations_count":{"NONE":68,"CONTRIBUTOR":5,"OWNER":1},"pull_request_author_associations_count":{"CONTRIBUTOR":18,"NONE":6},"issue_authors":{"angoca":10,"muralito":4,"danieldegroot2":3,"matozoid":3,"scarapella":3,"watmildon":3,"mxdanger":2,"EwenH":2,"daganzdaanda":2,"mcliquid":2,"JesseWeinstein":2,"Janjko":2,"cliffordsnow":1,"Venefilyn":1,"chlenixxON":1,"adamfranco":1,"2hu4u":1,"flacombe":1,"zstadler":1,"limex":1,"operon":1,"maxerickson":1,"doniks":1,"JLZIMMERMANN":1,"pierzen":1,"hungerburg":1,"starsep":1,"RedAuburn":1,"risturiz":1,"Adn44f":1,"osmuser63783":1,"kaleidoscopica":1,"dch0ph":1,"habi":1,"ftrebien":1,"quincylvania":1,"amandasaurus":1,"Heinlein115":1,"ForgottenHero":1,"Danysan1":1,"Beakerboy":1,"tcurdt":1,"ivanbranco":1,"matkoniecz":1,"russss":1,"jleedev":1,"501Ghost":1,"ablevi202":1},"pull_request_authors":{"mxdanger":8,"quincylvania":4,"JesseWeinstein":2,"limex":2,"zuzak":2,"watmildon":2,"kaleidoscopica":2,"yvecai":1,"operon":1},"host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2025-12-23T00:00:36.934Z","repositories_count":12387371,"issues_count":35784758,"pull_requests_count":117488511,"authors_count":11069450,"icon_url":"https://github.com/github.png","host_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories","owners_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/owners","authors_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors"},"past_year_issue_labels_count":{},"past_year_pull_request_labels_count":{},"past_year_issue_author_associations_count":{"NONE":18},"past_year_pull_request_author_associations_count":{"NONE":2,"CONTRIBUTOR":1},"past_year_issue_authors":{"muralito":4,"angoca":3,"danieldegroot2":2,"501Ghost":1,"Beakerboy":1,"doniks":1,"habi":1,"Janjko":1,"operon":1,"pierzen":1,"scarapella":1,"tcurdt":1},"past_year_pull_request_authors":{"watmildon":2,"operon":1},"maintainers":[{"login":"amandasaurus","count":1,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/amandasaurus"}],"active_maintainers":[]},"events":{"total":{"IssuesEvent":23,"WatchEvent":12,"IssueCommentEvent":59,"PushEvent":36,"PullRequestEvent":7,"ForkEvent":2},"last_year":{"IssuesEvent":20,"WatchEvent":6,"IssueCommentEvent":45,"PushEvent":20,"PullRequestEvent":5,"ForkEvent":1}},"keywords":["data-visualization","geo","geospatial","openstreetmap","openstreetmap-data","osm","osm-data","river-network-analysis","river-networks","topology","water","watershed"],"dependencies":[],"score":6.792344427470809,"created_at":"2023-11-03T00:01:12.019Z","updated_at":"2026-04-07T14:30:29.311Z","avatar_url":"https://github.com/amandasaurus.png","language":"Makefile","category":"Hydrosphere","sub_category":"Ocean and Hydrology Data Access","monthly_downloads":0,"total_dependent_repos":0,"total_dependent_packages":0,"readme":"# [WaterwayMap.org](https://waterwaymap.org)\n\nSee the [website](https://waterwaymap.org).\n\n![map of europe with all the river basins higlighted](https://waterwaymap.org/img/screenshot.png)\n\n[News \u0026 Updates on the OSM Town Mapstodon](https://en.osm.town/@amapanda/tagged/WaterwayMapOrg).\n\n## News \u0026 Posts\n\n* [Fedi/Mastodon post](https://en.osm.town/@amapanda/110118513232919061)\n* [OSM Community Forum](https://community.openstreetmap.org/t/osm-river-basins-website-to-show-how-are-rivers-in-osm-connected/102655)\n* Hacker News: [#1 (2023-08-30) (as “OSM River Basins”)](https://news.ycombinator.com/item?id=37321292), [#2 (2024-01-24)](https://news.ycombinator.com/item?id=39110434), [#3 (2024-08-19)](https://news.ycombinator.com/item?id=41293757)\n* I gave a lightening talk at [State of the Map Europe 2023](https://2023.stateofthemap.eu/) in Antwerp, Belgium in Nov. 2023. [slides](https://waterwaymap.org/static/2023-11-sotmeu23-waterway-presentation-lightening-talk.pdf.zst).\n* *“Flowing Connections: Mapping rivers \u0026 streams with WaterwayMap.org”* Presentation at [State of the Map Europe 2024](https://stateofthemap.eu/) in Łódź, Poland on Sun. 21st July 2024. [slides](https://waterwaymap.org/static/2024-07-21-sotmeu24-waterway-presentation.pdf.zst). [programme entry](https://cfp.openstreetmap.org.pl/state-of-the-map-europe-2024/talk/K8LF7U/). As of Jan. 2025, there are no recordings available.\n* [Interview about WaterwayMap.org on The OpenCage Blog](https://blog.opencagedata.com/post/openstreetmap-interview-waterwaymap) _(Jan. 2025)_\n* I gave a talk in German at [FOSSGIS 2025](https://pretalx.com/fossgis2025/talk/DPNHSU/), watch [the video here](https://media.ccc.de/v/fossgis2025-58272-nicht-von-neuen-algorithmen-uberflutet-osm-daten-fur-waterwaymap-verarbeiten).\n\n## Who's using mapping with this?\n\n* [neis-one `#WaterwayMapOrg`](https://resultmaps.neis-one.org/osm-changesets?comment=WaterwayMapOrg) (older [`#RiverMapping` tag](https://resultmaps.neis-one.org/osm-changesets?comment=RiverMapping)).\n* [OSMCha `#WaterwayMapOrg`](https://osmcha.org/?filters=%7B%22metadata%22%3A%5B%7B%22label%22%3A%22hashtags%3D%23WaterwayMapOrg%22%2C%22value%22%3A%22hashtags%3D%23WaterwayMapOrg%22%7D%5D%7D) (_older [`#RiverMapping` on OSMCha](https://osmcha.org/?filters=%7B%22metadata%22%3A%5B%7B%22label%22%3A%22hashtags%3D%23RiverMapping%22%2C%22value%22%3A%22hashtags%3D%23RiverMapping%22%7D%5D%7D)_)\n\n### OSM Tagging Discussions from this tool\n\n* [Should river lines be mapped through lakes, estuaries, gulfs, and other large water bodies?](https://community.openstreetmap.org/t/should-river-lines-be-mapped-through-lakes-estuaries-gulfs-and-other-large-water-bodies/104438) _(Oct. 2023)_\n  * [Flowlines](https://wiki.openstreetmap.org/wiki/Proposal:Flowlines) tagging proposal. [osm comm. forum](https://community.openstreetmap.org/t/rfc-feature-proposal-flowlines/117361) \u0026 [`tagging@`](https://lists.openstreetmap.org/pipermail/tagging/2024-August/067978.html).\n* [Properly mapping dry washes](https://community.openstreetmap.org/t/properly-mapping-dry-washes/108437) _(Jan. 2024)_\n* [Is there a common tag for underground infiltrated watercourses?](https://community.openstreetmap.org/t/is-there-a-common-tag-for-underground-infiltrated-watercourses/111558) _(Apr. 2024)_\n* [How to map a Lazy river in an amusement park](https://community.openstreetmap.org/t/how-to-map-a-lazy-river-in-an-amusement-park/113429) _(May 2024)_\n* [RfC: Deprecate use of “waterway=pressurised” on anything not artificially built for hydropower uses](https://community.openstreetmap.org/t/rfc-deprecate-use-of-waterway-pressurised-on-anything-not-artificially-built-for-hydropower-uses/115222) _(June 2024)_\n* All posts [tagged `#waterwaymaporg`](https://community.openstreetmap.org/tag/waterwaymaporg), or [`#waterway`](https://community.openstreetmap.org/tag/waterway) on the OSM Community Forum.\n\n## Loops\n\nLoops in waterways are detected and shown on:\n[`WaterwayMap.org/loops`](https://waterwaymap.org/loops).\n\n\n* [Fedi/Masto post](https://en.osm.town/@amapanda/111658136395447174)\n* [OSM Ccommunity Forum announcement](https://community.openstreetmap.org/t/the-wonders-of-early-medieval-fore-abbey-and-osm-river-topology-today-i-e-waterwaymap-org-is-going-around-in-circles/107497)\n\n\n## End Points\n\nPoints at which waterways end are shown on: [`WaterwayMap.org/ends`](https://waterwaymap.org/ends).\n\n* [Fedi/Masto post](https://en.osm.town/@amapanda/111844170704856219)\n* [OSM Ccommunity Forum announcement](https://community.openstreetmap.org/t/the-end-of-waterway-map/108632)\n\n### Where things turn into streams\n\nTo detect places where waterways (e.g. rivers) flow into a stream, a GeoJSON file of those is generated: [`data.waterwaymap.org/planet-waterway-stream-ends.geojson.gz`](https://data.waterwaymap.org/planet-waterway-stream-ends.geojson.gz) (~ 2 MiB compressed). It can be loaded into JOSM to find errors.\n\nIt was asked for in [issue 52](https://github.com/amandasaurus/waterwaymap.org/issues/52), with the code in [commit `4730275`](https://github.com/amandasaurus/waterwaymap.org/commit/4730275509c1655e46a09c3994436403b3bd5ec1).\n\n## Statistics\n\n### Loops\n\nA CSV file of statistics of loops is generated and available for download at\n[`data.waterwaymap.org/waterwaymap.org_loops_stats.csv`](\nhttps://data.waterwaymap.org/waterwaymap.org_loops_stats.csv). See the\n[`osm-lump-ways` documentation on the CSV stats\nfile](https://github.com/amandasaurus/osm-lump-ways?tab=readme-ov-file#ends-stats-csv---ends-csv-file-filenamecsv)\nfor documentation.\n\nIt is used by [`@watmildon@en.osm.town`](https://en.osm.town/@watmildon) for a\nmastodon account summarizing stats:\n[`@OSMWaterwayLoopStats@en.osm.town`](https://en.osm.town/@OSMWaterwayLoopStats)\n[feed](https://en.osm.town/@OSMWaterwayLoopStats.rss)\n\n### End Points\n\nA CSV statistics file of end points, is also generated dails and downloadable at\n[`data.waterwaymap.org/waterwaymap.org_ends_stats.csv.zst`](https://data.waterwaymap.org/waterwaymap.org_ends_stats.csv.zst).\n\nSee the [`osm-lump-ways`\ndocumentation](https://github.com/amandasaurus/osm-lump-ways?tab=readme-ov-file#ends-stats-csv---ends-csv-file-filenamecsv)\nfor file format.\n\n## Related Projects\n\n* [JOSM Waterway Style](https://josm.openstreetmap.de/wiki/Styles/Waterways)\n\n### Other websites\n\nIf you like WaterwayMap.org, you might like the following other websites:\n\n* [Global Watersheds](https://mghydro.com/watersheds/) ([mheberger/delineator](https://github.com/mheberger/delineator) on github)\n* [RiverMap.online](https://rivermap.online/)\n\n## FAQ\n\n### What do the colours mean?\n\nThe colours are randomly assigned, and based on the final destination of the\nriver. Everything that flows into the same point, gets the same colour. If you\nclick the settings, you can change the number of colours. This can be useful to\ntry to differentiate 2 different river networks.\n\n### Does thickness represent flow rate?\n\nThe thickness of the lines is based on how many kilometres of river are\nupstream of that segment. The flow rate of a river is based on many things,\nsuch as the width of a river, and obviously changes a lot based on rainfall! I\nonly use OpenStreetMap data, which rarely has width, and wouldn't have\nreal-time data about the amount of water flowing through a point! What it does\nshow (“how many waterways in total are upstream of here?”) will probably\ncorrelate with the flow rate, and is probably good enough for making a map, but\nyou shouldn't use to see if your house is going to flood!\n\n### If a natural waterway runs through a lake, is it possible to show all the branches as connected waterways?\n\nCurrently, the only way to do this is map a waterway _though_ the water body.\nThere is currently no other way to do it. The OSM community is a little\nuncertain if this is always a good idea. There is a [community\ndiscussion](https://community.openstreetmap.org/t/should-river-lines-be-mapped-through-lakes-estuaries-gulfs-and-other-large-water-bodies/104438).\nThere is a new tag\n[`waterway=flowline`](https://wiki.openstreetmap.org/wiki/Tag:waterway%3Dflowline)\nas possible tag to use for these ways through waterbodies.\n\nI did try to add a map view which would include the edges of waterbodies,\n[e.g.](https://community.openstreetmap.org/t/osm-river-basins-website-to-show-how-are-rivers-in-osm-connected/102655/118)\nbut that didn't work as well, because it only uses `ways` not `relations`, so\nmany water bodies weren't included.\n\nHowever, the latest new feature, the [River Directory](https://waterwaymap.org/river/), could benefit from relation\nsupport. So I might add that.\n[cf.](https://community.openstreetmap.org/t/waterwaymap-org-is-not-a-map/127608#:~:text=like%20the%20rest%20of%20wwm%2C%20osm%20waterway%20relations%20are%20completely%20ignored.%20however%2C%20they%E2%80%99re%20probably%20the%20solution%20to%20%E2%80%9Criver%20name%20changes%E2%80%9D%2C%20so%20watch%20this%20space).\n\n\n## Copyright\n\nCopyright MIT or Apache-2.0, 2017→2024 Amanda McCann \u003camanda@technomancy.org\u003e\n\nInitially this project was called `osm-river-basins`.\n\n","funding_links":[],"readme_doi_urls":[],"works":{},"citation_counts":{},"total_citations":0,"keywords_from_contributors":[],"project_url":"https://ost.ecosyste.ms/api/v1/projects/130026","html_url":"https://ost.ecosyste.ms/projects/130026"}