Git Product home page Git Product logo

mapsinterminal's Introduction

MapsInTerminal

A WMS client for the terminal.

MapsInTerminal is a simple command line utility to view maps in the terminal using a WMS service.

Supports WMS version 1.1.1 and 1.3.0. Might work with other versions, but that is untested.

Tested on GNU/Linux, but might work on other Operating Systems as well.

License

Mozilla Public License, v. 2.0

Usage

Web Mercator projection

This is the default projection, EPSG:3857.

mapsint http://some-wms-service/my/wms mylayer

Official projection of Sweden

Use a custom projection, for example EPSG:3006.

mapsint http://some-wms-service/my/wms mylayer --crs epsg:3006 --center 593000,6902000

OpenStreetMap

Can be used with OpenStreetMap WMS provided by terrestris

mapsint https://ows.terrestris.de/osm/service OSM-WMS

wms_osm

(Map data from OpenStreetMap)

Controls

Pan: arrow keys
Zoom: +/-
Reset view: backspace
Exit: escape

Configuration options

  • WMS CRS
  • WMS image format
  • WMS styles
  • WMS version
  • Center coordinate, view positioning x,y
  • Resolution (units/pixel), zoom level at startup
  • Image gutter
  • Image scaling
  • Basic Auth user:pass
  • Invert axis order
  • Disable SSL certificate verification

To see all options run: mapsint --help

It is possible to set default values for options by creating a file named .MapsInTerminal in the user's home directory:

{
   "crs": "EPSG:3857",
   "format": "image/png",
   "styles": null,
   "version": "1.1.1",
   "center": "2044638,8251379",
   "res": 1222.992452562820,
   "gutter": 0,
   "scaling": 1,
   "auth": null,
   "invert": false,
   "ssl_verify": true
}

Dependencies

  • Python 3
  • requests
  • Pillow
  • pager
  • img2txt.py

Installation

cd MapsInTerminal
pip install .

mapsinterminal's People

Contributors

tomhel avatar

Stargazers

 avatar  avatar

Watchers

 avatar

Forkers

darasmussen

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.