# MapSCII: Render World Maps in Braille and ASCII Directly in Your Console

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/rastapasta-mapscii
Generated for open source discovery and AI-assisted research.

MapSCII is a unique JavaScript project that brings the world map to your terminal, rendering maps using Braille and ASCII characters. It offers an interactive experience directly from your console, allowing users to explore the globe, zoom, and pan. This fascinating tool is perfect for command-line enthusiasts looking for a novel way to visualize geographical data.

GitHub: https://github.com/rastapasta/mapscii
OSRepos URL: https://osrepos.com/repo/rastapasta-mapscii

## Summary

MapSCII is a unique JavaScript project that brings the world map to your terminal, rendering maps using Braille and ASCII characters. It offers an interactive experience directly from your console, allowing users to explore the globe, zoom, and pan. This fascinating tool is perfect for command-line enthusiasts looking for a novel way to visualize geographical data.

## Topics

- JavaScript
- Console
- Map
- ASCII Art
- Braille
- OpenStreetMap
- CLI Tool
- Geospatial

## Repository Information

Last analyzed by OSRepos: Fri Nov 21 2025 08:00:55 GMT+0000 (Western European Standard Time)
Detail views: 6
GitHub clicks: 1

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction

MapSCII is an extraordinary open-source project that brings the entire world map directly to your console. Developed in JavaScript, this unique tool renders geographical data using Braille and ASCII characters, offering an interactive and visually distinct mapping experience. It's a fascinating way to explore the globe without leaving your terminal, supporting features like zooming, panning, and discovering points of interest. You can even try it instantly by typing `telnet mapscii.me` in your terminal.

## Installation

Getting MapSCII up and running is straightforward. Ensure you have Node.js (version 10 or higher) installed on your system.

### With npm

To install MapSCII globally via npm:

sh
npm install -g mapscii


If you encounter permission errors, especially on macOS, you might need to use `sudo`:

sh
sudo npm install -g mapscii


You can also run it directly without global installation using `npx`:

sh
npx mapscii


### With Snap

For users on supported Linux distributions, MapSCII is also available as a Snap package:

sh
sudo snap install mapscii


## Examples

Once installed, simply run `mapscii` from your terminal to launch the interactive map.

sh
mapscii


**Keyboard Shortcuts:**
*   **Arrows (up, down, left, right)**: Scroll around the map.
*   **a** or **z**: Zoom in and out.
*   **c**: Switch to block character mode.
*   **q**: Quit the application.

**Mouse Control:**
If your terminal supports mouse events, you can drag the map to pan and use your scroll wheel to zoom in and out, providing a more intuitive navigation experience.

## Why Use MapSCII?

MapSCII stands out for several compelling reasons:

*   **Unique Console Experience**: It offers a novel way to interact with maps directly from your command line, perfect for developers and CLI enthusiasts.
*   **Highly Customizable**: Supports Mapbox Styles, allowing for extensive customization of layer styling.
*   **Offline Capabilities**: Connects to any public or private vector tile server, and can work offline with local VectorTile/MBTiles.
*   **Optimized Performance**: Built with highly optimized algorithms in pure JavaScript for a smooth and responsive experience.
*   **Accessibility**: Provides a lightweight mapping solution accessible across most Linux and macOS terminals, and via PuTTY on Windows.

## Links

*   **GitHub Repository**: [https://github.com/rastapasta/mapscii](https://github.com/rastapasta/mapscii){:target="_blank"}
*   **Live Demo**: Connect via `telnet mapscii.me` (On Windows, use [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html){:target="_blank"})