{"id":13419788,"url":"https://github.com/mapbox/mbutil","last_synced_at":"2025-10-21T20:09:11.839Z","repository":{"id":645982,"uuid":"1363607","full_name":"mapbox/mbutil","owner":"mapbox","description":"Importer and Exporter of MBTiles","archived":false,"fork":false,"pushed_at":"2024-08-02T14:14:40.000Z","size":1390,"stargazers_count":756,"open_issues_count":17,"forks_count":198,"subscribers_count":154,"default_branch":"master","last_synced_at":"2024-10-01T10:19:24.643Z","etag":null,"topics":["satellite"],"latest_commit_sha":null,"homepage":"http://mapbox.com/developers/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mapbox.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.txt","contributing":null,"funding":null,"license":"LICENSE.md","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":"2011-02-14T01:48:06.000Z","updated_at":"2024-09-23T08:51:06.000Z","dependencies_parsed_at":"2024-10-26T16:53:31.925Z","dependency_job_id":"d3c37c40-d95a-4f41-a756-ed126863e56b","html_url":"https://github.com/mapbox/mbutil","commit_stats":{"total_commits":97,"total_committers":35,"mean_commits":"2.7714285714285714","dds":0.7835051546391752,"last_synced_commit":"544c76eea925e3c1bc129f601e314ea9701bfc79"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapbox%2Fmbutil","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapbox%2Fmbutil/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapbox%2Fmbutil/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapbox%2Fmbutil/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mapbox","download_url":"https://codeload.github.com/mapbox/mbutil/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243690112,"owners_count":20331726,"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":["satellite"],"created_at":"2024-07-30T22:01:20.883Z","updated_at":"2025-10-21T20:09:06.803Z","avatar_url":"https://github.com/mapbox.png","language":"Python","readme":"# MBUtil\n\nMBUtil is a utility for importing and exporting the [MBTiles](http://mbtiles.org/) format,\ntypically created with [Mapbox](http://mapbox.com/) [TileMill](http://mapbox.com/tilemill/).\n\nBefore exporting tiles to disk, see if there's a [Mapbox Hosting plan](http://mapbox.com/plans/)\nor an open source [MBTiles server implementation](https://github.com/mapbox/mbtiles-spec/wiki/Implementations)\nthat works for you - tiles on disk are notoriously difficult to manage.\n\n[![Build Status](https://secure.travis-ci.org/mapbox/mbutil.png)](http://travis-ci.org/mapbox/mbutil)\n\n**Note well**: this project is no longer actively developed. Issues and pull requests will be attended to when possible, but delays should be expected.\n\n## Installation\n\nGit checkout (requires git)\n\n    git clone https://github.com/mapbox/mbutil.git\n    cd mbutil\n    # get usage\n    ./mb-util -h\n\nThen to install the mb-util command globally:\n\n    sudo python setup.py install\n    # then you can run:\n    mb-util\n\nPython installation (requires easy_install)\n\n    easy_install mbutil\n    mb-util -h\n\n## Usage\n\n    $ mb-util -h\n    Usage: mb-util [options] input output\n\n    Examples:\n\n        Export an mbtiles file to a directory of files:\n        $ mb-util world.mbtiles tiles # tiles must not already exist\n\n        Import a directory of tiles into an mbtiles file:\n        $ mb-util tiles world.mbtiles # mbtiles file must not already exist\n\n    Options:\n      -h, --help            Show this help message and exit\n      --scheme=SCHEME       Tiling scheme of the tiles. Default is \"xyz\" (z/x/y),\n                            other options are \"tms\" which is also z/x/y\n                            but uses a flipped y coordinate, and \"wms\" which replicates\n                            the MapServer WMS TileCache directory structure \"z/000/000/x/000/000/y.png\"''',\n                            and \"zyx\" which is the format vips dzsave --layout google uses.\n      --image_format=FORMAT\n                            The format of the image tiles, either png, jpg, webp or pbf\n      --grid_callback=CALLBACK\n                            Option to control JSONP callback for UTFGrid tiles. If\n                            grids are not used as JSONP, you can\n                            remove callbacks specifying --grid_callback=\"\"\n      --do_compression      Do mbtiles compression\n      --silent              Dictate whether the operations should run silently\n\n\n    Export an `mbtiles` file to files on the filesystem:\n\n        mb-util World_Light.mbtiles adirectory\n\n\n    Import a directory into a `mbtiles` file\n\n        mb-util directory World_Light.mbtiles\n\n## Requirements\n\n* Python `\u003e= 2.6`\n\n## Metadata\n\nMBUtil imports and exports metadata as JSON, in the root of the tile directory, as a file named `metadata.json`.\n\n```javascript\n{\n    \"name\": \"World Light\",\n    \"description\": \"A Test Metadata\",\n    \"version\": \"3\"\n}\n```\n\n## Testing\n\nThis project uses [nosetests](http://readthedocs.org/docs/nose/en/latest/) for testing. Install nosetests:\n\n    pip install nose\nor\n\n    easy_install nose\n    \nThen run:\n\n    nosetests\n\n## See Also\n\n* [node-mbtiles provides mbpipe](https://github.com/mapbox/node-mbtiles/wiki/Post-processing-MBTiles-with-MBPipe), a useful utility.\n* [mbliberator](https://github.com/calvinmetcalf/mbliberator) a similar program but in node.\n\n## License\n\nBSD - see LICENSE.md\n\n## Authors\n\n- Tom MacWright (tmcw)\n- Dane Springmeyer (springmeyer)\n- Mathieu Leplatre (leplatrem)\n","funding_links":[],"categories":["Python","CLI Utilities"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmapbox%2Fmbutil","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmapbox%2Fmbutil","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmapbox%2Fmbutil/lists"}