Skip to content

Environment variables

Variable
MAPTERM_GRAPHICS kitty or cells: force raster layers to real images or cell colors instead of detecting kitty graphics support.
MAPTERM_KITTY_BUDGET_MB How many MiB of decoded images to keep in the terminal (default 48). Off-screen tiles are freed first.
MAPTERM_SMOOTH shift or 1: the experimental smooth scrolling modes.
Variable
MAPTERM_GEOCODER The place search service: Photon by default, nominatim for OpenStreetMap’s Nominatim, or the URL of your own server.

Keys come from the environment or from --raster-key-cmd, never from the command line.

Variable For
VANTOR_API_KEY (or MAXAR_API_KEY) --raster vantor
PL_API_KEY (or PLANET_API_KEY) --raster planet
PLANET_MOSAIC The Planet mosaic, instead of --raster-param mosaic=NAME
MAPBOX_ACCESS_TOKEN --raster mapbox
MAPTILER_KEY --raster maptiler
MAPTERM_RASTER_KEY {key} in a custom raster URL or header
Variable
MAPTERM_LOG A file path: mapterm writes a debug log there (tile loads and errors, style warnings, frame timing).