rastapasta

mapscii: Explore Vector Maps in a Terminal

MapSCII renders OpenStreetMap-based vector tiles as Braille and ASCII in an interactive terminal map. It suits people who want lightweight map exploration from a console, or developers experimenting with vector-tile sources and styles.

View on GitHub Compare
Stars
9.2k
Forks
299
Stars, last 30 days
+22

Our take

Health score

27/100

How it is scored
Activity
19
Community
49
Issues
21
Pull requests
20

+22 stars in the last 30 days

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

9,283

Forks

298

Change since Nov 17, 2026: 0 stars·0 forks

Overview

MapSCII is a JavaScript terminal application that turns vector map tiles into Braille or ASCII characters. It brings interactive map browsing to xterm-compatible consoles, where users can pan around and zoom without opening a graphical map interface.

It is useful for terminal-based exploration and for inspecting vector tile data, including local MBTiles files or public and private tile servers. It is not a general-purpose graphical GIS viewer.

Key Features

  • Renders vector map data using Braille, ASCII, or block characters.
  • Supports panning and zooming with keyboard controls, and mouse input in terminals that support mouse events.
  • Displays points of interest around a location.
  • Supports styling with the Mapbox Style specification.
  • Can connect to public or private vector tile servers, and can work with local vector tiles or MBTiles.
  • Offers a hosted telnet entry point as well as local Node.js execution.

Use Cases

  • Terminal users can browse maps when they want a console-based alternative to a graphical map application.
  • Developers working with vector tiles can inspect tile sources and experiment with map styles from a terminal.
  • Users with local MBTiles data can explore map tiles offline.
  • Map and GIS learners can see how vector map features are rendered into terminal characters.

Getting Started

With Node.js installed, run:

npx mapscii

For other installation options and controls, see the README.

Considerations

  • The interface depends on an xterm-compatible terminal; mouse controls require terminal support for mouse events.
  • Local execution requires Node.js. The README specifies Node.js 10 or newer for installation.
  • Map rendering requires vector tile data. Offline use depends on having local vector tiles or MBTiles available.
  • The repository describes the supplied map data as OpenStreetMap data under the ODbL, with map cartography under CC BY-SA. Check the applicable data and attribution terms when using map data.

Found this useful?

Share it with someone who would like mapscii.