Skip to main content

An importer and exporter for MBTiles

Project description

# MBUtil

MBUtil is a utility for importing and exporting the [MBTiles]( format,
typically created with [MapBox]( [TileMill](

Before exporting tiles to disk, see if there's a [MapBox Hosting plan](
or an open source [MBTiles server implementation](
that works for you - tiles on disk are notoriously difficult to manage.

## Installation

Git checkout (requires git)

git clone git://
cd mbutil
./mb-util -h

# then to install the mb-util command globally:
sudo python install
# then you can run:

Python installation (requires easy_install)

easy_install mbutil
mb-util -h

## Usage

$ mb-util -h
Usage: mb-util [options] input output

Export an mbtiles file to a directory of files:

$ mb-util world.mbtiles tiles # tiles must not already exist

Import a directory of tiles into an mbtiles file:
$ mb-util tiles world.mbtiles # mbtiles file must not already exist

-h, --help show this help message and exit
--scheme=SCHEME Tiling scheme of the tiles. Default is "xyz" (z/x/y),
other options are "tms" which is also z/x/y
but uses a flipped y coordinate, and "wms" which replicates
the MapServer WMS TileCache directory structure "z/000/000/x/000/000/y.png"''',

Export an `mbtiles` file to files on the filesystem:

mb-util World_Light.mbtiles adirectory

Import a directory into a `mbtiles` file

mb-util directory World_Light.mbtiles

## Requirements

* Python `>= 2.6`

## Metadata

MBUtil imports and exports metadata as JSON, in the root of the tile directory, as a file named `metadata.json`.

"name": "World Light",
"description": "A Test Metadata",
"version": "3"

## Testing

This project uses [nosetests]( for testing. Install nosetests
and run


## See Also

* [node-mbtiles provides mbpipe](, a useful utility.

## License

BSD - see

## Authors

- Tom MacWright (tmcw)
- Dane Springmeyer (springmeyer)
- Mathieu Leplatre (leplatrem)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mbutil-0.2.0.tar.gz (6.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page