Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A high-performance map tile server powered by MBTiles files
JavaScript Shell

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
assets
commands
controllers
examples
lib
models
platforms/ubuntu
servers
templates
test
views
.gitignore
.npmignore
LICENSE.md
README.md
UPGRADING.md
index.js
package.json

README.md

TileStream

A high performance tile server and simple web viewer for MBTiles files.

Features

  • MBTiles-based tile server
  • Minimal gallery view and map viewer for tiles
  • Support for MBTiles interaction using Wax

Requirements

  • TileStream client
    • Tested: Chrome 6+, Firefox 3+, IE8+
    • May work: Opera 11
  • TileStream server
    • Tested: Mac OS X 10.6, Ubuntu 10.04, Ubuntu 11.04
    • Tested: node 0.4.9
    • Tested: npm v1.0.3
    • At least 613MB memory
    • May work: Older versions, other POSIX-compliant systems

Installation: Mac OS X 10.6

Install Xcode for Mac OS X.

Install node.

Install npm:

curl http://npmjs.org/install.sh | sh

Install TileStream:

npm install -g tilestream

This will install TileStream globally. If you want a local installation in your current working directory, run the command without the -g option.

Start TileStream:

tilestream

TileStream should now be accessible from a browser at http://localhost:8888.

Installation: Ubuntu 10.04

Install build requirements:

sudo apt-get install curl build-essential libssl-dev libsqlite3-0 libsqlite3-dev git-core

Install node:

git clone --depth 1 git://github.com/joyent/node.git
cd node
git checkout v0.4.9
export JOBS=2 # optional, sets number of parallel commands.
mkdir ~/local
./configure --prefix=$HOME/local/node
make
make install
echo 'export PATH=$HOME/local/node/bin:$PATH' >> ~/.profile
source ~/.profile

Install npm:

curl http://npmjs.org/install.sh | sh

Install TileStream:

npm install -g tilestream

This will install TileStream globally. If you want a local installation in your current working directory, run the command without the -g option.

Start TileStream:

tilestream

TileStream should now be accessible from a browser at http://localhost:8888. If you intend to run TileStream as a server on a hostname or an IP rather than as localhost, specify that hostname when you run TileStream:

tilestream --host 127.0.0.1
tilestream --host yourhost.com

Usage

MBTiles files should be placed in the ~/Documents/MapBox/tiles directory, which is created at first run. Each tileset can be previewed at http://localhost:8888/map/[filename] where [filename] is the name of the tileset file without the .mbtiles extension.

Tileset filenames:

  • May contain letters (lower or upper case), numbers, underscores or dashes.

    world-light.mbtiles
    control_room.mbtiles
    PartyLikeIts1999.mbtiles
    
  • May not contain periods, spaces, non ASCII characters or other punctuation.

    World Light.mbtiles
    BlueWorld-1.0.mbtiles
    

To see the options available for use with TileStream, run

tilestream start --help

Tests

TileStream tests use Expresso.

npm install -g expresso
cd tilestream
npm test

Contributors

Something went wrong with that request. Please try again.