Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Linux
Transform your favorite cities into beautiful, minimalist designs. MapToPoster lets you create and export visually striking map posters with code.
Saved setup from 8 h ago
Will it work on Linux?
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
git clone https://github.com/originalankur/maptoposter.git cd maptoposter
Python >=3.11
curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync
If you're using uv:
uv run ./create_map_poster.py --city <city> --country <country> [options]
Otherwise (pip + venv):
python create_map_poster.py --city <city> --country <country> [options]
| Option | Short | Description |
|--------|-------|-------------|
| --city | -c | City name (used for geocoding) |
| --country | -C | Country name (used for geocoding) |
| Option | Short | Description | Default |
|--------|-------|-------------|---------|
| OPTIONAL: --latitude | -lat | Override latitude center point (use with --longitude) | |
| OPTIONAL: --longitude | -long | Override longitude center point (use with --latitude) | |
| OPTIONAL: --country-label | | Override country text displayed on poster | |
| OPTIONAL: --theme | -t | Theme name | terracotta |
| OPTIONAL: --distance | -d | Map radius in meters | 18000 |
| OPTIONAL: --list-themes | | List all available themes | |
| OPTIONAL: --all-themes | | Generate posters for all available themes | |
| OPTIONAL: --width | -W | Image width in inches | 12 (max: 20) |
| OPTIONAL: --height | -H | Image height in inches | 16 (max: 20) |
Display city and country names in your language with custom fonts from google fonts:
| Option | Short | Description |
|--------|-------|-------------|
| --display-city | -dc | Custom display name for city (e.g., "東京") |
| --display-country | -dC | Custom display name for country (e.g., "日本") |
| --font-family | | Google Fonts family name (e.g., "Noto Sans JP") |
Examples:
# Japanese
python create_map_poster.py -c "Tokyo" -C "Japan" -dc "東京" -dC "日本" --font-family "Noto Sans JP"
# Korean
python create_map_poster.py -c "Seoul" -C "South Korea" -dc "서울" -dC "대한민국" --font-family "Noto Sans KR"
# Arabic
python create_map_poster.py -c "Dubai" -C "UAE" -dc "دبي" -dC "الإمارات" --font-family "Cairo"
Note: Fonts are automatically downloaded from Google Fonts and cached locally in fonts/cache/.
Use these values for -W and -H to target specific resolutions:
| Target | Resolution (px) | Inches (-W / -H) | |--------|-----------------|------------------| | Instagram Post | 1080 x 1080 | 3.6 x 3.6 | | Mobile Wallpaper | 1080 x 1920 | 3.6 x 6.4 | | HD Wallpaper | 1920 x 1080 | 6.4 x 3.6 | | 4K Wallpaper | 3840 x 2160 | 12.8 x 7.2 | | A4 Print | 2480 x 3508 | 8.3 x 11.7 |
# Simple usage with default theme
python create_map_poster.py -c "Paris" -C "France"
# With custom theme and distance
python create_map_poster.py -c "New York" -C "USA" -t noir -d 12000
Display city names in their native scripts:
# Japanese
python create_map_poster.py -c "Tokyo" -C "Japan" -dc "東京" -dC "日本" --font-family "Noto Sans JP" -t japanese_ink
# Korean
python create_map_poster.py -c "Seoul" -C "South Korea" -dc "서울" -dC "대한민국" --font-family "Noto Sans KR" -t midnight_blue
# Thai
python create_map_poster.py -c "Bangkok" -C "Thailand" -dc "กรุงเทพมหานคร" -dC "ประเทศไทย" --font-family "Noto Sans Thai" -t sunset
# Arabic
python create_map_poster.py -c "Dubai" -C "UAE" -dc "دبي" -dC "الإمارات" --font-family "Cairo" -t terracotta
# Chinese (Simplified)
python create_map_poster.py -c "Beijing" -C "China" -dc "北京" -dC "中国" --font-family "Noto Sans SC"
# Khmer
python create_map_poster.py -c "Phnom Penh" -C "Cambodia" -dc "ភ្នំពេញ" -dC "កម្ពុជា" --font-family "Noto Sans Khmer"
# Iconic grid patterns
python create_map_poster.py -c "New York" -C "USA" -t noir -d 12000 # Manhattan grid
python create_map_poster.py -c "Barcelona" -C "Spain" -t warm_beige -d 8000 # Eixample district
# Waterfront & canals
python create_map_poster.py -c "Venice" -C "Italy" -t blueprint -d 4000 # Canal network
python create_map_poster.py -c "Amsterdam" -C "Netherlands" -t ocean -d 6000 # Concentric canals
python create_map_poster.py -c "Dubai" -C "UAE" -t midnight_blue -d 15000 # Palm & coastline
# Radial patterns
python create_map_poster.py -c "Paris" -C "France" -t pastel_dream -d 10000 # Haussmann boulevards
python create_map_poster.py -c "Moscow" -C "Russia" -t noir -d 12000 # Ring roads
# Organic old cities
python create_map_poster.py -c "Tokyo" -C "Japan" -t japanese_ink -d 15000 # Dense organic streets
python create_map_poster.py -c "Marrakech" -C "Morocco" -t terracotta -d 5000 # Medina maze
python create_map_poster.py -c "Rome" -C "Italy" -t warm_beige -d 8000 # Ancient layout
# Coastal cities
python create_map_poster.py -c "San Francisco" -C "USA" -t sunset -d 10000 # Peninsula grid
python create_map_poster.py -c "Sydney" -C "Australia" -t ocean -d 12000 # Harbor city
python create_map_poster.py -c "Mumbai"
…
No reports for Linux yet.
GitManual AI Agent reads the 5 key files and writes a step-by-step guide for Linux. Once written, it's saved for everyone.