install

• Install Rust (very easy)
• Then run cargo install opencloudtiles (very easy, but compiling can take 1-2 minutes)

run

running opencloudtiles will list you the available commands: ``` Usage: opencloudtiles

Commands: convert Convert between different tile containers serve Serve tiles via http probe Show information about a tile container compare Compare two tile containers ```

formats

| feature | cloudtiles | pmtiles | mbtiles | tar | |---------------------|------------|---------|---------|-----| | read container | | | | | | - from file | ✅ | 🚧 | ✅ | ✅ | | - from http | 🚧 | 🚧 | 🚫 | 🚫 | | - from gcs | 🚧 | 🚧 | 🚫 | 🚫 | | - from S3 | 🚧 | 🚧 | 🚫 | 🚫 | | write container | | | | | | - to file | ✅ | 🚧 | 🚧 | ✅ | | precompression | | | | | | - uncompressed | ✅ | 🚧 | 🚫 | ✅ | | - gzip | ✅ | 🚧 | ✅ | ✅ | | - brotli | ✅ | 🚧 | 🚫 | ✅ |

More on the cloudtiles container: github.com/OpenCloudTiles/opencloudtiles-specification

examples

```bash cargo build && ./target/debug/opencloudtiles convert --tile-format webp tiles/original/hitzekarte.tar tiles/hitzekarte.tar cargo build && ./target/debug/opencloudtiles convert tiles/original/stuttgart.mbtiles tiles/stuttgart.cloudtiles cargo build && ./target/debug/opencloudtiles convert tiles/stuttgart.cloudtiles tiles/stuttgart.tar cargo build && ./target/debug/opencloudtiles convert --min-zoom 14 --bbox -30,15,-20,20 tiles/original/2023-01-planet.mbtiles tiles/mostly_water.cloudtiles

cargo build && ./target/debug/opencloudtiles probe tiles/stuttgart.cloudtiles cargo build && ./target/debug/opencloudtiles serve tiles/stuttgart.cloudtiles cargo build && ./target/debug/opencloudtiles serve -s tiles/frontend tiles/stuttgart.cloudtiles

cargo build && ./target/debug/opencloudtiles serve -s tiles/frontend tiles/original/europe.mbtiles

cargo instruments --all-features -t "CPU Profiler" -- convert ~/Dropbox/Dropbox\ upload/Dropbbox\ upload\ new/opencloudtiles/mbtiles/2023-01-eu-de.mbtiles tiles/test.cloudtiles

cargo build -r && ./target/release/opencloudtiles probe --scan ~/Dropbox/Dropbox\ upload/Dropbbox\ upload\ new/opencloudtiles/mbtiles/2023-01-eu-de.mbtiles

cargo instruments --all-features -t "CPU Profiler" -- probe --scan ~/Dropbox/Dropbox\ upload/Dropbbox\ upload\ new/opencloudtiles/mbtiles/2023-01-eu-de.mbtiles

```

dev config

git config --local core.hooksPath .githooks/