{"id":20269258,"url":"https://github.com/wroge/wms","last_synced_at":"2025-06-21T10:36:42.304Z","repository":{"id":46092558,"uuid":"177165401","full_name":"wroge/wms","owner":"wroge","description":"Web Map Service - Command Line Tool","archived":false,"fork":false,"pushed_at":"2021-09-16T15:50:09.000Z","size":9930,"stargazers_count":2,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-01-14T05:31:43.098Z","etag":null,"topics":["getcapabilities","getmap","webmapservice","wms","wms-cli"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wroge.png","metadata":{"files":{"readme":"README.md","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}},"created_at":"2019-03-22T15:28:36.000Z","updated_at":"2023-09-17T20:37:25.000Z","dependencies_parsed_at":"2022-07-19T00:02:08.251Z","dependency_job_id":null,"html_url":"https://github.com/wroge/wms","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wroge%2Fwms","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wroge%2Fwms/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wroge%2Fwms/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wroge%2Fwms/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wroge","download_url":"https://codeload.github.com/wroge/wms/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241753144,"owners_count":20014252,"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":["getcapabilities","getmap","webmapservice","wms","wms-cli"],"created_at":"2024-11-14T12:24:12.910Z","updated_at":"2025-03-03T23:06:45.676Z","avatar_url":"https://github.com/wroge.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![GitHub release](https://img.shields.io/github/release/wroge/wms.svg)](https://github.com/wroge/wms/releases/latest)\n[![Go Report Card](https://goreportcard.com/badge/github.com/wroge/wms)](https://goreportcard.com/report/github.com/wroge/wms)\n\n# Web Map Service - Manager\n\nA command-line-tool to simplify the use of Web Map Services.\nYou can download WMS-Tiles and check the Capabilities of a service. Including:\n\n- Set specific requests in a configuration file\n- Get helpful error messages\n- Automatic coordinate transformation into a supported reference system [by wroge/wgs84](https://github.com/wroge/wgs84)\n- Download several bounding boxes at the same time\n\n## Install\n\n- Linux (i386/x86_64)\n- MacOS (i386/x86_64)\n- Windows (i386/x86_64)\n\n[Releases](https://github.com/wroge/wms/releases)\n\nAlternatively, you can install ```wms``` via Homebrew, Scoop, Snapcraft or Docker. Of course, you can also create the executable file from source.\n\n### Homebrew (MacOS)\n\n```\nbrew install wroge/tap/wms\n```\n\n### Scoop (Windows)\n\n```\nscoop bucket add app https://github.com/wroge/scoop-bucket\nscoop install wms\n```\n\n### Snapcraft (Linux)\n\n```\nsnap install wms\n```\n\n### Docker\n\nDocker-Images: [@DockerHub](https://hub.docker.com/r/wroge/wms/tags)\n\n```\ndocker pull wroge/wms:latest\ndocker run -v \"$(pwd)/output:/output\" -v \"$HOME/wms-config:/wms-config\" wroge/wms\n```\n\n### From Source\n\nThis Go-Project is using ```go mod```. Please clone this repository outside of ```GOPATH```.\n\n```\ngit clone https://github.com/wroge/wms.git\ncd wms\ngo build -o wms ./cli\n```\n\n## Features\n\n### Helpful error-messages\n\nYou can look up the capabilities ```wms cap``` or just try it out.\n\n```\nwms cap -u http://ows.terrestris.de/osm/service -l\n[OSM-WMS OSM-Overlay-WMS TOPO-WMS TOPO-OSM-WMS SRTM30-Hillshade SRTM30-Colored SRTM30-Colored-Hillshade SRTM30-Contour]\n\nwms map -u http://ows.terrestris.de/osm/service -l abc\nError: Invalid Layer: abc\nValid Layers: [OSM-WMS OSM-Overlay-WMS TOPO-WMS TOPO-OSM-WMS SRTM30-Hillshade SRTM30-Colored SRTM30-Colored-Hillshade SRTM30-Contour]\n```\n\n### Automatic Coordinate Transformation\n\nSupported by [wroge/wgs84](https://github.com/wroge/wgs84).  Some WMS allow only a few coordinate reference systems. With ```wms map``` you can choose from a larger number of EPSG codes. Please open an issue in the [wroge/wgs84](https://github.com/wroge/wgs84) repository to support your specific system.\n\n```\nwms cap -u http://ows.terrestris.de/osm/service -e\n[4326 3857 900913]\n\nwms map -u http://ows.terrestris.de/osm/service -e 12345\nError: Invalid EPSG: 12345\n Valid EPSGs: [900913 4326 3857 32650 32659 5650 25838 31466 32603 32613 32639 \n        102014 6962 27700 32627 32633 32647 32652 32632 32636 3067 25829 25834 \n        32605 32607 32622 32643 32654 4258 102008 102013 2154 5669 32630 32645 \n        32655 102010 32656 32657 32614 32616 32619 32621 32642 32649 32638 32648 \n        6870 31467 31468 32611 32628 32634 32601 32608 32612 32640 32651 32631 32660 \n        5668 25833 25836 32609 32615 4647 25832 31469 32620 32641 32644 4277 25837 \n        32610 32646 54027 32624 32629 32637 32658 4462 25830 25831 32625 32626 32635 \n        4978 32606 32618 3395 25835 32602 32617 32623 32653 32604]\n```\n\n### Download several bounding boxes\n\nYou can create a text file that contains all the required bounding boxes and download them concurrently. (Using Goroutines)\n\n```\ncat $HOME/bbox-wgs84.txt\n9,52,9.2,52.2\n9.2,52,9.4,52.2\n9.4,52,9.6,52.2\n\nwms map -u http://ows.terrestris.de/osm/service -B $HOME/bbox-wgs84.txt -w 1000 -e 4326\n```\n\n### Configuration\n\nYou can change the configuration using ```--save``` or edit the configuration file ```$HOME/wms-config/.wms.yaml``` directly. \n\n```\nwms map -u http://ows.terrestris.de/osm/service -n example -e 25832 -l OSM-WMS/default --save terrestris --dry-run\nSaving service: terrestris\nURL: http://ows.terrestris.de/osm/service\nVersion: 1.1.1\nFormat: image/jpeg\nLayers: [OSM-WMS]\nStyles: [default]\nEPSG: 25832\nFile name: example\n\nwms cap terrestris\n...\n\nwms map terrestris -b 565000,5930000,570000,5935000 -w 1000\n```\n\n### Automatic image size calculation\n\nGetMap-Requests require a ```WIDTH```and a ```HEIGHT```parameter. ```wms map``` calculates these parameters based on the UTM-size (ideal for small regions). You can define ```--height```, ```--width```or ```--dpi \u0026 --scale```.\n\n```\nwms map terrestris -b 565000,5930000,570000,5935000 --width 1000\nhttp://ows.terrestris.de/osm/service?SERVICE=WMS\u0026REQUEST=GetMap\u0026VERSION=1.1.1\u0026FORMAT=image/jpeg\u0026LAYERS=OSM-WMS\u0026STYLES=default\u0026SRS=EPSG:900913\u0026WIDTH=1000\u0026HEIGHT=1000\u0026BBOX=1110998.5409540,7078815.1864107,1119515.6232213,7087111.5778055\nDone. Your requested file is here: \u003coutput\u003e\n\nwms map terrestris -b 565000,5930000,570000,5935000 --height 1000\nwms map terrestris -b 565000,5930000,570000,5935000 --dpi 100 --scale 10000\n```\n\n### More\n\n- Expand \u0026 Cut bounding boxes (interesting for dynamically generated texts and symbols)\n- Basic Authentication with ```--user```\u0026```--password```\n- ```wms map --help```\n- ```wms cap --help```\n\n## FAQ\n\n...For any problems/questions please open an issue.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwroge%2Fwms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwroge%2Fwms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwroge%2Fwms/lists"}