Skip to main content

Transform Cities into Art

Generate beautiful, minimalist map posters for any city in the world. MapToPoster turns OpenStreetMap data into stunning visual art with customizable themes, multilingual support, and export-ready formats.

Get StartedView Gallery
Singapore city map poster with neon cyberpunk theme

Quick Start

Create your first map poster in three simple steps

1

Install the tool

Install MapToPoster using uv (recommended) or pip:
uv run ./create_map_poster.py --city "Paris" --country "France"
Using uv automatically creates and manages a virtual environment on first run.
2

Generate your first poster

Run the command with your desired city and country:
python create_map_poster.py --city "Tokyo" --country "Japan" --theme japanese_ink
The poster will be saved to the posters/ directory with format: {city}_{theme}_{timestamp}.png
3

Customize and explore

Try different themes, adjust the map radius, or add multilingual labels:
python create_map_poster.py \
  -c "Barcelona" -C "Spain" \
  -t warm_beige \
  -d 8000 \
  -W 12 -H 16
Your poster will include:
  • Road network with hierarchical styling
  • Water features and parks
  • City and country labels
  • Geographic coordinates
  • High-quality 300 DPI output

Key Features

Everything you need to create professional map posters

17 Built-in Themes

From minimalist noir to vibrant neon cyberpunk, choose from carefully crafted color schemes

Multilingual Support

Display city names in their native scripts with automatic Google Fonts integration

Customizable Output

Generate posters from Instagram posts to 4K wallpapers with precise dimension control

Road Hierarchy

Intelligent road styling based on OSM highway types with customizable colors and widths

Multiple Formats

Export as PNG, SVG, or PDF for print-ready or web-optimized outputs

Offline Caching

Local caching of OpenStreetMap data for faster regeneration and offline work

Explore by Use Case

Find inspiration and examples for different city types

Barcelona grid pattern map poster

Grid Patterns

Showcase cities with iconic street grids like Manhattan, Barcelona, and Chicago

View examples →
Venice waterfront map poster

Waterfront & Canals

Highlight coastal cities and canal networks like Venice, Amsterdam, and Dubai

View examples →
Tokyo organic layout map poster

Organic Old Cities

Capture the organic beauty of cities like Tokyo, Marrakech, and Rome

View examples →
Dubai map poster with custom coordinates

Advanced Examples

Custom coordinates, multiple formats, and batch generation techniques

View examples →

Ready to Create?

Install MapToPoster and start generating beautiful map posters in minutes

Install NowContribute on GitHub

Build docs developers (and LLMs) love

Get started for freeTalk to us