From OpenStreetMap Wiki
Jump to: navigation, search
Available languages — Mapscii
Afrikaans Alemannisch aragonés asturianu azərbaycanca Bahasa Indonesia Bahasa Melayu Bân-lâm-gú Basa Jawa Baso Minangkabau bosanski brezhoneg català čeština dansk Deutsch eesti English español Esperanto estremeñu euskara français Frysk Gaeilge Gàidhlig galego Hausa hrvatski Igbo interlingua Interlingue isiXhosa isiZulu íslenska italiano Kiswahili Kreyòl ayisyen kréyòl gwadloupéyen kurdî latviešu Lëtzebuergesch lietuvių magyar Malagasy Malti Nederlands Nedersaksies norsk norsk nynorsk occitan Oromoo oʻzbekcha/ўзбекча Plattdüütsch polski português português do Brasil română shqip slovenčina slovenščina Soomaaliga suomi svenska Tiếng Việt Türkçe Vahcuengh vèneto Wolof Yorùbá Zazaki српски / srpski беларуская български қазақша македонски монгол русский тоҷикӣ українська Ελληνικά Հայերեն ქართული नेपाली मराठी हिन्दी অসমীয়া বাংলা ਪੰਜਾਬੀ ગુજરાતી ଓଡ଼ିଆ தமிழ் తెలుగు ಕನ್ನಡ മലയാളം සිංහල ไทย မြန်မာဘာသာ ລາວ ភាសាខ្មែរ ⵜⴰⵎⴰⵣⵉⵖⵜ አማርኛ 한국어 日本語 中文(简体)‎ 吴语 粵語 中文(繁體)‎ ייִדיש עברית اردو العربية پښتو سنڌي فارسی ދިވެހިބަސް
Mapscii being presented at Berlin Hack and Tell

mapscii is a fun "ASCII art" zooming panning view of OpenStreetMap.

mapscii github repo (instructions to run it and videos of it in action)


You can view the map in terminal window either telnetting to the Mapscii server or running the nodejs app yourself.


should work. If your connection unexpectedly drops, try reconnecting with "telnet -E".

No images are transferred by the session, only plain text. Navigate the map simply using your keyboard:

  • , , , – scroll around;
  • a or z – zoom in and out;
  • c – switch between Unicode Braille and raw ASCII mode;
  • q – quit the session.

Or, if your terminal supports mouse events, you can drag the map and use your scroll wheel to zoom in and out. The map will center on any location you click.

Terminal requirements

This just requires a terminal supporting an Xterm-compatible emulation (most telnet client softwares support it), and Unicode characters (with UTF-8 encoding) for symbols (including Braille dot patterns) rendered with suitable monospaced fonts installed on your system.

For now the default telnet client of Windows is not supported (no compatible Xterm emulation, it supports only the "ANSI.SYS" legacy terminal emulation inherited from DOS and all past versions of Windows), but you can use the open source client PuTTY to connect. If you are using Windows 10, you can run the native Linux telnet client from the "Ubuntu Bash" optional feature, supported by Microsoft. After connecting press c to activate the raw ASCII mode as otherwise some symbols will not be rendered if your system does not have fonts to render them with suitable monospace metrics. Instead they will be shown as squared "?" symbols (not allowing you to see the distinctive Braille dot patterns or other symbols).


To run it yourself as a Node.js app, see How to install it locally on Linux.