A high performance tile server and simple web viewer for MBTiles files.
- MBTiles-based tile server
- Minimal gallery view and map viewer for tiles
- Support for MBTiles interaction using Wax
- 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
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.
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
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
TileStream tests use Expresso.
npm install -g expresso
cd tilestream
npm test