{"id":13426150,"url":"https://github.com/mapbox/mapbox-tile-copy","last_synced_at":"2025-03-15T21:30:45.287Z","repository":{"id":22995184,"uuid":"26345697","full_name":"mapbox/mapbox-tile-copy","owner":"mapbox","description":"Put tiles on s3 from a variety of geographic data files","archived":false,"fork":false,"pushed_at":"2024-05-20T19:48:01.000Z","size":5717,"stargazers_count":155,"open_issues_count":13,"forks_count":28,"subscribers_count":123,"default_branch":"main","last_synced_at":"2025-03-09T00:07:06.101Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/mapbox.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}},"created_at":"2014-11-08T01:18:19.000Z","updated_at":"2025-03-07T10:12:24.000Z","dependencies_parsed_at":"2024-05-20T20:34:12.691Z","dependency_job_id":"3515dbcd-3c69-4e13-9cbc-3594f88d0fb6","html_url":"https://github.com/mapbox/mapbox-tile-copy","commit_stats":{"total_commits":366,"total_committers":34,"mean_commits":"10.764705882352942","dds":0.7295081967213115,"last_synced_commit":"7f1647f9686a10de096540a25446146199a1abb5"},"previous_names":[],"tags_count":94,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapbox%2Fmapbox-tile-copy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapbox%2Fmapbox-tile-copy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapbox%2Fmapbox-tile-copy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapbox%2Fmapbox-tile-copy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mapbox","download_url":"https://codeload.github.com/mapbox/mapbox-tile-copy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243792287,"owners_count":20348609,"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":[],"created_at":"2024-07-31T00:01:27.496Z","updated_at":"2025-03-15T21:30:44.286Z","avatar_url":"https://github.com/mapbox.png","language":"JavaScript","readme":"# mapbox-tile-copy\n\nA shortcut from local geodata files to tiles on S3 or to the local filesystem.\n\n[![Build Status](https://travis-ci.com/mapbox/mapbox-tile-copy.svg?branch=master)](https://travis-ci.com/mapbox/mapbox-tile-copy)\n\n## Installation\n\n```sh\n$ npm install -g @mapbox/mapbox-tile-copy\n```\n\n## Configuration\n\nIf writing to S3 you'll need to make sure that your shell environment is [configured with appropriate credentials](http://docs.aws.amazon.com/AWSJavaScriptSDK/guide/node-configuring.html).\n\n## Usage\n\n```sh\n$ mapbox-tile-copy \u003cfile\u003e \u003cs3:// url template or file:// path\u003e\n```\n\nYour s3 url template must include a `{z}/{x}/{y}` scheme for writing and distributing tiles. File extensions are not required.\n\n#### Examples:\n\nCopy tiles from an mbtiles file to a folder in `my-bucket`:\n```sh\n$ mapbox-tile-copy ~/data/my-tiles.mbtiles s3://my-bucket/folder/mbtiles/{z}/{x}/{y}\n```\n\nCopy tiles from an mbtiles file to a relative folder in the current working directory named 'tiles':\n```sh\n$ mapbox-tile-copy ~/data/my-tiles.mbtiles file://./tiles\n```\n\nConvert a GeoJSON file into vector tiles:\n```sh\n$ mapbox-tile-copy ~/data/my-data.geojson s3://my-bucket/folder/geojson/{z}/{x}/{y}\n```\n\nCopy tiles from one S3 location to another via tilejson describing the source:\n```sh\n$ mapbox-tile-copy ~/data/online-data.tilejson s3://my-bucket/folder/tilejson/{z}/{x}/{y}\n```\n\nRender image tiles from vector tiles, using custom fonts from a location on your computer:\n```sh\n$ MapboxTileCopyFonts=/path/to/font/dir mapbox-tile-copy ~/style.tm2z s3://my-bucket/pngs/{z}/{x}/{y}\n```\n\nPerform a part of a copy operation. [Useful for parallel processing a large file](https://github.com/mapbox/tilelive.js#parallel-read-streams):\n```sh\n$ mapbox-tile-copy ~/data/my-tiles.mbtiles s3://my-bucket/parallel/{z}/{x}/{y} --part 2 --parts 12\n```\n\nThe `--part` operation is explicitly _zero-indexed_ because this gives tilelive's stream processors a predictable way to segment tiles per part. For example, the following will distribute all tiles among a single part. So all tiles will be rendered by this single part:\n```sh\n$ mapbox-tile-copy ~/data/my-tiles.mbtiles s3://my-bucket/parallel/{z}/{x}/{y} --part 0 --parts 1\n```\n\nThe following example will distribute tiles to the second part out of 4 total parts:\n```sh\n$ mapbox-tile-copy ~/data/my-tiles.mbtiles s3://my-bucket/parallel/{z}/{x}/{y} --part 1 --parts 4\n```\n\nYou can add extra parameters supported by [tilelive-s3](https://github.com/mapbox/tilelive-s3) onto the end of the S3 URL. For instance, to extend the default HTTP timeout of 2000ms:\n```sh\n$ mapbox-tile-copy ~/data/my-tiles.mbtiles s3://my-bucket//{z}/{x}/{y}?timeout=10000\n```\n\nCollect tile size statistics and dump to your local tmp dir named `/tmp/\u003ctmpdirpath\u003e/tilelive-bridge-stats.json`\n```sh\n$ BRIDGE_LOG_MAX_VTILE_BYTES_COMPRESSED=1 mapbox-tile-copy ~/data/my-tiles.mbtiles s3://my-bucket/folder/mbtiles/{z}/{x}/{y}\n```\n\n## Supported file types\n\n- .mbtiles\n- .tilejson\n- .tm2z\n- .kml\n- .geojson\n- .gpx\n- .csv\n- .shp\n- .tif\n- .vrt\n- serialtiles\n\n## Running tests\n\n```sh\n$ npm test\n```","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmapbox%2Fmapbox-tile-copy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmapbox%2Fmapbox-tile-copy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmapbox%2Fmapbox-tile-copy/lists"}