// the find
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
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.