# Install mapscii with Homebrew, Nix

Whole World In Your Console. Version 0.3.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:mapscii
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mapscii
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#mapscii
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ma/mapscii/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:mapscii
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/mapscii>
- **Version:** 0.3.1
- **Source summary:** Whole World In Your Console
- **Homepage:** <https://github.com/rastapasta/mapscii>
- **Repository:** <https://github.com/rastapasta/mapscii>
- **Upstream docs:** <https://github.com/rastapasta/mapscii#readme>
- **License:** MIT
- **Source archive:** <https://registry.npmjs.org/mapscii/-/mapscii-0.3.1.tgz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- mapscii (cli)
- mapscii (alias)

## Dependencies

- node

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.3.1
- Local data: ok
- Upstream repository: https://github.com/rastapasta/mapscii
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

MapSCII is a JavaScript terminal map viewer that renders world map data as Braille and ASCII characters and can be run locally or over a telnet-style terminal session.

### Project history

The MapSCII GitHub repository was created in September 2016. Its README presents the project as a Braille and ASCII world map renderer for the console, with mouse dragging and zooming, points of interest, Mapbox-style layer styling, public or private vector tile servers, OSM2VectorTiles-based data, and offline MBTiles support.

The official release stream shows the early feature path: ASCII mode in 2017, improved mouse support later in 2017, a CoffeeScript-to-JavaScript transition in 2019, and version 0.3.1 in February 2020.

### Adoption history

MapSCII spread as a terminal novelty with real geospatial plumbing underneath. The official README documents npx mapscii, npm install -g mapscii, snap install mapscii, and direct use of the mapscii command, while Homebrew and Nix metadata in the input show additional package-manager adoption.

Its GitHub repository metadata shows unusually high interest for a small CLI map viewer, which fits its role as a memorable demo of vector tiles, terminal graphics, and OpenStreetMap-style data in one command.

### How it is used

Users run mapscii, pan with arrow keys, zoom with a and z, switch character mode with c, quit with q, and use mouse events when the terminal supports them. It can connect to vector tile servers or work with local VectorTile/MBTiles data.

For package users, MapSCII is mostly a frictionless CLI: install it, run mapscii, and get an interactive world map in a terminal without a browser.

### Why package nerds care

MapSCII is significant as a tiny package-index gem: it combines Node packaging, terminal rendering, vector tiles, and OpenStreetMap-derived data in a way that is instantly testable from a shell.

It is also a good example of why package managers carry playful tools: the utility may be narrow, but it exercises real terminal and geospatial dependencies.

### Timeline

- 2016: Public GitHub repository created.
- 2017: ASCII mode and improved mouse support releases published.
- 2019: CoffeeScript-to-JavaScript release published.
- 2020: v0.3.1 release published.

### Related projects

- Mapbox Styles, vector tiles, MBTiles, and OSM2VectorTiles are listed in the official README as part of the MapSCII feature set.
- OpenStreetMap-derived data is central to the project's map-viewing experience.

### Sources

- <https://api.github.com/repos/rastapasta/mapscii>
- <https://api.github.com/repos/rastapasta/mapscii/releases?per_page=5>
- <https://github.com/rastapasta/mapscii>
- source_facts.package-manager


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** mapscii
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - mapscii: normalized package name match | nixpkgs package indexes: pkgs/by-name/ma/mapscii/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew.
- [chawan](https://www.automicvault.com/pkg/brew/chawan/) - Shares av.db curated category or tags: cli, networking, terminal.
- [links](https://www.automicvault.com/pkg/brew/links/) - Shares av.db curated category or tags: cli, networking, terminal.
- [mosh](https://www.automicvault.com/pkg/brew/mosh/) - Shares av.db curated category or tags: cli, networking, terminal.
- [trzsz](https://www.automicvault.com/pkg/brew/trzsz/) - Shares av.db curated category or tags: cli, networking, terminal.
- [trzsz-go](https://www.automicvault.com/pkg/brew/trzsz-go/) - Shares av.db curated category or tags: cli, networking, terminal.
- [felinks](https://www.automicvault.com/pkg/brew/felinks/) - Shares av.db curated category or tags: cli, networking, terminal.
- [putty](https://www.automicvault.com/pkg/brew/putty/) - Shares av.db curated category or tags: cli, networking, terminal.
- [shellinabox](https://www.automicvault.com/pkg/brew/shellinabox/) - Shares av.db curated category or tags: cli, networking, terminal.
- [ggh](https://www.automicvault.com/pkg/brew/ggh/) - Local package facts share a topical domain. Shared terms: cli, networking, terminal, your.

## Combined YAML source

View the package source record on GitHub. [combined/mapscii.yml](https://github.com/automic-vault/db/blob/main/combined/mapscii.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
