Skip to content

ItsLimitlezz/mui-tiles

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 

Repository files navigation

Mesh Maps Studio

macOS 14+ app to download OpenStreetMap (and Carto Light/Dark) tiles and convert them to LVGL .bin (RGB565, no alpha) in the folder layout MUI expects. Output is SD-card ready:

maps/<style>/<z>/<x>/<y>.bin

Copy the maps/ folder onto your SD card root (or Portduino FS). MUI supports /maps/...; our firmware also falls back to /map/... if needed.

Mesh Maps Studio screenshot

Features

  • macOS app (14+), Swift-only converter (no Python dependency)
  • Providers: OpenStreetMap, Carto Light, Carto Dark (folders: osm/, carto-light/, carto-dark/)
  • Output: maps/<style>/<z>/<x>/<y>.bin (RGB565 LVGL); optional keep-PNG toggle
  • Map preview: Control-click / long-press to drop a pin; grid overlays for zoom/radius
  • Inputs: zoom min/max, radius, delay ms, keep-PNG toggle; estimates tile count + size
  • Progress UI with counts (downloaded/converted/failed) and cancel
  • Sandbox-friendly output folder picker

Quick start (app)

  1. macOS 14+ only. Build/run the app.
  2. Choose output folder (e.g., ~/Downloads/mui-tiles-export).
  3. Pick zoom min/max and radius. Map style: choose OSM / Carto Light / Carto Dark.
  4. Click Start Download. (Optional: keep PNGs.)
  5. Copy the exported maps/ folder to your SD card root (/maps/<style>/z/x/y.bin).

Notes

  • Respect each tile provider’s usage policy (OSM/Carto); no custom providers in this build.
  • Be gentle with download rates (use delay if pulling many tiles).
  • Firmware/Portduino will also accept /map/... thanks to a fallback, but the recommended layout is /maps/<style>/....

About

MUI tile downloader + LVGL RGB565 .bin converter (SD-card ready)

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages