satpass 0.1.0

Get the next satellite overpass (Sentinel-1, Sentinel-2, Landsat-8, Landsat-9) for any location.

satpass

Get the next satellite overpass (Sentinel-1, Sentinel-2, Landsat-8, Landsat-9) for any location.

Acquisition plans are fetched from ESA and USGS and cached locally for 12 hours.

Installation

pip install satpass

Or with uv:

uv add satpass

Usage

Command Line

satpass <lat> <lon> <satellite> [--date YYYY-MM-DD]

Satellites: sentinel1, sentinel2, landsat8, landsat9, landsat

Examples:

# Next Sentinel-2 overpass from today
satpass 59.706 28.433 sentinel2

# Next Sentinel-2 overpass on or after a specific date
satpass 59.70629085831534 28.433021598704343 sentinel2 --date 2026-03-25

# Next Landsat overpass (either L8 or L9, whichever is sooner)
satpass 34.05 -118.24 landsat --date 2026-03-25

Output (JSON):

{
  "satellite": "sentinel2",
  "date": "2026-03-26 10:14:22+00:00",
  "orbit": 81
}

Python API

from satpass import get_next_overpass
from datetime import datetime, timezone

result = get_next_overpass(
    lat=59.70629085831534,
    lon=28.433021598704343,
    satellite="sentinel2",
    after_date=datetime(2026, 3, 25, tzinfo=timezone.utc),
)
print(result)
# {'satellite': 'sentinel2', 'date': datetime(...), 'orbit': 81}

after_date defaults to now if omitted.

Data Sources

• Sentinel-1 / Sentinel-2: ESA acquisition plan KML files from the Copernicus portal
• Landsat-8 / Landsat-9: USGS Landsat acquisition cycles JSON and WRS path/row lookup