https://github.com/mojodna/tl

An alternate command line interface to tilelive
https://github.com/mojodna/tl

Last synced: 2 months ago
JSON representation

An alternate command line interface to tilelive

• Host: GitHub
• URL: https://github.com/mojodna/tl
• Owner: mojodna
• Created: 2014-05-28T22:59:48.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2018-07-10T20:44:07.000Z (over 6 years ago)
• Last Synced: 2024-11-05T03:05:19.527Z (2 months ago)
• Language: JavaScript
• Homepage:
• Size: 39.1 KB
• Stars: 38
• Watchers: 7
• Forks: 12
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

• awesome-vector-tiles - tl - An alternate command line interface to tilelive (CLI Utilities)

README

        
# tl

A command line alternative to

[`tilelive`](https://github.com/mapbox/tilelive.js) that supports streaming

copies and static image rendering.

## Installation

```bash

npm install tl

npm install mbtiles tilelive-file

# install any other tilelive modules you'd like to read/write from

```

## Usage

Copy tiles from a filesystem to an MBTiles archive (assumes that

`tilelive-file` and `mbtiles` are installed):

```bash

tl copy file://./tiles mbtiles://./tiles.mbtiles

```

Render a [TM2](https://github.com/mapbox/tm2) style for a small area into an

MBTiles archive:

```bash

npm install mbtiles tilelive-tmstyle tilelive-mapbox tilejson \

  tilelive-vector@^0.13.0

tl copy

  -z 6 -Z 6 -b "-124.4096 32.5343 -114.1308 42.0095" \

  tmstyle://./project.tm2/ mbtiles://./tiles.mbtiles

```

Copy tiles from an MBTiles archive to S3.

```bash

tl copy mbtiles://./tiles.mbtiles "s3://bucket-name/{z}/{x}/{y}.png?acl=public-read"

```

## Caveats

Some tilelive providers use other providers but don't depend on them directly

(relying on `tilelive.load()`), so you may need to install (and `--require|-r`)

some modules that you're not using directly.

For example, [`tilelive-tmstyle`](https://github.com/mojodna/tilelive-tmstyle)

often loads data using

[`tilelive-mapbox`](https://github.com/mojodna/tilelive-mapbox), which actually

uses [`tilejson`](https://github.com/mapbox/node-tilejson) under the hood to do

the fetching. Rendering is then done using

[`tilelive-vector`](https://github.com/mapbox/tilelive-vector) (which is

declared as a peer dependency of `tilelive-tmstyle`, so versions may not always

match up to whatever's most up-to-date).