man(1)

📦
version 3.1.0 · 2 versions
  • 3.1.0 · debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 2.0.0 · ubuntu jammy
, in debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 tilemaker 💖

okay so this is the man(1) page for tilemaker, bestie — section 1, the big leagues. pull up a chair, grab a boba, we're doing this 🧋✨

✨ NAME ✨

tilemaker — Generates vector tiles from OpenStreetMap data 🗺️🦋

✨ SYNOPSIS ✨

tilemaker --input input.osm.pbf --output output.mbtiles

✨ DESCRIPTION ✨

okay so real talk, this manual page documents briefly the tilemaker command. that's the vibe, that's the job 📝

tilemaker generates vector tiles from OpenStreetMap planet and diff files without any complex stack or need for a database. like… no database. none. zero. she's self-contained, she's low-maintenance, she's the moment 💅

by default she uses the schema of OpenMapTiles, but bestie you can absolutely produce custom vector tiles if you want to — you just modify the JSON config (that's the layer config and the general options, both of them, don't forget) plus the Lua processing script (which is the thing mapping OSM tags to vector tile layers/attributes). custom queen behavior 👑

this program follows the usual GNU command line syntax, with long options starting with two dashes (`-`). a summary of options is included below, and ngl it's a good one 🎀

✨ OPTIONS ✨

  • --input — Source path and file from OpenStreetMap (.osm.pbf). 🍓
  • --output — Target path for vector tiles. Specify .mbtiles/.sqlite to create an mbtiles archive, or a directory to create individual .mvt files. two paths, one destiny, pick your fighter 🌈
  • --config — Path to layer and global config file (.json). config.json assumed if not specified. she'll assume, respectfully 🫶
  • --process — Path to Lua processing script for processing tags. process.lua assumed if not specified. same assumption energy 💜
  • --store — Path to the directory to use as a temporary store during processing. If specified, tilemaker uses on-disk storage instead of holding everything in RAM. Fast storage (e.g. SSD) is strongly recommended. no cap, if you're gonna do on-disk storage, give her the good drive, she deserves it 😭🔥
  • --compact — Reduce overall memory usage by assuming nodes are numbered sequentially (requires .osm.pbf to be pre-processed with osmium renumber). tiny but mighty, but she requires that pre-processing, don't skip it 🙈
  • --merge — Merge with existing .mbtiles/.sqlite file. blending families, iconic ✨
  • --bbox — Bounding box to use if the input file does not set one in the header (as minlon,minlat,maxlon,maxlat). order matters bestie, lon first, don't come at me 📐
  • --skip-integrity — Don't enforce checks on all nodes being present in ways. living dangerously, we love that for you 💀
  • --verbose — Outputs any issues encountered during tile creation. she will tell you everything, she's a yapper and honestly? valid 🗣️
  • --threads — Number of threads (automatically detected if 0). set it to 0 and let her figure it out, she's smart like that 🧚
  • --help — Show help message for tilemaker. the classic. the icon. the one you should've read first 👑

🐛 BUGS 🐛

No known bugs. (she said what she said. flawless, unbothered, moisturized 🌸)

💜 AUTHOR 💜

This manual page was written by tilemaker contributors. thank you contributors, we owe you our lives fr fr 🙏

ok and that's the whole page, bestie — go make some tiles, you're gonna eat 💖

signing off: this was tilemaker man page, version 1.0, dated 10 Feb 2022 — iykyk, periodt 🎀✨

📦 where this page comes from