ou

README

où

où (French for "where") is a command-line tool that opens an interactive map in your terminal and displays a location or geometry.

It is built with Bubble Tea, using the tiletea map component, itself based on maprender.

Install

Homebrew

brew tap akhenakh/tap
brew install ou

Go

go install github.com/akhenakh/ou@latest

Usage

Open the map with a marker at a specific location:

ou -lat 48.8566 -lng 2.3522

Or pass the coordinates directly as two positional arguments:

ou 48.8566 2.3522

Display a file's geometry. The format is guessed from its content (GeoJSON, WKT, WKB):

ou -file /path/to/geometry.geojson

Or pipe geometry in on stdin; it's guessed the same way as -file:

cat /path/to/geometry.geojson | ou

Controls

Keys	Action
Arrow keys / h j k l	Pan
+ / =	Zoom in
-	Zoom out
d	Toggle the data panel (geometry mode only)
c	Match the closest road to the marker with ouca (location mode only)
q / ctrl+c	Quit

When viewing a geometry, press d to split the view in half vertically and show a data panel listing the geometry's metadata — its type, bounding box, computed area (polygons), number of edges and holes, number of polygons (multipolygons), length (lines), and any GeoJSON properties — alongside the map.

License

MIT

Documentation

Overview

Command ou opens an interactive terminal map showing a location or the geometry of a file.

"où" is French for "where".