Our take
- 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.
Stars
9,283Forks
298Change 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.