A no-code Streamlit dashboard for extracting historical satellite and climate datasets from Google Earth Engine (GEE) — without writing a single line of JavaScript or Python. Built for researchers, GIS analysts, remote sensing specialists, and data scientists who need fast, reproducible access to environmental data such as NDVI timeseries, ERA5-Land climate reanalysis, and CHIRPS precipitation records.
Overview · Features · Datasets · Installation · Usage · Architecture · Roadmap · Contributing · License
The SatLit dashboard provides a complete end-to-end pipeline for acquiring environmental and satellite imagery data directly from Google Earth Engine — no manual coding required. Users can define their region of interest (ROI) visually, configure temporal filters, and submit high-volume extraction jobs to Google Drive or local storage in just a few clicks.
New in v0.4.0 — Project Rebranding to SatLit: combining Satellite data with Streamlit, new branding assets, and updated desktop launcher.
New in v0.3.0 — Extraction Presets: save a full extraction layout (dataset, bands, ROI, dates), reload it anytime, and share it with teammates as a portable JSON file or clipboard paste — without exposing credentials or local file paths.
This tool is especially useful for:
- Agricultural monitoring (NDVI, EVI crop health analysis)
- Climate research (ERA5-Land temperature, wind, humidity)
- Hydrological studies (CHIRPS rainfall, GPM precipitation)
- GIS automation workflows requiring batch satellite data downloads
- Intuitive No-Code GUI: A polished Streamlit dashboard covering the full extraction workflow from ROI definition to download.
- Flexible Region of Interest (ROI) Selection:
- Point Coordinates: Enter Lat/Lon coordinates directly.
- Google Maps Link: Paste any Google Maps URL (full or short link) to extract coordinates automatically.
- File Upload: Import Shapefiles (
.shp), GeoJSON, or KML geometries. - Administrative Boundaries: Country and province-level selection via GADM integration (
pygadm).
- Multiple Export Targets: Export to Google Drive for large batch jobs or download results locally for quick samples.
- Extraction Presets: Build a personal library of reusable extraction layouts. Open Presets in the sidebar to Load, Save, Import, or Share a setup. Teammates can exchange presets via JSON download or copy/paste — credentials and local shapefile paths are never included.
- Reproducibility & History: Settings are persisted in
config/settings.toml; full job history is tracked in.cache/history.jsonfor instant parameter reloading. From Settings you can inspect cache size and clear all history or only entries older than a chosen age. - Desktop Shortcut: Create or recreate the SatLit desktop launcher anytime from Settings (in addition to the one-time first-run prompt).
- GEE Task Monitor: Refresh recent Earth Engine tasks in the sidebar, with a direct link to the GEE Task Manager.
- Live Map Verification: Automated geometry and map rendering to visually confirm your ROI before submitting a job.
- Auto-Update: On startup the app checks for a new version on GitHub. If one is available, a banner appears in the sidebar — one click pulls the latest changes and restarts the app in place.
| Category | Dataset | Source |
|---|---|---|
| Vegetation Indices | NDVI & EVI | MODIS MOD13Q1 |
| Weather & Climate | Temperature, Wind, Humidity | ERA5 Hourly & ERA5-Land (Hourly & Daily) |
| Precipitation | High-resolution rainfall | CHIRPS Daily |
| Precipitation | Near-real-time global rain | GPM IMERG V07 (30-Min) |
| Soil Moisture | Surface & root-zone soil moisture, temp, fluxes | SMAP SPL4SMGP v008 (3-Hourly) |
More datasets are planned — see the Roadmap.
- OS: Windows, macOS, or Linux
- Python: 3.8 or higher
- Google Earth Engine account (Sign up here — free for research)
This is the easiest path and requires no prior Python experience.
- Clone or download the repository.
- Double-click
run.bat.- On first run, it launches the installer automatically: creates a Python virtual environment and installs all dependencies.
- On subsequent runs, it simply activates the environment and launches the app.
- Authenticate with Google Earth Engine (first time only) — a browser window will open automatically asking you to authorize access.
That's it. To re-run setup at any time (e.g. after a manual git pull), run python install.py.
1. Clone the Repository
git clone https://github.com/Mastro1/SatLit.git
cd SatLit2. Run the installer
python install.pyThis creates a virtual environment and installs all dependencies.
3. Authenticate with Google Earth Engine (first time only)
python -c "import ee; ee.Authenticate()"Follow the browser prompt to authorize access. Your credentials will be cached locally.
The easiest way is to use the provided launcher scripts, which handle environment setup automatically:
- Windows: Double-click
run.bat - All platforms: Run
python run.py
Alternatively, launch manually:
streamlit run src/interface/app.py- Configure Settings — Use the sidebar to set your GEE Project ID, download folders, manage job history cache, and create a desktop shortcut. Open Presets anytime to save or reload a full extraction layout.
- Define WHAT — Select your satellite dataset (e.g., ERA5-Land Daily) and the specific bands or variables you need.
- Define WHERE — Enter point coordinates, paste a Google Maps link, upload a geometry file (Shapefile, GeoJSON, KML), or pick an administrative boundary using the GADM selector.
- Define WHEN — Set your start/end date range and apply optional seasonal filters (e.g., extract only June–September).
- Verify — Inspect the auto-rendered map to confirm your ROI is correct.
- Execute — Click Save to Drive for large batch extractions or Download Locally for immediate results.
A preset is a named extraction layout — satellite, bands, ROI, dates, and export preferences — not a past GEE job. Use presets when you re-run the same setup often, or when you want to hand a ready-made configuration to a teammate.
- Load — Open Presets, pick a saved layout under Load, then apply it to the form.
- Save — Store the current form under Save.
- Import — Under Import, paste or upload JSON, preview, then Add & load.
- Share — Under Share, download a
.jsonfile or copy from the JSON code block.
Notes: Points and GADM share cleanly. Shapefile presets remember that you used a file, but paths are never shared — the recipient chooses their own local file under File Import. Shared JSON never includes Google credentials or task IDs.
The application follows a Local State Architecture to ensure responsiveness and reliability across sessions.
User Input (Streamlit UI)
│
▼
State Manager (settings.toml + history.json + presets.json)
│
▼
GEE Python API Wrapper
│
▼
Google Earth Engine Servers
│
┌────┴────┐
▼ ▼
Google Local
Drive Storage
| Layer | Technology |
|---|---|
| Frontend (UI) | Streamlit |
| GEE Interface | earthengine-api (Python) |
| ROI Handling | geopandas, pygadm |
| Persistence | settings.toml + .cache/history.json + .cache/presets.json |
- Expand Dataset Catalog — Integrate Sentinel-2, Landsat-8/9, and additional climate products.
- Spatial Masking — Support for uploading and applying custom masks (e.g., crop masks, land cover layers) during extraction.
- Full Session Restore — Finalize "Reload Settings" to allow seamless recovery of complete previous work states.
- Extraction Presets — Local preset library with Load / Save / Import / Share (JSON file and clipboard), shipped in v0.3.0.
- Auto-Update — On startup the app checks for a new version on GitHub. If one is available, a banner appears in the sidebar — one click pulls the latest changes and restarts the app in place.
Contributions, bug reports, and feature suggestions are very welcome! This project is actively maintained and we appreciate community feedback.
To contribute:
- Fork the repository and create a new branch (
git checkout -b feature/my-feature). - Make your changes and ensure existing functionality is not broken.
- Open a Pull Request with a clear description of what you changed and why.
- Report bugs by opening a GitHub Issue with steps to reproduce.
This project is licensed under the MIT License — see the LICENSE file for details.
Developed with ❤️ for the Remote Sensing Community — github.com/Mastro1