finds.dev

rastapasta/mapscii

🗺 MapSCII is a Braille & ASCII world map renderer for your console - enter => telnet mapscii.me <= on Mac (brew install telnet) and Linux, connect with PuTTY on Windows

View on GitHub

★ 9,133JavaScriptMITupdated Nov 2024

// the take

MapSCII renders OpenStreetMap vector tiles as Braille and ASCII art in your terminal, with real mouse support and live tile fetching. It's a genuine technical achievement — `telnet mapscii.me` actually works and looks impressive. The audience is developers who want a fun demo, a lightweight map viewer for headless servers, or just something cool to show at a terminal.

The Braille rendering is legitimately clever — packing 2x4 pixel cells into Unicode Braille characters gives you 8x the resolution of plain ASCII, which is a non-obvious trick. Mouse drag and scroll-to-zoom in a terminal application is well-executed and works without any external GUI toolkit. The tile pipeline is well-composed: Mapbox vector tiles → protobuf decoding → earcut polygon triangulation → Bresenham line rasterization — each step uses the right dedicated library rather than reinventing it. Offline MBTiles support means you can take a local extract and use it without network access.

The project is effectively unmaintained — last meaningful activity was years before the 2024 bump, Travis CI badge is broken, and the TODOs list has barely moved. The tile server it depends on (OSM2VectorTiles) is a dead project; if the hosted mapscii.me server goes away, new users will have a harder time getting it running against a live source. There are no types, no bundler config, and only two spec files for a ~1500-line codebase — the 'highly optimized' rendering code is essentially untested. Zoom-based style ranges from Mapbox styles are explicitly not implemented, so styling is coarser than it looks in the screenshots.

We read the README, the directory tree and a key source file in June 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
9,133
Forks
290
Language
JavaScript
License
MIT
Last commit
3 Nov 2024

// nearby

If mapscii isn't quite it.

All repos →