Skip to main content

Image Tiles

A Moonshine Labs tool

Overview

A simple but flexible tool to view a folder full of images on your web browser. Features:

  • Run one command and serve a folder of images in any format PIL supports.
  • Easily view images on another computer, such as when working via SSH or remotely.
  • Support for AWS S3 and Google Cloud Storage buckets.
  • Normalization and rendering options for a variety of multispectral images, especially satellites.
  • Support for multichannel TIFF, JP2, and other less common file formats.

Quickstart

Run uvx image_tiles /path/to/folder

Installation

# Install default installation
$ pip install image_tiles

# Install with AWS S3 support
$ pip install image_tiles[aws]

# Install with Google Cloud Storage support
$ pip install image_tiles[gcp]

# Install with all cloud backends
$ pip install image_tiles[all]

Using uvx

You can also run image_tiles directly with uvx without installing:

# Run with default installation
$ uvx image_tiles /path/to/folder

# Run with AWS S3 support
$ uvx --with 'image_tiles[aws]' image_tiles s3://my-bucket/images/

# Run with Google Cloud Storage support
$ uvx --with 'image_tiles[gcp]' image_tiles gs://my-bucket/images/

# Run with all cloud backends
$ uvx --with 'image_tiles[all]' image_tiles /path/to/folder

Usage

# Serve local images
$ image_tiles ./path_to_folder

# Serve images from AWS S3
$ image_tiles s3://my-bucket/images/

# Serve images from Google Cloud Storage
$ image_tiles gs://my-bucket/images/

Serving a folder of JPEGs (images from instagram.com/dustinlefevre)

example_page

Serving a folder of multispectral TIFFs:

example_sat

Rendering options

  • rgb: Standard RGB image rendering (default).
  • bgr: BGR image rendering.
  • bw: Grayscale image rendering from the first 3 channels.
  • sentinel: Render using channels[1:4] for sentinel satellite data.

Normalization options

  • standard: If the image is a standard 1/3 channel image, leave it alone. Otherwise apply scaling (default)
  • scaling: Scale to 0-255, clipping negative numbers and scaling positive numbers.
  • sigmoid: Sigmoid normalization, as described in xarray true color
  • sentinel: Sentinel-2 specific normalization, as described at the Sentinel 2 user guide

Current Limitations

  • Only a subset of useful normalization and rendering options supported. Help contribute!
  • Eventually we'd like to more easily support user code and functions.
  • Must restart the server to change some options.

Metadata

Release files for image_tiles 0.1.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for image_tiles 0.1.5
File Size Uploaded Provenance Actions
image_tiles-0.1.5.tar.gz 2.3 MB Without provenance Details for image_tiles-0.1.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for image_tiles 0.1.5
File Interpreter ABI Platform Actions
image_tiles-0.1.5-py3-none-any.whl Python 3 none any Details for image_tiles-0.1.5-py3-none-any.whl

Total release size: 2.3 MB

Release files / image_tiles-0.1.5.tar.gz

Download URL image_tiles-0.1.5.tar.gz
Size 2.3 MB
Tags Source
SHA-256 checksum
How to use checksums
8f72b2a3917a7feadcac6b2d4f5f976cc6a24429256677fde25e81d162759bce
BLAKE2b-256 checksum
How to use checksums
58c02bec841d7d1c31a7b13f23798a539ed1f4a699d4395688830348dbcb7888
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.7

Release files / image_tiles-0.1.5-py3-none-any.whl

Download URL image_tiles-0.1.5-py3-none-any.whl
Size 19.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
41db11f676631eaa803201251ad65d97648b6dafca61dfa558e093b43680df21
BLAKE2b-256 checksum
How to use checksums
aa71ad40aa1350d47029ec035c8e9b3683708bb7d9432432f69d2d5a90de1c05
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.7

Security for image_tiles 0.1.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page