{"id":13577876,"url":"https://github.com/Creator13/mapsnap","last_synced_at":"2025-04-05T15:31:42.044Z","repository":{"id":69981449,"uuid":"425270577","full_name":"Creator13/mapsnap","owner":"Creator13","description":"A small command line tool to grab images from OpenStreetMap, with the purpose of creating snapshots and mapping timelapses.","archived":false,"fork":false,"pushed_at":"2023-11-18T13:42:16.000Z","size":191,"stargazers_count":7,"open_issues_count":1,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-11-05T15:48:14.579Z","etag":null,"topics":["command-line-tool","csharp","dotnet","image-processing","openstreetmap"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Creator13.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,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-11-06T14:54:10.000Z","updated_at":"2024-05-24T10:37:22.000Z","dependencies_parsed_at":"2024-04-11T21:10:37.821Z","dependency_job_id":"f9f26d84-fe93-4574-a70a-86a150205377","html_url":"https://github.com/Creator13/mapsnap","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Creator13%2Fmapsnap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Creator13%2Fmapsnap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Creator13%2Fmapsnap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Creator13%2Fmapsnap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Creator13","download_url":"https://codeload.github.com/Creator13/mapsnap/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247358803,"owners_count":20926292,"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":["command-line-tool","csharp","dotnet","image-processing","openstreetmap"],"created_at":"2024-08-01T15:01:25.121Z","updated_at":"2025-04-05T15:31:38.188Z","avatar_url":"https://github.com/Creator13.png","language":"C#","funding_links":[],"categories":["C# #"],"sub_categories":[],"readme":"# MapSnap\n\nThis small command line tool enables mappers from the OpenStreetMap community to create snapshots and timelapses of their work!\n\n## Features\n- **Snapshot**: Capture any region of the rendered OpenStreetMap slippy map, by entering the boundary coordinates and the zoom level you want to want.\n- **Projects**: Store the area you want to capture in a project file, so you can capture a new snapshot with just one command! \n- **Filename customization**: Save your images with index numbering or with a date format.\n- **Timelapses**: Create an animated gif from captured snapshots!\n\n## Future features\n- **Snap anywhere**: Run `snap` from anywhere and provide coordinates to create a single snapshot image. \n- **Output resizing**: Resize output images to a custom size, different from the standard tile size of 256 per tile.\n\n# Documentation\nSee the [wiki](https://github.com/Creator13/mapsnap/wiki) for the full documentation of the tool.\n\n# Installation\nDownload the latest binary zip from the releases pages. Extract it in a folder and run mapsnap.exe from the command line.\n\nI'll be looking into creating an installer for mapsnap in the future!\n### Add to Path (Windows)\nYou'll want to run mapsnap from any place on your computer. Follow [this guide](https://stackoverflow.com/questions/44272416/how-to-add-a-folder-to-path-environment-variable-in-windows-10-with-screensho) to add the folder with mapsnap.exe to your PATH in order to run `mapsnap` from a console window.\n\n# Getting started\nWith mapsnap installed and added to the PATH, you should open a new terminal window. On Windows, you can use Windows Terminal, Command Line (cmd.exe), or PowerShell (ps.exe). On MacOS/Linux, open your system terminal.\n\n## Create a project\nTo create a new project, run:\n```sh\n\u003e mapsnap init myProject \"52.3990,4.8591\" \"52.3393,4.9781\" 15\n```\nThis will create a new folder and project called myProject of Amsterdam at zoom level 15. For more info on the `init` command, including all the optional parameters, see this [wiki page](https://github.com/Creator13/mapsnap/wiki/init).\n\n### **Where do I find my coordinates and zoom level?**\nYou can get your coordinates from any source, like Google Maps or openstreetmap.com. Navigate to your area of interest and choose two points as the outermost corners of your image.\n\n**NOTE**: OpenStreetMap tiles come in sizes of 256x256. You can choose whether you want to capture an image at exactly the coordinates you specified by adding the `-P` option to the `init` command. If not specified, it will capture the entire tile in which your coordinates lie, resulting in an image that is slightly bigger than you might expect.\n#### **Coordinates from openstreetmap.com**\nTo get coordinates from the OpenStreetMap website, right click on the corner point and select \"Show address.\" The coordinates of the point will appear in the search bar in the left sidebar and can be copied straight into MapSnap.\n\nIf your coordinates contain spaces, be sure to surround them with double quotes.\n\nYou can also copy the coordinates from the url. Mind that these are the coordinates of the center of the portion of the map you're viewing, so this method can be a little more tricky.\n\n#### **Zoom level**\nThe zoom level can be found in the url on openstreetmap.com. Navigate to a place and zoom to the level you want, then look at the url:\n```\nhttps://www.openstreetmap.org/#map=15/52.3728/4.8936\n```\nThe part with `#map=15` indicates that the zoom level is `15` on this url.\n\n## Snap an image\nIn your terminal, navigate to your project folder. Using your file explorer you can navigate to the folder, then shift+right click somewhere and select \"Open in terminal/powershell\". \n\nIf you just created a new project called myProject, run:\n```sh\n\u003e cd myProject\n```\n\nOnce in your folder, simply run:\n```sh\n\u003e mapsnap snap\n```\nAfter the program is done, your project folder will contain a new map snapshot!\n\nFor more info on the `snap` command, see this [wiki page](https://github.com/Creator13/mapsnap/wiki/snap).\n\n## Create a GIF\nOne of the most interesting features is the `gif` command that allows you to turn captured snapshots in an animated gif!\n\nTo start, capture at least 2 snapshots in a project. Then, run the gif command:\n\n```sh\n\u003e mapsnap gif\n```\n\nThat simple! A new gif will appear in the project folder.\n\n# Contributing\nIf you want to contribute, please open an issue or a pull request!\n\n# License\nThis project is licensed under the GNU GPLv3 license.\n\nMap data \u0026 tiles are © OpenStreetMap contributors. Gifs and images created with mapsnap are CC BY-SA 2.0.\n\n# See also\n- https://www.openstreetmap.org\n- OpenStreetMap tilemap wiki: https://wiki.openstreetmap.org/wiki/Slippy_map_tilename\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCreator13%2Fmapsnap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCreator13%2Fmapsnap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCreator13%2Fmapsnap/lists"}