KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

tl

★ 37 Open GitHub ↗

An alternate command line interface to tilelive

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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).

tl

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README