Skip to main content
Help us improve Python packaging – donate today!

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.

[![Build Status](](

## Installation

Git checkout (requires git)

git clone git://
cd mbutil
# get usage
./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"''',
The format of the image tiles, either png, jpg, webp or pbf
Option to control JSONP callback for UTFGrid tiles. If
grids are not used as JSONP, you can
remove callbacks specifying --grid_callback=""
--do_compression Do mbtiles compression
--silent Dictate whether the operations should run silentl

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:

pip install nose

easy_install nose

Then run:


## See Also

* [node-mbtiles provides mbpipe](, a useful utility.
* [mbliberator]( a similar program but in node.

## License

BSD - see

## Authors

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

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
mbutil-0.3.0-py2.py3-none-any.whl (10.1 kB) Copy SHA256 hash SHA256 Wheel py2.py3 May 3, 2017
mbutil-0.3.0.tar.gz (8.3 kB) Copy SHA256 hash SHA256 Source None May 3, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page