Note: This repository has been renamed from mbtiles-util to tiles-util. Please update your references accordingly.

• Using pip install (Windows/ Linux):

  pip install tiles-util

• Show information of installed mbtiles-util:

  pip show tiles-util

• Install the latest vertion of mbtiles-util:

  pip install tiles-util --upgrade

• Visit tiles-util on PyPI

• Display MBTiles metadata info:

  > mbtilesinfo <file_path>

  Ex: > mbtilesinfo tiles.mbtiles

• Convert MBTiles file to folder: (support raster MBTiles (.png, .jpg, .webp) and vector MBTiles (.pbf))

  > mbtiles2folder -i <file_name.mbtiles> -o [output_folder (optional)] -tms [TMS scheme (optional 0 or 1, default is 0)]

  Ex: > mbtiles2folder -i tiles.mbtiles -o tiles_folder -tms 0

  Without -o parameter: output_folder has the same name with MBTiles file name at current directory

• Convert a tiles folder to MBTiles file: (support raster tile (.png, .jpg, .webp) and vector tile (.pbf))

  > folder2mbtiles -i <input_folder> -o [file_name.mbtiles (optional)] -tms [TMS scheme (optional 0 or 1, default is 0)]

  Ex: > folder2mbtiles -i tiles_folder -o tiles.mbtiles -tms 0

  Without -o parameter: file_name.mbtiles has the same name with input_folder name at current directory

• Uplpad a vector tiles folder to Amazon S3 Bucket:

  > vectorfolder2s3 <input_folder>   

  Ex: > vectorfolder2s3 vectortiles_folder

  Input S3 parameters:

    > S3 Bucket name: <Your S3 Bucket name (required)>
    > S3 Prefix: [Your S3 prefix (Optional. Press Enter to upload to the bucket root folder)]
    > AWS Access Key ID: <Your_Access_Key_ID (required)>
    > AWS Secret Access Key: <Your_Secrect_Access_Key (required)>
    > AWS Region: <AWS region (Optional. Press Enter to choose default region)>

• Uplpad a raster tiles folder to Amazon S3 Bucket:

  > rasterfolder2s3 <input_folder>   

  Ex: > rasterfolder2s3 rastertiles_folder

  Input S3 parameters:

    > S3 Bucket name: <Your S3 Bucket name (required)>
    > S3 Prefix: [Your S3 prefix (Optional. Press Enter to upload to the bucket root folder)]
    > AWS Access Key ID: <Your_Access_Key_ID (required)>
    > AWS Secret Access Key: <Your_Secrect_Access_Key (required)>
    > AWS Region: <AWS region (Optional. Press Enter to choose default region)>