tilestache-seed - seed a single layer in your TileStache configuration


tilestache-seed [options] zoom...


This manual page documents briefly the tilestache-seed command.

tilestache-seed seeds a single layer in your TileStache configuration. No images are returned, but TileStache ends up with a pre-filled cache. Bounding box is given as a pair of lat/lon coordinates, e.g. "37.788 -122.349 37.833 -122.246". Output is a list of tile paths as they are created.
Configuration, BBox, and Layer options are required.


-c, --config file
Path to configuration file. Required.
-l, --layer layer
Layer name from configuration. Required.
-b, --bbox south west north east
Bounding box in floating point geographic coordinates. Required.


-h, --help
Show summary of options.
-p, --padding padding
Extra margin of tiles to add around bounded area. Default value is 0 (no extra tiles).
-e, --extension extension
Optional file type for rendered tiles. Default value is "png" for most image layers and some variety of JSON for Vector or Mapnik Grid providers.
-f, --progress-file file
Optional JSON progress file that gets written on each iteration, so you don't have to pay close attention.
Suppress chatty output, --progress-file works well with this.
-i, --include-path
Add the following colon-separated list of paths to Python's include path (aka sys.path).
-d, --output-directory
Optional output directory for tiles, to override configured cache with the equivalent of:
 {"name": "Disk", "path": <output directory>, "dirs": "portable", "gzip": []}.

More information in

Optional output file for tiles, will be created as an MBTiles 1.1 tileset. See for more information.
Optional input file for tiles, will be read as an MBTiles 1.1 tileset. See for more information. Overrides --extension, --bbox and --padding (this may change).
Optional output bucket for tiles, will be populated with tiles in a standard Z/X/Y layout. Three required arguments: AWS access-key, secret, and bucket name.
Optional file of tile coordinates, a simple text list of Z/X/Y coordinates. Overrides --bbox and --padding.
Optional file of failed tile coordinates, a simple text list of Z/X/Y coordinates. If provided, failed tiles will be logged to this file instead of stopping tilestache-seed.
If true this will cause tilestache-seed to retry failed tile renderings up to (3) times. Default value is False.
-x, --ignore-cached
Re-render every tile, whether it is in the cache already or not.
Add a JSONP callback for tiles with a json mime-type, causing "*.js" tiles to be written to the cache wrapped in the callback function. Ignored for non-JSON tiles.




TileStache was written by Michal Migurski <mike [at]>.

This manual page was written by David Paleino <dapal [at]>, for the Debian project (and may be used by others).